## PowerCLI Reference

# New-OrgVdc

## Synopsis

This cmdlet creates an organization virtual datacenter (vDC).

Syntax

New-OrgVdc [-Name] <String> -AllocationModelAllocationPool -CpuAllocationGHz <Double> [-Description <String>] -MemoryAllocationGB <Decimal> [-NetworkPool <NetworkPool>] -Org <Org> -ProviderVdc <ProviderVdc> [-Server <CIServer[]>] -StorageAllocationGB <Decimal> [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OrgVdc [-Name] <String> -AllocationModelPayAsYouGo [-Description <String>] [-NetworkPool <NetworkPool>] -Org <Org> -ProviderVdc <ProviderVdc> [-Server <CIServer[]>] [-StorageAllocationGB <Decimal>] -VMCpuCoreMHz <Int64> [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-OrgVdc [-Name] <String> -AllocationModelReservationPool -CpuAllocationGHz <Double> [-Description <String>] -MemoryAllocationGB <Decimal> [-NetworkPool <NetworkPool>] -Org <Org> -ProviderVdc <ProviderVdc> [-Server <CIServer[]>] -StorageAllocationGB <Decimal> [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Remove-OrgVdc
Get-OrgVdc
Set-OrgVdc

Detailed Description

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 disabled.
* Fast provisioning is disabled.
* 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.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Name | String | Specifies a name for the organization vDC that you want to create. | true | false
AllocationModelAllocationPool | SwitchParameter | 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. | true | false
AllocationModelPayAsYouGo | SwitchParameter | 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. | true | false
AllocationModelReservationPool | SwitchParameter | 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. | true | false
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. | true | false
Description | String | Specifies a description for the organization vDC that you want to create. | 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. | true | false
NetworkPool | NetworkPool | Specifies a network pool that your organization vDC will have access to. | false | false
Org | Org | Specifies the organization for which you want to create an organization vDC. | true | true (ByValue)
PipelineVariable | String |  | false | false
ProviderVdc | ProviderVdc | Specifies the provider vDC that would provide the resources for your organization vDC. | true | true (ByValue)
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. 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. | true | 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. | true | 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

The newly created OrgVdc object

Notes

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.

Copyright © VMware, Inc. All rights reserved.