---
title: "Start-VBRvCloudRestoreVm"
description: "This cmdlet starts a restore session of a selected Cloud Director VM. With this cmdlet, you can perform the following recover scenarios: Restore to the original location Restore to another location Restore with different settings Secure restore of..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrvcloudrestorevm.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > Start-VBRvCloudRestoreVm"
dateModified: "2026-08-19"
---

# Start-VBRvCloudRestoreVm

## Short Description
Starts a Cloud Director VM restore.

**Platform**: VMware

**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-VBRvCloudRestoreVm [-RestorePoint] <COib> [-PowerUp] [-Reason <String>] [-RunAsync]
 [-EnableAntivirusScan] [-EnableYARAScan] [-YARAScanRule <String>] [-EnableEntireVolumeScan]
 [-VirusDetectionAction <VBRVirusDetectionAction>] [-EnableVmTagsRestore] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>DifferentLocation</code></p>

```
Start-VBRvCloudRestoreVm [-RestorePoint] <COib> -vApp <CVcdVappItem>
 [-StorageProfile <CVcdOrgVdcStorageProfile>] [-vCloudDatastore <CVcdDatastoreRestoreInfo>]
 [-VmTemplate <IVcdItem>] [-VMName <String>] [-PowerUp] [-Reason <String>] [-RunAsync] [-EnableAntivirusScan]
 [-EnableYARAScan] [-YARAScanRule <String>] [-EnableEntireVolumeScan]
 [-VirusDetectionAction <VBRVirusDetectionAction>] [-EnableVmTagsRestore] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts a restore session of a selected Cloud Director VM. With this cmdlet, you can perform the following recover scenarios:

- Restore to the original location
- Restore to another location
- Restore with different settings
- Secure restore of the selected restore point

To restore a VM to the original location you only need to select the required restore point. Be careful to specify the restore point of the VM, not the vApp which is not a valid value for this cmdlet. Veeam Backup & Replication gets all the information needed for restore from the restore point data.

You cannot restore multiple VM with one command, to restore several VMs you need to start a restore session for each one.

## 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>Defines that the cmdlet will perform secure restore. Veeam Backup & Replication will trigger the antivirus software to scan selected VMs 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>Enables the antivirus scan for all volumes of the infected restore point. Use this option if you want to perform secure restore with the following options:</p><ul><li>Continue machine scan after the first virus threat is found</li><li>Get the report on all virus threats</li></ul>
        </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">EnableVmTagsRestore</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore VM tags.</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">PowerUp</span></p>
        </td>
        <td>
          <p>If set, the VM will be powered up right after it is restored. Otherwise you will need to power up the VM manually.</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 the reason for performing restore of the selected VM.</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 the restore point of the VM. If you specify no other parameters of the VM, it will be restored with its initial settings, i.e. the datastore or VM template.</p><p>This parameter does not accept VM arrays.</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>0</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">StorageProfile</span></p>
        </td>
        <td>
          <p>Specifies the storage profile you want to apply to the restored VM.</p><p>Accepts the <code>CVcdOrgVdcStorageProfile</code> object. To get this object, run the <a href="find-vbrvcloudentity.md"><code>Find-VBRvCloudEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CVcdOrgVdcStorageProfile</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">vApp</span></p>
        </td>
        <td>
          <p>Specifies the vApp where to you want to restore the VM.</p><p>Accepts the <code>CVcdVappItem</code> object. To get this object, run the <a href="find-vbrvcloudentity.md"><code>Find-VBRvCloudEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CVcdVappItem</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">vCloudDatastore</span></p>
        </td>
        <td>
          <p>Specifies the datastore you want to use with the restored VM.</p><p>Accepts the <code>CVcdDatastoreRestoreInfo</code> object. To get this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CVcdDatastoreRestoreInfo</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">VirusDetectionAction</span></p>
        </td>
        <td>
          <p>For secure restore.</p><p>Specifies secure restore action when the virus threat is detected.</p><ul><li><code>DisableNetwork</code> — use this option if you want to restore VMs in safe state with disabled network adapters (NICs).</li><li><code>AbortRecovery</code> — use this option if you want to cancel the restore session.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRVirusDetectionAction</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">VMName</span></p>
        </td>
        <td>
          <p>Specifies the VM name you want to apply to the restored VM.</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">VmTemplate</span></p>
        </td>
        <td>
          <p>Specifies the template you want to apply to the restored VM.</p><p>Accepts the <code>IVcdItem</code> object. To get this object, run the <a href="find-vbrvcloudentity.md"><code>Find-VBRvCloudEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVcdItem</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).

## Examples

::: example
### Example 1. Starting Cloud VM Restore to Original Location

The example shows how to start a Cloud Director VM restore to the original location.

```
$restorepoint = Get-VBRRestorePoint
Start-VBRvCloudRestoreVm -RestorePoint $restorepoint[1]
```

Perform the following steps:

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

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

:::

::: example
### Example 2. Starting Cloud VM Restore to Another vApp

The example shows how to restore a VM to another vApp with another storage profile.

```
$restorepoint = Get-VBRRestorePoint
$vapp = Find-VBRvCloudEntity -VApp
$profile = Find-VBRvCloudEntity -StorageProfile
Start-VBRvCloudRestoreVm -RestorePoint $restorepoint -vApp $vapp -StorageProfile $profile
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.
2. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Provide the `VApp` parameter value. Save the result to the `$vapp` variable.
3. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Provide the `StorageProfile` parameter value. Save the result to the `$profile` variable.
4. Run the `Start-VBRvCloudRestoreVm` cmdlet. Set the `$restorepoint` as the `RestorePoint` parameter value. Set the `$vapp` as the `vApp` parameter value. Set the `$profile` as the `StorageProfile` parameter value.

:::

::: example
### Example 3. Starting Secure Cloud VM Restore

The example shows how to run secure restore of the selected VM. The job will run with the following settings:

- Veeam Backup & Replication will scan all volumes of the infected restore points.
- In case the infection is detected, Veeam Backup & Replication will restore the VM with disabled NIC.
- The `RunAsync` parameter is set to bring the process to the background.

```
$restorepoint = Get-VBRRestorePoint
Start-VBRvCloudRestoreVm -RestorePoint $restorepoint[1] -RunAsync -EnableAntivirusScan -EnableEntireVolumeScan -VirusDetectionAction DisableNetwork
```

Perform the following steps:

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

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
   - Provide the `RunAsync` parameter.
   - Provide the `EnableAntivirusScan` parameter.
   - Provide the `EnableEntireVolumeScan` parameter.
   - Set the `DisableNetwork` option for the `VirusDetectionAction` parameter.

:::

## Related Commands

- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md)