Suspend-ClusterNode

[アーティクル]
11/16/2015

Suspend-ClusterNode

Suspends activity on a failover cluster node, that is, pauses the node.

構文

Parameter Set: InputObject
Suspend-ClusterNode [[-Name] <StringCollection> ] [[-TargetNode] <String> ] [-Cluster <String> ] [-Drain] [-ForceEvacuation] [-InputObject <PSObject> ] [-Wait] [ <CommonParameters>]

詳細説明

The Suspend-ClusterNode cmdlet suspends activity on a failover cluster node, that is, pauses the node. If you use the Drain parameter, clustered roles currently running on the node will be drained before the node is paused.

Pausing (suspending) a node is usually done when applying software updates to the node. If you need to perform extensive diagnosis or maintenance on a cluster node, it might be more workable to stop (not pause) the Cluster service on that node.

パラメーター

-Cluster<String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Drain

Specifies that all of the workloads are gracefully moved to other nodes while maintaining the highest levels of availability and using the best placement logic.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-ForceEvacuation

Specifies that workloads are moved from a node even in the case of an error.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-InputObject<PSObject>

Specifies the cluster node to suspend (with or without draining), or the cluster on which to run the cmdlet.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	true (ByValue)
ワイルドカード文字を許可する	false

-Name<StringCollection>

Specifies the name of the cluster node to suspend (with or without draining).

エイリアス	なし
必須?	false
位置は?	1
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-TargetNode<String>

Specifies a node to which to drain the workloads.

エイリアス	なし
必須?	false
位置は?	2
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Wait

Specifies the time in seconds to wait for the cmdlet. If the Wait parameter is not specified, then the call is initiated and the cmdlet returns without waiting. If specified with no value, then the cmdlet waits for completion.. If -Wait 0 is specified, then the call is initiated and the cmdlet returns without waiting.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

Microsoft.FailoverClusters.PowerShell.Cluster
Microsoft.FailoverClusters.PowerShell.ClusterNode

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Microsoft.FailoverClusters.PowerShell.ClusterNode

例

EXAMPLE 1

This example pauses the node named node1 on the local cluster.

PS C:\> Suspend-ClusterNode node1

EXAMPLE 2

This example pauses the node named node2 on the cluster named cluster2.

PS C:\> Suspend-ClusterNode node2 -Cluster cluster2

EXAMPLE 3

This example pauses the node named node1 and moves the workloads from it to the node named node2.

PS C:\> Suspend-ClusterNode -Name node1 -Target node2 -Drain

EXAMPLE 4

This example provides a preview of the operation that will be performed on the node named node1.

PS C:\> Suspend-ClusterNode node1 -Drain -Whatif

Suspend-ClusterNode