Start-VBRvCloudRestoreVApp

Short Description

Starts a vApp restore.

Platform: VMware

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

Syntax

This cmdlet provides the following parameter sets:

DifferentLocation

Start-VBRvCloudRestoreVApp [-RestoreParams] <CVcdVAppRestoreSettings> [-PowerUp] [-Reason <String>] [-RunAsync] [<CommonParameters>]
OriginalLocation

Start-VBRvCloudRestoreVApp [-RestorePoint] <COib> [-PowerUp] [-Reason <String>] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet starts a restore session for a selected vApp.

With this cmdlet, you can restore the vApp to the original location or to another location, or with different settings.

To restore the vApp to the original location you only need to indicate the desired restore point. Be careful to specify the restore point of the vApp, not an individual VM which is not a valid value for this cmdlet. Veeam Backup & Replication gets all the information needed for restore from the restore point data.

To run restore to another location or with different settings you need to first create a CVcdVAppRestoreSettings object which unifies all the settings options required for restore. The CVcdVAppRestoreSettings object is created with the help of the New-VBRvCloudVAppRestoreSettings cmdlet. See the New-VBRvCloudVAppRestoreSettings topic for detailed instructions for advanced setup options.

This cmdlet provides two scenarios for each case.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
PowerUp	If set, the vApp will be powered up right after it is restored. Otherwise you will need to power up the vApp manually.	`SwitchParameter`	False	Named	False
Reason	Specifies the reason for performing restore of the selected vApp. The information you provide will be saved in the session history so that you can reference it later.	`String`	False	Named	False
RestoreParams	Specifies the `CVcdVAppRestoreSettings` object containing all settings required for the vApp restore. Accepts the `CVcdVAppRestoreSettings` object. To create this object, run the `New-VBRvCloudVAppRestoreSettings` cmdlet.	`CVcdVAppRestoreSettings`	True	0	True (ByPropertyName, ByValue)
RestorePoint	Specifies the restore point of the vApp. Used to restore vApp with all the same settings unchanged. Accepts the `COib` object. To get 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

<CommonParameters>

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

Examples

Start-VBRvCloudRestoreVApp Example 1. Starting vApp Restore to Original Location

This example shows how to start a vApp restore. The vApp named vApp_01 is restored to the original location and with all settings unchanged.

$restorepoint = Get-VBRRestorePoint -Name "vApp_01"

Start-VBRvCloudRestoreVApp -RestorePoint $restorepoint

Perform the following steps:

Run the Get-VBRRestorePoint cmdlet. Specify the Name parameter value. Save the result to the $restorepoint variable.
Run the Start-VBRvCloudRestoreVApp cmdlet. Set the $restorepoint variable as the RestorePoint variable.

Start-VBRvCloudRestoreVApp Example 2. Starting vApp Restore to Another Location

This example shows how to restore a vApp to another location. The vApp named vApp_01 is restored to the Org_02 organization with all other settings remaining unchanged.

$backup = Get-VBRBackup -Name "vCloud"

$restoreparams = Get-VBRRestorePoint -Backup $backup | Where {$_.Name -eq "vApp_01"} | New-VBRvCloudVAppRestoreSettings

$restoreparams.OrgVdc = Find-VBRvCloudEntity -OrganizationVdc -Name "Org_02"

Start-VBRvCloudRestoreVApp -RestoreParams $restoreparams -RunAsync

Perform the following steps:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
To restore the vApp to another organization, you need to first customize the CVcdVAppRestoreSettings object:
- Run the Get-VBRRestorePoint cmdlet. Set the $backup variable as the Backup parameter value. Pass the result to the Where-Object cmdlet to select the restore points with the Name property that equals vApp_01.
- Pipe the cmdlet output to the New-VBRvCloudVAppRestoreSettings cmdlet. Save the result to the $restoreparams variable.
Run the Find-VBRvCloudEntity cmdlet. Provide the OrganizationVdc parameter. Specify the Name parameter value for the target organization. Save the result to the OrgVdc property of the $restoreparams variable.
Run the Start-VBRvCloudRestoreVApp cmdlet. Set the $restoreparams variable as the RestoreParams parameter value. Provide the RunAsync parameter.