Start-VBRFCDInstantRecovery

Short Description

Starts the FCD instant recovery session.

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

Syntax

Start-VBRFCDInstantRecovery [-RestorePoint] <COib> [-TargetCluster] <CViClusterItem>

[-MappingOptions <VBRFCDInstantRecoveryMappingOptions>] [-CacheDatastore <VBRViDatastore>]

[-StoragePolicy <VBRViStoragePolicy>] [-RunAsync] [-Reason <String>] [<CommonParameters>]

Detailed Description

This cmdlet starts the FCD instant recovery session.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
CacheDatastore	Specifies a datastore to keep redo logs for the restored FCDs. Accepts the `VBRViDatastore` object. To create this object, run the `Find-VBRViDatastore` cmdlet.	`VBRViDatastore`	False	Named	False
MappingOptions	Specifies mapping settings of virtual disks that you want to restore as FCDs. By default, Veeam Backup & Replication assigns the name of the backed-up disk to all types of virtual disks. Note: If you do not provide this parameter, Veeam Backup & Replication will add all backed-up disks to the FCD instant recovery session. Accepts the `VBRFCDInstantRecoveryMappingOptions` object. To create this object, run the `New-VBRFCDInstantRecoveryMappingOptions` cmdlet.	`VBRFCDInstantRecoveryMappingOptions`	False	Named	False
Reason	Specifies a reason for performing restore of FCDs.	`String`	False	Named	False
RestorePoint	Specifies a restore point for the VM whose virtual disks you want to restore as FCDs. Accepts the `COib` object. To create this object, run the `Get-VBRRestorePoint` cmdlet.	`COib`	True	0	True (ByPropertyName, ByValue)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	False
StoragePolicy	Specifies a VM storage policy. Veeam Backup & Replication will apply this storage policy for FCDs and for a datastore that keeps redo logs for the restored FCDs. Note: The encrypted VM storage policy is not applied for FCD disks. However, you can apply this policy for a datastore that keeps redo logs for the restored FCDs. Accepts the `VBRViStoragePolicy` object. To create this object, run the `Find-VBRViStoragePolicy` cmdlet.	`VBRViStoragePolicy`	False	Named	False
TargetCluster	Specifies a cluster to which Veeam Backup & Replication will register FCDs. Accepts the `CViClusterItem` object. To create this object, run the `Find-VBRViEntity` cmdlet.	`CViClusterItem`	True	1	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRFCDInstantRecoverySession object that contains settings of FCD instant recovery session.

Examples

Start-VBRFCDInstantRecovery Example 1. Starting FCD Instant Recovery Session for all Disks

This example shows how to start FCD instant recovery session for all backed-up disks available in the Databaseo5 backup. The cmdlet will publish disks to the Workload-C cluster.

$backup = Get-VBRBackup -Name "Database05"

$restorepoint = Get-VBRRestorePoint -Backup $backup

$targetCluster = Find-VBRViEntity -Name "Workload-C" -HostsAndClusters

$publishingSession = Start-VBRFCDInstantRecovery -RestorePoint $restorepoint[2] -TargetCluster $targetCluster

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter. Save the result to the $restorepoint variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the third restore point will be used.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Provide the HostsAndClusters parameter. Save the result to the $targetCluster variable.
Run the Start-VBRFCDInstantRecovery cmdlet. Set the $restorepoint variable as the RestorePoint parameter value. Set the $targetCluster variable as the TargetCluster parameter value. Save the result to the $publishingSession variable.

Start-VBRFCDInstantRecovery Example 2. Starting FCD Instant Recovery Session for Specified Disks

This example shows how to start FCD instant recovery session for the Disk1 disk with the following settings:

The cmdlet will set the RestoredDisk1 to the virtual disk that that is mounted to the datastore.
The cmdlet will set the FCD-Disk1 to the FCD that is registered on the Workload-C cluster.

$backup = Get-VBRBackup -Name "Database backup"

$restorepoint = Get-VBRRestorePoint -Backup $backup

$targetCluster = Find-VBRViEntity -Name "Workload-C" -HostsAndClusters

$diskMapping = New-VBRFCDInstantRecoveryMappingOptions -NameInBackup "Disk1" -MountedDiskName "RestoredDisk1" -RegisteredFCDName "FCD-Disk1"

$publishingSession = Start-VBRFCDInstantRecovery -RestorePoint $restorepoint[2] -TargetCluster $targetCluster -MappingOptions $diskMapping

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter. Save the result to the $restorepoint variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the third restore point is used.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Provide the HostsAndClusters parameter. Save the result to the $targetCluster variable.
Run the New-VBRFCDInstantRecoveryMappingOptions cmdlet. Specify the NameInBackup, MountedDiskName and RegisteredFCDName parameter values. Save the result to the $diskMapping variable.
Run the Start-VBRFCDInstantRecovery cmdlet. Set the $restorepoint variable as the RestorePoint parameter value. Set the $targetCluster variable as the TargetCluster parameter value. Set the $diskMapping variable as the MappingOptions parameter value. Save the result to the $publishingSession variable.

Start-VBRFCDInstantRecovery Example 3. Starting FCD Instant Recovery Session with Redo Logs Redirection

This example shows how to start FCD instant recovery session for the Disk1 disk. The cmdlet will write redo logs to the VeeamDatastore datastore. The datastore is assigned the Virtual SAN Default Storage Policy.

$server = Get-VBRServer -Name "tech.local"

$datastore = Find-VBRViDatastore -Server $server -Name "VeeamDatastore"

$storagePolicy = Find-VBRViStoragePolicy -Server $server -Datastore $datastore -Name "Virtual SAN Default"

$backup = Get-VBRBackup -Name "Database backup"

$restorepoint = Get-VBRRestorePoint $backup

$targetCluster = Find-VBRViEntity -Name "Workload-Cluster" -HostsAndClusters

$publishingSession = Start-VBRFCDInstantRecovery -RestorePoint $restorepoint[2] -TargetCluster $targetCluster -CacheDatastore $datastore -StoragePolicy $storagePolicy

Perform the following steps:

Get the datastore:
1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
2. Run the Find-VBRViDatastore cmdlet. Specify the Server and Name parameter values. Save the result to the $datastore variable.
3. Run the Find-VBRViStoragePolicy cmdlet. Specify the Server, Datastore and Name parameter values. Save the result to the $storagePolicy variable.
Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter. Save the result to the $restorepoint variable.
The Get-VBRRestorePoint cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the third restore point will be used.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Provide the HostsAndClusters parameter. Save the result to the $targetCluster variable.
Run the Start-VBRFCDInstantRecovery cmdlet. Specify the following settings:
- Set the $restorepoint variable as the RestorePoint parameter value.
- Set the $targetCluster variable as the TargetCluster parameter value.
- Set the $datastore variable as the CacheDatastore parameter value.
- Set the $storagePolicy variable as the StoragePolicy parameter value.
- Save the result to the $publishingSession variable.