Applies To: Microsoft HPC Pack 2008 R2, Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2, Windows HPC Server 2008 R2

Provides subcommands for managing diagnostic tests.


Subcommand Description

test add

Adds the custom diagnostic tests that the specified XML file defines to the set of diagnostic tests that administrators can run on the HPC cluster.

test cancel

Cancels the specified diagnostic test run if it is still running.

test listruns

Displays information about all of the test runs for the HPC cluster.

test listtests

Lists the diagnostic tests that are currently installed on the HPC cluster, including the identifiers, aliases, names, and descriptions for the tests.

test remove

Removes the diagnostic test with the specified alias or identifier from the HPC cluster.

test run

Runs the specified diagnostic test on one or more specified nodes, or on all nodes if no nodes are specified.

test setcreds

Sets or clears the credentials that are used to run diagnostic tests on the HPC cluster.

test viewresult

Displays the Report.html file that includes the results for the specified test run in a web browser.

test viewrun

Displays information about the specified test run, including the following items:

  • The state and result for the test

  • The user who requested the test

  • The dates and times that the test was submitted, started, and ended

  • The result of the test on each node on which the test ran

test viewtest

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

test /?

Displays Help at the command prompt.

test /help

Displays Help at the command prompt.


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

  • This command and its subcommands were introduced in Microsoft® HPC Pack 2008 R2. They are not supported in previous versions.