---
title: "Start-VBRTapeObjectStorageRestore"
description: "Starts the restore of objects from tape. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet starts the restore of objects backed-up by tape jobs."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrtapeobjectstoragerestore.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Jobs > Start-VBRTapeObjectStorageRestore"
dateModified: "2026-08-19"
---

# Start-VBRTapeObjectStorageRestore

## Short Description
Starts the restore of objects 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-VBRTapeObjectStorageRestore [-CatalogItem <VBRTapeCatalogItem[]>]
 [-CatalogItemVersion <VBRTapeCatalogItemVersion[]>] [-ItemRestorePolicy <VBRTapeCatalogItemRestorePolicy>]
 [-EnableItemSecurityRestore] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DifferentLocation</code></p>

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

## Detailed Description
This cmdlet starts the restore of objects 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 objects 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 objects to restore.</p><p>If this parameter is not specified, the cmdlet will restore the latest version of objects.</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 option for the restored objects 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 object already exists in the target folder:</p><ul><li><code>LeaveExisting</code>: use this option not to overwrite the existing object with the restored one.</li><li><code>OverwriteOlder</code>: use this option to overwrite the existing object only if it is older than the restored object.</li><li><code>AlwaysOverwrite</code>: use this option to overwrite the existing object with the restored object 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, objects will be restored to the specified target folder without keeping the folder structure.</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 Objects from Tape to Original Location

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

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

Perform the following steps:

1. Run the [`Find-VBRTapeCatalogItem`](find-vbrtapecatalogitem.md) cmdlet. Save the result to the `$item` variable.

   The `Find-VBRTapeCatalogItem` cmdlet will return an array of objects to restore. Mind the ordinal number of the necessary object (in our example, it is the fourth restore point in the array).

2. Run the `Start-VBRTapeObjectStorageRestore` cmdlet. Set the `$item[3]` variable as the `CatalogItem` parameter value.

:::

::: example
### Example 2.  Restoring Objects from Tape to Another Location

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

```
$host = Get-VBRServer -Name target.tech.local
$item = Find-VBRTapeCatalogItem
Start-VBRTapeObjectStorageRestore -Server $host -Path "C:\Backup restore\Azure Blob Container" -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.

   The `Find-VBRTapeCatalogItem` cmdlet will return an array of objects to restore. Mind the ordinal number of the necessary object (in our example, it is the fourth restore point in the array).

3. Run the `Start-VBRTapeObjectStorageRestore` 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.

:::

::: example
### Example 3.  Restoring Objects from Tape to Another Object Storage Location

This example shows how to start the restore of the `ABC Bucket` item to the `SDK Container` within Microsoft Azure Blob Storage.

```
$azure = Get-VBRServer -Name "Azure Blob Storage"
$item = Find-VBRTapeCatalogItem -Name "ABC Bucket"
Start-VBRTapeObjectStorageRestore -Server $azure -Path "<ObjectStorageHostPath><Region>Azure Global (Standard)</Region><Container>SDK Container</Container><RelativePath></RelativePath><Delimiter>/</Delimiter><IsObject>False</IsObject></ObjectStorageHostPath>" -CatalogItem $item
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$azure` variable.
2. Run the [`Find-VBRTapeCatalogItem`](find-vbrtapecatalogitem.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$item` variable.
3. Run the `Start-VBRTapeObjectStorageRestore` cmdlet. Specify the following settings:

   - Set the `$azure` variable as the `Server` parameter value.
   - Specify the `Path` parameter value.
   - Set the `$item` variable as the `CatalogItem` parameter value.

:::

::: example
### Restoring Objects from Tape to Another Object Storage Location (XML)

If you restore to another storage or container, you must provide the path to this new location in the XML format. The format must have the following tags:

```
<ObjectStorageHostPath>
  <Region>Reqion_name</Region>
  <Container>Container_name</Container>
  <RelativePath>Prefix</RelativePath>
  <Delimiter>/</Delimiter>
  <IsObject>False</IsObject>
</ObjectStorageHostPath>
```

The path contains the following tags and parameters:

- **\<Region\>** — specifies a name of a region for the object storage. **Note**: If you do not have a name of a region, specify the asterisk sign `*`.
- **\<Container\>** — specifies the name of the container or bucket  to which you want to restore the object storage data.
- **\<RelativePath\>** — specifies the prefix for the restored objects. **Note**: Do not specify this tag when restoring objects to the root container or bucket.
- **\<Delimiter\>** — the value always must be `/`.
- **\<IsObject\>** — the value always must be `False`.

:::

## Related Commands

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