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

# Start-VBRNasBackupRestore

## Short Description
Starts restore of backups created by the file 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-VBRNasBackupRestore -RestorePoint <VBRNASBackupRestorePoint> [-PreservePermissions] [-RollBack]
 [-OverwriteMode <VBRNASBackupRestoreOverwriteMode>] [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DifferentLocation</code></p>

```
Start-VBRNasBackupRestore -RestorePoint <VBRNASBackupRestorePoint> -DestinationServer <VBRUnstructuredServer>
 -DestinationFolderPath <String> [-PreservePermissions] [-PreserveHierarchy] [-RollBack]
 [-OverwriteMode <VBRNASBackupRestoreOverwriteMode>] [-RunAsync]
 [-RetrievalSettings <VBRUnstructuredBackupColdStorageRetrievalSettings>] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts restore of backups created by the file 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>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">DestinationServer</span></p>
        </td>
        <td>
          <p>Specifies a target file share. The cmdlet will start restore to recover backup files to this file share.</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>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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore backups created by the file 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">OverwriteMode</span></p>
        </td>
        <td>
          <p>Specifies restore options for files, that you want to restore if they are already added to the target file share. You can select either of the following restore options:</p><ul><li><code>Leave:</code> use this option if you do not want to overwrite the existing file version with the restored file version. The cmdlet will keep the existing file version on the target file share.</li><li><code>Overwrite:</code> use this option if you want to overwrite the existing file version with the restored file version.</li><li><code>OverwriteIfOlder:</code> use this option if the backed-up file version is newer than the existing file version on the file share. The cmdlet will overwrite the existing file versions with the backed-up file 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>VBRNASBackupRestoreOverwriteMode</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">PreserveHierarchy</span></p>
        </td>
        <td>
          <p>For restore to a different location.</p><p>Defines that the cmdlet will restore the hierarchy of recovered backups.</p><p>If you provide this parameter, the cmdlet will restore hierarchy of recovered backups. Otherwise, the folder hierarchy of backups will not be recovered.</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">PreservePermissions</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore permissions and security attributes of recovered backups.</p><p>If you provide this parameter, the cmdlet will restore backup files with security attributes and permissions set by the user. Otherwise, permissions and security attributes of restored backups will not be recovered.</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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies a restore point. The cmdlet will start restore to recover backup files to the specified restore point.</p><p>Accepts the <code>VBRNASBackupRestorePoint</code> object. To get this object, run the <a href="get-vbrnasbackuprestorepoint.md"><code>Get-VBRNASBackupRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnasbackuprestorepoint.md"><code>VBRNASBackupRestorePoint</code></a></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 backup files that have been modified to a previous version. Files, that have not been modified will remain unchanged.</p><p>If you provide this parameter, the cmdlet will roll back the modified backup files. Otherwise, the cmdlet will restore the latest version of files that have been modified.</p><p><strong>Note</strong>: You must specify either this or the <code>OverwriteMode</code> parameter.</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 `VBRNasBackupRestore` object that contains settings of restore sessions that are started to recover backups created by file backup jobs.

## Examples

::: example
### Example 1. Restoring Backups to Original Location

This example shows how to restore backup files to the original location. The backups will be restored with the following settings:

- Veeam Backup & Replication will restore permissions of restored files.
- Veeam Backup & Replication will overwrite the existing file versions with the restored file versions.

```
$restorepoint = Get-VBRNASBackupRestorePoint
Start-VBRNasBackupRestore -RestorePoint $restorepoint -PreservePermissions -OverwriteMode Overwrite
Restore Type       VM Name                    State      Start Time             End Time               Description
------------       -------                    -----      ----------             --------               -----------
NasRestore         \\FileShare09\Reports      Stopped    9/5/2019 7:13:52 AM    9/5/2019 7:14:12 AM
```

Perform the following steps:

1. Run the [`Get-VBRNASBackupRestorePoint`](get-vbrnasbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRNasBackupRestore` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
   - Provide the `PreservePermissions` parameter.
   - Set the `Overwrite` option as the `OverwriteMode` parameter value.

3. The cmdlet output will contain the following details on the restore session: `Restore Type`, `VM Name`, `State`, `Start` `Time`, `End` `Time`, `Description`.

:::

::: example
### Example 2. Restoring Backups to Different Location

This example shows how to restore backup files to the `\\SMBSRV\Documents\` server. The backups will be restored with the following settings:

- Veeam Backup & Replication will restore permissions of restored files.
- Veeam Backup & Replication will restore the hierarchy of restored files.
- Veeam Backup & Replication will restore backup files to the `\\SMBSRV\Documents\restored` folder.
- Veeam Backup & Replication will keep the existing file version on the target file share.

```
$restorepoint = Get-VBRNASBackupRestorePoint
$destinationsrv = Get-VBRUnstructuredServer -Name "\\SMBSRV\Documents\"
Start-VBRNasBackupRestore -RestorePoint $restorepoint -DestinationServer $destinationsrv -DestinationFolderPath "\\SMBSRV\Documents\restored" -PreservePermissions -PreserveHierarchy -OverwriteMode Leave
```

Perform the following steps:

1. Run the [`Get-VBRNASBackupRestorePoint`](get-vbrnasbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$destinationsrv` variable.
3. Run the `Start-VBRNasBackupRestore` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
   - Set the `$destinationsrv` variable as the `DestinationServer` parameter value.
   - Specify the `DestinationFolderPath` parameter value.
   - Provide the `PreservePermissions` parameter.
   - Provide the `PreserveHierarchy` parameter.
   - Set the `Leave` option for the `OverwriteMode` parameter.

:::

::: example
### Example 3. Restoring Corrupted Backups to Original Location

This example shows how to restore corrupted backup files to the original location.

```
$restorepoint = Get-VBRNASBackupRestorePoint
Start-VBRNasBackupRestore -RestorePoint $restorepoint -RollBack
Restore Type       VM Name                    State      Start Time             End Time               Description
------------       -------                    -----      ----------             --------               -----------
NasRestore         \\FileShare09\Reports      Stopped    9/5/2019 7:13:52 AM    9/5/2019 7:14:12 AM    UrgentRetore
```

Perform the following steps:

1. Run the [`Get-VBRNASBackupRestorePoint`](get-vbrnasbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRNasBackupRestore` cmdlet. Set the `$restorepoint` as the `RestorePoint` parameter value. Specify the `RollBack` parameter.

:::

::: example
### Example 4. Restoring Corrupted Backups to Different Location

This example shows how to restore corrupted backup files to the `\\SMBSRV\Documents\` server. The backups will be restored with the following settings:

- Veeam Backup & Replication will restore permissions of restored files.
- Veeam Backup & Replication will restore hierarchy of of restored files.
- Veeam Backup & Replication will restore backup files to the `\\SMBSRV\Documents\restored` folder.
- Veeam Backup & Replication will will keep the existing file version on the target file share.

```
$restorepoint = Get-VBRNASBackupRestorePoint
$destinationsrv = Get-VBRUnstructuredServer -Name "\\SMBSRV\Documents\"
Start-VBRNasBackupRestore -RestorePoint $restorepoint -DestinationServer $destinationsrv -DestinationFolderPath "\\SMBSRV\Documents\restored" -PreservePermissions -PreserveHierarchy -RollBack
```

Perform the following steps:

1. Run the [`Get-VBRNASBackupRestorePoint`](get-vbrnasbackuprestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$destinationsrv` variable.
3. Run the `Start-VBRNasBackupRestore` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
   - Set the `$destinationsrv` variable as the `DestinationServer` parameter value.
   - Specify the `DestinationFolderPath` parameter value.
   - Specify the `PreservePermissions` parameter.
   - Specify the `PreserveHierarchy` parameter.
   - Specify the `RollBack` parameter.

:::

## Related Commands

- [`Get-VBRNASBackupRestorePoint`](get-vbrnasbackuprestorepoint.md)
- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)