## PowerCLI Reference

# Test-VsanStoragePerformance

## Synopsis

This cmdlet runs a storage performance test on the specified vSAN clusters and returns the test results.

Syntax

Test-VsanStoragePerformance [-Cluster] <Cluster[]> [-RunAsync] [-TestDurationSeconds <Int32>] [-StoragePolicy <SpbmStoragePolicy>] [-UseCache] [-Workload <VsanStorageWorkloadType>] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version

Detailed Description

This cmdlet runs a storage performance test on the specified vSAN clusters and returns the test results.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Cluster | Cluster[] | Specifies the clusters on which you want to run a vSAN storage performance test. | true | true (ByValue)
RunAsync | SwitchParameter | Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console. | false | false
Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | false | false
StoragePolicy | SpbmStoragePolicy | Specifies the storage policy you want to use. | false | false
TestDurationSeconds | Int32 | Specifies the duration of the storage performance test in seconds. When the UseCache parameter is not specified, TestDurationSeconds must be specified. | false | false
UseCache | SwitchParameter | Indicates whether to get a cached result from the server. If specified, a test is not run on the server and the last result cached on the server side is returned. If not specified, a test is run on the server side and the result is returned. | false | false
Workload | VsanStorageWorkloadType | Specifies the type of workload which should be run to test the storage performance. | false | false

Return Type

VsanClusterStoragePerformanceTestResult objects representing the result of the test run

Notes

Examples

-------------- Example 1 --------------

    Test-VsanStoragePerformance -Cluster $cluster -TestDurationsSeconds 120 -StoragePolicy $policy -WorkLoad BasicSanityTest

Runs the storage performance test of basic sanity workload type with test duration of 120 seconds, using the $policy storage policy on the $cluster vSAN cluster, and returns the result of the test.

-------------- Example 2 --------------

    Test-VsanStoragePerformance -Cluster $cluster -UseCache

Gets the result of the last storage performance test run on the $cluster vSAN cluster.

Copyright © VMware, Inc. All rights reserved.