Export (0) Print
Expand All

Start-WBApplicationRecovery

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Start-WBApplicationRecovery

Starts an application recovery operation.

Syntax

Parameter Set: Default
Start-WBApplicationRecovery [-BackupSet] <WBBackupSet> [-ApplicationInBackup] <WBApplication> [[-RecoveryTarget] <String> ] [[-NoRollForward]] [[-Async]] [[-Force]] [ <CommonParameters>]




Detailed Description

The Start-WBApplicationRecovery cmdlet starts an application recovery operation. To perform application recovery, you must specify the backup set from which to recover the application and the application to recover. The application to recover must exist in the application array for the backup set specified. If you do not specify a recovery target, the operation recovers the application to the application's original location.

Parameters

-ApplicationInBackup<WBApplication>

Specifies an application object that contains the application to recover. This application must exist in the backup set's application array.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Async

Indicates that Windows PowerShell returns immediately after starting the backup without displaying status messages to the console.


Aliases

none

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-BackupSet<WBBackupSet>

Specifies a backup set object that contains the backup set from which to recover the application.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Force

Starts the application recovery operation without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.


Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NoRollForward

Indicates that you can recover applications 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.


Aliases

none

Required?

false

Position?

4

Default Value

False

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RecoveryTarget<String>

Specifies the path to which the recovery operation recovers the application.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • WBBackupSet, WBApplication

Outputs

The output type is the type of the objects that the cmdlet emits.

  • System.String

    If you do not specify the Async parameter, the recovery operation displays status messages at periodic intervals until the recovery is complete. While the recovery operation is running, you can use the Get-WBJob cmdlet to get the status of the operation. After the operation is complete you can use the Get-WBJob -Previous 1 command to get the completed recovery status.


Examples

Example 1: Start an application recovery operation

This example recovers an application to a file path.

The first command gets the backup object from the system catalog and stores it in the variable named $Backup.

The second command starts the recovery by specifying $Backup as the backup set, and specifying the first element of the application array within the backup set. The first element of the application array is the registry.


PS C:\> $Backup = Get-WBBackupSet
PS C:\> Start-WBApplicationRecovery -BackupSet $Backup -ApplicationInBackup $Backup.Application[0] -RecoveryTarget F:\
Warning
Start recovery of application Registry to F:\ ?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
Recovering component Registry :
Recovering component Registry : Preparing to recover.
Completed. 

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft