PowerCLI Reference

New-HCXServiceMesh

Synopsis

This cmdlet creates an HCX Service Mesh.

Syntax

New-HCXServiceMesh [-DVS <HCXServiceMeshDVS[]>] -Destination <HCXSite> -DestinationComputeProfile <HCXComputeProfile> [-DestinationUplinkNetworkProfile <HCXNetworkProfile[]>] -Name <String> [-Server <HcxServer[]>] -Service {Interconnect | NetworkExtension | WANOptimization | BulkMigration | DisasterRecovery | Vmotion} -SourceComputeProfile <HCXComputeProfile> [-SourceUplinkNetworkProfile <HCXNetworkProfile[]>] [-WANOptimizationBandwidth <Int32>] [<CommonParameters>]

New-HCXServiceMesh -Destination <HCXSite> [-Server <HcxServer[]>] -UpgradeFromFleet [<CommonParameters>]

New-HCXServiceMesh [-Server <HcxServer[]>] -ServiceMesh <HCXServiceMesh> [<CommonParameters>]

Related Commands

Detailed Description

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

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
DestinationHCXSiteSpecifies the destination site.trueTrue (ByValue)
DestinationComputeProfileHCXComputeProfileSpecifies the destination site compute profile for enabling hybridity services.trueTrue (ByValue)
DestinationUplinkNetworkProfileHCXNetworkProfile[]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.falseTrue (ByValue)
DVSHCXServiceMeshDVS[]Specifies the distributed virtual switch (DVS). The Service Mesh defaults to one Extension appliance per vSphere Distributed Switch.falseTrue (ByValue)
NameStringSpecifies the name of the HCX Service Mesh.trueFalse
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
ServiceInterconnectServiceType[]Specifies the services that you want to enable.trueFalse
ServiceMeshHCXServiceMeshSpecifies the Service Mesh that you want to resync.trueTrue (ByValue)
SourceComputeProfileHCXComputeProfileSpecifies the source site compute profile for enabling hybridity services.trueTrue (ByValue)
SourceUplinkNetworkProfileHCXNetworkProfile[]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.falseTrue (ByValue)
UpgradeFromFleetSwitchParameterIndicates that you want to upgrade the fleet appliances to the Service Mesh.trueFalse
WANOptimizationBandwidthInt32Specifies the maximum aggregate uplink bandwidth that you want to consume for migrations across all uplinks.falseFalse

Return Type

VMware.VimAutomation.Hcx.Types.V1.HCXInterconnectTask

Notes

Examples

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

PS C:\> $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
PS C:\> New-HCXServiceMesh -UpgradeFromFleet -Destination $destination

Upgrades the old fleet to a Service Mesh.

-------------------------- Example 3 --------------------------

$myServiceMesh = Get-HCXServiceMesh
PS C:\> New-HCXServiceMesh -ServiceMesh $myServiceMesh

Indicates that you want to resync the Service Mesh.


Copyright © VMware, Inc. All rights reserved.