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

NameTypeDescriptionRequired?Pipeline InputDefault Value
ApplianceHCXApplianceSpecifies the L2Concentrator Appliance.trueTrue (ByValue)
ConfirmSwitchParameterIf 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.falseFalse
DestinationGatewayHCXGatewaySpecifies the gateway at the destination site.trueTrue (ByValue)
DestinationSiteHCXSiteSpecifies the destination site.trueTrue (ByValue)
EgressOptimizationBooleanSpecifies the option which enables egress optimization.falseFalse
GatewayIpStringSpecifies the gateway IP address that can be provided in the format <gateway-IP>.trueFalse
NetmaskStringSpecifies the netmask.trueFalse
NetworkHCXNetworkSpecifies the network that you want to extend.trueTrue (ByValue)
ProximityRoutingBooleanSpecifies the option that enables proximity routing.falseFalse
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
SourceSiteHCXSiteSpecifies the source site.trueTrue (ByValue)
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

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.


Copyright © VMware, Inc. All rights reserved.