PowerCLI Reference

New-VmcSddc

Synopsis

This cmdlet creates a new VMware Cloud on AWS software-defined data center (SDDC).

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>]

New-VmcSddc [-Confirm] -HostCount <Int32> -Name <String> [-Provider {Aws | Zerocloud}] -Region <String> [-RunAsync] [-Server <CisServer[]>] [-WhatIf] [-ManagementSubnetCidr <String>] [-SddcType <SddcType>] -SkipAccountLinking [<CommonParameters>]

Related Commands

Remove-VmcSddc
Set-VmcSddc

Detailed Description

This cmdlet creates a new VMware Cloud on AWS software-defined data center (SDDC).

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
AwsAccountAwsAccountSpecifies the VMware Cloud on AWS account that you want to link to the SDDC.trueFalse
AwsVpcSubnetAwsVpcSubnetSpecifies 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.trueFalse
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
HostCountInt32Specifies the number of the hosts that you want to create.trueFalse
ManagementSubnetCidrStringSpecifies the IP subnet in a CIDR format for the compute gateway.falseFalse
NameStringSpecifies the name of the created SDDC.trueFalse
ProviderVmcProviderSpecifies the cloud provider (e.g. VMware Cloud on AWS) that you use to provide the physical resources for the newly created SDDC.falseFalse
RegionStringSpecifies 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.
trueFalse
RunAsyncSwitchParameterIndicates 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.falseFalse
SddcTypeSddcTypeSpecifies if the SDDC is single or multi host.falseFalse
ServerCisServer[]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.falseFalse
SkipAccountLinkingSwitchParameterSpecifies that the account linking is delayed.trueFalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

VMware.VimAutomation.Vmc.Types.V1.CmdletObject.VmcSddc

Notes

Examples

-------------------------- 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.


Copyright © VMware, Inc. All rights reserved.