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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
ControllerNumber	Specifies a controller number for VM virtual disks. The cmdlet will set the specified controller number to the VM virtual disks. Maximum allowed value: `3`.	`Int32`	False	Named	False
Type	Specifies a virtual device node type. You can specify one of the following virtual device node types: `SCSI` `SATA` `NVME` `IDE`	`VBRViVirtualDeviceType`	False	Named	False
VirtualDevice	Specifies VM virtual disks. The cmdlet will modify settings of these VM disks. Accepts the `VBRViVirtualDevice` object. To get this object, run the `Get-VBRViVirtualDevice` cmdlet.	`VBRViVirtualDevice`	True	0	True (ByPropertyName, ByValue)
VirtualDeviceNode	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.	`Int32`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

This cmdlet returns the VBRViVirtualDevice object that contains details on virtual disks of VMs from backups.

Examples

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:

Get the restore point:
1. Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
2. Run the Get-VBRRestorePoint 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.
Run the Get-VBRViVirtualDevice 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.
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.