Syntax
New-VmcSddc [-Confirm] -HostCount <Int32> -Name <String> [-Provider {Aws | Zerocloud}] -Region <String> [-RunAsync] [-Server <CisServer[]>] [-WhatIf] [-ManagementSubnetCidr <String>] [-SddcType <SddcType>] -AwsAccount <AwsAccount> -AwsVpcSubnet <AwsVpcSubnet> [<CommonParameters>]Related Commands
Detailed Description
This cmdlet creates a new VMware Cloud on AWS software-defined data center (SDDC).Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
AwsAccount | AwsAccount | Specifies the VMware Cloud on AWS account that you want to link to the SDDC. | true | False | |
AwsVpcSubnet | AwsVpcSubnet | Specifies a private subnet range (RFC 1918) that you want to use for vCenter Server, NSX Manager, and the ESXi hosts. Choose a range that does not conflict with other networks that you want to connect to this SDDC. | 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 | |
HostCount | Int32 | Specifies the number of the hosts that you want to create. | true | False | |
ManagementSubnetCidr | String | Specifies the IP subnet in a CIDR format for the compute gateway. | false | False | |
Name | String | Specifies the name of the created SDDC. | true | False | |
Provider | VmcProvider | Specifies the cloud provider (e.g. VMware Cloud on AWS) that you use to provide the physical resources for the newly created SDDC. | false | False | |
Region | String | Specifies the geographical region where you want to create the SDDC. You can find a list of the VMware Cloud on AWS regions in the table below.
| Region Name | Region | |--------------------------|---------------| |US East (Ohio) |US_EAST_2 | |US East (N. Virginia) |US_EAST_1 | |US West (N. California) |US_WEST_1 | |US West (Oregon) |US_WEST_2 | |Asia Pacific (Hong Kong) |AP_EAST_1 | |Asia Pacific (Mumbai) |AP_SOUTH_1 | |Asia Pacific (Osaka-Local)|AP_NORTHEAST_3 | |Asia Pacific (Seoul) |AP_NORTHEAST_2 | |Asia Pacific (Singapore) |AP_SOUTHEAST_1 | |Asia Pacific (Sydney) |AP_SOUTHEAST_2 | |Asia Pacific (Tokyo) |AP_NORTHEAST_1 | |Canada (Central) |CA_CENTRAL_1 | |China (Beijing) |CN_NORTH_1 | |China (Ningxia) |CN_NORTHWEST_1 | |EU (Frankfurt) |EU_CENTRAL_1 | |EU (Ireland) |EU_WEST_1 | |EU (London) |EU_WEST_2 | |EU (Paris) |EU_WEST_3 | |EU (Stockholm) |EU_NORTH_1 | |Middle East (Bahrain) |ME_SOUTH_1 | |South America (Sao Paulo) |SA_EAST_1 | |AWS GovCloud (US-East) |US_GOV_EAST_1 | |AWS GovCloud (US-West) |US_GOV_WEST_1 | Please note that VMC may not be supported in all regions. | true | False | |
RunAsync | SwitchParameter | Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | false | False | |
SddcType | SddcType | Specifies if the SDDC is single or multi host. | false | False | |
Server | CisServer[] | Specifies the VMware Cloud on AWS 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 the Connect-Vmc cmdlet. | false | False | |
SkipAccountLinking | SwitchParameter | Specifies that the account linking is delayed. | 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
VMware.VimAutomation.Vmc.Types.V1.CmdletObject.VmcSddcNotes
## RELATED LINKSExamples
-------------------------- Example 1 --------------------------
New-VmcSddc -Name "SddcName" -Provider Aws -HostCount 1 -Region "US_EAST_1" -SddcType SingleHost -SkipAccountLinking
Creates a new SDDC with the name "SddcName" with one host. The SDDC provider is Aws, the region is US_EAST_1. The SDDC is not linked to an account. Sddc type is a single host.
-------------------------- Example 2 --------------------------
New-VmcSddc -Name "SddcName" -Provider Aws -HostCount 3 -Region "US_EAST_1" -ManagementSubnetCidr $vpcir -SddcType MultiHost -SkipAccountLinking -RunAsync
Creates a new SDDC with the name "SddcName" with three hosts. The SDDC provider is Aws, the region is US_EAST_1, the IP subnet is set to $vpcir. The SDDC is not linked to an account. Sddc type is a multi host. The operation is performed asynchronously.
-------------------------- Example 3 --------------------------
New-VmcSddc -Name "SddcName" -Provider Aws -HostCount 3 -Region "US_EAST_1" -SddcType MultiHost -AwsAccount $awsAccount -AwsVpcSubnet $awsVpcSubnet
The SDDC is linked to the $awsAccount account and to the VMware Cloud on AWS subnet $awsVpcSubnet.