Start-VBRRestoreVirtualDisks

Short Description

Restores disks from backups of physical or virtual machines and converts them to the VMDK, VHD or VHDX formats.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Start-VBRRestoreVirtualDisks -RestorePoint <COib> -Server <CHost> -Path <string> -RestoreDiskType {Vmdk | Vhd | Vhdx} [-Datastore <VBRViDatastoreBase>] [-StorageFormat {Thin | Thick | EagerZeroedThick | Fixed | Dynamic}] [-Files <COIBFileInfo[]>] [-SourceShareCredentials <CCredentials>] [-TargetShareCredentials <CCredentials>] [-Reason <string>] [-EnableAntivirusScan] [-EnableYARAScan] [-YARAScanRule <String>] [-EnableEntireVolumeScan] [-ProceedToRecoveryIfThreatFound] [-RunAsync]  [<CommonParameters>]

Detailed Description

This cmdlet restores disks from backups of physical or virtual machines and converts them to the VMDK, VHD or VHDX formats.

The cmdlet allows you to scan the disks that you want to restore with the antivirus.

Run the Start-VBRRestoreVMFiles cmdlet to restore VM configuration files.

Note

In case the antivirus detects the virus threat, Veeam Backup & Replication will cancel the restore session.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

RestorePoint

Specifies the restore point from which you want to restore the disks.

You must select restore points only from Veeam Agent for Microsoft Windows volume-level backups.

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

True

1

True (ByValue,
ByProperty
Name)

Server

Specifies the Windows host to which the disks should be restored.

Accepts the CHost object. To get this object, run the Get-VBRServer cmdlet.

True

2

False

Path

Specifies the path to the folder on the target server. The cmdlet will register virtual disks in this folder.

String

True

3

False

RestoreDiskType

Specifies the format to which you want to convert the resulting virtual disk:

  • VHD
  • VHDX
  • VMDK

EVirtualDiskRestoreType

False

Named

False

StorageFormat

Specifies the format that will be used to convert the resulting virtual disk:

  • Thin: the resulting vmdk virtual disk will be thin.
  • Thick: the restresulting vmdk virtual disk will be thick lazy zeroed.
  • EagerZeroedThick: resulting vmdk virtual disk will be eager lazy zeroed.
  • Fixed: resulting vhd/vhdx virtual disk will be thick fixed.
  • Dynamic: resulting vhd/vhdx virtual disk will be dynamic.

Default: Source.

VBRStorageFormatType

False

Named

False

Datastore

Specifies a target datastore. The cmdlet will register converted disks to this datastore.

Note: You must provide the Path parameter to specify the path to the folder in the datastore where you want to keep the converted disks. You must create the necessary folder beforehand.

Accepts the VBRViDatastoreBase object. To get this object, run the Find-VBRViDatastore cmdlet.

False

Named

False

Files

Specifies the disks from the backup that you want to restore.

Default: all.

Accepts the COIBFileInfo[] object. To get this object, run the Get-VBRFilesInRestorePoint cmdlet.

False

Named

True (ByProperty
Name)

SourceShareCredentials

Specifies the credentials for the backup repository. The cmdlet will export the backup from this repository.

Accepts the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.

False

Named

False

TargetShareCredentials

Specifies the credentials for the shared folder. The cmdlet will add the exported files to that folder.

Accepts the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.

False

Named

False

Reason

Specifies the reason for performing the disk restore.

String

False

Named

False

EnableAntivirusScan

Enables the secure restore option. Veeam Backup & Replication will trigger the antivirus software to scan selected machines before the restore.

SwitchParameter

False

Named

False

EnableYARAScan

Enables the YARA scan for the selected VMs.

Use the YARAScanRule parameter to specify the YARA rule to be used.

SwitchParameter

False

Named

False

YARAScanRule

Specifies the YARA rule. Veeam Backup & Replication will scan VMs with this rule.

Veeam Backup & Replication searches for YARA rules in the YaraRules folder. The default path is: C:\Program Files\Veeam\Backup and Replication\Backup\YaraRules.

To use a YARA rule, you must specify its name and extension. Veeam Backup & Replication accepts only .yar and .yara extensions.

String

False

Named

False

EnableEntireVolumeScan

For secure restore.

Enables the option for the antivirus to continue physical discs scan after the first virus threat is found. Use this option if you want to get the report on all virus threats.

SwitchParameter

False

Named

False

ProceedToRecoveryIfThreatFound

For secure restore.

Defines that if antivirus detects malware, the cmdlet will restore physical disks.

SwitchParameter

False

Named

False

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

None.

Examples

Start-VBRRestoreVirtualDisksExample 1. Restoring All Physical Disks from Volume-Level Backups by Veeam Agent

Start-VBRRestoreVirtualDisksExample 2. Restoring Specified Disks to Windows Server

Start-VBRRestoreVirtualDisksExample 3. Restoring Specified Disks to ESXi Host

Related Commands

Page updated 12/11/2024

Page content applies to build 12.3.1.1139