Configuring Failover Cluster Nodes by Using Windows PowerShell

  • Article

Updated: October 1, 2009

Applies To: Windows Server 2008 R2

This topic lists common tasks related to configuring nodes in a failover cluster running Windows Server 2008 R2, and shows example Windows PowerShell commands for performing those tasks. The Windows PowerShell cmdlets provide an alternative interface for actions that you might otherwise perform with command-line commands or the Failover Cluster Manager snap-in. For topics that list other common tasks and the corresponding Windows PowerShell commands, see Performing Common Tasks in a Failover Cluster by Using Windows PowerShell.

For more information about how to use Windows PowerShell, see Additional references, later in this topic.

Common tasks and example commands for working with nodes in a failover cluster

The following table lists common tasks for working with nodes in a failover cluster, and the example Windows PowerShell commands for performing those tasks.

Task PowerShell command

Review the state of nodes.

Get-ClusterNode

For more information, see Get-ClusterNode (https://go.microsoft.com/fwlink/?LinkId=143789).

Run validation tests on a new server.

(The Failover Clustering feature must be installed.)

Test-Cluster -Node newserver,node1,node2

Where newserver is the new server that you want to add to a cluster, and node1 and node2 are nodes in that cluster.

For more information, see:

Prepare a node for maintenance.

(Moves clustered services and applications off the node.)

Get-ClusterNode node2 | Get-ClusterGroup | Move-ClusterGroup

Where node2 is the node from which you want to move clustered services and applications.

For more information, see:

Pause a node.

Suspend-ClusterNode node2

Where node2 is the node that you want to pause.

For more information, see Suspend-ClusterNode (https://go.microsoft.com/fwlink/?LinkId=143793).

Resume a node.

Resume-ClusterNode node2

Where node2 is the node that you want to resume.

For more information, see Resume-ClusterNode (https://go.microsoft.com/fwlink/?LinkId=143813).

Stop the Cluster service on a node.

Stop-ClusterNode node2

Where node2 is the node on which you want to stop the Cluster service.

For more information, see Stop-ClusterNode (https://go.microsoft.com/fwlink/?LinkId=143826).

Start the Cluster service on a node.

Start-ClusterNode node2

Where node2 is the node on which you want to start the Cluster service.

For more information, see Start-ClusterNode (https://go.microsoft.com/fwlink/?LinkId=143822).

Additional references