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"

Remove-HpcNode

Restart-HpcNode

Set-HpcNode

Shutdown-HpcNode

Start-HpcNode