Failover Cluster Cmdlets in Windows PowerShell Listed by Task Focus

Updated: October 1, 2009

Applies To: Windows Server 2008 R2

This topic lists Windows PowerShell cmdlets for the Failover Clustering feature in Windows Server® 2008 R2. It lists the cmdlets in alphabetical order by task focus, that is, by the noun at the end of the cmdlet. For a list of cmdlets in alphabetical order based on the verb at the beginning of the cmdlet, see Failover Cluster Cmdlets in Windows PowerShell (https://go.microsoft.com/fwlink/?LinkId=162163).

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 more information about using Windows PowerShell, see Additional references, later in this topic.

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-Cluster

Get information about one or more failover clusters in a given domain.

New-Cluster

Create a new failover cluster. Before you can create a cluster, you must connect the hardware (servers, networks, and storage), and run the validation tests.

Remove-Cluster

Destroy an existing failover cluster. The affected servers will no longer function together as a cluster.

Start-Cluster

Start the Cluster service on all nodes of the cluster on which it is not yet started.

Stop-Cluster

Stop the Cluster service on all nodes in a failover cluster, which will stop all services and applications configured in the cluster.

Test-Cluster

Run validation tests for failover cluster hardware and settings. Tests can be run both before and after a cluster is set up.

Cmdlets for "ClusterAccess"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Block-ClusterAccess

Prevent the specified user or users from accessing a failover cluster.

Get-ClusterAccess

Get information about permissions that control access to a failover cluster.

Grant-ClusterAccess

Grant access to a failover cluster, either full access or read-only access.

Remove-ClusterAccess

Remove a user from the access list on the cluster.

Cmdlets for "ClusterAvailableDisk," "ClusterDisk," and "ClusterDiskReservation"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-ClusterAvailableDisk

Get information about the disks that can support failover clustering and are visible to all nodes, but are not yet part of the set of clustered disks.

Add-ClusterDisk

Make a new disk available for use in a failover cluster. The disk (LUN) must be exposed to all nodes in the failover cluster, and should not be exposed to any other servers.

Clear-ClusterDiskReservation

Clear the persistent reservation on a disk in a failover cluster.

Cmdlets for adding "ClusterFileServerRole" and other cluster roles

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterFileServerRole

Create a clustered file server (resource group that includes one or more disks, on which you can create shared folders for users).

Add-ClusterGenericApplicationRole

Configure high availability for an application that was not originally designed to run in a failover cluster.

Add-ClusterGenericScriptRole

Configure an application controlled by a script that runs in Windows Script Host, within a failover cluster.

Add-ClusterGenericServiceRole

Configure high availability for a service that was not originally designed to run in a failover cluster.

Add-ClusterPrintServerRole

Create a clustered print server (a resource group that includes a printer and a disk for storing print job information and printer drivers).

Add-ClusterServerRole

Add a group containing only a client access point and storage to the failover cluster configuration.

Add-ClusterVirtualMachineRole

Create a clustered virtual machine, that is, a virtual machine that can be failed over if necessary to a different server in the failover cluster.

Cmdlets for "ClusterGroup"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterGroup

Add an empty resource group to the failover cluster configuration, in preparation for adding clustered resources to the group.

Get-ClusterGroup

Get information about one or more clustered services or applications (resource groups) in a failover cluster.

Move-ClusterGroup

Move a clustered service or application (a resource group) from one node to another in a failover cluster.

Remove-ClusterGroup

Remove a clustered service or application (also called a resource group) from a failover cluster.

Start-ClusterGroup

Bring one or more clustered services and applications (also known as resource groups) online on a failover cluster.

Stop-ClusterGroup

Take one or more clustered services and applications (also known as resource groups) offline on a failover cluster.

Cmdlets for "ClusterLog"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-ClusterLog

Create a log file for all nodes (or a specific node) in a failover cluster.

Set-ClusterLog

Set the size and level of detail for the cluster log.

Cmdlets for "ClusterIPResource," "ClusterNetwork," and "ClusterNetworkInterface"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Update-ClusterIPResource

Renew or release the DHCP lease for an IP address resource in a failover cluster.

Get-ClusterNetwork

Get information about one or more networks in a failover cluster.

Get-ClusterNetworkInterface

Get information about one or more network adapters in a failover cluster.

Cmdlets for "ClusterNode"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterNode

Add a node (server) to a failover cluster. Before adding the new node, you should run validation tests on the existing nodes together with the proposed new node.

Clear-ClusterNode

Clear the cluster configuration from a node that was evicted from a failover cluster.

Get-ClusterNode

Get information about one or more nodes (servers) in a failover cluster.

Remove-ClusterNode

Remove a node from a failover cluster. After the node is removed, it no longer functions as part of the cluster unless you add it back to the cluster.

Resume-ClusterNode

Resume activity on a failover cluster node after you have suspended it (that is, paused it).

Start-ClusterNode

Start the Cluster service on a node in a failover cluster.

Stop-ClusterNode

Stop the Cluster service on a node in a failover cluster.

Suspend-ClusterNode

Suspend activity on a failover cluster node, that is, pause the node.

Cmdlets for "ClusterOwnerNode"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-ClusterOwnerNode

For a resource in a failover cluster, get information about which nodes can own the resource. For a clustered service or application (a resource group), get information about the order of preference among owner nodes.

Set-ClusterOwnerNode

For a resource in a failover cluster, specify which nodes can own the resource. For a clustered service or application (a resource group), specify information about the order of preference among owner nodes.

Cmdlets for "ClusterParameter"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-ClusterParameter

Get detailed information about an object in a failover cluster, such as a cluster resource. This cmdlet is used to manage private properties for a cluster object.

Set-ClusterParameter

Control specific properties of an object in a failover cluster, such as a resource, a group, or a network.

Cmdlets for "ClusterQuorum"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Get-ClusterQuorum

Get information about the quorum configuration of a failover cluster.

Set-ClusterQuorum

Configure quorum options for a failover cluster.

Cmdlets for "ClusterResource" and "ClusterResourceFailure"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterResource

Add a resource to a clustered service or application (resource group) in a failover cluster.

Get-ClusterResource

Get information about one or more resources in a failover cluster.

Move-ClusterResource

Move a clustered resource from one clustered service or application to another within a failover cluster.

Remove-ClusterResource

Remove a clustered resource from the failover cluster.

Resume-ClusterResource

Turn off maintenance for a disk resource or Cluster Shared Volume within a failover cluster.

Start-ClusterResource

Bring a resource online in a failover cluster.

Stop-ClusterResource

Take a resource offline in a failover cluster.

Suspend-ClusterResource

Turn on maintenance for a disk resource or Cluster Shared Volume so that you can run a disk maintenance tool without triggering failover.

Test-ClusterResourceFailure

Simulate a failure of a cluster resource.

Cmdlets for "ClusterResourceDependency" and "ClusterResourceDependencyReport"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterResourceDependency

Add a resource to the list of resources that a particular resource depends on (using AND as the connector) within a failover cluster. Existing dependencies will remain in the list.

Get-ClusterResourceDependency

Get information about the dependencies that have been configured between clustered resources in a failover cluster.

Remove-ClusterResourceDependency

Remove a dependency between two resources in a clustered service or application within a failover cluster.

Set-ClusterResourceDependency

Specify the resources that a particular resource depends on within a failover cluster. Existing dependencies will be overwritten by the dependencies that you specify.

Get-ClusterResourceDependencyReport

Generate a report that lists the dependencies between resources in a failover cluster.

Cmdlets for "ClusterResourceType"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterResourceType

Add a resource type to a failover cluster, and specify information such as the dynamic-link library (DLL) to use with that resource type.

Get-ClusterResourceType

Get information about one or more resource types in a failover cluster.

Remove-ClusterResourceType

Remove a resource type from a failover cluster.

Cmdlets for "ClusterSharedVolume"

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Add-ClusterSharedVolume

Make a volume available in Cluster Shared Volumes in a failover cluster.

Get-ClusterSharedVolume

Get information about Cluster Shared Volumes in a failover cluster.

Move-ClusterSharedVolume

Move a Cluster Shared Volume to ownership by a different node in a failover cluster.

Remove-ClusterSharedVolume

Remove a volume from the Cluster Shared Volumes in a failover cluster, and place it in Available Storage in the cluster.

Repair-ClusterSharedVolume

Run repair tools on a Cluster Shared Volume locally on a cluster node.

Cmdlets for "ClusterVirtualMachineConfiguration," and other virtual machine cmdlets

Cmdlets for "Cluster"

Cmdlet name Cmdlet use

Update-ClusterVirtualMachineConfiguration

Refresh the configuration of a clustered virtual machine within a failover cluster.

Add-ClusterVirtualMachineRole

Create a clustered virtual machine, that is, a virtual machine that can be failed over if necessary to a different server in the failover cluster.

Move-ClusterVirtualMachineRole

Move the ownership of a clustered virtual machine to a different node.

Additional references