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

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

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.

Examples

Example 1

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

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

Example 2

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

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.

Parameters

-Cluster

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Owners

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.

Type:StringCollection
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Resource

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

None