New-OrgVdc Command | Vmware PowerCLI Reference

New-OrgVdc

This cmdlet creates an organization virtual datacenter (vDC). You can configure resource allocation for the organization vDC by specifying an allocation model and by configuring CPU, memory and storage allocation. The organization vDC is created using a default configuration. * VMMaxCount is set to 100. * NetworkMaxCount is set to 1024. * The vDC is automatically enabled. * Thin provisioning is deactivated. * Fast provisioning is deactivated. * NicMaxCount is set to $null (unlimited). When you set the AllocationModelAllocationPool parameter, by default MemoryGuaranteedPercent is set to 100 and CpuGuaranteedPercent is set to 0. When you set the AllocationModelPayAsYouGo parameter, by default MemoryGuaranteedPercent is set to 100 and CpuGuaranteeedPercent is set to 0.

Syntax

New-OrgVdc
-AllocationModelAllocationPool
-CpuAllocationGHz < Double >
-MemoryAllocationGB < Decimal >
-Name < String >
-Org < Org >
-ProviderVdc < ProviderVdc >
-StorageAllocationGB < Decimal >
[-Description < String > ]
[-NetworkPool < NetworkPool > ]
[-ProgressAction < ActionPreference > ]
[-Server < CIServer[] > ]
[-StorageProfile < ProviderVdcStorageProfile > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
AllocationModelAllocationPool SwitchParameter named
Specifies that you want to use the Allocation Pool resource allocation model. The allocation model determines how and when the provider vDC compute and memory resources that you allocate are committed to the organization vDC.
required
CpuAllocationGHz Double named
Specifies the CPU resources in gigahertz (GHz) that you want to allocate to the organization vDC.
required
MemoryAllocationGB Decimal named
Specifies the memory resources in gigabytes (GB) that you want to allocate to the organization vDC.
required
Name String named
Specifies a name for the organization vDC that you want to create.
required
Org Org named
  • pipeline
Specifies the organization for which you want to create an organization vDC.
required
ProviderVdc ProviderVdc named
  • pipeline
Specifies the provider vDC that would provide the resources for your organization vDC.
required
StorageAllocationGB Decimal named
Specifies the storage resources in gigabytes (GB) that you want to allocate to the organization vDC. Note: To ensure backward compatibility, PowerCLI provides limited support for this parameter against vCloud Director 5.1 environments. When you develop new scripts for vCloud Director 5.1 environments, do not use this parameter.
optional Description String named
Specifies a description for the organization vDC that you want to create.
optional NetworkPool NetworkPool named
Specifies a network pool that your organization vDC will have access to.
optional ProgressAction ActionPreference named
optional Server CIServer[] named
Specifies the cloud 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 Connect-CIServer.
optional StorageProfile ProviderVdcStorageProfile named
Specifies a storage profile to support. The profile is selected amongst the ones that the provider Vdc supports.
New-OrgVdc
-AllocationModelPayAsYouGo
-Name < String >
-Org < Org >
-ProviderVdc < ProviderVdc >
-VMCpuCoreMHz < Int64 >
[-Description < String > ]
[-NetworkPool < NetworkPool > ]
[-ProgressAction < ActionPreference > ]
[-Server < CIServer[] > ]
[-StorageAllocationGB < Decimal > ]
[-StorageProfile < ProviderVdcStorageProfile > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
AllocationModelPayAsYouGo SwitchParameter named
Specifies that you want to use the Pay As You Go resource allocation model. The allocation model determines how and when the provider vDC compute and memory resources that you allocate are committed to the organization vDC.
required
Name String named
Specifies a name for the organization vDC that you want to create.
required
Org Org named
  • pipeline
Specifies the organization for which you want to create an organization vDC.
required
ProviderVdc ProviderVdc named
  • pipeline
Specifies the provider vDC that would provide the resources for your organization vDC.
required
VMCpuCoreMHz Int64 named
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.
optional Description String named
Specifies a description for the organization vDC that you want to create.
optional NetworkPool NetworkPool named
Specifies a network pool that your organization vDC will have access to.
optional ProgressAction ActionPreference named
optional Server CIServer[] named
Specifies the cloud 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 Connect-CIServer.
optional StorageAllocationGB Decimal named
Specifies the storage resources in gigabytes (GB) that you want to allocate to the organization vDC. Note: To ensure backward compatibility, PowerCLI provides limited support for this parameter against vCloud Director 5.1 environments. When you develop new scripts for vCloud Director 5.1 environments, do not use this parameter.
optional StorageProfile ProviderVdcStorageProfile named
Specifies a storage profile to support. The profile is selected amongst the ones that the provider Vdc supports.
New-OrgVdc
-AllocationModelReservationPool
-CpuAllocationGHz < Double >
-MemoryAllocationGB < Decimal >
-Name < String >
-Org < Org >
-ProviderVdc < ProviderVdc >
-StorageAllocationGB < Decimal >
[-Description < String > ]
[-NetworkPool < NetworkPool > ]
[-ProgressAction < ActionPreference > ]
[-Server < CIServer[] > ]
[-StorageProfile < ProviderVdcStorageProfile > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
AllocationModelReservationPool SwitchParameter named
Specifies that you want to use the Reservation Pool resource allocation model. The allocation model determines how and when the provider vDC compute and memory resources that you allocate are committed to the organization vDC.
required
CpuAllocationGHz Double named
Specifies the CPU resources in gigahertz (GHz) that you want to allocate to the organization vDC.
required
MemoryAllocationGB Decimal named
Specifies the memory resources in gigabytes (GB) that you want to allocate to the organization vDC.
required
Name String named
Specifies a name for the organization vDC that you want to create.
required
Org Org named
  • pipeline
Specifies the organization for which you want to create an organization vDC.
required
ProviderVdc ProviderVdc named
  • pipeline
Specifies the provider vDC that would provide the resources for your organization vDC.
required
StorageAllocationGB Decimal named
Specifies the storage resources in gigabytes (GB) that you want to allocate to the organization vDC. Note: To ensure backward compatibility, PowerCLI provides limited support for this parameter against vCloud Director 5.1 environments. When you develop new scripts for vCloud Director 5.1 environments, do not use this parameter.
optional Description String named
Specifies a description for the organization vDC that you want to create.
optional NetworkPool NetworkPool named
Specifies a network pool that your organization vDC will have access to.
optional ProgressAction ActionPreference named
optional Server CIServer[] named
Specifies the cloud 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 Connect-CIServer.
optional StorageProfile ProviderVdcStorageProfile named
Specifies a storage profile to support. The profile is selected amongst the ones that the provider Vdc supports.

Output

VMware.VimAutomation.Cloud.Types.V1.OrgVdc

Examples

Example 1

New-OrgVdc `
-AllocationModelAllocationPool `
-CpuAllocationGHz 2 `
-Description "Org VDC for org1" `
-MemoryAllocationGB 20 `
-Name "myOrgVdc1" `
-Org "organization1" `
-ProviderVdc "myProviderVdc" `
-StorageAllocationGB "100" `
-NetworkPool 'largeNetworkPool

Creates a new organization vDC using the Allocation Pool resource allocation model.

Example 2

New-OrgVdc `
-AllocationModelPayAsYouGo `
-Description "Org VDC for org1" `
-VMCpuCoreMHz 2 `
-Name "myPayAsYouGoOrgVdc" `
-Org "organization1" `
-ProviderVdc "myProviderVdc1" `
-StorageAllocationGB 100 `
-NetworkPool 'largeNetworkPool'

Creates a new organization vDC using the Pay As You Go resource allocation model.

Example 3

New-OrgVdc `
-AllocationModelReservationPool `
-CpuAllocationGHz 2 `
-Description "Org VDC for org1" `
-MemoryAllocationGB 20
-Name "myReservationPoolOrgVdc" `
-Org "organization1" `
-ProviderVdc "myProviderVdc1" `
-StorageAllocationGB 100 `
-NetworkPool 'largeNetworkPool'

Creates a new organization vDC using the Reservation Pool resource allocation model.

Example 4

$pvdc = (Get-ProviderVdc)[0]

New-OrgVdc `
-AllocationModelReservationPool `
-CpuAllocationGHz 2 `
-Description "Org VDC for org1" `
-MemoryAllocationGB 20 `
-Name "myReservationPoolOrgVdc" `
-Org "organization1" `
-StorageAllocationGB 100 `
-NetworkPool 'largeNetworkPool'
-ProviderVdc $pvdc `
-StorageProfile $pvdc.StorageProfiles[1]

Creates a new organization vDC using the second storage profile supported by the provider vDC.

Related Commands

Org

This cmdlet retrieves cloud organizations.

This cmdlet creates a new organization.

This cmdlet removes the specified organization.

This cmdlet modifies the configuration of the specified organization.

OrgVdc

This cmdlet retrieves organization vDCs.

This cmdlet creates an organization virtual datacenter (vDC).

This cmdlet removes organization virtual datacenters (vDCs).

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

OrgVdcNetwork

This cmdlet retrieves organization vDC networks.

This cmdlet creates a new organization VDC network on a vCloud Director server.

This cmdlet deletes the specified organization VDC network.

This cmdlet modifies the configuration of the specified organization network.