## PowerCLI Reference

# Set-DatastoreCluster

## Synopsis

This cmdlet 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

This cmdlet modifies the configuration of the specified datastore cluster.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Confirm | SwitchParameter | If 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. | false | false
DatastoreCluster | DatastoreCluster[] | Specifies the datastore cluster that you want to configure. | true | true (ByValue)
IOLatencyThresholdMillisecond | Int32 | Specifies 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. | false | false
IOLoadBalanceEnabled | Boolean | Specifies 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. | false | false
Name | String | Specifies a new name for the datastore cluster. | false | false
SdrsAutomationLevel | DrsAutomationLevel | Specifies the Storage DRS automation level for the datastore cluster. This parameter accepts Disabled, Manual, and FullyAutomated values. | 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
SpaceUtilizationThresholdPercent | Int32 | Specifies 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. | false | false
WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | false

Return Type

One or more modified DatastoreCluster objects

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 © VMware, Inc. All rights reserved.