Share via

Invoke-HpcTest

Module:
HPC Module

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

Syntax

TestNameNodeName (Default) 

Invoke-HpcTest
    [-Alias] <String>
    [[-Company] <String>]
    -NodeName <String[]>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

TestNameNodeObj 

Invoke-HpcTest
    [-Alias] <String>
    [[-Company] <String>]
    -Node <HpcNode[]>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

TestNameGroupName 

Invoke-HpcTest
    [-Alias] <String>
    [[-Company] <String>]
    -GroupName <String>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

TestObjNodeName 

Invoke-HpcTest
    -Test <HpcTestCase>
    -NodeName <String[]>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

TestObjNodeObj 

Invoke-HpcTest
    -Test <HpcTestCase>
    -Node <HpcNode[]>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

TestObjGroupName 

Invoke-HpcTest
    -Test <HpcTestCase>
    -GroupName <String>
    [-Parameters <Hashtable>]
    [-RunTestAs <PSCredential>]
    [-ClusterConnectionString <String[]>]
    [-Scheduler <String[]>]
    [<CommonParameters>]

Description

The Invoke-HpcTest cmdlet runs the specified diagnostic tests on one or more specified nodes. You can specify the diagnostic test by using the alias or by specifying the HpcTestCase object for the test. You can specify the nodes by using the names or by specifying the HpcNode objects for the nodes, or you can use the name of a node group that contains the nodes.

Examples

Example 1: Invoke a test by node name

PS C:\>Invoke-HpcTest -Alias "ping" -NodeName "ComputeNode1"

This command runs the Ping Test on the node named ComputeNode1.

Example 2: Invoke a test by group name

PS C:\>Invoke-HpcTest -Alias "dnstest" -GroupName "MyNodeGroup"

This command runs the DNS Test on all of the nodes that belong to the node group named MyNodeGroup.

Example 3: Get a node and invoke a test

PS C:\>Get-HpcNode -Name "MyComputeNode" | Invoke-HpcTest -Alias "ad"

This command gets the HpcNode object for the node named MyComputeNode, and then runs the Domain Connectivity Test on that node by redirecting that HpcNode object to the Invoke-HpcTest cmdlet.

Example 4: Invoke a test and specify its parameters

PS C:\>Invoke-HpcTest -Alias "ping" -Parameters @{ Network="Private" ; count=5 } -RunTestAs CONTOSO\someone -NodeName "ComputeNode01"

This command runs the Ping Test with the Network parameter set to Private and the ping count parameter set to 5 on ComputeNode01, and uses the credentials of the user with the user name of CONTOSO\someone. A dialog box is displayed to prompt you for the password for the CONTOSO\someone account.

Example 5: Get a test case and invoke it on a node

PS C:\>Get-HpcTest -Alias "ad" | Invoke-HpcTest -NodeName "ComputeNode2"

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

Parameters

-Alias

Specifies the alias for the diagnostic test that you want to run. Use the Get-HpcTest cmdlet to view the diagnostic tests that are available on the HPC cluster. You cannot specify both the Alias and Test parameters.

This parameter was introduced in HPC Pack 2008 R2. It is not available in previous versions. It replaced the Name parameter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name

Parameter sets

TestNameNodeName
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestNameNodeObj
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestNameGroupName
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClusterConnectionString

Specifies an array of cluster connection strings for the cluster to which you want to add the device drivers. The value format is host1,host2,host3. If you do not specify the ClusterConnectionString parameter, this cmdlet uses the connection string on the head node that the CCP_CONNECTIONSTRING environment variable specifies. To set this environment variable, run the following cmdlet: Set-Content Env: CCP_CONNECTIONSTRING \<head_node_name\>.

This parameter was introduced in HPC Pack 2008 R2. It is not available in previous versions. It replaced the Name parameter.

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

-Company

Specifies the company that created the diagnostic test that you want to run. If you specify the Company parameter, you must also specify the Alias parameter. Specify the company if your HPC cluster includes two diagnostic tests with the same alias from different companies. You cannot specify both the Company and Test parameters.

This parameter was introduced in HPC Pack 2008 R2. It is not available in previous versions. It replaced the Name parameter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TestNameNodeName
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestNameNodeObj
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestNameGroupName
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GroupName

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TestNameGroupName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestObjGroupName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Node

Specifies an array of 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.

Parameter properties

Type:

HpcNode[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TestNameNodeObj
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
TestObjNodeObj
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-NodeName

Specifies an array of names for the nodes on which you want to run the diagnostic tests. Use the Get-HpcNode cmdlet to 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. This parameter is a filter parameter, so you do not receive an error for specifying a node the does not exist in the HPC cluster as long as you specify at least one node that does exist.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TestNameNodeName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TestObjNodeName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Parameters

Specifies the values to use for the parameters of the diagnostic test. When you specify the hash table for the parameters and values, use the switch name for the parameter as the key name. For example, the ping test has parameters with the switch names of Network and count, so you can specify the hash table as @{ Network="Private" ; count=5 } if you want to use the Private network and a ping count of 5. Use the Get-HpcTestDetail cmdlet, or contact the company that created the test to determine the parameters available for the diagnostic test and their switch names.

This parameter was introduced in HPC Pack 2008 R2. It is not available in previous versions.

Parameter properties

Type:Hashtable
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

-RunTestAs

Specifies the credentials under which you want the commands for the diagnostic test to run. Use the Get-Credential cmdlet to create a PSCredential object. If you specify a user name for this parameter, the cmdlet displays a dialog box that prompts you to provide a password for the user.

This parameter was introduced in HPC Pack 2008 R2. It is not available in previous versions. It replaced the Name parameter.

Parameter properties

Type:PSCredential
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

-Scheduler

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\>

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

-Test

Specifies an HpcTestCase object for the diagnostic test that you want to run. Use the Get-HpcTest cmdlet to get the HpcTestCase object for the diagnostic test. You cannot specify both the Test and either Alias or Company parameters.

Parameter properties

Type:HpcTestCase
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

TestObjNodeName
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
TestObjNodeObj
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
TestObjGroupName
Position:Named
Mandatory:True
Value from pipeline:True
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.

Inputs

HpcTestCase, HpcNode

Outputs

HpcTestResult

Notes

  • To cancel a diagnostic test run, use the Stop-HpcTestResult cmdlet.
  • You must be a cluster administrator to run this cmdlet successfully.