PoolOperations.Reimage Method

Definition

Namespace:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Package:

Microsoft.Azure.Batch v16.2.0

Source:

PoolOperations.cs

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).