Restore-WBCatalog
Restores a backup catalog for the local computer from a storage location.
Syntax
Default (Default)
Restore-WBCatalog
[-BackupTarget] <WBBackupTarget>
[-Force]
[<CommonParameters>]
Description
The Restore-WBCatalog cmdlet restores a backup catalog for the local computer from a storage location that you specify.
If the location (disk, DVD, or remote shared folder) where you store your backups is damaged or lost and you cannot use it to restore the backup catalog, use this cmdlet to remove the corrupted catalog. Then create a new backup after the cmdlet finishes removing your backup catalog.
Examples
Example 1: Restore a backup catalog
PS C:\> Restore-WBCatalog -BackupTarget $Bt -Force
3 backups found in the specified target.
WARNING: The backup information on this location has details of backups created
up to 12/8/2011 11:41:38 AM. You may not be able to access backups created
after this date when the catalog recovery operation completes.
The catalog has been successfully recovered.
This command recovers the backup catalog from the backup target stored in the variable named $Bt. The cmdlet displays a warning that gives details about the backups present in the backup target. The cmdlet also displays a message that confirms that it has successfully recovered the catalog.
Parameters
-BackupTarget
Specifies a backup target object that contains the storage location where backups from which the cmdlet restores the catalog reside.
Parameter properties
| Type: | WBBackupTarget |
| 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 |
-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: | 1 |
| 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.
Inputs
Microsoft.Windows.ServerBackup.Commands.WBBackupTarget
Specifies a backup target object from which to restore the catalog. Use the Force parameter to suppress the confirmation message.