---
title: "Restore-VBRUnstructuredBackupFLRItem"
description: "This cmdlet restores specific files and folders backed up by file backup jobs or object storage backup jobs. The cmdlet will restore files and folders to original file shares or object storage."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/restore-vbrunstructuredbackupflritem.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > Restore-VBRUnstructuredBackupFLRItem"
dateModified: "2026-08-20"
---

# Restore-VBRUnstructuredBackupFLRItem

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

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

## Syntax
```
Restore-VBRUnstructuredBackupFLRItem -Item <VBRUnstructuredBackupFLRItem[]> [-Overwrite] [-RunAsync]
 [-ChangedItemsOnly] [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet restores specific files and folders backed up by file backup jobs or object storage backup jobs. The cmdlet will restore files and folders to original 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">ChangedItemsOnly</span></p>
        </td>
        <td>
          <p>Defines whether to restore changed files and folders only.</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">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 objects. The cmdlet will restore these objects to the original file share or object storage.</p><p>Accepts the <code>VBRUnstructuredBackupFLRItem[]</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">Overwrite</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will overwrite an existing object with the restored one.</p><p>If you provide this parameter, the cmdlet will overwrite an existing object on the file share or object storage server with the version of an object from a backup. Otherwise, an existing object will not be overwritten.</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>
    </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 contains information on backed-up objects that have been restored to original file shares or object storage.

## Examples

::: example
### Example 1. Restoring all Versions of Objects to File Share

This example shows how to restore specific versions of files and folders to the original file share. Veeam Backup & Replication will not overwrite files and folders that are already added to a file share with versions of these files and folders from a backup.

```
$restorepoint = Get-VBRUnstructuredBackupRestorePoint
$session = Start-VBRUnstructuredBackupFLRSession -RestorePoint $restorepoint
$files = Get-VBRUnstructuredBackupFLRItem -Session $session
$fileversion = Get-VBRUnstructuredBackupFLRItemVersion -Item $files
Restore-VBRUnstructuredBackupFLRItem -Item $fileversion[0]
```

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-VBRUnstructuredBackupFLRItem`](get-vbrunstructuredbackupflritem.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Save the result to the `$files` variable.
4. Run the [`Get-VBRUnstructuredBackupFLRItemVersion`](get-vbrunstructuredbackupflritemversion.md) cmdlet. Set the `$files` variable as the `Item` parameter value. Save the result to the `$fileversion` variable.
5. Run the `Restore-VBRUnstructuredBackupFLRItem` cmdlet. Set the `$fileversion` variable as the `Item` parameter value.

:::

::: example
### Example 2. Restoring Specific Restore Point of Objects to File Share

This example shows how to restore files and folders to the specific restore point.Veeam Backup & Replication will overwrite files and folders that are already added to a file share with versions of these files and folders from a backup.

```
$restorepoint = Get-VBRUnstructuredBackupRestorePoint
$session = Start-VBRUnstructuredBackupFLRSession -RestorePoint $restorepoint[3]
$files = Get-VBRUnstructuredBackupFLRItem -Session $session
Restore-VBRUnstructuredBackupFLRItem -Item $files -Overwrite
```

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-VBRUnstructuredBackupFLRItem`](get-vbrunstructuredbackupflritem.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Save the result to the `$files` variable.
4. Run the `Restore-VBRUnstructuredBackupFLRItem` cmdlet. Set the `$files` variable as the `Item` parameter value. Provide the `Overwrite` parameter.

:::

## Related Commands

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