Get-ClusterOwnerNode

Article
07/03/2012

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.

Syntax

Get-ClusterOwnerNode [-InputObject <psobject>] [-Cluster <string>] [-Group <string>] [-Resource <string>] [-ResourceType <string>] [<CommonParameters>]

InputObject
Cluster
Group
Resource
ResourceType

Detailed Description

Settings that control the possible or preferred owners affect the way the cluster responds to the failure of a resource or a resource group (a clustered service or application).

Parameters

Cluster

Specifies the name of the cluster to run this cmdlet on. If you type "-Cluster ." or omit the parameter, the cmdlet runs on the local cluster.

Default Value: **

Data Type: string

Attributes

Name	Value	PSMAML Attribute
Required?	false	required
Variable Length?	false	variableLength
Accept wildcard characters?	false	globbing
Accept Pipeline Input?	false	pipelineInput
Position?	named	position

Value Attributes

Name	Value	PSMAML Attribute
Required?	true	required
Variable Length?	false	variableLength

Group

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

Default Value: **

Data Type: string

Attributes

Name	Value	PSMAML Attribute
Required?	false	required
Variable Length?	false	variableLength
Accept wildcard characters?	false	globbing
Accept Pipeline Input?	false	pipelineInput
Position?	named	position

Value Attributes

Name	Value	PSMAML Attribute
Required?	true	required
Variable Length?	false	variableLength

InputObject

Specifies the cluster group or cluster resource to enumerate owner nodes on.

Default Value: **

Data Type: psobject

Attributes

Name	Value	PSMAML Attribute
Required?	false	required
Variable Length?	false	variableLength
Accept wildcard characters?	false	globbing
Accept Pipeline Input?	true (ByValue)	pipelineInput
Position?	named	position

Value Attributes

Name	Value	PSMAML Attribute
Required?	true	required
Variable Length?	false	variableLength

Resource

Specifies the name of the cluster resource for which owner nodes are enumerated. [Alias: res]

Default Value: **

Data Type: string

Attributes

Name	Value	PSMAML Attribute
Required?	false	required
Variable Length?	false	variableLength
Accept wildcard characters?	false	globbing
Accept Pipeline Input?	false	pipelineInput
Position?	named	position

Value Attributes

Name	Value	PSMAML Attribute
Required?	true	required
Variable Length?	false	variableLength

ResourceType

Specifies the name of the cluster resource type for which owner nodes are enumerated. [Alias: restype]

Default Value: **

Data Type: string

Attributes

Name	Value	PSMAML Attribute
Required?	false	required
Variable Length?	false	variableLength
Accept wildcard characters?	false	globbing
Accept Pipeline Input?	false	pipelineInput
Position?	named	position

Value Attributes

Name	Value	PSMAML Attribute
Required?	true	required
Variable Length?	false	variableLength

Input Type

Microsoft.FailoverClusters.PowerShell.ClusterResource, Microsoft.FailoverClusters.PowerShell.ClusterGroup, Microsoft.FailoverClusters.PowerShell.ClusterResourceType

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterOwnerNodeList

Examples

-------------------------- EXAMPLE 1 --------------------------

Command Prompt: C:\PS>

 
Get-ClusterResource "Cluster Disk 1" | Get-ClusterOwnerNode 
 
ClusterObject                           OwnerNodes 
-------------                           ---------- 
Cluster Disk 1                          {node1, node2}

Description

-----------

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

-------------------------- EXAMPLE 2 --------------------------

Command Prompt: C:\PS>

 
Get-ClusterGroup cluster1FS12 | Get-ClusterOwnerNode 
 
ClusterObject                           OwnerNodes 
-------------                           ---------- 
cluster1FS12                            {}

Description

-----------

This command lists the preferred owners for the clustered file server (resource group) called cluster1FS12 on the local cluster.

Get-ClusterOwnerNode