< Back

Test-VsanStoragePerformance

Sun Jan 19, 2020 7:22 pm

NAME 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] [-Server <VIServer[]>] [-StoragePolicy

<SpbmStoragePolicy>] [-TestDurationSeconds <Int32>] [-UseCache] [-Workload <VsanStorageWorkloadType>]

[<CommonParameters>]





DESCRIPTION

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.





PARAMETERS

-Cluster <Cluster[]>

Specifies the clusters on which you want to run a vSAN storage performance test.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? true



-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.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-StoragePolicy <SpbmStoragePolicy>

Specifies the storage policy you want to use.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-TestDurationSeconds <Int32>

Specifies the duration of the storage performance test in seconds. When the UseCache parameter is not

specified, TestDurationSeconds must be specified.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Workload <VsanStorageWorkloadType>

Specifies the type of workload which should be run to test the storage performance.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

VsanClusterStoragePerformanceTestResult objects representing the result of the test run







NOTES









-------------------------- 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 LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... mance.html