Configuring Existing Failover Cluster Disks by Using Windows PowerShell

  • Article

Updated: October 1, 2009

Applies To: Windows Server 2008 R2

This topic lists common tasks related to configuring existing disks 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 existing disks in a failover cluster

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

Note

This topic describes commands for failover cluster disks that are not in Cluster Shared Volumes. For information about commands for Cluster Shared Volumes, see Configuring Cluster Shared Volumes and Clustered Virtual Machines by Using Windows PowerShell.

Task PowerShell command

Review the status of existing disks.

Get-ClusterResource

The preceding command provides the status of all resources in the cluster. You can also review the name and status of existing disks only (as with other commands in this topic, this excludes Cluster Shared Volumes):

Get-ClusterResource | ?{$_.ResourceType.Name -eq "Physical Disk"}

For more information, see:

  • Get-ClusterResource (https://go.microsoft.com/fwlink/?LinkId=143793)

  • Information about Where-Object, represented in the preceding command by ?, the question-mark alias: Where-Object (https://go.microsoft.com/fwlink/?LinkId=113423)

Review the signature and other properties of a cluster disk.

Get-ClusterResource "Cluster Disk 2" | Get-ClusterParameter

Where Cluster Disk 2 is the disk for which you want to review the disk signature.

For more information, see:

Move Available Storage to a particular node.

(Allows you to work on disks in Available Storage through that node.)

Move-ClusterGroup "Available Storage" -Node node1

Where node1 is the node that you want to move Available Storage to.

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

Turn on maintenance for a disk.

Suspend-ClusterResource "Cluster Disk 2"

Where Cluster Disk 2 is the disk in cluster storage for which you are turning on maintenance.

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

Turn off maintenance for a disk.

Resume-ClusterResource "Cluster Disk 2"

Where Cluster Disk 2 is the disk in cluster storage for which you are turning off maintenance.

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

Additional references