IClusterNodeUpdater.StageAsync Method (IStageCallback)

 

Starts a task that will perform any required staging prior to installation, such as downloading needed first-order updates.

Namespace:   Microsoft.ClusterAwareUpdating
Assembly:  ClusterAwareUpdating (in ClusterAwareUpdating.dll)

Syntax

Task StageAsync(
    IStageCallback stageCallback
)

Task^ StageAsync(
    IStageCallback^ stageCallback
)

abstract StageAsync : 
        stageCallback:IStageCallback -> Task

Function StageAsync (
    stageCallback As IStageCallback
) As Task

Parameters

• stageCallback
  Type: Microsoft.ClusterAwareUpdating.IStageCallback

  An interface that allows the plugin to report the progress of the staging operation and any updates that were staged. The callback methods are thread safe and can be called from any thread.

Return Value

Type: System.Threading.Tasks.Task

Returns a Task containing a task object that can be used to track the staging operation. The task should already be running.

Remarks

The stage operation should be run on the node specified in the call to CreateUpdater. Similarly, the System.Threading.CancellationToken passed to CreateUpdater will be used to signal cancellation.

The first time this method is called, the target node will not yet be in Node Maintenance Mode. The task started by this method should do as much preparation as possible (such as to download updates) before the target machine is placed into Node Maintenance Mode.

The returned task does not need to stage any second-order updates, which are updates that apply only after the first-order updates have been installed.

See Also

IClusterNodeUpdater Interface
Microsoft.ClusterAwareUpdating Namespace

Return to top