---
title: "Start-VBRComputerVolumeRestore"
description: "Starts restore to original location of computer volumes backed-up with Veeam Agent for Microsoft Windows. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet starts restore to original location of computer volu"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrcomputervolumerestore.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Restoring Data from Veeam Agent Backups > Restoring Volumes > Start-VBRComputerVolumeRestore"
dateModified: "2026-08-19"
---

# Start-VBRComputerVolumeRestore

## Short Description
Starts restore to original location of computer volumes backed-up with Veeam Agent for Microsoft Windows.

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

## Syntax
```
Start-VBRComputerVolumeRestore -RestorePoint <COib> [-Volumes <VBRComputerDiskPartition[]>]
 [-EnableAntivirusScan] [-EnableYARAScan] [-YARAScanRule <String>] [-EnableEntireVolumeScan] [-Reason <String>]
 [-Force] [-RunAsync] [<CommonParameters>]
```

## Detailed Description
This cmdlet starts restore to original location of computer volumes backed-up with Veeam Agent for Microsoft Windows.

::: important

Consider the following:

- The cmdlet does not support the disk mapping option. All disks are restored to the original location.
- Restore of system OS volumes to original location is not supported.

:::

## 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">EnableAntivirusScan</span></p>
        </td>
        <td>
          <p>Enables the option to perform secure restore.</p><p>If you provide this parameter, Veeam Backup & Replication will trigger the antivirus software to scan selected computer volumes before the restore.</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">EnableEntireVolumeScan</span></p>
        </td>
        <td>
          <p>For secure restore.</p><p>Defines that the antivirus will continue computer volumes scan after the first virus threat is found. If you provide this parameter, the cmdlet will generate a report on all virus threats.</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">EnableYARAScan</span></p>
        </td>
        <td>
          <p>Enables the YARA scan for the selected VMs.</p><p>Use the <code>YARAScanRule</code> parameter to specify the YARA rule to be used.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will start restore 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">Reason</span></p>
        </td>
        <td>
          <p>Specifies a reason of volume-level restore.</p><p>The information you provide will be saved in the session history so that you can reference it later.</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 of computers. The cmdlet will restore volumes these computers.</p><p>Accepts the <code>COib</code> object. To get this object, run the <a href="get-vbrrestorepoint.md"><code>Get-VBRRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>COib</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">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">Volumes</span></p>
        </td>
        <td>
          <p>Specifies an array of computer volumes that you want to restore.</p><p>Accepts the <code>VBRComputerDiskPartition</code>[] object. To get this object, run the <a href="get-vbrcomputerdiskpartition.md"><code>Get-VBRComputerDiskPartition</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerDiskPartition[]</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">YARAScanRule</span></p>
        </td>
        <td>
          <p>Specifies the YARA rule. Veeam Backup & Replication will scan VMs with this rule.</p><p>Veeam Backup & Replication searches for YARA rules in the <code>YaraRules</code> folder. The default path is: <code>C:\Program Files\Veeam\Backup and Replication\Backup\YaraRules</code>.</p><p>To use a YARA rule, you must specify its name and extension. Veeam Backup & Replication accepts only <code>.yar</code> and <code>.yara</code> extensions.</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>
    </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
[`VBRSession`](vbrsession.md)

## Examples

::: example
### Starting Restore to Original Location of Computer Volumes Backed-Up with Veeam Agent for Microsoft Windows

This example shows how to start a volume-level restore of the `WinLaptop2017` computer.

```
$backup = Get-VBRBackup -Name "WinLaptop2017*"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$volume = Get-VBRComputerDiskPartition -RestorePoint $restorepoint[3]
Start-VBRComputerVolumeRestore -RestorePoint $restorepoint[3] -Volumes $volume[2] -EnableAntivirusScan -EnableEntireVolumeScan -Force
```

Perform the following steps:

1. Get the restore point:

   1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.

      **Note**: To get a list of restore points for a Veeam Agent job, you must provide the asterisks sign for the `Name` parameter value: `Name "AgentJob*"`. Otherwise, the `Get-VBRRestorePoint` cmdlet will not return any restore points for the Veeam Agent job.

   2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.

      The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore point in the array).

2. Run the [`Get-VBRComputerDiskPartition`](get-vbrcomputerdiskpartition.md) cmdlet. Set the `$restorepoint[3]` variable as the `RestorePoint` parameter value. Save the result to the `$volume` variable.

   The `Get-VBRComputerDiskPartition` cmdlet will return an array of volumes. Mind the ordinal number of the necessary volumes (in our example, it is the third volume in the array).

3. Run the `Start-VBRComputerVolumeRestore` cmdlet. Specify the following settings: 

   - Set the `$restorepoint[3]` variable as the `RestorePoint` parameter value.
   - Set the `$volume[2]` variable as the `Volumes` parameter value.
   - Provide the `EnableAntivirusScan` parameter.
   - Provide the `EnableEntireVolumeScan` parameter.
   - Provide the `Force` parameter.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Get-VBRComputerDiskPartition`](get-vbrcomputerdiskpartition.md)