Get-HpcNode
Get-HpcNode
Gets a list of one or more nodes in the HPC cluster that meet the specified criteria.
Syntax
Parameter Set: node
Get-HpcNode [[-Name] <String[]> ] [-Group <HpcGroup> ] [-GroupName <String[]> ] [-Health <NodeHealth[]> ] [-HealthState <NodeHealthState[]> ] [-Location <String[]> ] [-Scheduler <String> ] [-State <ClusterNodeState[]> ] [-TemplateName <String[]> ] [ <CommonParameters>]
Detailed Description
Gets a list of one or more nodes in the HPC cluster that meet the specified criteria for name, group, location, node template, node health, or node state.
Parameters
-Group<HpcGroup>
Specifies the HpcGroup object for the node group that contains the nodes that you want to get.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
no default |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-GroupName<String[]>
Specifies a list of names for the node groups that contain the nodes that you want to get. The cmdlet gets nodes only once if they belong to multiple groups.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
no default |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Health<NodeHealth[]>
Specifies a list of the health values for the nodes that you want to get. The cmdlet gets the nodes that have a health value that matches any value on the list. The possible values for the Health parameter are OK, Unreachable, OngoingOperation, DiagnosticFailed, and ProvisioningFailed.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
the combination of all health values |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Location<String[]>
Specifies a list of one or more locations for the nodes that you want to get. A location is a string with a format of \<DataCenter>[\<Rack>[\<Chassis>]]. The cmdlet gets the nodes that have a location that matches any location on the list.
The location must begin with a backslash (\). If you include the <Rack> or secondary location part of the string, you must also include the <DataCenter> or primary location. If you include the <Chassis> or tertiary location part of the string, you must also specify the <Rack> or secondary location plus the <DataCenter> or primary location. Each part of the string has a maximum length of 256 characters.
If you specify only the <DataCenter> or primary location part of the location, the cmdlet gets all of the nodes that have the specified <DataCenter> or primary location, regardless of their <Rack> or secondary location and <Chassis> or tertiary location values. If you specify only the <DataCenter> or primary location and the <Rack> or secondary location, the cmdlet gets all of the nodes that have the specified <DataCenter> or primary location and the specified <Rack> or secondary location, regardless of their <Chassis> or tertiary location values.
This parameter was introduced in HPC Pack 2008 R2. It is not supported in previous versions.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
no default |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-HealthState<NodeHealthState[]>
Specifies a list of one or more node health values for the nodes that you want to get. The cmdlet gets the nodes that have a node health values that matches any value in the list.
This parameter was introduced in HPC Pack 2008 R2. It is not supported in previous versions.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
the combination of all health state values |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies a list of one or more names for the nodes that you want to get.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
no default |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Scheduler<String>
Specifies the host name or IP address of the head node for the cluster that includes the nodes. The value must be a valid computer name or IP address. If you do not specify the Scheduler parameter, this cmdlet uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. To set this environment variable, run the following cmdlet:
Set-Content Env:CCP_SCHEDULER <head_node_name>
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
%CCP_SCHEDULER% |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-State<ClusterNodeState[]>
Specifies the states of the nodes that you want to get. The state of a node reflects the deployment state of the node and whether or not an administrator wants the node to be available as a resource for cluster jobs. The cmdlet gets the nodes that have a state that matches any value in the list.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
the combination of all state values |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TemplateName<String[]>
Specifies a list of names for the node templates that are associated with the nodes that you want to get.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
no default |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<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.
- An HpcGroup object
Outputs
The output type is the type of the objects that the cmdlet emits.
- One or more HpcNode objects
Notes
The behavior of this parameter was changed in Windows HPC Pack 2008 R2 so that when you provision nodes from bare metal the nodes are not assigned to any node groups until provisioning is complete.
You must be a cluster administrator to run this cmdlet successfully.
Examples
EXAMPLE 1
Gets all compute nodes that use the node template named ApplicationA. You can set up nodes to have a particular node template when you provision the nodes for a particular application.
PS C:\>Get-HpcNode -TemplateName "ApplicationA"
EXAMPLE 2
Gets all healthy nodes.
PS C:\>Get-HpcNode -HealthState OK
EXAMPLE 3
Gets all of the nodes that have a state of Offline or Rejected.
PS C:\>Get-HpcNode -State Offline,Rejected
EXAMPLE 4
Gets all of the nodes that are located in data center 1, regardless of their rack or chassis locations.
PS C:\>Get-HpcNode -Location "\datacenter1"