PowerCLI Reference

New-HCXReplication

Synopsis

This cmdlet creates an HCX replication request.

Syntax

New-HCXReplication -DestinationSeedVm <HCXVM> -DestinationSite <HCXSite> [-NetworkCompressionEnabled <Boolean>] [-QuiesceGuestEnabled <Boolean>] -RPOIntervalMinutes <Int32> [-Server <HcxServer[]>] -SnapshotIntervalMinutes <Int32> -SnapshotNumber <Int32> -SourceSite <HCXSite> -VM <HCXVM> [-Confirm] [-NetworkMapping <HCXNetworkMapping[]>] [-WhatIf] [<CommonParameters>]

New-HCXReplication -DestinationSite <HCXSite> [-NetworkCompressionEnabled <Boolean>] [-QuiesceGuestEnabled <Boolean>] -RPOIntervalMinutes <Int32> [-Server <HcxServer[]>] -SnapshotIntervalMinutes <Int32> -SnapshotNumber <Int32> -SourceSite <HCXSite> [-TargetComputeContainer <HCXComputeContainer>] -TargetDatastore <HCXDatastore> -VM <HCXVM> [-Confirm] -NetworkMapping <HCXNetworkMapping[]> [-WhatIf] [-TargetDataCenter <HCXFolderContainer>] [-TargetStorageProfile <HCXStorageProfile>] [<CommonParameters>]

Related Commands

Detailed Description

This cmdlet creates an HCX replication request. You can use the output of the cmdlet in the Start-HCXReplication cmdlet.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falseFalse
DestinationSeedVmHCXVMSpecifies the virtual machine on the destination site that you want to use as a seed for replicating.trueFalse
DestinationSiteHCXSiteSpecifies the site to which you want to replicate the virtual machine.trueTrue (ByValue)
NetworkCompressionEnabledBooleanSpecifies the network compression enabled option.falseFalse
NetworkMappingHCXNetworkMapping[]Specifies the list of network mapping from a source to destination site that you want to use.trueTrue (ByValue)
QuiesceGuestEnabledBooleanSpecifies the quiesce guest enabled option.falseFalse
RPOIntervalMinutesInt32Specifies the time interval in minutes for which the data should sync from source to destination.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
SnapshotIntervalMinutesInt32Specifies the time interval for which you can take the specified number of snapshots.trueFalse
SnapshotNumberInt32Specifies the number of snapshots that you want to take.trueFalse
SourceSiteHCXSiteSpecifies the site at which the virtual machine that you want to replicate resides.trueTrue (ByValue)
TargetComputeContainerHCXComputeContainerSpecifies the target compute container.falseTrue (ByValue)
TargetDataCenterHCXFolderContainerSpecifies the data center at the destination site that you want to use.falseTrue (ByValue)
TargetDatastoreHCXDatastoreSpecifies the target datastore.trueTrue (ByValue)
TargetStorageProfileHCXStorageProfileSpecifies the storage profile at the destination site that you want to use.falseTrue (ByValue)
VMHCXVMSpecifies the virtual machine at the source site that you want to protect.trueTrue (ByValue)
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

VMware.VimAutomation.Hcx.Types.V1.HCXReplication

Notes

Examples

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

PS C:\> New-HCXReplication -DestinationSite $myDestination -NetworkMapping $myNetworkMapping -RPOIntervalMinutes 30 -SnapshotIntervalMinutes 180 -SnapshotNumber 3 -SourceSite $mySourceSite -TargetComputeContainer $myTargetComputeContainer -TargetDataCenter $myTargetDataCenter -TargetDatastore $myTargetDatastore -VM $myVm

Creates a replication request.

-------------------------- Example 2 --------------------------

PS C:\> New-HCXReplication -DestinationSeedVm $myDestinationSeedVm -DestinationSite myDestination -RPOIntervalMinutes 30 -SnapshotIntervalMinutes 180 -SnapshotNumber 3 -SourceSite $mySourceSite -VM $myVm

Creates a replication request with a seed virtual machine option.

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

PS C:\> $myDestination = Get-HCXSite -Destination -Name "myDestinationName"
        $myStorageProfile = Get-HCXStorageProfile -Site $myDestination -Name "myStorageProfileName"
New-HCXReplication -DestinationSite $myDestination -NetworkMapping $myNetworkMapping -RPOIntervalMinutes 30 -SnapshotIntervalMinutes 180 -SnapshotNumber 3 -SourceSite $mySourceSite -TargetComputeContainer $myTargetComputeContainer -TargetDataCenter $myTargetDataCenter -TargetDatastore $myTargetDatastore -VM $myVm -StorageProfile $myStorageProfile

Creates a replication request with a datastore matching storage profile on the destination site.


Copyright © VMware, Inc. All rights reserved.