Start-DPMOnlineRecatalog
Start-DPMOnlineRecatalog
Returns a detailed list of data for a DPM recovery point.
Syntax
Parameter Set: Default
Start-DPMOnlineRecatalog [-RecoveryPoint] <RecoverySource> [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryPointLocation <RecoverySourceLocation> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Start-DPMOnlineRecatalog cmdlet returns details of data for a System Center 2012 – Data Protection Manager (DPM) recovery point. You can use this information to perform partial recoveries or recovery of selected files.
Parameters
-JobStateChangedEventHandler<JobStateChangedEventHandler>
Specifies an event handler for Job.StateChanged events. Use this parameter to build a graphical user interface based on cmdlets. Do not use this parameter in the DPM Management Shell.
Aliases |
Handler |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RecoveryPoint<RecoverySource>
Specifies a recovery point for which this cmdlet starts to catalog. To obtain a recovery point object, use the Get-DPMRecoveryPoint cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-RecoveryPointLocation<RecoverySourceLocation>
Specifies a recovery point location of the recovery points that this cmdlet gets. To obtain a recovery point location object, use the Get-DPMRecoveryPointLocation cmdlet. If a recovery item occurs in more than one recovery point, you must specify the location of recovery point.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- Job
Examples
Example 1: Start online catalog
The first command uses the Get-DPMProtectionGroup cmdlet to get a protection group for the DPM server named DPMServer07. The command stores the protection group in the $MPGroup variable.
The second command uses the Get-DPMDatasource cmdlet to get a data source for the protection group in $MPGroup, and then stores that data source in the $PObject variable.
The third command uses the Get-DPMRecoveryPoint cmdlet to get recovery points for the data source in $PObject, and then stores those recovery points in the $RPoints variable.
The fourth command uses the Get-DPMRecoveryPointLocation cmdlet to get a recovery point location for the recovery point in $RPoint, and stores the recovery point location object in the $RPLocation variable.
The fifth command starts a catalog action for a recovery point in $RPoints. The command uses standard array syntax to select the second member of that array. The command specifies the recovery point location as the object in $RPLocation.
PS C:\> $MPGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer07"
PS C:\> $PObject = Get-DPMDatasource -ProtectionGroup $MPGroup
PS C:\> $RPoints = Get-DPMRecoveryPoint -Datasource $PObject
PS C:\> $RPLocation = Get-DPMRecoveryPointLocation -RecoveryPoint $RPoint
PS C:\> Start-DPMOnlineRecatalog -RecoveryPoint $RPoints[1] -RecoveryPointLocation $RPLocation