Start-VBRViInstantRecoveryDiskMigration

In this article

    Short Description

    Starts publish VM virtual disks to the production environment.

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

    Syntax

    Start-VBRViInstantRecoveryDiskMigration [-InstantRecovery] <InstantRecovery> [-Datastore <CViDatastoreItem>] [-DiskMigrationMappingRule <VBRViDiskMigrationRule[]>] [-StoragePolicy <VBRViStoragePolicy>] [-SourceProxy <CViProxy[]>] [-TargetProxy <CViProxy[]>] [-UseDataTransportEngine] [-Force] [-RunAsync]  [<CommonParameters>]

    Detailed Description

    This cmdlet publish VM virtual disks to the production environment. To publish the disks, it uses the Quick Migration mechanism.

    Important

    You can run this cmdlet only after you have performed Instant VM Disk Recovery.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    InstantRecovery

    Specifies an Instant VM Disc Recovery session. The cmdlet will start quick migration of VM virtual discs that are recovered during this session.

    Accepts the InstantRecovery object. To create this object, run the Get-VBRInstantRecovery cmdlet.

    True

    0

    True (ByValue,
    ByProperty
    Name)

    Datastore

    Specifies a datastore. The cmdelt will publish VM virtual disks to this datastore.

    Accepts the CViDatastoreItem object. To create this object, run the Find-VBRViDatastore cmdlet.

    False

    Named

    False

    DiskMigrationMappingRule

    Specifies an array of mapping settings of VM virual disks. The cmdlet will publish the recovered VM virual disks to the datastores that you define in these mapping settings.

    Provide this parameter to defines mapping settings for multiple VM virtual disks.

    Accepts the VBRViDiskMigrationRule[] object. To create this object, run the New-VBRViDiskMigrationMappingRule cmdlet.

    False

    Named

    False

    StoragePolicy

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

    Accepts the VBRViStoragePolicy object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    SourceProxy

    Specifies an array of the source backup proxies that you want to use as source backup proxies.

    Accepts the CViProxy[] object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    TargetProxy

    Specifies an array of the target backup proxies that you want to use as target backup proxies.

    Accepts the CViProxy[] object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    UseDataTransportEngine

    Defines that the cmdet will enable the data transport engine,

    SwitchParameter

    False

    Named

    False

    Force

    Defines that the cmdlet will perform VM restore even if the geographical location of the repository where VM backups reside and the target host location does not match.

    SwitchParameter

    False

    Named

    False

    RunAsync

    Defines that the command returns immediately without waiting for the task to complete.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

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

    Output Object

    The cmdlet returns the CBackupSession object that contains settings of the publish operation VM virtual disks to the production environment.

    Examples

    Publishing VM Virtual Disks to Production Environment

    This example shows how to publish VM virtual disks to the production environment. The cmdlet will publish the disks to the datastore as it is defines in the mapping settings of the VM virtual disks.

    $sesson = Get-VBRInstantRecovery

    $backup = Get-VBRBackup -Name "Winsrv4515"

    $restorepoint = Get-VBRRestorePoint -Backup $backup

    $disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]

    $mapping = New-VBRViDiskMigrationMappingRule -TargetVirtualDevice $disks

    Start-VBRViInstantRecoveryDiskMigration -InstantRecovery $sesson -DiskMigrationMappingRule $mapping -Force -RunAsync

    Perform the following steps:

    1. Run the Get-VBRInstantRecovery cmdlet.  Save the result to the $sesson variable.
    2. Get the mapping settings of VM virtual disks:
    1. Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
    2. Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
    3. Run the Get-VBRViVirtualDevice cmdlet. Specify the RestorePoint parameter value. Save the result to the $disks variable.

    The Get-VBRRestorePoint cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array).

    1. Run the New-VBRViVirtualDeviceMappingRule cmdlet. Specify the SourceVirtualDevice parameter value. Save the result to the $mappingrule variable.
    1. Run the Start-VBRViVirtualDiskRestore cmdlet. Set the $restorepoint variable as the RestorePoint parameter value. Set the $mappingrule variable as the VirtualDeviceMapping parameter value..

    Related Commands

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.