Start-VBRQuickMigration

In this article

    Short Description

    Starts Quick Migration of a virtual machine.

    Applies to

    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.

    Starting from Veeam Backup & Replication version 9.5 Update 3, the cmdlet checks if the data of the VMs you want to migrate changes its geographical location.

    Start-VBRQuickMigration Note:

    The cmdlet will not run if the geographical 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

    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

    ForceVeeamQM

    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

    DeleteSorceVmFiles

    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

    Force

    Indicates that the cmdlet will start Quick Migration even if the geographical location of the VMs you want to migrate and the destination server location do not match.

    False

    Named

    False

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    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.

    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

    Get-VBRLocation