This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRRestoreVirtualDisks

In this article

Short Description

Restores physical disks from Endpoint backups to virtual disk formats.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Start-VBRRestoreVirtualDisks [-RestorePoint] <COib> [-Server] <CHost> [-Path] <string> -RestoreDiskType <EVirtualDiskRestoreType> {Vmdk | Vhd | Vhdx} [-Files <COIBFileInfo[]>] [-Reason <string>] [-RunAsync] [<CommonParameters>]

Related Commands

Get-VBRRestorePoint

Get-VBRServer

Get-VBRFilesInRestorePoint

Detailed Description

This cmdlet allows you to restore physical disks from Endpoint volume level backups and convert them to VMDK, VHDX or VHD format. The data from the backups is restored as a folder to a selected path.

You can restore disks to any Windows host added to Veeam Backup & Replication.

If the Endpoint backup contains several disks, you can restore specific disks from backup. Use the Files parameter to select the disks to restore.

For virtual disks restore, run Start-VBRRestoreVMFiles.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
RestorePoint	Specifies the restore point from which you want to restore the disks. You must select restore points only from Endpoint volume level backups.	True	1	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
Server	Specifies the Windows host to which the disks should be restored.	True	2	False	False
Path	Specifies the path to the folder on the server where the virtual disks must be placed.	True	3	False	False
RestoreDisk Type	Specifies the format to which you want to convert the resulting virtual disk: VHD, VHDX, VMDK.	True	Named	False	False
Files	Specifies the disks from the backup you want to restore. By default, all disks from the backup will be restored.	False	Named	True (ByName)	False
Reason	Specifies the string with the reason for performing the disk restore.	False	Named	False	False
RunAsync	Indicates that the command returns immediately without waiting for the task to complete.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command restores all disks from an SRV03 Endpoint backup to Veeam backup server. The disks are restored to the latest restore point. The resulting format is VMDK.

The Veeam backup server is obtained by Get-VBRLocalhost and assigned to the '$server' variable.
The restore point is obtained by Get-VBRRestorePoint. The restore points are filtered with Sort-Object method by the "CreationTime" property to get the most recent one. The restore point is assigned to the '$restorepoint' variable.
The path to the folder where files will be saved is ''C:\SRV03_Restored'.
The RestoreDiskType is set to 'Vmdk'.

The RunAsync parameter is set to bring the process to the background.

PS C:\PS> $server = Get-VBRLocalhost

PS C:\PS> $restorepoint = Get-VBRBackup -Name "Backup Job SRV03" | Get-VBRRestorePoint | Sort-Object -Property CreationTime | Select-Object -First 1

PS C:\PS> Start-VBRRestoreVirtualDisks -RestorePoint $restorepoint -Server $server -Path "C:\SRV03_Restored" -RestoreDiskType Vmdk -RunAsync

Example 2

This command restores selected disks from an SRV03 computer to a Windows server added to Veeam Backup & Replication. The disks are restored to the latest restore point. The resulting format is VHDX.

The restore point is obtained with Get-VBRRestorePoint. First, all Hyper-V backups are selected by filtering all backups with ".BackupPlatform" property. Then, the available restore points are filtered by the 'SRV03' name by Type property. Then the restore points are sorted with Sort-Object method by the "CreationTime" property to get the most recent one.
The target server is obtained with Get-VBRServer and assigned to the '$server' variable.
The path to the folder where files will be saved is ''C:\SRV03_Restored'.
The RestoreDiskType is set to 'Vhdx'.
The disks in the backup are obtained with Get-VBRFilesInRestorePoint and assigned to the '$disks' variable. The needed disks 1 and 3 will be restored.

The RunAsync parameter is set to bring the process to the background.

PS C:\PS> $restorepoint = Get-VBRBackup | Where { $_.IsBackup -and $_.BackupPlatform -eq 'EHyperV' } | Get-VBRRestorePoint | Where { $_.Name -eq 'SRV03' -and $_.Type -eq 'Full' } | Sort-Object -Property CreationTime | Select-Object -First 1

PS C:\PS> $server = Get-VBRServer -Type Windows -Name "Veeam_Remote"

PS C:\PS> $disks = Get-VBRFilesInRestorePoint -RestorePoint $restorepoint

PS C:\PS> Start-VBRRestoreVirtualDisks -RestorePoint $restorepoint -Server $server -Path "C:\SRV03_Restored" -RestoreDiskType Vhdx -Files $disks[1,3] -RunAsync