Start-VBRViInstantRecoveryMigration

In this article

    Short Description

    Starts VMs quick migration to specified ESXi host.

    Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    Start-VBRViInstantRecoveryMigration [-InstantRecovery] <InstantRecovery> [-ToTarget] [-Server <CHost>] [-ResourcePool <CViResourcePoolItem>] [-Datastore <CViDatastoreItem>] [-Folder <CViFolderItem>] [-StoragePolicy <VBRViStoragePolicy>] [-SourceProxy <CViProxy[]>] [-TargetProxy <CViProxy[]>] [-DeleteSourceVmFiles] [-ForceVeeamQM] [-Force] [-RunAsync] [<CommonParameters>]

    Detailed Description

    This cmdelt starts VMs quick migration to specified ESXi host. You can run this cmdlet after you perform Instant VM Recovery.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    InstantRecovery

    Specifies a running Instant VM Recovery session. The cmdlet will start a quick migration of VMs that are recovered during this session.

    Accepts the InstantRecovery object. To create this object, run the Get-VBRInstantRecovery cmdlet.

    True

    0

    True (ByValue,
    ByProperty
    Name)

    ToTarget

    Defines target server settings.

    If you provide this parameter and do not specify the target server explicitly with the Server parameter, the cmdlet will migrate VMs to the ESXi host that is specified in the Instant VM Recovery session. Otherwise, it will mirgate VMs to the original ESXi host.

    SwitchParameter

    False

    Named

    False

    Server

    Specifies the target ESXi host. The cmdlet will migrate restored VMs to this host.

    Note: You must not specify a vCenter Server in this parameter.

    Accepts the CHost object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    ResourcePool

    Specifies the resource pool. The cmdlet will migrate restored VMs to this resource pool.

    Accepts the CViResourcePoolItem object. To create this object, run the Find-VBRViResourcePool cmdlet.

    False

    Named

    False

    Datastore

    Specifies the datastore to which you want to migrate restored VMs. Veeam Backup & Replication will redirect the redo logs to the selected datastore.

    Accepts the CViDatastoreItem object. To create this object, run the Find-VBRViDatastore cmdlet.

    False

    Named

    False

    Folder

    Specifies the folder where you want to store the migrated VM.

    Accepts the CViFolderItem object. To create this object, run the Find-VBRViFolder cmdlet.

    False

    Named

    False

    StoragePolicy

    Specifies the VMware storage policy profile that must be applied to the restored virtual disks.

    Accepts the VBRViStoragePolicy object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    SourceProxy

    Specifies an array of the source backup proxies that you want to use as source backup proxies.

    Accepts the CViProxy[] object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    TargetProxy

    Specifies an array of the target backup proxies that you want to use as target backup proxies.

    Accepts the CViProxy[] object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    DeleteSourceVmFiles

    Defines that the cmdlet will delete the original VM on the source host after the heartbeat is received.

    If you do not provide this parameter, the source VM will not be deleted. All jobs to which the VM is added will continue to process the source VM.

    Note: You can not apply this option if you provide the ForceVeeamQM parameter.

    SwitchParameter

    False

    Named

    False

    ForceVeeamQM

    Defines that the cmdlet will apply the Veeam Quick Migration mechanism to migrate VMs.

    SwitchParameter

    False

    Named

    False

    Force

    Indicates that the cmdlet will perform VM restore even if the geographical location of the repository where VM backups reside and the target host location does not match.

    SwitchParameter

    False

    Named

    False

    RunAsync

    Defines that the command returns immediately without waiting for the task to complete.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

    The cmdlet returns the CBackupSession object that contains setting of a VMs quick migration session.

    Examples

    Performing VMs Quick Migration

    This example shows how to migrate the VMs to a the support.north.local ESXi host with the following settings:

    • The target resource pool is set to ResourcePool_9.
    • The target datastore is set to Datastore_5.
    • The target folder is set to VM_recovery.
    • The cmdlet will apply the Veeam Quick Migration mechanism to migrate VMs.
    • The RunAsync parameter is set to bring the process to the background.

    $session = Get-VBRInstantRecovery

    $server = Get-VBRServer -Name support.north.local

    $pool = Find-VBRViResourcePool -Name "ResourcePool_9"

    $store = Find-VBRViDatastore -Name "Datastore_5"

    $folder = Find-VBRViFolder -Name "VM_recovery"

    Start-VBRViInstantRecoveryMigration -InstantRecovery $session -Server $server -ResourcePool $pool -Datastore $store -Folder $folder -ForceVeeamQM -RunAsync

    Perform the following steps:

    1. Run the Get-VBRInstantRecovery cmdlet. Save the result to the $session variable.
    2. Run the Get-VBRServer cmdlet. Provide the Name parameter value. Save the result to the $server variable.
    3. Run the Find-VBRViResourcePool cmdlet. Provide the Name parameter value. Save the result to the $pool variable.
    4. Run the Find-VBRViDatastore cmdlet. Provide the Name parameter value. Save the result to the $store variable.
    5. Run the Find-VBRViFolder cmdlet. Provide the Name parameter value. Save the result to the $folder variable.
    6. Run the Start-VBRViInstantRecoveryMigration cmdlet. Specify the following settings:
    • Set the $session variable as the InstantRecovery parameter value.
    • Set the $server variable as the Server parameter value.
    • Set the $pool variable as the ResourcePool parameter value.
    • Set the $store variable as the Datastore parameter value.
    • Set the $folder variable as the Folder parameter value.
    • Provide the ForceVeeamQM parameter.
    • Provide the RunAsync parameter.

    Related Commands