New-HCXServiceMesh Command | Vmware PowerCLI Reference

New-HCXServiceMesh

This cmdlet creates an HCX Service Mesh. You can use the HCXInterconnectTask output to retrieve task details by running the Get-HCXJob cmdlet.

Syntax

New-HCXServiceMesh
-Destination < HCXSite >
-DestinationComputeProfile < HCXComputeProfile >
-Name < String >
-SourceComputeProfile < HCXComputeProfile >
[-DVS < HCXServiceMeshDVS[] > ]
[-DestinationUplinkNetworkProfile < HCXNetworkProfile[] > ]
[-ProgressAction < ActionPreference > ]
[-Server < HcxServer[] > ]
[-SourceUplinkNetworkProfile < HCXNetworkProfile[] > ]
[-WANOptimizationBandwidth < Int32 > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Destination HCXSite named
  • pipeline
Specifies the destination site.
required
DestinationComputeProfile HCXComputeProfile named
  • pipeline
Specifies the destination site compute profile for enabling hybridity services.
required
Name String named
Specifies the name of the HCX Service Mesh.
required
Service InterconnectServiceType[] named
Specifies the services that you want to enable. Licenses must be enabled for the RAV and OSAssistedMigration services to work.
required
SourceComputeProfile HCXComputeProfile named
  • pipeline
Specifies the source site compute profile for enabling hybridity services.
optional DVS HCXServiceMeshDVS[] named
  • pipeline
Specifies the distributed virtual switch (DVS). The Service Mesh defaults to one Extension appliance per vSphere Distributed Switch.
optional DestinationUplinkNetworkProfile HCXNetworkProfile[] named
  • pipeline
Specifies the destination uplink network profile that you can use to connect to the network and by which you can reach the remote site's Interconnect appliances. By default, the uplink network profile is used from the compute profile selected at the destination site. It is mandatory when the uplink network profile is not provided in the destination compute profile.
optional ProgressAction ActionPreference named
optional Server HcxServer[] named
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.
optional SourceUplinkNetworkProfile HCXNetworkProfile[] named
  • pipeline
Specifies the source uplink network profile that you can use to connect to the network and by which you can reach the remote site's Interconnect appliances. By default, the uplink network profile is used from the compute profile selected at the source site. It is mandatory when the uplink network profile is not provided in the source compute profile.
optional WANOptimizationBandwidth Int32 named
Specifies the maximum aggregate uplink bandwidth that you want to consume for migrations across all uplinks.
New-HCXServiceMesh
-ServiceMesh < HCXServiceMesh >
[-ProgressAction < ActionPreference > ]
[-Server < HcxServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
ServiceMesh HCXServiceMesh named
  • pipeline
Specifies the Service Mesh that you want to resync.
optional ProgressAction ActionPreference named
optional Server HcxServer[] named
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.
New-HCXServiceMesh
-Destination < HCXSite >
-UpgradeFromFleet
[-ProgressAction < ActionPreference > ]
[-Server < HcxServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Destination HCXSite named
  • pipeline
Specifies the destination site.
required
UpgradeFromFleet SwitchParameter named
Indicates that you want to upgrade the fleet appliances to the Service Mesh.
optional ProgressAction ActionPreference named
optional Server HcxServer[] named
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.HCXInterconnectTask

Examples

Example 1

$destination = Get-HCXSite -Destination
$myLocalComputeProfile = Get-HCXComputeProfile -Name "myLocalComputeProfile"
$myRemoteComputeProfile = Get-HCXComputeProfile -Site $destination -Name "myRemoteComputeProfile"
New-HCXServiceMesh -SourceComputeProfile $myLocalComputeProfile -Destination $destination -DestinationComputeProfile $myRemoteComputeProfile -Service BulkMigration,DisasterRecovery,Interconnect,NetworkExtension,Vmotion,WANOptimization -Name "myServiceMesh"

Creates a new HCX Service Mesh.

Example 2

$destination = Get-HCXSite -Destination
New-HCXServiceMesh -UpgradeFromFleet -Destination $destination

Upgrades the old fleet to a Service Mesh.

Example 3

$myServiceMesh = Get-HCXServiceMesh
New-HCXServiceMesh -ServiceMesh $myServiceMesh

Indicates that you want to resync the Service Mesh.

Related Commands

HCXServiceMesh

This cmdlet retrieves a list of the HCX Service Mesh.

This cmdlet creates an HCX Service Mesh.

This cmdlet removes an existing HCX Service Mesh.

Specifies the HCX Service Mesh that you want to modify.

HCXServiceMeshDVS

This cmdlet creates a DVS configuration for the Service Mesh.