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

-Destination  <HCXSite>
-DestinationComputeProfile  <HCXComputeProfile>
-Name  <String>
-Service  <InterconnectServiceType[]>
-SourceComputeProfile  <HCXComputeProfile>
[-DVS  <HCXServiceMeshDVS[]>]
[-DestinationUplinkNetworkProfile  <HCXNetworkProfile[]>]
[-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
    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.

    -ServiceMesh  <HCXServiceMesh>
    [-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
    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.

    -Destination  <HCXSite>
    -UpgradeFromFleet
    [-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
    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

    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.

    Related Commands

    Feedback

    Was this page helpful?