---
title: "Start-VBRTapeRestoreFiles (obsolete)"
description: "This cmdlet starts restoring files from backup copied to tape. You can restore file to its most recent state or to any of its backup version. The versions of files are used as restore points."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrtaperestorefiles.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Obsolete Cmdlets > Start-VBRTapeRestoreFiles (obsolete)"
dateModified: "2026-08-19"
---

# Start-VBRTapeRestoreFiles

## Short Description
Starts files restore from tape.

::: note

This cmdlet is obsolete. The cmdlet will still work but it is recommended to perform the tape restore operation with Veeam Backup & Replication UI for full functionality

:::

**Platform**: VMware, Hyper-V

## Syntax
```
Start-VBRTapeRestoreFiles [-Files <CatalogueFile[]>] [-Version <CatalogueFileVersion[]>] -Server <CHost>
 -Path <String> [-PreserveHierarhy] [-Overwrite <RestoreOverwrite>] [-Security] [-RunAsync] [<CommonParameters>]
```

## Detailed Description
This cmdlet starts restoring files from backup copied to tape. You can restore file to its most recent state or to any of its backup version. The versions of files are used as restore points.

## 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">Files</span></p>
        </td>
        <td>
          <p>Specifies the files to restore. The most recent file version is used.</p><p>Accepts the <code>CatalogueFile[]</code> object. To get this object, run the <a href="find-vbrtapecatalog.md"><code>Find-VBRTapeCatalog</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CatalogueFile[]</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">Overwrite</span></p>
        </td>
        <td>
          <p>Specifies the overwrite options in case the file exists on the target side:</p><ul><li><code>None</code> — leave the original file</li><li><code>Newer</code> — overwrite the file if the restore file in newer</li><li><code>Always</code> — overwrite the existing file</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>RestoreOverwrite</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 files to restore.</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">PreserveHierarhy</span></p>
        </td>
        <td>
          <p>If indicated, the files and folders will be restored in respect to the original folder hierarchy. Otherwise all files and folders are restored into a plain sequence.</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">Security</span></p>
        </td>
        <td>
          <p>If indicated, the files will be restored with with the original security settings. Otherwise the file/folder security settings will be inherited from parent item.</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 source host where the files to restore are located.</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Version</span></p>
        </td>
        <td>
          <p>Specifies the version of the files you want to restore.</p><p>Accepts the <code>CatalogueFileVersion[]</code> object. To get this object, run the <a href="find-vbrtapecatalogversion.md"><code>Find-VBRTapeCatalogVersion</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CatalogueFileVersion[]</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>
    </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 File from Tape [Using Pipeline]

This example shows how to start restoring the `VM01 Backup Job 1.vbm` file.

```
$server = Get-VBRServer -Name "srv001"
Find-VBRTapeCatalog -Name "VM01 Backup Job 1.vbm" | Start-VBRTapeRestoreFiles -Server $server -Path "C:\backup\Backup Job 1\VM01 Backup Job 1.vbm" -PreserveHierarhy -Overwrite Newer -Security -RunAsync
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`Find-VBRTapeCatalog`](find-vbrtapecatalog.md) cmdlet. Specify the `Name` parameter value.
3. Pipe the cmdlet output to the `Start-VBRTapeRestoreFiles` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.
   - Provide the `PreserveHierarhy` parameter value.
   - Set the `Newer` option for the `Overwrite` parameter.
   - Provide the `Security` parameter value.
   - Provide the `RunAsync` parameter value.

:::

::: example
### Example 2. Restoring Specific Version of File from Tape [Using Variable]

This example shows how to restore a specific version of the `VM01 Backup Job 1.vbm` file.

```
$file = Find-VBRTapeCatalog -Name "VM01 Backup Job 1.vbm" 
$fileversion = Find-VBRTapeCatalogVersion -CatalogFile $file
$server = Get-VBRServer -Name "srv001"
Start-VBRTapeRestoreFiles -Version $fileversion -Server $server -Path "C:\backup\Backup Job 1\VM01 Backup Job 1.vbm" -PreserveHierarhy -Overwrite Always
```

Perform the following steps:

1. Run the [`Find-VBRTapeCatalog`](find-vbrtapecatalog.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$file` variable.
2. Run the [`Find-VBRTapeCatalogVersion`](find-vbrtapecatalogversion.md) cmdlet. Set the `$file` variable as the `CatalogFile` parameter value. Save the result to the `$fileversion` variable.
3. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
4. Pipe the cmdlet output to the `Start-VBRTapeRestoreFiles` cmdlet. Specify the following settings:

   - Set the `$fileversion` variable as the `Version` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.
   - Provide the `PreserveHierarhy` parameter value.
   - Set the `Always` option for the `Overwrite` parameter.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRTapeCatalog`](find-vbrtapecatalog.md)
- [`Find-VBRTapeCatalogVersion`](find-vbrtapecatalogversion.md)