Export (0) Print
Expand All

Get-HpcTestResult

Gets the status of test results for the specified diagnostic test that meet the specified criteria, or gets the status of test results for diagnostic tests that failed on the specified node that meet the specified criteria.

Syntax

Get-HpcTestResult [-LastRunTime <DateTime>] [-Scheduler <string>] [-Suite <string>] [-TestState <TestResult>] [-Name] <string> [<CommonParameters>]

Get-HpcTestResult [-FailedNode <HpcNode>] [-LastRunTime <DateTime>] [-Scheduler <string>] [-Suite <string>] [-TestState <TestResult>] [<CommonParameters>]

Get-HpcTestResult [-LastRunTime <DateTime>] [-Scheduler <string>] [-Suite <string>] [-TestState <TestResult>] -Test <HpcTestCase> [<CommonParameters>]

Detailed Description

Gets the status of test results for the specified diagnostic test that meet the specified criteria, or gets the status of test results for diagnostic tests that failed on the specified node that meet the specified criteria. The status of a test result includes values such as success, failure, completed, and so on.

If you do not specify a diagnostic test or node, the cmdlet gets the status all of the test results that meet any specified criteria, regardless of the diagnostic test that generated the test results or the node that ran the diagnostic test.

Parameters

-FailedNode <HpcNode>

Specifies the HpcNode object for the node for which you want to get the test results for diagnostic tests that failed. Use the Get-HpcNode cmdlet to get an HpcNode object for a node. If you specify the FailedNode parameter, the Get-HpcTestResult only gets test results for diagnostic test runs that failed.

You cannot specify both the FailedNode parameter and either the Name or the Test parameter.

 

Required?

false

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LastRunTime <DateTime>

Specifies a DateTime object or equivalent string for the date and time at or after which a user ran the diagnostic test that generated the test results that you want to get. If you specify the LastRunTime parameter, the Get-HpcTestResult cmdlet gets only the test results for diagnostic tests that ran at or after the specified date and time.

 

Required?

false

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name <string>

Specifies the name of the diagnostic test for which you want to get the test results. You cannot specify both the Name parameter and either the FailedNode or the Test parameter.

 

Required?

true

Position?

1

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-Scheduler <string>

Specifies the host name or IP address of the head node for the cluster that includes the test results. 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>

 

Required?

false

Position?

named

Default Value

%CCP_SCHEDULER%

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Suite <string>

Specifies the name of the test suite that includes the diagnostic test for which you want to get test results. A diagnostic test can belong to one of the following test suites: Connectivity, Performance, Scheduler, Services, SOA, or System Configuration.

 

Required?

false

Position?

named

Default Value

the combination of all test suites

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Test <HpcTestCase>

Specifies the HpcTestCase object for the diagnostic test for which you want to get the test results. Use the Get-HpcTest cmdlet to get the HpcTestCase object for a diagnostic test. You can either save that HpcTestCase object in a variable that you specify for the Test parameter, or redirect the output of a command or an expression that gets an HpcTestCase object to the Get-HpcTestCase by using the object pipeline.

You cannot specify both the Test parameter and either the FailedNode or the Name parameter.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TestState <TestResult>

Specifies the state of the test results that you want to get. The following values are valid states: Running, Success, Warning, Failure, FailedToRun, and Complete.

 

Required?

false

Position?

named

Default Value

the combination of all of the states

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

 

Input Type

An HpcTestCase object.

Return Type

One or more HpcTestResult objects.

Example 1

C:\PS>Get-HpcTestResult -Name *connectivity* -LastRunTime (get-date).AddMonths(-3)

Gets the results of all diagnostic tests that have names that include the word "connectivity" that user ran in the past 3 months. An administrator can use these test results to determine performance trends.

Example 2

C:\PS>Get-HpcTestResult -Suite Services

Gets the results for all diagnostic tests that belong to the Services test suite.

Example 3

C:\PS>Get-HpcTestResult -Name NetworkConfiguration* -TestState Complete | Select-Object -Last 1

Gets the result for the last completed test for a diagnostic test that has a name that begins with NetworkConfiguration.

Example 4

C:\PS>Get-HpcTest -Name "Domain Connectivity" | Get-HpcTestResult -LastRunTime (get-date).AddDays(-1)

Gets all of the test results for the past day for the diagnostic test named Domain Connectivity.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft