This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRQuickMigration

In this article

Short Description

Starts Quick Migration of a virtual machine.

Applies to

Platform: VMware

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

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

Related Commands

Find-VBRViEntity

Get-VBRServer

Find-VBRViResourcePool

Find-VBRViDatastore

Find-VBRViFolder

Get-VBRViProxy

Detailed Description

This cmdlet starts Quick Migration for a selected virtual machine(s).

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Entity	Specifies the virtual machine(s) you want to migrate. You can assign multiple VMs to this object.	True	Named	True (ByValue, ByProperty Name)	False
Server	Specifies the destination server to where you want to migrate the VM.	True	Named	True (ByValue, ByProperty Name)	False
ResourcePool	Specifies the destination resource pool to where you want to migrate the VM.	False	Named	False	False
Datastore	Specifies the destination datastore to where you want to migrate the VM.	False	Named	False	False
Folder	Specifies the destination folder to where you want to migrate the VM.	False	Named	False	False
StoragePolicy	Specifies the VMware storage policy profile that must be applied to the virtual disks of the VM.	False	Named	False	False
SourceProxy	Specifies the source backup proxy(ies). If not specified, Veeam Backup & Replication provides automatic selection of the proxy (recommended). For best migration performance you should deploy at least one source backup proxy. You can assign multiple proxies to this object.	False	Named	False	False
TargetProxy	Specifies the target backup proxy(ies). If not specified, Veeam Backup & Replication provides automatic selection of the proxy (recommended). For best migration performance you should deploy at least one target backup proxy. You can assign multiple proxies to this object.	False	Named	False	False
Force VeeamQM	Forces using Veeam Quick Migration. If omitted, migration process will use VMware VMotion given that the migration scenario and VMware licensing allows it.	False	Named	False	False
DeleteSorce VmFiles	If set, the original VM will be deleted upon receiving the heartbeat from the VM on the target host.	False	Named	False	False
RunAsync	Indicates that the command returns immediately without waiting for the task to complete.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example

This command starts Quick Migration of the selected VM.

The VM to migrate is obtained with Find-VBRViEntity and assigned to the $vm variable beforehand,
The host to where the VM will be migrated is obtained with Get-VBRServer and assigned to the $server variable beforehand,
The resource pool to where the VM will be migrated is obtained with Find-VBRViResourcePool and assigned to the $pool variable beforehand,
The datastore to connect the VM to is obtained with Find-VBRViDatastore and assigned to the $datastore variable beforehand,
The folder to where the VM will be migrated is obtained with Find-VBRViFolder and assigned to the $folder variable beforehand.

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.

PS C:\PS> Start-VBRQuickMigration -Entity $vm -Server $server -ResourcePool $pool -Datastore $d -Folder $folder -DeleteSorceVmFiles