vSphere PowerCLI Reference

Set-DatastoreCluster

Synopsis

Modifies the configuration of the specified datastore cluster.

Syntax

Set-DatastoreCluster -DatastoreCluster <DatastoreCluster[]> [-IOLatencyThresholdMillisecond <Int32>] [-IOLoadBalanceEnabled [<Boolean>]] [-Name <String>] [-SdrsAutomationLevel <DrsAutomationLevel>] [-SpaceUtilizationThresholdPercent <Int32>] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-DatastoreCluster
New-DatastoreCluster
Remove-DatastoreCluster

Detailed Description

Modifies the configuration of the specified datastore cluster.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
DatastoreClusterDatastoreCluster[]Specify the datastore cluster that you want to configure.truetrue (ByValue)
IOLatencyThresholdMillisecondInt32Specify the maximum I/O latency in milliseconds allowed before Storage DRS is triggered for the datastore cluster. The parameter accepts values in the range of 5 to 100. If the value of IOLoadBalancing is $false, the setting for the I/O latency threshold is not applied.falsefalse
IOLoadBalanceEnabledBooleanSpecify whether I/O load balancing is enabled for the datastore cluster. If the value is $false, I/O load balancing is disabled and the settings for the I/O latency threshold and utilized space threshold are not applied.falsefalse
NameStringSpecify a new name for the datastore cluster.falsefalse
SdrsAutomationLevelDrsAutomationLevelSpecify the Storage DRS automation level for the datastore cluster. The parameter accepts Disabled, Manual, and FullyAutomated values.falsefalse
ServerVIServer[]Specify 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.falsefalse
SpaceUtilizationThresholdPercentInt32Specify the maximum percentage of consumed space allowed before Storage DRS is triggered for the datastore cluster. The parameter accepts values in the range of 50 to 100. If the value of IOLoadBalancing is $false, the setting for the utilized space threshold is not applied.falsefalse
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

DatastoreCluster[]

Notes

Examples

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

Set-DatastoreCluster -DatastoreCluster MyDatastoreCluster1 -Name 'MyDatastoreCluster2'

Changes the name of the specified datastore cluster.

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

Set-DatastoreCluster -DatastoreCluster MyDatastoreCluster -IOLatencyThresholdMillisecond 5

Sets the maximum I/O latency in milliseconds allowed before Storage DRS is triggered for the specified datastore cluster to 5 milliseconds.

-------------- Example 3 --------------

Set-DatastoreCluster -DatastoreCluster MyDatastoreCluster - SdrsAutomationLevel FullyAutomated

Changes the Storage DRS automation level of the specified datastore cluster to Fully Automated.


Copyright © 1998 - 2012 VMware, Inc. All rights reserved.