Start-WBFileRecovery
Starts a file recovery operation.
Syntax
Default (Default)
Start-WBFileRecovery
[-BackupSet] <WBBackupSet>
[-SourcePath] <String>
[[-TargetPath] <String>]
[[-Option] <WBFileRecoveryOptions>]
[-Recursive]
[-NoRestoreAcl]
[-Async]
[-Force]
[<CommonParameters>]
Description
The Start-WBFileRecovery cmdlet starts a file recovery operation. For file recovery, you must specify the backup set from which to recover the file, along with the file that you want to recover.
To browse the volumes in backup, use the Get-WBBackupVolumeBrowsePath cmdlet.
Examples
Example 1 :Recover files to their original location
PS C:\> Start-WBFileRecovery -BackupSet $Backup -FilePathToRecover "C:\Dir1" -Recursive -FileRecoveryOption CreateCopyIfExists -Force
Recovering files from C:\Dir1 :
Completed.
This command recovers the file at the path C:\Dir1 from the backup set named $Backup and restores it to its original location. Because the command includes the Force parameter, the backup proceeds without confirmation prompts.
Example 2: Recover files to a new location
PS C:\> Get-WBBackupVolumeBrowsePath -BackupSet $Backup -VolumeInBackup $Backup.Volume[0]
\\Server01\WsbMountedVolumes\WsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963\ PS C:\> dir \\Server01\WsbMountedVolumes\WsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963\dir1\File1.txt
Directory: \\Server01\WsbMountedVolumes\WsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963\dir1
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 12/13/2011 2:35 PM 0 File1.txt PS C:\> Start-WBFileRecovery -BackupSet $Backup -FilePathToRecover "\\Server01\WsbMountedVolumes\WsbMountedVolumeFile46_6fc68703-1c22-11e1-89cd-806e6f6e6963\Dir1\File1.txt" -RecoveryTarget "F:\Dir1"
Warning
Start recovery of files from C:\Dir1\File1.txt to F:\Fir1 ?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Recovering files from C:\Dir1\File1.txt :
Completed.
This example recovers the file named C:\Dir1\File1.txt to the alternate location F:\Dir1.
The first command uses the Get-WBBackupVolumeBrowsePath cmdlet to get the volume browse path for the file that you recover. The first element of the Volume array within the backup set stored in the variable named $Backup specifies the volume from which to obtain the backup files.
The second command checks the path that you obtained from the first command for a file named File1.txt.
The third command restores the file named File1.txt to the path F:\Dir1.
Parameters
-Async
Indicates that Windows PowerShell® returns immediately after it starts the backup and does not display status messages.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 6 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BackupSet
Specifies a backup set object that contains the backup set from which this cmdlet recover files.
Parameter properties
| Type: | WBBackupSet |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Forces the command to run without asking for user confirmation.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 7 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-NoRestoreAcl
Indicates that the cmdlet does not restore the security attributes for the files after recovery.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 6 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Option
Specifies an object that contains file recovery options. The options specify the action to take when a file that you recover already exists in the same location. The acceptable values for this parameter are:
- SkipIfExists: Causes Windows Server Backup to skip the existing file and continue with recovery of the next file.
- CreateCopyIfExists: Causes Windows Server Backup to create a copy of the existing file and not overwrite it.
- OverwriteIfExists: Causes Windows Server Backup to overwrite the existing file with the file from the backup.
If you do not specify this parameter, the cmdlet uses the CreateCopyIfExists option by default.
Parameter properties
| Type: | WBFileRecoveryOptions |
| Default value: | None |
| Accepted values: | Default, SkipIfExists, CreateCopyIfExists, OverwriteIfExists |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Recursive
Indicates that Windows Server Backup recovers the files from the folders that you specify along with files in folders that are subordinate to those folders. By default, the backup operation recovers only files that reside directly under the specified folders.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 6 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SourcePath
Specifies the file path that this cmdlet recovers from the backup. You can prefix the file path with a volume browse path that you get from the Get-WBBackupVolumeBrowsePath cmdlet.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TargetPath
Specifies the location where recovered files reside after the recovery. If you do not specify this parameter, the backup operation recovers files to their original locations.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.