---
title: "Set-VBRViVirtualDevice"
description: "This cmdlet modifies settings of VM virtual disks. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrvivirtualdevice.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Instant VM Disk Recovery > Set-VBRViVirtualDevice"
dateModified: "2026-08-19"
---

# Set-VBRViVirtualDevice

## Short Description
Modifies settings of VM virtual disks.

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

## Syntax
```
Set-VBRViVirtualDevice [-VirtualDevice] <VBRViVirtualDevice> [-ControllerNumber <Int32>]
 [-Type <VBRViVirtualDeviceType>] [-VirtualDeviceNode <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of VM virtual disks.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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">ControllerNumber</span></p>
        </td>
        <td>
          <p>Specifies a controller number for VM virtual disks. The cmdlet will set the specified controller number to the VM virtual disks.</p><p>Maximum allowed value: <code>3</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">Type</span></p>
        </td>
        <td>
          <p>Specifies a virtual device node type. You can specify one of the following virtual device node types:</p><ul><li><code>SCSI</code></li><li><code>SATA</code></li><li><code>NVME</code></li><li><code>IDE</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualDeviceType</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">VirtualDevice</span></p>
        </td>
        <td>
          <p>Specifies VM virtual disks. The cmdlet will modify settings of these VM disks.</p><p>Accepts the <code>VBRViVirtualDevice</code> object. To get this object, run the <a href="get-vbrvivirtualdevice.md"><code>Get-VBRViVirtualDevice</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualDevice</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">VirtualDeviceNode</span></p>
        </td>
        <td>
          <p>Specifies a number of a virtual device node. The cmdlet will set the VM virtual disk with the specified number of a virtual device node.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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
This cmdlet returns the `VBRViVirtualDevice` object that contains details on virtual disks of VMs from backups.

## Examples

::: example
### Modifying VM Virtual Disk Settings

This cmdlet modifies the following settings for VM virtual disks and sets it to the SCSI 0:5. The controller number is set to 0. The number of a virtual device node is set to 5.

```
$backup = Get-VBRBackup -Name "Winsrv4515"
$restorepoint = Get-VBRRestorePoint
$disk = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]
Set-VBRViVirtualDevice -VirtualDevice $disk -ControllerNumber 0 -Type SCSI -VirtualDeviceNode 5
```

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.
   2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Save the result to the `$restorepoint` variable.

      The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the fourth restore point is used.

2. Run the [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value.  Save the result to the `$disk` variable.

   The cmdlet output will contain the following details on VM virtual disks: `ControllerNumber`, `Type`, `VirtualDeviceNode`, `VirtualDeviceCapacityGB` and `Name`.

3. Run the `Set-VBRViVirtualDevice` cmdlet. Specify the following settings:

   - Set the `$disk` variable as the `VirtualDevice` parameter value. 
   - Specify the `ControllerNumber` parameter value.
   - Set the `SCSI` option for the `Type` parameter.
   - Specify the `VirtualDeviceNode` parameter value.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md)