Start-WBHyperVRecovery
Starts recovery of a Hyper-V Server 2016 virtual machine.
Syntax
Start-WBHyperVRecovery
[-BackupSet] <WBBackupSet>
[-VMInBackup] <WBVirtualMachine[]>
[[-TargetPath] <String>]
[-NoRollForward]
[-Async]
[-Force]
[-UseAlternateLocation]
[-RecreatePath]
[<CommonParameters>] Description
The Start-WBHyperVRecovery cmdlet starts a recovery operation for a Hyper-V virtual machine. Use the application array from a WBBackupSet object to specify the virtual machines that you want to recover.
For an overview of Hyper-V, see Hyper-V Overview on TechNet.
Examples
Example 1: Recover a virtual machine to its original location
PS C:\> $Backup = Get-WBBackupSet
PS C:\> Start-WBHyperVRecovery -BackupSet $Backup -VMInBackup $Backup.Application[0].Component[0]This example recovers a virtual machine to its original location.
The first command gets the backup set object from the system catalog and stores it in the variable named $Backup.
The second command uses the backup set stored in $Backup to recover a virtual machine that has the ID 285CEA9B-E337-44E1-9BF9-BF431BC3EB35 to its original location.
Example 2: Recover a virtual machine to an alternate location
PS C:\> $Backup = Get-WBBackupSet
PS C:\> Start-WBHyperVRecovery -BackupSet $Backup -VMInBackup $Backup.Application[0].Component[1] -TargetPath "F:\Dir1" -UseAlternateLocation -RecreatePathThis example recovers a virtual machine to an alternate location.
The first command gets the backup set object from the system catalog and stores it in the variable named $Backup.
The second command recovers the virtual machine that has the ID F7D8AAF4-D086-47CC-8264-61F80527BFF4 to an alternate location.
Parameters
-Async
Indicates that Windows PowerShell returns immediately after it starts the recovery and does not display status messages.
| Type: | SwitchParameter |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupSet
Specifies a backup set object that contains a Hyper-V application backup.
| Type: | WBBackupSet |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Forces the command to run without asking for user confirmation.
| Type: | SwitchParameter |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoRollForward
Indicates that this cmdlet recovers a virtual machine from a previous point in time if you select the latest version of the application from the backups. For versions of the application other than the latest version, the operation uses point-in-time recovery by default.
| Type: | SwitchParameter |
| Position: | 3 |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecreatePath
Indicates that the recovery operation recreates the original folder structure when it restores a virtual machine. This option applies only if you recover a virtual machine to an alternate location. If you do not specify this option, the recovery puts all files for a component under a single folder.
| Type: | SwitchParameter |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetPath
Specifies an alternate location in the backup set where the recovery process searches for files.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateLocation
Indicates that you can use the recovery process to recover Hyper-V components, update configuration, and register the virtual machine with the Hyper-V management service. This option applies only if you recover a virtual machine to an alternate location.
| Type: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMInBackup
Specifies a list of virtual machine objects that contain the virtual machines to recover. This list must contain virtual machines from the Hyper-V application object in the backup set's application array.
| Type: | WBVirtualMachine[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Inputs
Microsoft.Windows.ServerBackup.Commands.WBBackupSet
Microsoft.Windows.ServerBackup.Commands.WBVirtualMachine[]