Short Description
Restores physical disks 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>] |
Detailed Description
This cmdlet restores physical disks from Veeam Agent for Microsoft Windows volume level backups and converts them to VMDK, VHDX or VHD format. The data from the backups is restored as a folder to a selected path. If the Veeam Agent for Microsoft Windows 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 Veeam Agent for Microsoft Windows volume level backups. | True | 1 | True (ByValue, | 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. Default: all. | False | Named | True (ByProperty | False |
Reason | Specifies 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 example shows how to restore all disks from a Veeam Agent for Microsoft Windows backup to Veeam backup server. The disks are restored to the latest restore point. The resulting format is VMDK.
- Run Get-VBRLocalhost to get the Veeam backup server. Save it to the $server variable.
- Get the most recent restore point. Run Get-VBRRestorePoint and filter the array of restore points with Sort-Object method by the "CreationTime" property. Save the result to the $restorepoint variable.
- Run Start-VBRRestoreVirtualDisks with the $restorepoint and $server variables.
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 example shows how to restore selected disks to a Windows server added to Veeam Backup & Replication. The disks are restored to the latest restore point. The resulting format is VHDX.
- Get the most recent restore point. Run Get-VBRRestorePoint and filter the array of restore points with Sort-Object method by the "CreationTime" property. Save the result to the $restorepoint variable.
- Run Get-VBRServer to get the server and save it to the $server variable.
- Run Get-VBRFilesInRestorePoint to get the disks in the backup. Save the result to the $disks variable. In this example, disks 1 and 3 will be restored.
- Run Start-VBRRestoreVirtualDisks. Use the $restorepoint, $server and $disks variables.
PS C:\PS> $restorepoint = Get-VBRBackup -Name "Backup Job SRV03" | Get-VBRRestorePoint | 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 |
Related Commands