Start-DPMOnlineRecatalog

Returns a detailed list of data for a DPM recovery point.

Syntax

Start-DPMOnlineRecatalog [-RecoveryPoint] <RecoverySource>
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryPointLocation <RecoverySourceLocation>]
 [-Confirm] [-WhatIf] [<CommonParameters>]

Description

The Start-DPMOnlineRecatalog cmdlet returns details of data for a System Center 2016 - 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

-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.

Type:JobStateChangedEventHandler
Aliases:Handler
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecoveryPoint

Specifies a recovery point for which this cmdlet starts to catalog. To obtain a recovery point object, use the Get-DPMRecoveryPoint cmdlet.

Type:RecoverySource
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters: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.

Type:RecoverySourceLocation
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.

Type:SwitchParameter
Aliases:cf
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.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Job