Start-VBRUnstructuredBackupFLRSession

Short Description

Starts a restore session to explore objects backed-up by file backup jobs and object storage backup jobs.

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 a restore of files, folders or individual objects.

Start-VBRUnstructuredBackupFLRSession -Backup <VBRUnstructuredBackup> -Server <VBRUnstructuredServer>  [<CommonParameters>]

  • Start a restore of files, folders or individual objects. This parameter set recovers backup files or objects to the specified restore point.

Start-VBRUnstructuredBackupFLRSession -RestorePoint <VBRUnstructuredBackupRestorePoint>  [<CommonParameters>]

Detailed Description

This cmdlet mounts backup content and allows you to restore files, folders and objects that are backed-up by file backup jobs or object storage backup jobs. You can mount backup content to one of the following options:

  • Mount backup to the specific restore point.
  • Mount all versions of backup files that are located on the specific file share or object storage. The cmdlet will mount all versions of backup files that are located on the short-term and long-term repositories.

You might want to use this mount session to restore specifics files and folders that are backed-up by file backup jobs and object storage backup jobs.

Run the Get-VBRUnstructuredBackupFLRItem cmdlet to get items that you want to restore.

Run the Restore-VBRUnstructuredBackupFLRItem cmdlet to restore the necessary files and folders.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Backup

Specifies the backup file. The cmdlet will start a file-level restore to recover all versions of a backup file that is located on the short-term and long-term repositories.

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

True

Named

True (ByPropertyName

Server

Specifies file shares or object storage. The cmdlet will start a restore of files, folders or individual objects. This parameter set recovers backup files or objects to the specified restore point.

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

True

Named

True (ByValue, ByPropertyName)

RestorePoint

Specifies a restore point. The cmdlet will start a restore of files, folders or individual objects. This parameter set recovers backup files or objects to the specified restore point.

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

True

Named

True (ByValue, ByPropertyName)

<CommonParameters>

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

Output Object

The cmdlet returns the VBRUnstructuredBackupFLRSession object that contains settings of restore sessions that are started to perform a file-level restore of backups that are created by file backup jobs and object storage backup jobs.

Examples

Start-VBRUnstructuredBackupFLRSessionExample 1. Restoring Backups on Specific Object Storage

This example shows how to start a file-level restore of backups that are located on a specific file share.

$backup = Get-VBRUnstructuredBackup

$server = Get-VBRUnstructuredServer -Backup $backup

Start-VBRUnstructuredBackupFLRSession -Backup $backup -Server $server

Perform the following steps:

  1. Run the Get-VBRUnstructuredBackup cmdlet. Save the result to the $backup variable.
  2. Run the Get-VBRUnstructuredServer cmdlet. Specify the Backup parameter. Save the result to the $server variable.
  3. Run the Start-VBRUnstructuredBackupFLRSession cmdlet. Set the $backup variable as the Backup parameter value. Set the $server variable as the Server parameter value.

Start-VBRUnstructuredBackupFLRSessionExample 2. Restoring Backups to Specific Restore Point

This example shows how to start a file-level restore of backups to a specific restore point.

$restorepoint = Get-VBRUnstructuredBackupRestorePoint

Start-VBRUnstructuredBackupFLRSession -RestorePoint $restorepoint[3]

Perform the following steps:

  1. Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Save the result to the $restorepoint variable.

The Get-VBRUnstructuredBackupRestorePoint 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).

  1. Run the Start-VBRUnstructuredBackupFLRSession cmdlet. Set the $restorepoint[3] variable as the RestorePoint parameter value.

Related Commands