Get-BeSuiteRunStatistics
Gets statistics about the last runs of a specific suite.
Get-BeSuiteRunStatistics
-Connection <Connection>
-SuiteId <Integer>
[-Skip <Integer>]
[-Take <Integer>]
Description
The Get-BeSuiteRunStatistics cmdlet returns a list of statistic-objects about the last runs of a specific test suite.
Use the optional parameters Skip and Take to define which suite runs should be returned. E.g. if using -Take 1, the very last suite run stats get returned.
Example
The following example shows how to return the very last suite run stats.
$suiteId = 1
# Get statistics about the last Suite-Run
$runStats = Get-BeSuiteRunStatistics -SuiteId $suiteId -Take 1 -Connection $connection
$runStat = $runStats.items[0]
# Write some statistics about the last run to the console
Write-Host ("Run-ID: " + $runStat.runId)
Write-Host ("Tests run: " + $runStat.totalCount)
Write-Host ("Tests succeeded: " + $runStat.succeededCount)
Write-Host ("Tests failed: " + $runStat.failedCount)
Write-Host ("Tests excepted: " + $runStat.exceptionsCount)
Write-Host ("Success-Rate: " + ($runStat.succeededCount / $runStat.totalCount * 100) + "%")
Parameters
-Connection
Pass the connection-object returned by the Connect-BeInstance cmdlet.
| Type: | Connection |
| Mandatory: | Yes |
| Position: | Named |
| Default Value: | None |
-SuiteId
The ID of the suite whose last runs should be returned.
| Type: | Integer |
| Mandatory: | Yes |
| Position: | Named |
| Default Value: | None |
-Skip
The amount of records that should be skipped from the result. e.g. using -Skip 3 means that the last three runs will not be returned.
| Type: | Integer |
| Mandatory: | No |
| Position: | Named |
| Default Value: | 0 |
-Skip
The amount of records that should be returned.
| Type: | Integer |
| Mandatory: | No |
| Position: | Named |
| Default Value: | 10 |
Output
The cmdlet outputs a SuiteRunStatisticsResult-object that contains the following attributes.
| Name | Data Type | Description |
|---|---|---|
| Items | List | A list of TestResultsScopedItem-objects that are explained in detail below. |
| Total | Int64 | The total amount of available suite run stats. |
| Skip | Int64 | The amount of stats that were skipped in the result. |
| Take | Int64 | The amount of stats returned by the cmdlet. |
The TestResultsScopedItem-object contains the following attributes.
| Name | Data Type | Description |
|---|---|---|
| RunId | List | The ID of the test suite run that produced the test results. |
| Timestamp | DateTime | The point in time when the suite run finished. |
| Status | String | The completion status of the suite run. Either Succeeded, Failed or Canceled. |
| SucceededCount | Integer | The amount of test case instances that succeeded. |
| FailedCount | Integer | The amount of test case instances that failed. |
| ExceptionsCount | Integer | The amount of test case instances that threw an exception. |
| NotEnoughProbesCount | Integer | The amount of test case instances that had not enough probes to evaluate the testing algorithm. |
| DifferentDimensionalityCount | Integer | The amount of test case instances that failed due to a dimensionality divergence. |
| NotEvaluatedCount | Integer | The amount of test case instances that couldn’t be evaluated. |
| ExecutingCount | Integer | The amount of test case instances that are still executing. |
| TotalCount | Integer | The total amount of test case instances within the suite run. |