Start-DPMOnlineRecatalog
Returns a detailed list of data for a DPM recovery point.
Syntax
Default (Default)
Start-DPMOnlineRecatalog
[-RecoveryPoint] <RecoverySource>
[-RecoveryPointLocation <RecoverySourceLocation>]
[-JobStateChangedEventHandler <JobStateChangedEventHandler>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Start-DPMOnlineRecatalog cmdlet returns details of data for a System Center - Data Protection Manager (DPM) recovery point. You can use this information to perform partial recoveries or recovery of selected files.
Examples
Example 1: Start online catalog
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
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.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-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.
Parameter properties
| Type: | JobStateChangedEventHandler |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Handler |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RecoveryPoint
Specifies a recovery point for which this cmdlet starts to catalog. To obtain a recovery point object, use the Get-DPMRecoveryPoint cmdlet.
Parameter properties
| Type: | RecoverySource |
| 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 |
-RecoveryPointLocation
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.
Parameter properties
| Type: | RecoverySourceLocation |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| 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.