PowerCLI Reference

Set-OrgVdc

Synopsis

This cmdlet modifies the configuration of the specified organization virtual datacenter (vDC).

Syntax

Set-OrgVdc [-OrgVdc] <OrgVdc[]> [-CpuAllocationGHz <Double>] [-CpuGuaranteedPercent <Int32>] [-Description <String>] [-Enabled <Boolean>] [-MemoryAllocationGB <Decimal>] [-MemoryGuaranteedPercent <Int32>] [-Name <String>] [-NetworkMaxCount <Int32>] [-NetworkPool <NetworkPool>] [-NicMaxCount <Int32>] [-Server <CIServer[]>] [-StorageAllocationGB <Decimal>] [-ThinProvisioned <Boolean>] [-UseFastProvisioning <Boolean>] [-VMCpuCoreMHz <Int64>] [-VMMaxCount <Int32>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-OrgVdc
New-OrgVdc
Remove-OrgVdc

Detailed Description

This cmdlet modifies the configuration of the specified organization virtual datacenter (vDC).

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
OrgVdcOrgVdc[]Specifies the organization vDC that you want to configure.truetrue (ByValue)
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
CpuAllocationGHzDoubleSpecifies the CPU resources in gigahertz (GHz) that you want to allocate to the organization vDC.
This parameter is only applicable to the Allocation Pool and Resource Pool resource allocation models.
falsefalse
CpuGuaranteedPercentInt32Specifies the percentage of CPU resources that are reserved for the organization vDC. This parameter accepts values in the range of 0 to 100.
This parameter is only applicable to the Pay As You Go and Allocation Pool resource allocation models.
falsefalse
DescriptionStringSpecifies a new description for the specified organization vDC.falsefalse
EnabledBooleanSpecifies whether the organization vDC is enabled.falsefalse
InformationActionActionPreferencefalsefalse
InformationVariableStringfalsefalse
MemoryAllocationGBDecimalSpecifies the memory resources in gigabytes (GB) that you want to allocate to the organization vDC.
This parameter is only applicable to the Allocation Pool and Resource Pool resource allocation models.
falsefalse
MemoryGuaranteedPercentInt32Specifies the percentage of memory resources that are reserved for the organization vDC. This parameter accepts values in the range of 0 to 100.
This parameter is only applicable to the Pay As You Go and Allocation Pool resource allocation models.
falsefalse
NameStringSpecifies a new name for the organization vDC.falsefalse
NetworkMaxCountInt32Specifies the maximum number of provisioned networks for the organization vDC. To specify that there is no limit, pass $null.falsefalse
NetworkPoolNetworkPoolSpecifies a provision network pool for your organization vDC. The organization vDC will use this network pool to create vApp networks. To specify that there is no network pool, pass $null.falsefalse
NicMaxCountInt32Specifies the maximum number of NICs in the organization vDC. To specify that there is no limit, pass $null.falsefalse
PipelineVariableStringfalsefalse
ServerCIServer[]Specifies the cloud servers 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-CIServer.falsefalse
StorageAllocationGBDecimalSpecifies the storage resources in gigabytes (GB) that you want to allocate to the organization vDC. To specify that there is no limit, pass $null.

Note: This parameter is supported only on vCloud Director 1.5.x environments.
falsefalse
ThinProvisionedBooleanIndicates whether you want to enable thin provisioning.falsefalse
UseFastProvisioningBooleanIndicates whether you want to enable fast provisioning.falsefalse
VMCpuCoreMHzInt64Specifies a vCPU speed in megahertz (MHz). This value defines what a virtual machine with one vCPU will consume at maximum when running within this organization vDC. A virtual machine with two vCPUs would consume a maximum of twice this value.
This parameter is only applicable to the Pay As You Go resource allocation model.
falsefalse
VMMaxCountInt32Specifies the maximum number of virtual machines in the organization vDC. To specify that there is no limit, pass $null.
This parameter is only applicable to the Pay As You Go resource allocation model.
falsefalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

Zero or more modified OrgVdc objects

Notes

Examples

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

Get-OrgVdc -Name 'MyPayAsYouGoOrgVdc' | Set-OrgVdc -Name "NewOrgVdcName" -Description "The settings for this organization vDC have been modified." -VMMaxCount 2 -VMCpuCoreMhz 512 -Enabled $false

Modifies the name and description of the organization vDC, and changes the maximum number of virtual machines and the vCPU speed in the organization vDC. Disables the organization vDC.

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

$myNetworkPool = Get-NetworkPool -Name 'MyNetworkPool'
Get-OrgVdc -Name 'MyReservationPoolOrgVdc' | Set-OrgVdc -NetworkPool $myNetworkPool -NetworkMaxCount 3 -NicMaxCount $null

Changes the network pool, the maximum number of networks and the maximum amount of NICs in the organization vDC.

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

Get-OrgVdc -Name 'MyAllocationPoolOrgVdc' | Set-OrgVdc -MemoryAllocationGB 0.1 -MemoryGuaranteedPercent 75 -StorageAllocationGB 0.1 -CpuAllocationGHz 0.3 -CpuGuaranteedPercent 50 -ThinProvisioned $true -UseFastProvisioning $true

Modifies the memory, storage, and CPU allocation settings for the organization vDC, and enables thin and fast provisioning.


Copyright © VMware, Inc. All rights reserved.