Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

PoolOperations.Reimage Method

Definition

Namespace:
Microsoft.Azure.Batch
Assembly:
Microsoft.Azure.Batch.dll
Package:
Microsoft.Azure.Batch v16.3.1
Source:
PoolOperations.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Reinstalls the operating system on the specified compute node.

public void Reimage(string poolId, string computeNodeId, Microsoft.Azure.Batch.Common.ComputeNodeReimageOption? reimageOption = default, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default);
member this.Reimage : string * string * Nullable<Microsoft.Azure.Batch.Common.ComputeNodeReimageOption> * seq<Microsoft.Azure.Batch.BatchClientBehavior> -> unit
Public Sub Reimage (poolId As String, computeNodeId As String, Optional reimageOption As Nullable(Of ComputeNodeReimageOption) = Nothing, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing)

Parameters

poolId
String

The id of the pool that contains the compute node.

computeNodeId
String

The id of the compute node to reimage.

reimageOption
Nullable<ComputeNodeReimageOption>

Specifies when to reimage the node and what to do with currently running tasks. The default is Requeue.

additionalBehaviors
IEnumerable<BatchClientBehavior>

A collection of BatchClientBehavior instances that are applied to the Batch service request after the CustomBehaviors.

Remarks

You can reimage a compute node only when it is in the Idle or Running state.

This is a blocking operation. For a non-blocking equivalent, see ReimageAsync(String, String, Nullable<ComputeNodeReimageOption>, IEnumerable<BatchClientBehavior>, CancellationToken).

Applies to


Feedback

Was this page helpful?