New-HCXNetworkExtension Command | Vmware PowerCLI Reference

New-HCXNetworkExtension

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.

Syntax

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

Parameters

Required Parameter Name Type Position Features Description
required
 Appliance HCXAppliance named
  • pipeline
 Specifies the L2Concentrator Appliance.
required
 DestinationGateway HCXGateway named
  • pipeline
 Specifies the gateway at the destination site.
required
 DestinationSite HCXSite named
  • pipeline
 Specifies the destination site.
required
 GatewayIp String named
Specifies the gateway IP address that can be provided in the format <gateway-IP>.
required
 Netmask String named
Specifies the netmask.
required
 Network HCXNetwork named
  • pipeline
 Specifies the network that you want to extend.
required
 SourceSite HCXSite named
  • pipeline
 Specifies the source site.
optional EgressOptimization Boolean named
Specifies the option which enables egress optimization.
optional ProximityRouting Boolean named
Specifies the option that enables proximity routing.
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 

$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.

Related Commands

HCXNetwork

This cmdlet retrieves a list of HCX networks.

HCXNetworkBacking

This cmdlet retrieves a list of HCX Network Backings.

HCXNetworkExtension

This cmdlet retrieves a list of HCX Network Extension (HCX-NET-EXT).

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

This cmdlet removes an HCX Network Extension.

HCXNetworkMapping

This cmdlet creates an HCX network mapping request.

HCXNetworkProfile

This cmdlet retrieves a list of HCX Network Profiles.

This cmdlet creates an HCX Network Profile.

This cmdlet removes an existing HCX Network Profile.

This cmdlet modifies the HCX Network Profile.