---
title: "Save-VBRUnstructuredBackupFLRItem"
description: "This cmdlet restores objects backed up by file backup jobs or object storage backup jobs to the specified file shares or object storage."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/save-vbrunstructuredbackupflritem.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > Save-VBRUnstructuredBackupFLRItem"
dateModified: "2026-08-20"
---

# Save-VBRUnstructuredBackupFLRItem

## Short Description
Restores objects backed up by file backup jobs or object storage backup jobs to the specified file shares or object storage.

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

## Syntax
```
Save-VBRUnstructuredBackupFLRItem -Item <VBRUnstructuredBackupFLRItem[]> [-PreservePermissions]
 -Server <VBRUnstructuredServer> -Path <String> [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet restores objects backed up by file backup jobs or object storage backup jobs to the specified file shares or object storage.

## 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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore unstructured data backups 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">Item</span></p>
        </td>
        <td>
          <p>Specifies an array of backed-up object. The cmdlet will restore these objects to the file share.</p><p>[For restore of backups to the specific restore point]: Accepts the <code>VBRNASBackupFLRItem[]</code> object. To get this object, run the <a href="get-vbrunstructuredbackupflritem.md"><code>Get-VBRUnstructuredBackupFLRItem</code></a> cmdlet.</p><p>[For all versions of backups restore]: Accepts the <code>VBRUnstructuredBackupFLRItemVersion</code> object. To get this object, run the <a href="get-vbrunstructuredbackupflritemversion.md"><code>Get-VBRUnstructuredBackupFLRItemVersion</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupFLRItem[]</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">Path</span></p>
        </td>
        <td>
          <p>Specifies one of the location:</p><ul><li>[For file shares] a path to the folder.</li><li>[For object storage] a bucket, a container and prefixes inside the bucket or a container.</li></ul><p>The cmdlet will restore the backed-up object to that location.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">PreservePermissions</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore permissions and security attributes of objects that you want to save.</p><p>If you provide this parameter, the cmdlet will restore backup files with security attributes and permissions set by the user. Otherwise, permissions and security attributes of restored backups will not be recovered.</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">RetrievalSettings</span></p>
        </td>
        <td>
          <p>Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive object storage 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">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</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">Server</span></p>
        </td>
        <td>
          <p>Specifies a file share or object storage. The cmdlet will restore the backed-up object to this file share or object storage.</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>False</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 `VBRUnstructuredBackupFLRItem` object that contain settings of restored guest OS files and folders that have been backed up by file backup jobs or object storage backup jobs.

## Examples

::: example
### Example 1. Restoring All Objects to File Shares

This example shows how to restore all backed-up files and folders to the `\\WinSrv\Reports` file share. Veeam Backup & Replication will save files and folders to the `\\WinSrv\Reports\Restored` folder on the file share.

```
$restorepoint = Get-VBRUnstructuredBackupRestorePoint
$session = Start-VBRUnstructuredBackupFLRSession -RestorePoint $restorepoint
$fileshare = Get-VBRUnstructuredServer -Name "\\WinSrv\Reports"
$file = Get-VBRUnstructuredBackupFLRItem -Session $session
Save-VBRUnstructuredBackupFLRItem -Item $file -Server $fileshare -Path "\\WinSrv\Reports\Restored"
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the [`Start-VBRUnstructuredBackupFLRSession`](start-vbrunstructuredbackupflrsession.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$session` variable.
3. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$fileshare` variable.
4. Run the [`Get-VBRUnstructuredBackupFLRItem`](get-vbrunstructuredbackupflritem.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Save the result to the `$file` variable.
5. Run the `Save-VBRUnstructuredBackupFLRItem` cmdlet. Specify the following settings:

   - Set the `$file` variable as the `Item` parameter value.
   - Set the `$fileshare` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.

:::

::: example
### Example 2. Restoring Specific Folder to File Shares

This example shows how to restore the `October Reports` folder to the `\\WinSrv\Reports` file share. Veeam Backup & Replication will save files and folders to the `\\WinSrv\Reports\Restored` folder on the file share.

```
$restorepoint = Get-VBRUnstructuredBackupRestorePoint
$session = Start-VBRUnstructuredBackupFLRSession -RestorePoint $restorepoint
$fileshare = Get-VBRUnstructuredServer -Name "\\WinSrv\Reports"
$files = Get-VBRUnstructuredBackupFLRItem -Session $session -Name "October Reports"
Save-VBRUnstructuredBackupFLRItem -Item $files -Server $fileshare -Path "\\WinSrv\Reports\Restored"
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the [`Start-VBRUnstructuredBackupFLRSession`](start-vbrunstructuredbackupflrsession.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$session` variable.
3. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$fileshare` variable.
4. Run the [`Get-VBRUnstructuredBackupFLRItem`](get-vbrunstructuredbackupflritem.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `Name` parameter value. Save the result to the `$files` variable.
5. Run the `Save-VBRUnstructuredBackupFLRItem` cmdlet. Specify the following settings:

   - Set the `$files` variable as the `Item` parameter value.
   - Set the `$fileshare` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.

:::

## Related Commands

- [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md)
- [`Start-VBRUnstructuredBackupFLRSession`](start-vbrunstructuredbackupflrsession.md)
- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`Get-VBRUnstructuredBackupFLRItem`](get-vbrunstructuredbackupflritem.md)