Recover-RecoverableItem
Recover-RecoverableItem
Recovers a version of the data source to a target location.
Syntax
Recover-RecoverableItem [-RecoveryOption] <RecoveryOption> [[-RecoverableItem] <RecoverableObject>] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <Notification>] [-RecoveryPointLocation <RecoverySourceLocation>] [<CommonParameters>]
Detailed Description
The Recover-RecoverableItem cmdlet recovers a point in time version of a data source (recovery point) or a child recoverable item within it to the target location.
Parameters
-RecoveryOption
Encapsulates the user's protection intent while performing a recovery based on the recovery source and recovery type. This object is built using the New-RecoveryOption cmdlet.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
0 |
-RecoverableItem
A child item within a recovery point that can be recovered. For example, a Windows file system share or volume, a Microsoft SQL Server database, a Microsoft Exchange storage group, a Microsoft SharePoint, Microsoft Virtual Machine, a Microsoft DPM database, a system state, or a recovery point.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
1 |
-JobStateChangedEventHandler
The JobStateChangedEventHandler is used along with the -Async parameter so that the user can be informed of the status of the operation. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RecoveryNotification
Notifies you when recovery has been completed. The notification object is returned by the New-NotificationObject cmdlet.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RecoveryPointLocation
The location of the recovery point. This is necessary if a recovery item exists in more than one location for the same point in time. For example, on a disk and tape or on two tapes.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Recover-RecoverableItem -detailed".
For technical information, type "Get-Help Recover-RecoverableItem -full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.
Examples
EXAMPLE 1
$rp = Get-RecoveryPoint -Datasource $ds
$rop = New-RecoveryOption -TargetServer test.contoso.com -RecoveryLocation copytofolder -FileSystem -AlternateLocation "f:\restore" -OverwriteType overwrite -RestoreSecurity -RecoveryType Restore
Recover-RecoverableItem -RecoverableItem $rp -RecoveryOption $rop
This command recovers the entire recovery point specified.