Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

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>]

Detailed Description

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

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

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Entity

Specifies the array of virtual machines you want to migrate.

True

Named

True (ByValue,
ByProperty
Name)

False

Server

Specifies the destination server to where you want to migrate the VMs.

True

Named

True (ByValue,
ByProperty
Name)

False

ResourcePool

Specifies the destination resource pool to where you want to migrate the VMs.

False

Named

False

False

Datastore

Specifies the destination datastore to where you want to migrate the VMs.

False

Named

False

False

Folder

Specifies the destination folder to where you want to migrate the VMs.

False

Named

False

False

StoragePolicy

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

Accepts VBRViStoragePolicy type.

False

Named

False

False

SourceProxy

Specifies the array of source proxies.

For best migration performance deploy at least one source backup proxy.

Default: automatic selection (recommended).

False

Named

False

False

TargetProxy

Specifies the array of target proxies.

For best migration performance deploy at least one target backup proxy.

Default: automatic selection (recommended).

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

<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.

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

Related Commands

Find-VBRViEntity

Get-VBRServer

Find-VBRViResourcePool

Find-VBRViDatastore

Find-VBRViFolder

Get-VBRViProxy

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation