Set-VmcClusterEdrsPolicy Command | Vmware PowerCLI Reference

Set-VmcClusterEdrsPolicy

This cmdlet modifies the Elastic Distributed Resource Scheduler (EDRS) policy of а cluster in a software-defined data center (SDDC).

Syntax

Set-VmcClusterEdrsPolicy
-Cluster < VmcSddcCluster[] >
-MaxHostCount < Int32 >
-MinHostCount < Int32 >
-PolicyType < String >
[-ProgressAction < ActionPreference > ]
[-ScaleUpHostIncrement < Int32 > ]
[-Server < VmcServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Cluster VmcSddcCluster[] named
  • pipeline
Specifies the cluster whose policy you want to modify.
required
MaxHostCount Int32 named
Specifies the maximum number of hosts which you can assign to the cluster.
required
MinHostCount Int32 named
Specifies the minimum number of hosts which you can assign to the cluster.
required
PolicyType String named
The possible EDRS policies are as follows: - "cost": Based on the cluster utilization, you can remove the hosts more quickly (and add them more slowly) to keep the cost as low as possible. - "performance": Based on the cluster utilization, you can add the hosts more quickly (and removed them more slowly) to ensure the best possible performance. - "rapid-scaleup": Based on the cluster CPU and memory utilization, you can add multiple hosts at the same time. You must remove the hosts manually when you no longer need them. Based on the cluster storage utilization, you can add one host at a time when the storage utilization becomes critical. - "storage-scaleup": You can add the host when the cluster storage utilization becomes critical. The default EDRS policy type is "storage-scaleup".
optional ProgressAction ActionPreference named
optional ScaleUpHostIncrement Int32 named
Specifies the number of hosts that will be added to the cluster in parallel when a scale-up operation is triggered. The supported values are 4, 8 and 12. This is only supported when used along with the "rapid-scaleup" EDRS policy. The number of hosts you can add depends on the minimum and maximum cluster size you have configured. You can use the scale-up feature for additional flexibility and for rapid burst-case scenarios. By default, hosts are added two at a time. Beginning with SDDC version 1.14, you can specify a larger increment of hosts for faster disaster recovery scaling and other use cases. Scale-up time increases with the number of hosts added and can take up to 40 minutes for an increment of 12 hosts.
optional Server VmcServer[] named
  • wildcards
Specifies the VMware Cloud on AWS servers 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 the Connect-Vmc cmdlet.
Set-VmcClusterEdrsPolicy
-Cluster < VmcSddcCluster[] >
-Disable
[-ProgressAction < ActionPreference > ]
[-Server < VmcServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Cluster VmcSddcCluster[] named
  • pipeline
Specifies the cluster whose policy you want to modify.
required
Disable SwitchParameter named
Specifies if the EDRS policy is deactivated. By default, the policy is activated. When you deactivate the policy, it will be set to the default "storage-scaleup" policy. You cannot deactivate the default policy.
optional ProgressAction ActionPreference named
optional Server VmcServer[] named
  • wildcards
Specifies the VMware Cloud on AWS servers 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 the Connect-Vmc cmdlet.

Output

VMware.VimAutomation.Vmc.Types.V1.CmdletObject.IVmcEdrsPolicy

Examples

Example 1

Set-VmcClusterEdrsPolicy -Cluster $cluster -PolicyType "cost" -MinHostCount 6 -MaxHostCount 15

Modifies the EDRS policy type of the selected $cluster cluster. The policy type is set to "cost" with the minimum number of hosts 6 and the maximum number of hosts 15.

Example 2

Set-VmcClusterEdrsPolicy -Cluster $cluster -Disable

Deactivates the EDRS policy type of the specified cluster. The policy type is reset to the default "storage-scaleup" policy type.

Example 3

Set-VmcClusterEdrsPolicy -Cluster $cluster -PolicyType "rapid-scaleup" -MinHostCount 6 -MaxHostCount 15 -ScaleUpHostIncrement 4

Modifies the EDRS policy type of the specified cluster. The policy type is set to "rapid-scaleup" with the minimum number of hosts set to six and the maximum number of hosts set to 15 and a scale-up host increment of four.

Related Commands

VmcClusterEdrsPolicy

This cmdlet retrieves EDRS policies of clusters.

This cmdlet modifies the Elastic Distributed Resource Scheduler (EDRS) policy of а cluster in a software-defined data center (SDDC).