PoolOperations.ReimageAsync Method (String, String, Nullable<ComputeNodeReimageOption>, IEnumerable<BatchClientBehavior>)

Reinstalls the operating system on the specified compute node.

Namespace:   Microsoft.Azure.Batch
Assembly:  Microsoft.Azure.Batch (in Microsoft.Azure.Batch.dll)

Syntax

public Task ReimageAsync(
    string poolId,
    string computeNodeId,
    Nullable<ComputeNodeReimageOption> reimageOption = null,
    IEnumerable<BatchClientBehavior> additionalBehaviors = null
)

public:
Task^ ReimageAsync(
    String^ poolId,
    String^ computeNodeId,
    Nullable<ComputeNodeReimageOption> reimageOption = null,
    IEnumerable<BatchClientBehavior^>^ additionalBehaviors = null
)

member ReimageAsync : 
        poolId:string *
        computeNodeId:string *
        reimageOption:Nullable<ComputeNodeReimageOption> = null *
        additionalBehaviors:IEnumerable<BatchClientBehavior> = null -> Task

Public Function ReimageAsync (
    poolId As String,
    computeNodeId As String,
    reimageOption As Nullable(Of ComputeNodeReimageOption),
    additionalBehaviors As IEnumerable(Of BatchClientBehavior)
) As Task

Parameters

• poolId
  Type: System.String

  The id of the pool that contains the compute node.

• computeNodeId
  Type: System.String

  The id of the compute node to reimage.

• reimageOption
  Type: System.Nullable<ComputeNodeReimageOption>

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

• additionalBehaviors
  Type: System.Collections.Generic.IEnumerable<BatchClientBehavior>

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

Return Value

Type: System.Threading.Tasks.Task

A Task that represents the asynchronous operation.

Remarks

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

The reimage operation runs asynchronously.

See Also

PoolOperations Class
Microsoft.Azure.Batch Namespace

Return to top