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>]
   -Owners <StringCollection>
   [-Resource <String>]
   [<CommonParameters>]

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.

Required Parameters

-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
Accept pipeline input:False
Accept wildcard characters:False

Optional 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
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
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
Accept pipeline input:True (ByValue)
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
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResource

Outputs

None