Get-ClusterOwnerNode

Gets information about which nodes can own a resource in a failover cluster or information about the order of preference among owner nodes for a clustered role.

Syntax

Get-ClusterOwnerNode
   [-Resource <String>]
   [-Group <String>]
   [-ResourceType <String>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Get-ClusterOwnerNode cmdlet gets information about which nodes can own a resource in a failover cluster or information about the order of preference among owner nodes for a clustered role.

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 -Cluster "Cluster Disk 1" | Get-ClusterOwnerNode
ClusterObject                           OwnerNodes 
-------------                           ---------- 
Cluster Disk 1                          {node1, node2}

This example lists the possible owners for the cluster named Cluster Disk 1 in the local cluster.

Example 2

PS C:\> Get-ClusterGroup -Group cluster1FS12 | Get-ClusterOwnerNode
ClusterObject                           OwnerNodes 
-------------                           ---------- 
cluster1FS12                            {}

This example lists the preferred owners for the clustered file server, or resource group, called cluster1FS12 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 enumerated.

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 on which to enumerate owner nodes.

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

-Resource

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

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

-ResourceType

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

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

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterResource

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Microsoft.FailoverClusters.PowerShell.ClusterResourceType

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterOwnerNodeList