Start-DPMOnlineRecatalog

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

Syntax

Start-DPMOnlineRecatalog
     [-RecoveryPoint] <RecoverySource>
     [-RecoveryPointLocation <RecoverySourceLocation>]
     [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
     [-WhatIf]
     [-Confirm]
     [<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.

Required Parameters

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:JobStateChangedEventHandler
Aliases:Handler
Position:Named
Default value:None
Accept pipeline input:False
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
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Outputs

Job