---
title: "Start-VBRUnstructuredBackupFLRSession"
description: "Starts a restore session to explore objects backed-up by file backup jobs and object storage backup jobs. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet m"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrunstructuredbackupflrsession.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > Start-VBRUnstructuredBackupFLRSession"
dateModified: "2026-08-20"
---

# Start-VBRUnstructuredBackupFLRSession

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

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>RestorePoint</code></p>

```
Start-VBRUnstructuredBackupFLRSession -RestorePoint <VBRUnstructuredBackupRestorePoint>
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>AllTime</code></p>

```
Start-VBRUnstructuredBackupFLRSession -Backup <VBRUnstructuredBackup> -Server <VBRUnstructuredServer>
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## 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`](get-vbrunstructuredbackupflritem.md) cmdlet to get items that you want to restore.

Run the [`Restore-VBRUnstructuredBackupFLRItem`](restore-vbrunstructuredbackupflritem.md) cmdlet to restore the necessary files and folders.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Backup</span></p>
        </td>
        <td>
          <p>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.</p><p>Accepts the  <code>VBRUnstructuredBackup</code> object. To get this object, run the <a href="get-vbrunstructuredbackup.md"><code>Get-VBRUnstructuredBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrunstructuredbackup.md"><code>VBRUnstructuredBackup</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will start a restore session without showing warnings in the PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestorePoint</span></p>
        </td>
        <td>
          <p>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.</p><p>Accepts the <code>VBRUnstructuredBackupRestorePoint</code> object. To get this object, run the <a href="get-vbrunstructuredbackuprestorepoint.md"><code>Get-VBRUnstructuredBackupRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupRestorePoint</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RetrievalSettings</span></p>
        </td>
        <td>
          <p>Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive repositories.</p><p><strong>Note</strong>: If you do not provide this parameter, the cmdlet will prompt you to use the default retrieval policy settings.</p><p>Accepts the <code>VBRUnstructuredBackupColdStorageRetrievalSettings</code> object. To create this object, run the <a href="new-vbrunstructuredbackupretrievalsettings.md"><code>New-VBRUnstructuredBackupColdStorageRetrievalSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupColdStorageRetrievalSettings</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>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.</p><p>Accepts the <code>VBRUnstructuredServer</code> object. To get this object, run the <a href="get-vbrunstructuredserver.md"><code>Get-VBRUnstructuredServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredServer</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## 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

::: example
### Example 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`](get-vbrunstructuredbackup.md) cmdlet. Save the result to the `$backup` variable.
2. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. 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.

:::

::: example
### Example 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`](get-vbrunstructuredbackuprestorepoint.md) 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).

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

:::

## Related Commands

- [`Get-VBRUnstructuredBackup`](get-vbrunstructuredbackup.md)
- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md)