test viewtest

 

Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

Gets detailed information about a specified diagnostic test, including the metadata, parameters, environment variables, and commands for the test.

For examples of how to use this command, see Examples.

Syntax

test viewtest {<test_alias> | /testid:<identifier>} [/company:<company_name>]
[/server:<server_name>]

test viewtest {/? | /help}

Parameters

Parameter

Description

<test_alias>

Specifies the alias for the diagnostic test for which you want to view detailed information. You must specify the <test_alias> or the /testid parameter. If you specify both the <test_alias> and /testid parameters, the <test_alias> parameter is ignored. If your HPC cluster includes two tests with the same alias from different companies, specify the /company parameter in addition to the <test_alias> parameter to specify the test for which you want to view detailed information.

/testid:<identifier>

Specifies the numeric identifier for the test for which you want to view detailed information. You must specify the /testid or <test_alias> parameter. If you specify both the /testid and <test_alias> parameters, the <test_alias> parameter is ignored.

/company:<company_name>

Specifies the company that created the diagnostic test for which you want to view detailed information. Specify the company if your HPC cluster includes two diagnostic tests with the same alias from different companies. If the company name includes spaces, enclose the company name in quotation marks (").

/server:<server_name>

Specifies the host name or IP address of the server that hosts the HPC Diagnostics Service for the HPC cluster that has the test for which you want to view detailed information installed. The value must be a valid computer name or IP address. If you do not specify the /server parameter, this command uses the head node that the CCP_SCHEDULER environment variable specifies.

/?

Displays Help at the command prompt.

/help

Displays Help at the command prompt.

Remarks

  • To get a list of diagnostic tests that are installed on the cluster that includes their identifiers and aliases, use the test listtests command.

  • You must be a cluster administrator to run this command successfully.

Examples

To view detailed information about the diagnostic test with an alias of CustomTest3, type:

test viewtest CustomTest3

To view detailed information about the diagnostic test with an identifier of 73, type:

test viewtest /testid:73

To view detailed information about the diagnostic test with an alias of CustomTest4 from the company named Contoso, Ltd, type:

test viewtest CustomTest4 /company:"Contoso, Ltd"

Additional references