Suspend-ClusterNode
Suspends activity on a failover cluster node, that is, pauses the node.
Syntax
Suspend-ClusterNode
[[-Name] <StringCollection>]
[[-TargetNode] <String>]
[-Cluster <String>]
[-Drain]
[-ForceEvacuation]
[-InputObject <PSObject>]
[-Wait]
Description
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.
Examples
Example 1: Pause a node of the local cluster
PS C:\> Suspend-ClusterNode -Name "node1"
Name State
---- -----
node1 Paused
This example pauses the node named node1 on the local cluster.
Example 2: Pause a node of a cluster
PS C:\> Suspend-ClusterNode "node2" -Cluster "cluster2"
Name State
---- -----
node2 Paused
This example pauses the node named node2 on the cluster named cluster2.
Example 3: Pause a node and move its workloads
PS C:\> Suspend-ClusterNode -Name "node1" -Target "node2" -Drain
Name State
---- -----
node1 Paused
This example pauses the node named node1 and moves the workloads from it to the node named node2.
Example 4: Preview a pause operation
PS C:\> Suspend-ClusterNode node1 -Drain -WhatIf
What if: Performing operation "Suspend-ClusterNode" on Target "node1".
This example provides a preview of the operation that will be performed on the node named node1.
Parameters
-Cluster
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceEvacuation
Specifies that workloads are moved from a node even in the case of an error.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the cluster node to suspend (with or without draining), or the cluster on which to run the cmdlet.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifies the name of the cluster node to suspend (with or without draining).
Type: | StringCollection |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TargetNode
Specifies a node to which to drain the workloads.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
Specifies the time in seconds to wait for the cmdlet.
If the Wait parameter is not specified, then the cmdlet waits for completion.
If -Wait 0
is specified, then the call is initiated and the cmdlet returns without waiting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.Cluster
Microsoft.FailoverClusters.PowerShell.ClusterNode
Outputs
Microsoft.FailoverClusters.PowerShell.ClusterNode
Related Links
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for