PowerShell Logo Small

Suspend-ClusterNode



This is the built-in help made by Microsoft for the command 'Suspend-ClusterNode', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

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]
[<CommonParameters>]



Search powershellhelp.space

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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=321077
Add-ClusterNode
Get-ClusterNode
Remove-ClusterNode
Resume-ClusterNode
Start-ClusterNode
Stop-ClusterNode

REMARKS

<

Examples


EXAMPLE 1

PS C:\>Suspend-ClusterNode node1
Name State
---- -----
node1 Paused



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




EXAMPLE 2

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

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

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.