This is an archive version of the document. To get the most up-to-date information, see the current version.Start-VBRQuickMigration
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
Detailed Description
This cmdlet starts Quick Migration for a selected virtual machine(s).
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Entity | Specifies the virtual machine(s) you want to migrate. You can assign multiple VMs to this object. | True | Named | True (ByValue, | False |
Server | Specifies the destination server to where you want to migrate the VM. | True | Named | True (ByValue, | 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 | 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 | 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 |
<CommonParameters>
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.
