Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

New-VBRvCloudVAppRestoreSettings

Short Description

Creates a set of vApp restore parameters.

Applies to

Platform: VMware

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

New-VBRvCloudVAppRestoreSettings [-RestorePoint] <COib> [-vAppName <String>] [-OrgVdc <IVcdItem>] [-PowerUp] [-Reason <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet is an assistant command creating a CVcdVAppRestoreSettings object that is further used in the Start-VBRvCloudRestoreVApp cmdlet. This object gathers the parameters of a selected vApp that will be needed for restore.

The vApp that you want to restore and its parameters are derived from the specified restore point data. Use the -OrgVdc parameter to set another organization where you want to restore the vApp to.

You can customize any of the parameters that are derived from the restore point. For more information, see the Advanced Setup below.

Advanced Setup

The restore parameters include the settings of the vApp, namely restore point, vApp name, Organization vDC, and VMs included, as well as the settings of the VM: restore point, storage profile, datastore and template. Each of these settings can be reset to user settings allowing to restore the vApp i.e. to another organization, or with another vApp name, or apply other storage profiles to the VMs.

When applying different restore settings, it is recommended to set "null" to all VM settings that you leave unchanged to avoid conflicts when restoring the vApp to another infrastructure. For example, if the target organization has no access to the datastore that is originally set for the vApp, PowerShell will terminate your vApp restore job.

If you set "null" to all VM settings, Veeam Backup & Replication will apply the default settings of the target organization.

Make sure that you set the parameters for all VMs that belong to the vApp, otherwise you will not be able to run the restore job.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

RestorePoint

Specifies the restore point of the vApp you want to restore the vApp to.

True

1

True (ByValue,
ByProperty
Name)

False

vAppName

Specifies the name of the restored vApp. Use this parameter in case you want to restore the vApp with different name.

False

Named

False

False

OrgVdc

Specifies the Organization vDC you want to restore the vApp to. If not set, the vApp will be restored to the original Organization vDC.

False

Named

False

False

PowerUp

If set to True, the vApp will be powered up right after it is restored. Otherwise, you will need to power up the vApp manually.

False

Named

False

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.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example

This command creates settings for the future restore of the vApp in another Organization vDC.

  • The $restorepoint variable contains the restore point of the vApp. The restore point is obtained with Get-VBRRestorePoint and assigned to the variable beforehand.
  • The $vdc variable contains the Organization vDC object where the vApp will be restored. The vDC object is obtained with Find-VBRvCloudEntity ([-OrganizationVdc]) and assigned to the variable beforehand.
  • The PowerUp parameter is set to True to start the vApp automatically right after the restore.

PS C:\PS> $restoreparams = New-VBRvCloudVAppRestoreSettings -RestorePoint $restorepoint -vAppName "vApp01" -OrgVdc $Org

Here you get the $restorepoint variable containing the vApp settings:

  • vAppOib - the restore point of the vApp,
  • OrgVdc - the organization vDataCenter where the vApp is registered,
  • Vms - the list of VMs whithin the vApp,
  • vAppName - the name of the vApp.

vAppOib          OrgVdc            Vms              vAppName
-------          ------            ---              --------
Veeam.Bacvup..   Veeam.Backup... {Veeam.Backup...   vApp01

You can view the properties of the VMs within the vApp by typing "$restoreparams.vms":

  • VmOib - the VM restorepoint,
  • StorageProfile - the VM storage profile,
  • vCloudDatastore - the datastore that the VM uses,
  • VmTemplate - the VM template.

VmOib      StorageProfile    vCloudDatastore        VmTemplate
-----      --------------    ---------------        ----------
Veeam...   Name: 'Storag...  Veeam.Backup.CV...

You need to specify the new organization to where you want to restore the vApp. The new organization object is assigned to the $org variable. All other VM parameters are set to null.

PS C:\PS> $restoreparams = New-VBRvCloudVAppRestoreSettings -RestorePoint
$restorepoint -OrgVdc $Org

PS C:\PS> $restoreparams.vms[0].vCloudDatastore=$null

PS C:\PS> $restoreparams.vms[0].StorageProfile=$null

PS C:\PS> $restoreparams.vms[0].VmTemplate=$null

The $restoreparams variable now contains the data needed for the restore and can be used in the Start-VBRvCloudRestoreVApp cmdlet.

Related Commands

Get-VBRRestorePoint

Find-VBRvCloudEntity ([-OrganizationVdc])

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation