PowerCLI Reference

New-HCXNetworkExtension

Synopsis

This cmdlet creates an HCX Network Extension (L2 extension).

Syntax

New-HCXNetworkExtension -Appliance <HCXAppliance> -DestinationGateway <HCXGateway> -DestinationSite <HCXSite> [-EgressOptimization <Boolean>] -GatewayIp <String> -Netmask <String> -Network <HCXNetwork> [-ProximityRouting <Boolean>] [-Server <HcxServer[]>] -SourceSite <HCXSite> [-Confirm] [-WhatIf] [<CommonParameters>]

Related Commands

Detailed Description

This cmdlet creates an HCX Network Extension (L2 extension) and you can perform a stretch operation on the provided network. You can retrieve job details by running the Get-HCXJob cmdlet.

Parameters

Name	Type	Description	Required?	Pipeline Input
Appliance	HCXAppliance	Specifies the L2Concentrator Appliance.	true	True (ByValue)
Confirm	SwitchParameter	If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.	false	False
DestinationGateway	HCXGateway	Specifies the gateway at the destination site.	true	True (ByValue)
DestinationSite	HCXSite	Specifies the destination site.	true	True (ByValue)
EgressOptimization	Boolean	Specifies the option which enables egress optimization.	false	False
GatewayIp	String	Specifies the gateway IP address that can be provided in the format <gateway-IP>.	true	False
Netmask	String	Specifies the netmask.	true	False
Network	HCXNetwork	Specifies the network that you want to extend.	true	True (ByValue)
ProximityRouting	Boolean	Specifies the option that enables proximity routing.	false	False
Server	HcxServer[]	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.	false	False
SourceSite	HCXSite	Specifies the source site.	true	True (ByValue)
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False

Return Type

VMware.VimAutomation.Hcx.Types.V1.HCXJob

Notes

Examples

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

PS C:\> $myL2CAppliance = Get-HCXAppliance -Type L2Concentrator -Name "myAppliance"
        New-HCXNetworkExtension -Appliance $myL2CAppliance -DestinationGateway $myGateway -DestinationSite $myDestination -GatewayIp 192.167.5.21 -Netmask 255.255.192.0
        -Network $myNetwork -SourceSite $mySource

Creates a network extension.