Get-ClusterNode

Gets information about one or more nodes, or servers, in a failover cluster.

Syntax

Get-ClusterNode
   [[-Name] <StringCollection>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Get-ClusterNode cmdlet gets information about one or more nodes, or servers, in a failover cluster.

Use this cmdlet to obtain information about the node status. To see the resources currently owned by a particular node, specify that node in this cmdlet and then pipe the results through the Get-ClusterResource cmdlet.

Examples

Example 1

PS C:\> Get-ClusterNode
Name           ID    State 
----           --    ----- 
node1           1     Up 
node2           2     Up 
node3           3     Up 
node4           4     Up

This example displays the name, id, and state of each node, or server, in the local cluster.

Example 2

PS C:\> Get-ClusterNode -Cluster cluster1
Name           ID    State 
----           --    ----- 
node1           1     Up 
node2           2     Up

This example displays the name, id, and state of each node, or server, in the cluster named cluster1.

Example 3

PS C:\> Get-ClusterNode -Name node1 | Get-ClusterResource
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
Cluster Disk 1      Online              Cluster Group       Physical Disk 
Cluster IP Address  Online              Cluster Group       IP Address 
Cluster IP Addre... Online              Cluster Group       IPv6 Address 
Cluster Name        Online              Cluster Group       Network Name 
File Share Witness  Offline             Cluster Group       File Share Witness

This example lists all cluster resources that are currently owned by node named node1 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

-InputObject

Specifies the cluster on which to enumerate cluster nodes.

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

-Name

Specifies the name of the cluster node to get.

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

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterNode