Configuring Clustered Services and Applications (Resource Groups) by Using Windows PowerShell

Updated: October 1, 2009

Applies To: Windows Server 2008 R2

This topic lists common tasks related to configuring clustered services and applications (resource groups) on 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 clustered services and applications (resource groups)

The following table lists common tasks for working with clustered services and applications (resource groups), and the example Windows PowerShell commands for performing those tasks.

Task PowerShell command

Review status of clustered services and applications.

Get-ClusterGroup

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

Review the resources in a clustered service or application.

Get-ClusterGroup "Clustered Server 1" | Get-ClusterResource

Where Clustered Server 1 is a clustered server (such as a file server) that contains resources you want to review.

For more information, see:

Review detailed settings of resources in a clustered service or application.

Get-ClusterGroup "Clustered Server 1" | Get-ClusterResource | Get-ClusterParameter

Where Clustered Server 1 is a clustered server (such as a file server) for which you want to review resources and detailed resource settings.

For more information, see :

Bring a clustered service or application online.

Start-ClusterGroup "Clustered Server 1"

Where Clustered Server 1 is a clustered server (such as a file server) that you want to bring online.

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

Take a clustered service or application offline.

Stop-ClusterGroup "Clustered Server 1"

Where Clustered Server 1 is a clustered server (such as a file server) that you want to take offline.

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

Move a clustered service or application.

(This also tests failover.)

Move-ClusterGroup "Clustered Server 1"

Where Clustered Server 1 is a clustered server (such as a file server) that you want to test or move.

For more information, see Move-ClusterGroup (https://go.microsoft.com/fwlink/?LinkId=143799).

Additional references