.png)
Get-ClusterNode
Updated: August 15, 2012
Applies To: Windows Server 2012
Get-ClusterNode
Syntax
Parameter Set: InputObject Get-ClusterNode [[-Name] <StringCollection> ] [-Cluster <String> ] [-InputObject <PSObject> ] [ <CommonParameters>]
Detailed 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.
Parameters
-Cluster<String>
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.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-InputObject<PSObject>
Specifies the cluster on which to enumerate cluster nodes.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
Accept Pipeline Input? |
true (ByValue) |
|
Accept Wildcard Characters? |
false |
-Name<StringCollection>
Specifies the name of the cluster node to get.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
true |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- Microsoft.FailoverClusters.PowerShell.Cluster
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.FailoverClusters.PowerShell.ClusterNode
Examples
EXAMPLE 1
This example displays the name, id, and state of each node, or server, in the local cluster.
PS C:\> Get-ClusterNode
Name ID State ---- -- ----- node1 1 Up node2 2 Up node3 3 Up node4 4 Up
EXAMPLE 2
This example displays the name, id, and state of each node, or server, in the cluster named cluster1.
PS C:\> Get-ClusterNode -Cluster cluster1
Name ID State ---- -- ----- node1 1 Up node2 2 Up
EXAMPLE 3
This example lists all cluster resources that are currently owned by node named node1 on the local cluster.
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
Related topics
