---
title: "Start-VBRViInstantRecoveryMigration"
description: "This cmdlet starts VMs quick migration to specified ESXi host. You can run this cmdlet after you perform Instant Recovery."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrviinstantrecoverymigration.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Instant Recovery Migration > Start-VBRViInstantRecoveryMigration"
dateModified: "2026-08-19"
---

# Start-VBRViInstantRecoveryMigration

## Short Description
Starts VMs quick migration to specified ESXi host.

**Platform**: VMware

**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 cmdlet starts VMs quick migration to specified ESXi host. You can run this cmdlet after you perform [Instant Recovery](instant_cmdlets.md).

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Datastore</span></p>
        </td>
        <td>
          <p>Specifies the datastore to which you want to migrate restored VMs. Veeam Backup & Replication will redirect the redo logs to the selected datastore.</p><p><strong>Note</strong>: This parameter is required if you migrate a workload other than a VMware vSphere VM.</p><p>Accepts the <code>CViDatastoreItem</code> object. To create this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViDatastoreItem</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DeleteSourceVmFiles</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will delete the original VM on the source host after the heartbeat is received.</p><p>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.</p><p><strong>Note</strong>: You can not apply this option if you provide the <code>ForceVeeamQM</code> parameter.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Folder</span></p>
        </td>
        <td>
          <p>Specifies the folder where you want to store the migrated VM.</p><p><strong>Note</strong>: This parameter is required if you migrate a workload other than a VMware vSphere VM.</p><p>Accepts the <code>CViFolderItem</code> object. To create this object, run the <a href="find-vbrvifolder.md"><code>Find-VBRViFolder</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViFolderItem</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will perform VM restore even if the geographic location of the repository where VM backups reside and the target host location does not match.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ForceVeeamQM</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will apply the Veeam Quick Migration mechanism to migrate VMs.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstantRecovery</span></p>
        </td>
        <td>
          <p>Specifies a running Instant Recovery session. The cmdlet will start a quick migration of VMs that are recovered during this session.</p><p>Accepts the <code>InstantRecovery</code> object. To create this object, run the <a href="get-vbrinstantrecovery.md"><code>Get-VBRInstantRecovery</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>InstantRecovery</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ResourcePool</span></p>
        </td>
        <td>
          <p>Specifies the resource pool. The cmdlet will migrate restored VMs to this resource pool.</p><p><strong>Note</strong>: This parameter is required if you migrate a workload other than a VMware vSphere VM.</p><p>Accepts the <code>CViResourcePoolItem</code> object. To create this object, run the <a href="find-vbrviresourcepool.md"><code>Find-VBRViResourcePool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViResourcePoolItem</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>Specifies the target ESXi host. The cmdlet will migrate restored VMs to this host.</p><p><strong>Note</strong>: Consider the following:</p><ul><li>You must not specify a vCenter Server in this parameter.</li><li>This parameter is required if you migrate a workload other than a VMware vSphere VM.</li></ul><p>Accepts the <code>CHost</code> object. To create this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SourceProxy</span></p>
        </td>
        <td>
          <p>Specifies an array of the source backup proxies that you want to use as source backup proxies.</p><p>Accepts the <code>CViProxy</code>[] object. To create this object, run the <a href="get-vbrviproxy.md"><code>Get-VBRViProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViProxy[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">StoragePolicy</span></p>
        </td>
        <td>
          <p>Specifies the VMware storage policy profile that must be applied to the restored virtual disks.</p><p>Accepts the <code>VBRViStoragePolicy</code> object. To create this object, run the <a href="find-vbrvistoragepolicy.md"><code>Find-VBRViStoragePolicy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvistoragepolicy.md"><code>VBRViStoragePolicy</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TargetProxy</span></p>
        </td>
        <td>
          <p>Specifies an array of the target backup proxies that you want to use as target backup proxies.</p><p>Accepts the <code>CViProxy</code>[] object. To create this object, run the <a href="get-vbrviproxy.md"><code>Get-VBRViProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViProxy[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ToTarget</span></p>
        </td>
        <td>
          <p>Defines target server settings.</p><p>If you migrate VMware vSphere VMs, provide this parameter and do not specify the target server explicitly with the <code>Server</code> parameter, the cmdlet will migrate VMs to the ESXi host that is specified in the Instant Recovery session. Otherwise, it will migrate VMs to the original ESXi host.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

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

## Examples

::: example
### 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`](get-vbrinstantrecovery.md) cmdlet. Save the result to the `$session` variable.
2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Provide the `Name` parameter value. Save the result to the `$server` variable.
3. Run the [`Find-VBRViResourcePool`](find-vbrviresourcepool.md) cmdlet. Provide the `Name` parameter value. Save the result to the `$pool` variable.
4. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Provide the `Name` parameter value. Save the result to the `$store` variable.
5. Run the [`Find-VBRViFolder`](find-vbrvifolder.md) 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

- [`Get-VBRInstantRecovery`](get-vbrinstantrecovery.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRViResourcePool`](find-vbrviresourcepool.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)
- [`Find-VBRViFolder`](find-vbrvifolder.md)