This is an archive version of the document. To get the most up-to-date information, see the current version.Start-VBRRestoreVirtualDisks
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
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 | Accept |
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 | 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 | 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 | 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 |
<CommonParameters>
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 |
