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.
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | True |
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 |
Required: | False |
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.