Edit

Start-WBHyperVRecovery

  • Reference
Module:
WindowsServerBackup

Starts recovery of a hv_win8_2 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 (VM). Use the application array from a WBBackupSet object to specify the VMs that you want to recover.

For an overview of Hyper-V, see HyperV Overviewhttp://technet.microsoft.com/en-us/library/hh831531.aspx (http://technet.microsoft.com/en-us/library/hh831531.aspx) on TechNet.

Examples

Example 1: Recover a VM 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 VM 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 VM that has the ID 285CEA9B-E337-44E1-9BF9-BF431BC3EB35 to its original location.

Example 2: Recover a VM 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 VM 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 VM 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

Indicates that the cmdlet starts the recovery operation without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoRollForward

Indicates that you can recover a VM 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 VM. This option applies only if you recover a VM 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 VM with the Hyper-V management service. This option applies only if you recover a VM 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 VMs to recover. This list must contain VMs 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

WBBackupSet, WBVirtualMachine

Outputs

String