Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Returns a detailed list of data for a DPM recovery point.
Parameter Set: Default
Start-DPMOnlineRecatalog [-RecoveryPoint] <RecoverySource> [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryPointLocation <RecoverySourceLocation> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
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.
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 |
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 |
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 |
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
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 |
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).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
- Job
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