PowerCLI Reference

Get-HCXAppliance

Synopsis

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

Syntax

Get-HCXAppliance -Id <String[]> [-Server <HcxServer[]>] [<CommonParameters>]

Get-HCXAppliance [[-Name] <String[]>] [-Server <HcxServer[]>] [-Type {L2Concentrator | Interconnect | WANOptimization}] [<CommonParameters>]

Get-HCXAppliance [[-Name] <String[]>] [-Server <HcxServer[]>] [-Type {L2Concentrator | Interconnect | WANOptimization}] -ServiceMesh <HCXServiceMesh> [<CommonParameters>]

Related Commands

Detailed Description

This cmdlet retrieves the appliances of type Interconnect, WAN Optimization, and L2Concentrator (Network Extension).

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specifies the names of the appliance you want to retrieve.falseFalse
IdString[]Specifies the IDs of the appliances you want to retrieve.


Note: When a list of values is specified for the Id parameter, the returned objects have an ID that matches exactly one of the string values in the list.
trueFalse
ServerHcxServer[]Specifies the HCX Server systems 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-HCXServer cmdlet.falseFalse
ServiceMeshHCXServiceMeshSpecifies the Service Mesh for which you want to retrieve the appliances.trueTrue (ByValue)
TypeHXCApplianceTypeSpecifies the type of the appliances you want to retrieve. The valid values are L2Concentrator, Interconnect, and WANOptimization.falseFalse

Return Type

VMware.VimAutomation.Hcx.Types.V1.HCXAppliance

Notes

Examples

-------------------------- Example 1 --------------------------

PS C:\> Get-HCXAppliance

Retrieves the available appliances of type Interconnect, WAN Optimization, and L2Concentrator.

-------------------------- Example 2 --------------------------

PS C:\> Get-HCXAppliance -Type L2Concentrator

Retrieves the available appliances of type L2Concentrator.

-------------------------- Example 3 --------------------------

PS C:\> Get-HCXAppliance -Name "myName"

Retrieves available appliances that match the "myName" name.


Copyright © VMware, Inc. All rights reserved.