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>]
[-Outpost <VmcOutpost>]
[-Provider <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize <VmcSddcSizeEnum>]
[-SddcType <SddcType>]
[-Server <VmcServer[]>]
[-StretchedCluster]
[CommonParameters]
-AwsVpcSubnet <AwsVpcSubnet[]>
-HostCount <Int32>
-Name <String>
-Region <String>
[-HostType <VmcHostTypeEnum>]
[-ManagementSubnetCidr <String>]
[-Outpost <VmcOutpost>]
[-Provider <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize <VmcSddcSizeEnum>]
[-SddcType <SddcType>]
[-Server <VmcServer[]>]
[-StretchedCluster]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
AwsAccount | named |
|
Specifies the VMware Cloud on AWS account that you want to link to the SDDC. | required |
|
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 |
|
Int32 | named |
|
Specifies the number of the hosts that you want to create. | required |
|
String | named |
|
Specifies the name of the created SDDC. | required |
|
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. | 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 VMware Cloud on AWS may not be supported in all regions. | optional |
|
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 |
|
String | named |
|
Specifies the IP subnet in a classless inter-domain routing (CIDR) format for the compute gateway. | optional |
|
VmcOutpost | named |
|
Specifies the AWS Outpost on which you want to host this SDDC. | optional |
|
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 |
|
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 |
|
VmcSddcSizeEnum | named |
|
Specifies the SDDC appliances size. | optional |
|
SddcType | named |
|
Specifies if the SDDC is single or multi-host. | optional |
|
VmcServer[] | 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 |
|
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>]
[-Outpost <VmcOutpost>]
[-Provider <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize <VmcSddcSizeEnum>]
[-SddcType <SddcType>]
[-Server <VmcServer[]>]
[-StretchedCluster]
[CommonParameters]
-Name <String>
-Region <String>
-SkipAccountLinking
[-HostType <VmcHostTypeEnum>]
[-ManagementSubnetCidr <String>]
[-Outpost <VmcOutpost>]
[-Provider <VmcProvider>]
[-RunAsync]
[-SddcAppliancesSize <VmcSddcSizeEnum>]
[-SddcType <SddcType>]
[-Server <VmcServer[]>]
[-StretchedCluster]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
Int32 | named |
|
Specifies the number of the hosts that you want to create. | required |
|
String | named |
|
Specifies the name of the created SDDC. | required |
|
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. | 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 VMware Cloud on AWS may not be supported in all regions. | required |
|
SwitchParameter | named |
|
Specifies that the account linking is delayed. | optional |
|
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 |
|
String | named |
|
Specifies the IP subnet in a classless inter-domain routing (CIDR) format for the compute gateway. | optional |
|
VmcOutpost | named |
|
Specifies the AWS Outpost on which you want to host this SDDC. | optional |
|
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 |
|
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 |
|
VmcSddcSizeEnum | named |
|
Specifies the SDDC appliances size. | optional |
|
SddcType | named |
|
Specifies if the SDDC is single or multi-host. | optional |
|
VmcServer[] | 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 |
|
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
VmcSddc
This cmdlet retrieves VMware Cloud on AWS software-defined data centers (SDDCs) from the VMware Cloud environment.
This cmdlet modifies a specified VMware Cloud on AWS software-defined data center (SDDC). This cmdlet can activate or deactivate site recovery for a specified SDDC, and upsize an SDDC.
This cmdlet removes a VMware Cloud on AWS software-defined data center (SDDC) from the VMware Cloud environment.
This cmdlet creates a new VMware Cloud on AWS software-defined data center (SDDC).
VmcSddcCluster
This cmdlet retrieves clusters of VMware Cloud on AWS software-defined data centers (SDDCs) from the VMware Cloud environment.
This cmdlet removes clusters from a VMware Cloud on AWS software-defined data center (SDDC).
This cmdlet creates ? cluster and adds it to a VMware Cloud on AWS software-defined data center (SDDC).
VmcSddcGroup
This cmdlet retrieves groups of VMware Cloud on AWS software-defined data centers (SDDCs) from the VMware Cloud environment.
VmcSddcHost
This cmdlet adds hosts to a VMware Cloud on AWS software-defined data center (SDDC). If no cluster is specified, the host is added to the default cluster of the SDDC. If the cluster is specified, the host is added to that cluster.
This cmdlet removes hosts from a VMware Cloud on AWS software-defined data center (SDDC). If no cluster is specified, the hosts are removed from the default cluster of the SDDC. If a cluster is passed, the hosts are removed from the specified cluster.
VmcSddcNetworkService
This cmdlet retrieves PSObjects that represent services for network configuration managment of an SDDC in VMware Cloud.
VmcSddcSiteRecovery
This cmdlet retrieves the site recovery parameters of VMware Cloud on AWS software-defined data centers (SDDCs).
VmcSddcSiteRecoveryInstance
This cmdlet retrieves the site recovery instances for VMware Cloud on AWS software-defined data centers (SDDCs) that have site recovery enabled.
This cmdlet removes site recovery instances from a VMware Cloud on AWS software-defined data center (SDDC) that has site recovery activated.
This cmdlet creates ? new site recovery instance for a VMware Cloud on AWS software-defined data center (SDDC) that has site recovery activated.
