Start-DPMCloudRecatalog

Recatalogs a cloud recovery point.

Syntax

Start-DPMCloudRecatalog
     [-RecoverableItem] <RecoverableObject[]>
     [-JobStateChangedEventHandler <JobStateChangedEventHandler>]
     [-RecoveryNotification <NotificationObject>]
     [-AdhocJobsContext <AdhocJobsContext>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

The Start-DPMCloudRecatalog cmdlet starts to recatalog a point in time version of a System Center 2016 - Data Protection Manager (DPM) cloud recovery point.

Examples

Example 1: Recatalog a version of a cloud recovery point

PS C:\>$RPoints = Get-DPMProtectionGroup | Where {$_.Name -like "ProtectionGroup06"} | Get-DPMDatasource | Get-DPMRecoveryPoint -Online
PS C:\> Start-CloudRecatalog -RecoverableItem $RPoints[1]

The first command gets a protection group by using the Get-DPMProtectionGroup cmdlet. That cmdlet gets all protection groups, and then passes them to the Where-Object cmdlet by using the pipeline operator. That cmdlet drops all groups that do not match its criteria. For more information, type Get-Help Where-Object.

The command then passes the protection group to the Get-DPMDatasource cmdlet, which gets the data sources for that protection group.

The command then passes the data source to the Get-DPMRecoveryPoint cmdlet, which gets all available recovery points for the data source. The command stores the recovery points in the $RPoints variable.

The second command starts to recatalog the version of a cloud recovery point stored in position one (1) of $RPoints.

Required Parameters

-RecoverableItem

Specifies a recoverable item object. This is a child item in a recovery point that is recoverable. For example, a file system share or volume, a Microsoft SQL Server database, a Microsoft Exchange Server storage group, Microsoft SharePoint, Microsoft Virtual Machine, a Microsoft DPM database, system state, or a recovery point.

Type:RecoverableObject[]
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-AdhocJobsContext

Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.

Type:AdhocJobsContext
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
-RecoveryNotification

Specifies a notification to send when recovery is finished. You can use the New-DPMRecoveryNotification cmdlet to create a notification object.

Type:NotificationObject
Position:Named
Default value:None
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False