Start-VBRObjectStorageBackupRestore

Short Description

Starts restore of backups created by an object storage backup job.

Note

This cmdlet is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Applies to

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Start restore of backups created by the file share backup job to original location.

Start-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint> [-DestinationServer <VBRUnstructuredServer>] [-RollBack] [-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync] [<CommonParameters>]

  • Start restore of backups created by an object storage backup job to another location.

Start-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint> [-DestinationServer <VBRUnstructuredServer>] [-DestinationFolderPath <String>] [-RollBack] [-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync] [<CommonParameters>]

  • Start restore of backups created by an object storage backup job to a new bucket.

Start-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint> [-DestinationServer <VBRUnstructuredServer>] [-NewBucketName <String>] [-RegionId <String>] [-RollBack][-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet starts restore of backups created by an object storage backup job.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoint

Specifies a restore point. The cmdlet will start restore to recover objects to the specified restore point.

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

True

Named

False

DestinationServer

Specifies a target object storage. The cmdlet will start restore to recover objects to this object storage.

Accepts the VBRUnstructuredServer object. To get this object, run the Get-VBRUnstructuredServer cmdlet.

False

Named

False

RollBack

Defines that the cmdlet will roll back objects that have been modified to a previous version. Objects, that have not been modified will remain unchanged.

SwitchParameter

False

Named

False

OverwriteMode

Specifies restore options for objects, that you want to restore if they are already added to the target object storage. You can select one of the following restore options:

  • Leave: use this option if you do not want to overwrite the existing object version with the restored object version. The cmdlet will keep the existing object version on the target object storge.
  • Overwrite: use this option if you want to overwrite the existing object version with the restored object version.
  • OverwriteIfOlder: use this option if the backed-up object version is newer than the existing object version on the object storage. The cmdlet will overwrite the existing object versions with the backed-up object versions.

Note: You must specify either this or the RollBack parameter.

VBRUnstructuredBackupRestoreOverwriteMode

False

Named

False

OverwriteBucketAttributes

Defines that the cmdlet will overwrite the bucket attributes.

SwitchParameter

False

Named

False

DestinationFolderPath

Specifies the path to the folder on the file share. The cmdlet will restore backups to the specified folder.

String

False

Named

False

NewBucketName

Specifies a new name for the bucket.

String

False

Named

False

RegionId

Specifies the ID of the region.

String

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 Microsoft Docs.

Output Object

The cmdlet returns the VBRObjectStorageBackupRestore object that contains settings of a restore session that runs to restore backups created by an object storage backup job.

Examples

Starting Restore of Backups Created by Object Storage Backup Jobs

This example shows how to start restore of backups created by an object storage backup job.

$objectbackup = Get-VBRUnstructuredBackup -Name 'ObjectBackup'

$restorepoint = Get-VBRUnstructuredBackupRestorePoint -Backup $objectbackup

Start-VBRObjectStorageBackupRestore -RestorePoint $restorepoint -OverwriteBucketAttributes -OverwriteMode Overwrite

Perform the following steps:

  1. Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $objectbackup variable.
  2. Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
  3. Run the Start-VBRObjectStorageBackupRestore cmdlet. Set the $restorepoint variable as the RestorePoint parameter value. Provide the OverwriteBucketAttributes parameter. Set the Overwrite option for the OverwriteMode parameter value.

Related Commands