---
title: "Start-VBRObjectStorageBackupRestore"
description: "This cmdlet starts restore of backups created by an object storage backup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrobjectstoragebackuprestore.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > Start-VBRObjectStorageBackupRestore"
dateModified: "2026-08-20"
---

# Start-VBRObjectStorageBackupRestore

## Short Description
Starts restore of backups created by an object storage backup job.

**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-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint>
 [-DestinationServer <VBRUnstructuredServer>] [-RollBack]
 [-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DifferentLocation</code></p>

```
Start-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint>
 [-DestinationServer <VBRUnstructuredServer>] [-DestinationFolderPath <String>] [-RollBack]
 [-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>NewBucket</code></p>

```
Start-VBRObjectStorageBackupRestore -RestorePoint <VBRUnstructuredBackupRestorePoint>
 [-DestinationServer <VBRUnstructuredServer>] [-NewBucketName <String>] [-RegionId <String>] [-RollBack]
 [-OverwriteMode <VBRUnstructuredBackupRestoreOverwriteMode>] [-OverwriteBucketAttributes] [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts restore of backups created by an object storage backup job.

## 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">DestinationFolderPath</span></p>
        </td>
        <td>
          <p>Specifies the path to the folder on the file share. The cmdlet will restore backups to the specified folder.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">DestinationServer</span></p>
        </td>
        <td>
          <p>Specifies a target object storage. The cmdlet will start restore to recover objects to this 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>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 backups created by an object storage backup job 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">NewBucketName</span></p>
        </td>
        <td>
          <p>Specifies a new name for the bucket.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">OverwriteBucketAttributes</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will overwrite the bucket attributes.</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">OverwriteMode</span></p>
        </td>
        <td>
          <p>Specifies restore options for objects, that you want to restore if they are already added to the target object storage. You can select one of the following restore options:</p><ul><li><code>Leave:</code> use this option if you do not want to overwrite the existing object version with the restored object version. The cmdlet will keep the existing object version on the target object storage.</li><li><code>Overwrite:</code> use this option if you want to overwrite the existing object version with the restored object version.</li><li><code>OverwriteIfOlder:</code> use this option if the backed-up object version is newer than the existing object version on the object storage. The cmdlet will overwrite the existing object versions with the backed-up object versions.</li></ul><p><strong>Note</strong>: You must specify either this or the <code>RollBack</code> parameter.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupRestoreOverwriteMode</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">RegionId</span></p>
        </td>
        <td>
          <p>Specifies the ID of the region.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies a restore point. The cmdlet will start restore to recover objects to the specified restore point.</p><p>Accepts the <code>VBRUnstructuredBackupRestorePoint</code> object. To get this object, run the <a href="get-vbrunstructuredbackuprestorepoint.md"><code>Get-VBRUnstructuredBackupRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupRestorePoint</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">RetrievalSettings</span></p>
        </td>
        <td>
          <p>Specifies the retrieval policy settings. The cmdlet will use these settings to retrieve data from archive 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">RollBack</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will roll back objects that have been modified to a previous version. Objects, that have not been modified will remain unchanged.</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>
    </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 `VBRObjectStorageBackupRestore` object that contains settings of a restore session that runs to restore backups created by an object storage backup job.

## Examples

::: example
### Starting Restore of Backups Created by Object Storage Backup Jobs

This example shows how to start restore of backups created by an object storage backup job.

```
$objectbackup = Get-VBRUnstructuredBackup -Name 'ObjectBackup'
$restorepoint = Get-VBRUnstructuredBackupRestorePoint -Backup $objectbackup
Start-VBRObjectStorageBackupRestore -RestorePoint $restorepoint -OverwriteBucketAttributes -OverwriteMode Overwrite
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredBackup`](get-vbrunstructuredbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$objectbackup` variable.
2. Run the [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md) cmdlet. Specify the `Backup` parameter value. Save the result to the `$restorepoint` variable.
3. Run the `Start-VBRObjectStorageBackupRestore` cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Provide the `OverwriteBucketAttributes` parameter. Set the `Overwrite` option for the `OverwriteMode` parameter.

:::

## Related Commands

- [`Get-VBRUnstructuredBackup`](get-vbrunstructuredbackup.md)
- [`Get-VBRUnstructuredBackupRestorePoint`](get-vbrunstructuredbackuprestorepoint.md)