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 > ]
[-ProgressAction < ActionPreference > ]
[-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 ProgressAction ActionPreference named
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.