Remove-HCXAppliance Command | Vmware PowerCLI Reference

Remove-HCXAppliance

This cmdlet removes an HCX Appliance which can be of type Interconnect, L2Concentrator, and WANOptimization. You can use the HCXJob output to retrieve job details by running the Get-HCXJob cmdlet.

Syntax

Remove-HCXAppliance
-Appliance < HCXAppliance >
-DestinationSite < HCXSite >
[-Force ]
[-Server < HcxServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Appliance HCXAppliance named
  • pipeline
Specifies the appliance you want to remove. The supported types are Interconnect, L2Concentrator, and WANOptimization.
required
DestinationSite HCXSite named
  • pipeline
Specifies the destination site.
optional Force SwitchParameter named
Indicates that you want to remove the appliance. If the Force parameter is not set and the resource is busy, the appliance removal job will not be initiated.
optional Server HcxServer[] named
  • wildcards
Specifies the HCX Server systems 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-HCXServer cmdlet.

Output

VMware.VimAutomation.Hcx.Types.V1.HCXJob

Examples

Example 1

Remove-HCXAppliance -Appliance $myAppliance -DestinationSite $myDestination -Force

Removes the appliance.

Related Commands

HCXAppliance

This cmdlet retrieves the appliances of type Interconnect, WAN Optimization, and Network Extension that are available on the HCX Server system.

This cmdlet creates an HCX Appliance.

This cmdlet removes an HCX Appliance.

This cmdlet modifies the HCX appliances of type Interconnect and Network Extension that are available on the HCX Server system.