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 -RecreatePath
This 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[]
Outputs
Related Links
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour