Export (0) Print
Expand All

Invoke-HpcTest

Runs one or more specified diagnostic tests on one or more specified nodes.

Syntax

Invoke-HpcTest [-Scheduler <string>] -GroupName <string> -Name <string[]> [<CommonParameters>]

Invoke-HpcTest [-NodeName <string[]>] [-Scheduler <string>] -Name <string[]> [<CommonParameters>]

Invoke-HpcTest [-Scheduler <string>] -Name <string[]> -Node <HpcNode[]> [<CommonParameters>]

Invoke-HpcTest [-Scheduler <string>] -GroupName <string> -Test <HpcTestCase[]> [<CommonParameters>]

Invoke-HpcTest [-NodeName <string[]>] [-Scheduler <string>] -Test <HpcTestCase[]> [<CommonParameters>]

Invoke-HpcTest [-Scheduler <string>] -Node <HpcNode[]> -Test <HpcTestCase[]> [<CommonParameters>]

Detailed Description

Runs one or more specified diagnostic tests on one or more specified nodes. You can specify the diagnostic tests by using the names or HpcTestCase objects for the tests. You can specify the nodes by using the names or HpcNode objects for the nodes, or by using the name of a node group that contains the nodes.

Parameters

-GroupName <string>

Specifies the name of the node group that contains the nodes on which you want to run the diagnostic tests. You cannot specify both the GroupName parameter and either the Node or the NodeName parameter.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name <string[]>

Specifies a list of one or more names for the diagnostic tests that you want to run. Use the Get-HpcTest cmdlet to view a list of the available diagnostic tests. You cannot specify both the Name and Test parameters.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Node <HpcNode[]>

Specifies a list of one or more HpcNode objects for the nodes on which you want to run the diagnostic tests. Use the Get-HpcNode cmdlet to get the HpcNode objects for the nodes. You cannot specify both the Node parameter and either the GroupName or the NodeName parameter.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-NodeName <string[]>

Specifies a list of one or more names for the nodes on which you want to run the diagnostic tests. Use the Get-HpcNode cmdlet view the names of the nodes in the HPC cluster. You cannot specify both the NodeName parameter and either the GroupName or the Name parameter.

 

Required?

false

Position?

named

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 diagnostic tests and 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>

 

Required?

false

Position?

named

Default Value

%CCP_SCHEDULER%

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Test <HpcTestCase[]>

Specifies a list of one or more HpcTestCase objects for the diagnostic tests that you want to run. Use the Get-HpcTest cmdlet to get the HpcTestCase objects for the diagnostic tests. You cannot specify both the Test and Name parameters.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

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

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

 

Input Type

One or more HpcTestCase objects, or one or more HpcNode objects.

Return Type

None.

Example 1

C:\PS>Invoke-HpcTest -Name "Domain Connectivity" -NodeName ComputeNode1

Runs the diagnostic test named Domain Connectivity on the node named ComputeNode1.

Example 2

C:\PS>Invoke-HpcTest -Name "Domain Connectivity","Internode Connectivity" -GroupName MyNodeGroup

Runs the diagnostic tests named Domain Connectivity and Internode Connectivity on all of the nodes that belong to the node group named MyNodeGroup.

Example 3

C:\PS>Get-HpcNode -Name MyComputeNode | Invoke-HpcTest -Name "Internode Connectivity"

Gets the HpcNode object for the node named MyComputeNode, then runs the diagnostic test named Internode Connectivity on that node by redirecting that HpcNode object to the Invoke-HpcTest cmdlet.

Example 4

C:\PS>Get-HpcTest -Name "Domain Connectivity" | Invoke-HpcTest -NodeName ComputeNode2

Gets the HpcTestCase object for the diagnostic test named Domain Connectivity, then runs that diagnostic test on the node named ComputeNode2 by redirecting that HpcTestCase object to the Invoke-HpcTest cmdlet.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft