Get-VBRViVirtualDevice

Short Description

Returns details on virtual disks of VMs from backups.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Get-VBRViVirtualDevice [-RestorePoint] <COib>  [<CommonParameters>]

Detailed Description

This cmdlet returns details on virtual disks of VMs from backups. The cmdlet will return details on the following types of virtual disks:

  • SCSI
  • SATA
  • NVME
  • IDE

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoint

Specifies a restore point of VMs. The cmdlet will return details on virtual disks of these VMs.

Accepts the COib object. To get this object, run the Get-VBRRestorePoint cmdlet.

True

0

True (ByValue, ByPropertyName)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

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

Examples

Getting Details on Virtual Disks

This example shows how to get details on virtual disks of the VM that is backed up by the Winsrv4515 backup job.

$backup = Get-VBRBackup -Name "Winsrv4515"

$restorepoint = Get-VBRRestorePoint -Backup $backup

Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]

ControllerNumber        : 0

Type                    : SCSI

VirtualDeviceNode       : 0

VirtualDeviceCapacityGB : 50.00

Name                    : Winsrv4515.vmdk

Perform the following steps:

  1. 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. Mind the ordinal number of the necessary restore point (in our example, it is the forth restore point in the array).

  1. Run the Get-VBRViVirtualDevice cmdlet. Set the $restorepoint variable as the RestorePoint parameter value.

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

Related Commands

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.