Remove-VmcSddcHost
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.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
HostCount | Int32 | named |
|
Specifies the number of the host that you want to remove. |
| required
|
Sddc | VmcSddc[] | named |
|
Specifies the SDDC. |
| optional | ProgressAction | ActionPreference | named |
|
|
| 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 | Server | VmcServer[] | named |
|
Specifies the VMware Cloud on AWS servers on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-Vmc cmdlet. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Cluster | VmcSddcCluster[] | named |
|
Specifies the cluster. |
| required
|
HostCount | Int32 | named |
|
Specifies the number of the host that you want to remove. |
| optional | ProgressAction | ActionPreference | named |
|
|
| 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 | Server | VmcServer[] | named |
|
Specifies the VMware Cloud on AWS servers on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-Vmc cmdlet. |
Output
Examples
Example 1
Remove-VmcSddcHost -Sddc $SDDC -HostCount 2
Removes two hosts from the default cluster of the $SDDC SDDC.
Example 2
Remove-VmcSddcHost -Sddc $SDDC -HostCount 2 -RunAsync
Removes asynchronously two hosts from the default cluster of the $SDDC SDDC.
Example 3
Remove-VmcSddcHost -Cluster $CLUSTER -HostCount 2
Removes two hosts from the specified $CLUSTER cluster.
Related Commands
VmcSddc
This cmdlet retrieves VMware Cloud on AWS software-defined data centers (SDDCs) from the VMware Cloud environment.
This cmdlet creates a new VMware Cloud on AWS software-defined data center (SDDC).
This cmdlet removes a VMware Cloud on AWS software-defined data center (SDDC) 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.
VmcSddcCluster
This cmdlet retrieves clusters of VMware Cloud on AWS software-defined data centers (SDDCs) from the VMware Cloud environment.
This cmdlet creates а cluster and adds it to a VMware Cloud on AWS software-defined data center (SDDC).
This cmdlet removes clusters from 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 creates а new site recovery instance for a VMware Cloud on AWS software-defined data center (SDDC) that has site recovery activated.
This cmdlet removes site recovery instances from a VMware Cloud on AWS software-defined data center (SDDC) that has site recovery activated.