Set-ClusterOwnerNode

Set-ClusterOwnerNode

Specifies which nodes can own a resource in a failover cluster or specifies the order of preference among owner nodes for a clustered role, or resource group.

Syntax

Parameter Set: InputObject
Set-ClusterOwnerNode -Owners <StringCollection> [-Cluster <String> ] [-Group <String> ] [-InputObject <PSObject> ] [-Resource <String> ] [ <CommonParameters>]

Detailed Description

The Set-ClusterOwnerNode cmdlet specifies which nodes can own a resource in a failover cluster or specifies the order of preference among owner nodes for a clustered role, or resource group. The settings that control the possible or preferred owners affect the way the cluster responds to the failure of a resource or a clustered role.

Parameters

-Cluster<String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Group<String>

Specifies the name of the cluster group for which owner nodes are set.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-InputObject<PSObject>

Specifies the cluster group or cluster resource for which to set owner nodes.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Owners<StringCollection>

Specifies the list of owner nodes. If this is for a cluster group, then the sorted list of nodes is the preferred owners for this cluster group. If this is for a cluster resource, then the list is for the possible owners for this cluster resource.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Resource<String>

Specifies the name of the cluster resource for which owner nodes are set.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

• Microsoft.FailoverClusters.PowerShell.ClusterGroup
• Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

The output type is the type of the objects that the cmdlet emits.

• None

Examples

Example 1

This example sets the possible owners for cluster named Cluster Disk 3 on the local cluster to the nodes named node1 and node2.

PS C:\> Get-ClusterResource –Name "Cluster Disk 3" | Set-ClusterOwnerNode -Owners node1,node2

Example 2

This example sets the preferred owners for the clustered service named cluster12FS to the node named node3 followed by the node named node2 on the local cluster.

PS C:\> Set-ClusterOwnerNode -Group cluster12FS -Owners node3,node2

Related topics

Get-ClusterOwnerNode