Export (0) Print
Expand All

Start-WBSystemStateRecovery

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-WBSystemStateRecovery

Starts a system state recovery operation.

Syntax

Parameter Set: SSR
Start-WBSystemStateRecovery [-BackupSet] <WBBackupSet> [[-TargetPath] <String> ] [[-AuthoritativeSysvolRecovery]] [[-RestartComputer]] [[-Async]] [[-Force]] [ <CommonParameters>]

Parameter Set: ADIFM
Start-WBSystemStateRecovery [-BackupSet] <WBBackupSet> [-ADIFM] [-TargetPath] <String> [[-Async]] [[-Force]] [ <CommonParameters>]




Detailed Description

The Start-WBSystemStateRecovery cmdlet starts a system state recovery operation. If the System State recovery operation is performed on the actual machine, completion of the operation requires a restart. If recovery is performed on an Active Directory (AD) machine, this cmdlet must be run in Directory Services Restore Mode (DSRM).

Parameters

-ADIFM

Indicates an install from media (IFM) operation to recover all the related data needed for Active Directory Domain Services. Active Directory Install From Media (ADIFM) creates a copy of the Active Directory database, registry, and SYSVOL state, and then saves this information in the location specified by RecoveryTarget. Use this parameter only when RecoveryTarget is specified. This parameter is valid only if the backup set contains an Active Directory system state backup.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Async

Indicates that Windows PowerShell return immediately after starting the backup, and not output status to the screen.


Aliases

none

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AuthoritativeSysvolRecovery

Indicates an authoritative recovery of SYSVOL, the System Volume shared directory. This parameter is valid only if the backup set contains an Active Directory system state backup.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-BackupSet<WBBackupSet>

Specifies the backup set from which system state recovery is to be done.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Force

Starts the system state recovery 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

-RestartComputer

Indicates a system restart at the completion of the system state recovery operation. Use this parameter only for a recovery to the original location. Do not use this parameter if you need to perform steps after the recovery operation.


Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetPath<String>

Specifies an alternate location where the files belonging to system state can be recovered from the backup set. If you do not specify this parameter, system state recovery is performed for the actual machine, which will need a reboot at the end of the operation. ADIFM recovery requires this parameter.


Aliases

none

Required?

true

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

    Specifies the backup set that contains volume backup of all the system critical volumes, or contains backup of the system state for the system state recovery operation.


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 outputs status at periodic intervals until the recovery operation completes. You can also call Get-WBJob to get the status of the current recovery operation. After completion of recovery, run Get-WBJob with the Previous parameter and an argument of 1to get the final recovery status.


Examples

Example 1: Start a system state recovery operation

This example starts a system state recovery operation, then reboots the machine at the end of the recovery operation.

The first command stores the result of Get-WBBackupSetin a variable named $Backup.

The second command starts the system state recovery from the backup set in $Backup. The command also uses the Force parameter to perform the recovery without prompting, the AutoReboot parameter to reboot the machine when recovery finishes, and the Async parameter to suppress status output.


PS C:\> $Backup = Get-WBBackupSet
PS C:\> Start-WBSystemStateRecovery -BackupSet $Backup -Force -AutoReboot -Async

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