Start-VBRViInstantRecoveryDiskMigration

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

[-DiskMigrationMappingRule <VBRViDiskMigrationMapppingRule[]>] [-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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Datastore	Specifies a datastore. The cmdlet will publish VM virtual disks to this datastore. Accepts the following types of objects: The `CViDatastoreItem` object. To get this object, run the `Find-VBRViDatastore` cmdlet. The `CViDatastoreCluster` object. To create this object, run the `Find-VBRViDatastoreCluster` cmdlet.	`VBRViDatastoreBase`	False	Named	False
DiskMigrationMappingRule	Specifies an array of mapping settings of VM virtual disks. The cmdlet will publish the recovered VM virtual disks to the datastores that you define in these mapping settings. Provide this parameter to define mapping settings for multiple VM virtual disks. Accepts the `VBRViDiskMigrationRule`[] object. To create this object, run the `New-VBRViDiskMigrationMappingRule` cmdlet.	`VBRViDiskMigrationMapppingRule[]`	False	Named	False
Force	Defines that the cmdlet will perform VM restore even if the geographic location of the repository where VM backups reside and the target host location does not match.	`SwitchParameter`	False	Named	False
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.	`InstantRecovery`	True	0	True (ByPropertyName, ByValue)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	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.	`CViProxy[]`	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.	`VBRViStoragePolicy`	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.	`CViProxy[]`	False	Named	False
UseDataTransportEngine	Defines that the cmdlet will enable the data transport engine,	`SwitchParameter`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see 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.

$session = 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 $session -DiskMigrationMappingRule $mapping -Force -RunAsync

Perform the following steps:

Run the Get-VBRInstantRecovery cmdlet. Save the result to the $session variable.
Get the mapping settings of VM virtual disks:
- Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
- Run the Get-VBRRestorePoint cmdlet. Set the $backup variable as the Backup parameter value. Save the result to the $restorepoint variable.
- Run the Get-VBRViVirtualDevice cmdlet. Set the $restorepoint variable as 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).
- Run the New-VBRViVirtualDeviceMappingRule cmdlet. Set the $disks variable as the TargetVirtualDevice parameter value. Save the result to the $mapping variable.
Run the Start-VBRViInstantRecoveryDiskMigration cmdlet. Specify the following settings:
- Set the $session variable as the InstantRecovery parameter value.
- Set the $mapping variable as the DiskMigrationMappingRule parameter value.
- Provide the Force parameter.
- Provide the RunAsync parameter.