Get-ClusterNode
Gets information about one or more nodes, or servers, in a failover cluster.
Syntax
Default (Default)
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InputObject
Specifies the cluster on which to enumerate cluster nodes.
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
Specifies the name of the cluster node to get.
Parameter properties
| Type: | StringCollection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.