New-VmcSddc

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

Syntax

-AwsAccount  <AwsAccount>
-AwsVpcSubnet  <AwsVpcSubnet[]>
-HostCount  <Int32>
-Name  <String>
-Region  <String>
[-HostType  <VmcHostTypeEnum>]
[-ManagementSubnetCidr  <String>]
[-Provider  <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize  <VmcSddcSizeEnum>]
[-SddcType  <SddcType>]
[-Server  <CisServer[]>]
[-StretchedCluster]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
AwsAccount
AwsAccount named Specifies the VMware Cloud on AWS account that you want to link to the SDDC.
required
AwsVpcSubnet
AwsVpcSubnet[] named 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. If the SDDC is stretched cluster, you should choose more than one private subnet range.
required
HostCount
Int32 named Specifies the number of the hosts that you want to create.
required
Name
String named Specifies the name of the created SDDC.
required
Region
String named 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.
optional
HostType
VmcHostTypeEnum named Specifies the type of the hosts. The availale host types are: "I3EN" and "I3". If the host type is not specified, the default type "I3" is set.
optional
ManagementSubnetCidr
String named Specifies the IP subnet in a classless inter-domain routing (CIDR) format for the compute gateway.
optional
Provider
VmcProvider named Specifies the cloud provider (e.g. VMware Cloud on AWS) that you use to provide the physical resources for the newly created SDDC.
optional
RunAsync
SwitchParameter named 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.
optional
SddcAppliancesSize
VmcSddcSizeEnum named Specifies the SDDC appliances size.
optional
SddcType
SddcType named Specifies if the SDDC is single or multi-host.
optional
Server
CisServer[] named 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.
optional
StretchedCluster
SwitchParameter named Specifies if you want to stretch out the SDDC to two availability zones in order to be highly available.

-HostCount  <Int32>
-Name  <String>
-Region  <String>
-SkipAccountLinking
[-HostType  <VmcHostTypeEnum>]
[-ManagementSubnetCidr  <String>]
[-Provider  <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize  <VmcSddcSizeEnum>]
[-SddcType  <SddcType>]
[-Server  <CisServer[]>]
[-StretchedCluster]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
HostCount
Int32 named Specifies the number of the hosts that you want to create.
required
Name
String named Specifies the name of the created SDDC.
required
Region
String named 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.
required
SkipAccountLinking
SwitchParameter named Specifies that the account linking is delayed.
optional
HostType
VmcHostTypeEnum named Specifies the type of the hosts. The availale host types are: "I3EN" and "I3". If the host type is not specified, the default type "I3" is set.
optional
ManagementSubnetCidr
String named Specifies the IP subnet in a classless inter-domain routing (CIDR) format for the compute gateway.
optional
Provider
VmcProvider named Specifies the cloud provider (e.g. VMware Cloud on AWS) that you use to provide the physical resources for the newly created SDDC.
optional
RunAsync
SwitchParameter named 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.
optional
SddcAppliancesSize
VmcSddcSizeEnum named Specifies the SDDC appliances size.
optional
SddcType
SddcType named Specifies if the SDDC is single or multi-host.
optional
Server
CisServer[] named 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.
optional
StretchedCluster
SwitchParameter named Specifies if you want to stretch out the SDDC to two availability zones in order to be highly available.

Output

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

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 multi-host. The operation is performed asynchronously.

Example 3

New-VmcSddc -Name "SddcName" -Provider Aws -HostCount 3 -Region "US_EAST_1" -SddcType MultiHost -HostType "I3EN" -AwsAccount $awsAccount -AwsVpcSubnet $awsVpcSubnet

Creates the SDDC which is linked to the $awsAccount account and to the $awsVpcSubnet VMware Cloud on AWS subnet with hosts of type "I3EN".

Example 4

New-VmcSddc -Name "SddcName" -Provider Aws -HostCount 3 -Region "US_EAST_1" -SddcType MultiHost -AwsAccount $awsAccount -AwsVpcSubnet $awsVpcSubnet -SddcAppliancesSize Large -StretchedCluster

Creates the large SDDC which is linked to the $awsAccount account and the $awsVpcSubnet VMware Cloud on AWS subnet which is stretched.

Related Commands

Feedback

Was this page helpful?