---
title: "Start-VBRTapeFileRestore"
description: "Starts the restore of files and folders from tape. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: OriginalLocation (Default) DifferentLocation This cmdlet starts the "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrtapefilerestore.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Jobs > Start-VBRTapeFileRestore"
dateModified: "2026-08-19"
---

# Start-VBRTapeFileRestore

## Short Description
Starts the restore of files and folders from tape.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>OriginalLocation (Default)</code></p>

```
Start-VBRTapeFileRestore [-CatalogItem <VBRTapeCatalogItem[]>]
 [-CatalogItemVersion <VBRTapeCatalogItemVersion[]>] [-ItemRestorePolicy <VBRTapeCatalogItemRestorePolicy>]
 [-EnableItemSecurityRestore] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DifferentLocation</code></p>

```
Start-VBRTapeFileRestore [-CatalogItem <VBRTapeCatalogItem[]>]
 [-CatalogItemVersion <VBRTapeCatalogItemVersion[]>] -Server <CHost> -Path <String> [-PreserveFolderHierarchy]
 [-ItemRestorePolicy <VBRTapeCatalogItemRestorePolicy>] [-EnableItemSecurityRestore] [-RunAsync] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts the restore of files and folders backed-up by tape jobs.

## 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">CatalogItem</span></p>
        </td>
        <td>
          <p>Specifies an array of files or folders to restore.</p><p>Accepts the <code>VBRTapeCatalogItem[]</code> object. To get this object, run the <a href="find-vbrtapecatalogitem.md"><code>Find-VBRTapeCatalogItem</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRTapeCatalogItem[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">CatalogItemVersion</span></p>
        </td>
        <td>
          <p>Specifies an array of versions of files or folders to restore.</p><p>If this parameter is not specified, the cmdlet will restore the latest version of files or folders.</p><p>Accepts the <code>VBRTapeCatalogItemVersion[]</code> object. To get this object, run the <a href="find-vbrtapecatalogitemversion.md"><code>Find-VBRTapeCatalogItemVersion</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRTapeCatalogItemVersion[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">EnableItemSecurityRestore</span></p>
        </td>
        <td>
          <p>Enables the <code>Restore file and folder security</code> option: use it if you want the restored files to keep their original ownership and security permissions. Otherwise, Veeam Backup & Replication will change security settings: the user account under which the Veeam Backup Service runs will be set as the owner of the restored objects, while access permissions will be inherited from the target folder to which the objects are restored.</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">ItemRestorePolicy</span></p>
        </td>
        <td>
          <p>Specifies overwrite options to use in case the file already exists in the target folder:</p><ul><li><code>LeaveExisting</code>: use this option not to overwrite the existing file with the restored one.</li><li><code>OverwriteOlder</code>: use this option to overwrite the existing file only if it is older than the restored file.</li><li><code>AlwaysOverwrite</code>: use this option to overwrite the existing file with the restored file in all cases.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRTapeCatalogItemRestorePolicy</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">Path</span></p>
        </td>
        <td>
          <p>Specifies the path to the folder on the destination server to restore data to.</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">PreserveFolderHierarchy</span></p>
        </td>
        <td>
          <p>If you provide this parameter, the cmdlet will preserve the folder hierarchy of restored data.</p><p>Otherwise, files will be restored to the specified target folder without keeping the folder structure.</p><p><strong>Note</strong>: Do not use this parameter when restoring NDMP volumes.</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">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 the server to restore data to.</p><p>Accepts the <code>CHost</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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).

## Examples

::: example
### Example 1. Restoring to Original Location Items Backed-Up by Tape Jobs

This example shows how to start the restore to original location files and folders backed-up by tape jobs.

```
$item = Find-VBRTapeCatalogItem 
Start-VBRTapeFileRestore -CatalogItem $item[3]
```

Perform the following steps:

1. Run the [`Find-VBRTapeCatalogItem`](find-vbrtapecatalogitem.md) cmdlet. Save the result to the `$item` variable.
2. Run the `Start-VBRTapeFileRestore` cmdlet. Set the `$item[3]` variable as the `CatalogItem` parameter value.

:::

::: example
### Example 2.  Restoring to Another Location Items Backed-Up by Tape Jobs

This example shows how to start the restore to another location files and folders backed-up by tape jobs.

```
$host = Get-VBRServer -Name target.tech.local
$item = Find-VBRTapeCatalogItem 
Start-VBRTapeFileRestore -Server $host -Path "C:\Backup restore\Fileserv05" -CatalogItem $item[3]
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$host` variable.
2. Run the [`Find-VBRTapeCatalogItem`](find-vbrtapecatalogitem.md) cmdlet. Save the result to the `$item` variable.
3. Run the `Start-VBRTapeFileRestore` cmdlet. Set the `$host` variable as the `Server` parameter value. Specify the `Path` parameter value. Set the `$item[3]` variable as the `CatalogItem` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRTapeCatalogItem`](find-vbrtapecatalogitem.md)