Test-VsanStoragePerformance Command | Vmware PowerCLI Reference


This cmdlet runs a storage performance test on the specified vSAN clusters and returns the test results.This cmdlet is obsolete and will be removed in a future release.


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


Required Parameter Name Type Position Features Description
Cluster Cluster[] named
  • pipeline
  • wildcards
Specifies the clusters on which you want to run a vSAN storage performance test.
optional RunAsync SwitchParameter named
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.
optional Server VIServer[] named
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.
optional StoragePolicy SpbmStoragePolicy named
  • wildcards
Specifies the storage policy you want to use.
optional TestDurationSeconds Int32 named
Specifies the duration of the storage performance test in seconds. When the UseCache parameter is not specified, TestDurationSeconds must be specified.
optional UseCache SwitchParameter named
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.
optional Workload VsanStorageWorkloadType named
Specifies the type of workload which should be run to test the storage performance.




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.

Related Commands


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


This cmdlet adds one or multiple disks to the unique storage pool under a certain host. This cmdlet returns VsanStoragePoolDisk information of a disk that is claimed by a storage pool. Storage pool refers to vSAN ESA disks.

This cmdlet fetches VsanStoragePoolDisk information from a certain host or cluster. It also enables you to fetch storage pool disks by disk canonical name. If both host and disk canonical name are specified, the system uses both parameters.

This cmdlet removes a single or multiple storage pool disks on a vSAN cluster.