Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Get-ClusterNode

Last Updated: 3/28/2017

SYNOPSIS

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
Parameter Sets: (All)
Aliases: 

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

-InputObject

Specifies the cluster on which to enumerate cluster nodes.

Type: PSObject
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Specifies the name of the cluster node to get.

Type: StringCollection
Parameter Sets: (All)
Aliases: 

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Microsoft.FailoverClusters.PowerShell.Cluster

OUTPUTS

Microsoft.FailoverClusters.PowerShell.ClusterNode

NOTES

Add-ClusterNode

Get-ClusterResource

Remove-ClusterNode

Resume-ClusterNode

Start-ClusterNode

Stop-ClusterNode

Suspend-ClusterNode

© 2017 Microsoft