---
title: "Start-VBRQuickMigration"
description: "This cmdlet starts Quick Migration for a selected virtual machines. Quick Migration is a service allowing to promptly migrate a VM between ESXi hosts, datastores or both in any state with minimum disruption to business operations and end user..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrquickmigration.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Quick Migration > Start-VBRQuickMigration"
dateModified: "2026-08-19"
---

# Start-VBRQuickMigration

## Short Description
Starts Quick Migration of a virtual machine.

**Platform**: VMware

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

## Syntax
```
Start-VBRQuickMigration -Entity <CViVmItem[]> -Server <CHost> [-ResourcePool <CViResourcePoolItem>]
 [-Datastore <CViDatastoreItem>] [-Folder <CViFolderItem>] [-StoragePolicy <VBRViStoragePolicy>]
 [-SourceProxy <CViProxy[]>] [-TargetProxy <CViProxy[]>] [-ForceVeeamQM] [-DeleteSorceVmFiles] [-RunAsync]
 [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet starts Quick Migration for a selected virtual machines.

Quick Migration is a service allowing to promptly migrate a VM between ESXi hosts, datastores or both in any state with minimum disruption to business operations and end user access to services.

::: note

The cmdlet will not run if the geographic location of the VMs you want to migrate and the destination server location do not match. If you still want to run the cmdlet, use the `Force` parameter.

:::

## 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 destination datastore to where you want to migrate the VMs.</p><p>Accepts the <code>CViDatastoreItem</code> object. To get 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">DeleteSorceVmFiles</span></p>
        </td>
        <td>
          <p>Defines that the original VM will be deleted upon receiving the heartbeat from the VM on the target 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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Entity</span></p>
        </td>
        <td>
          <p>Specifies the array of virtual machines you want to migrate.</p><p>Accepts the <code>CViVmItem[]</code> object. To get this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViVmItem[]</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</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">Folder</span></p>
        </td>
        <td>
          <p>Specifies the destination folder to where you want to migrate the VMs.</p><p>Accepts the <code>CViFolderItem</code> object. To get 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 start Quick Migration even if the geographic location of the VMs you want to migrate and the destination server location do 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 force using Veeam Quick Migration.</p><p>If omitted, migration process will use VMware VMotion given that the migration scenario and VMware licensing allows it.</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">ResourcePool</span></p>
        </td>
        <td>
          <p>Specifies the destination resource pool to where you want to migrate the VMs.</p><p>Accepts the <code>CViResourcePoolItem</code> object. To get 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 destination server to where you want to migrate the VMs.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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 the array of source proxies.</p><p>For best migration performance deploy at least one source backup proxy.</p><p>Default: automatic selection (recommended).</p><p>Accepts the <code>CViProxy[]</code> object. To get 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 virtual disks of the VMs.</p><p>Accepts the <a href="vbrvistoragepolicy.md"><code>VBRViStoragePolicy</code></a> object. To get 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 the array of target proxies.</p><p>For best migration performance deploy at least one target backup proxy.</p><p>Default: automatic selection (recommended).</p><p>Accepts the <code>CViProxy[]</code> object. To get 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>
    </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).

## Examples

::: example
### Starting Quick Migration of Selected VM

This command starts Quick Migration of the selected VM with the following settings:

- The source and target proxies are not set enabling the Quick Migration mechanism to select them automatically.
- The `ForceVeeamQM` parameter is not set enabling the use of VMware VMotion.
- The `DeleteSourceVmFiles` parameter is set to enable the clear up of the original VM files upon successful migration.
- The `RunAsync` parameter is not set.

```
$vm = Find-VBRViEntity -Name "server01.tech.global"
$server = Get-VBRServer -Type ESXi -Name "esx05.tech.local"
$pool = Find-VBRViResourcePool -Server $server
$datastore = Find-VBRViDatastore -Server $server
$folder = Find-VBRViFolder -Server $server
Start-VBRQuickMigration -Entity $vm -Server $server -ResourcePool $pool -Datastore $datastore -Folder $folder -DeleteSorceVmFiles
```

Perform the following steps:

1. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vm` variable.
2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Set the `ESXi` option for the `Type` parameter. Specify the `Name` parameter value. Save the result to the `$server` variable.
3. Run the [`Find-VBRViResourcePool`](find-vbrviresourcepool.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$pool` variable.
4. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$datastore` variable.
5. Run the [`Find-VBRViFolder`](find-vbrvifolder.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$folder` variable.
6. Run the `Start-VBRQuickMigration` cmdlet. Specify the following settings:

   - Set the `$vm` variable as the `Entity` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Set the `$pool` variable as the `ResourcePool` parameter value.
   - Set the `$datastore` variable as the `Datastore` parameter value.
   - Set the `$folder` variable as the `Folder` parameter value.
   - Provide the `DeleteSorceVmFiles` parameter.

:::

## Related Commands

- [`Find-VBRViEntity`](find-vbrvientity.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRViResourcePool`](find-vbrviresourcepool.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)
- [`Find-VBRViFolder`](find-vbrvifolder.md)
- [`Get-VBRViProxy`](get-vbrviproxy.md)
- [`Get-VBRLocation`](get-vbrlocation.md)