Get-HpcTestResultDetail

Gets detailed information about the results of a run for a diagnostic test.

Syntax

Get-HpcTestResultDetail
   [-RunId] <Int32>
   [-ClusterConnectionString <String[]>]
   [-Scheduler <String[]>]
   [<CommonParameters>]
Get-HpcTestResultDetail
   -Run <HpcTestResult>
   [-ClusterConnectionString <String[]>]
   [-Scheduler <String[]>]
   [<CommonParameters>]

Description

The Get-HpcTestResultDetail cmdlet gets detailed information about the results of a specific run for a diagnostic test, including the start and end times for the test, the values specified for the parameters of the test, and the results of the test on each node in the test.

You can specify the test run for which you want to view detailed results by specifying the identifier of the test run or by specifying an HpcTestResult object for the run. Use the Get-HpcTestResult cmdlet to get the identifier of the runs for a diagnostic test or to get the HpcTestResult object for a specific run.

Examples

Example 1: Get test result details by run ID

PS C:\>Get-HpcTestResultDetail -RunId 9

This command gets detailed information about the results of a test run with a test run identifier of 9.

Example 2: Get test result details by result type

PS C:\>Get-HpcTestResult -Alias "ping" -Result Failure | Get-HpcTestResultDetail

This command gets HpcTestResult objects for the test runs of the Ping Test that has a result of Failure, and gets detailed information about those test runs by redirecting the HpcTestResult object to the input of the Get-HpcTestResultDetail cmdlet.

Required Parameters

-Run

Specifies the test run for which you want to view information. Use the Get-HpcTestResult cmdlet to get the HpcTestResult object for the test run. You cannot specify both the Run and RunId parameters.

Type:HpcTestResult
Aliases:TestResult
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RunId

Specifies the run identifier to the test run for which you want to view information. Use the Get-HpcTestResult cmdlet to view a list of test runs for the HPC cluster. You cannot specify both the RunId and Run parameters.

Type:Int32
Aliases:Id
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-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 2016.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Scheduler

Specifies the host name or IP address of the head node for the HPC cluster on which the diagnostic test was run. 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\>

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

HpcTestResult

Outputs

HpcTestResultDetail

Notes

  • You must be a cluster administrator to run this cmdlet successfully.
  • This cmdlet was introduced in HPC Pack 2008 R2. It is not supported in previous versions.