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 versionDetailed Description
This cmdlet modifies the configuration of the specified organization virtual datacenter (vDC).Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
OrgVdc | OrgVdc[] | Specifies the organization vDC that you want to configure. | true | true (ByValue) | |
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 | |
CpuAllocationGHz | Double | Specifies 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. | false | false | |
CpuGuaranteedPercent | Int32 | Specifies 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. | false | false | |
Description | String | Specifies a new description for the specified organization vDC. | false | false | |
Enabled | Boolean | Specifies whether the organization vDC is enabled. | false | false | |
InformationAction | ActionPreference | false | false | ||
InformationVariable | String | false | false | ||
MemoryAllocationGB | Decimal | Specifies 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. | false | false | |
MemoryGuaranteedPercent | Int32 | Specifies 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. | false | false | |
Name | String | Specifies a new name for the organization vDC. | false | false | |
NetworkMaxCount | Int32 | Specifies the maximum number of provisioned networks for the organization vDC. To specify that there is no limit, pass $null. | false | false | |
NetworkPool | NetworkPool | Specifies 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. | false | false | |
NicMaxCount | Int32 | Specifies the maximum number of NICs in the organization vDC. To specify that there is no limit, pass $null. | false | false | |
PipelineVariable | String | false | false | ||
Server | CIServer[] | 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. | false | false | |
StorageAllocationGB | Decimal | Specifies 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. | false | false | |
ThinProvisioned | Boolean | Indicates whether you want to enable thin provisioning. | false | false | |
UseFastProvisioning | Boolean | Indicates whether you want to enable fast provisioning. | false | false | |
VMCpuCoreMHz | Int64 | Specifies 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. | false | false | |
VMMaxCount | Int32 | Specifies 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. | 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
Zero or more modified OrgVdc objectsNotes
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.