Start-DPMCloudRecatalog
Start-DPMCloudRecatalog
Recatalogs a cloud recovery point.
Syntax
Parameter Set: Default
Start-DPMCloudRecatalog [-RecoverableItem] <RecoverableObject[]> [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryNotification <NotificationObject]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Start-DPMCloudRecatalog cmdlet starts to recatalog a point in time version of a System Center 2012 – Data Protection Manager (DPM) cloud recovery point.
Parameters
-AdhocJobsContext<AdhocJobsContext>
Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-JobStateChangedEventHandler<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.
Aliases |
Handler |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RecoverableItem<RecoverableObject[]>
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.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-RecoveryNotification<NotificationObject]>
Specifies a notification to send when recovery is finished. You can use the New-DPMRecoveryNotification cmdlet to create a notification object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
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.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
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).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Recatalog a version of a cloud recovery point
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.
PS C:\> $RPoints = Get-DPMProtectionGroup | Where {$_.Name -like "ProtectionGroup06"} | Get-DPMDatasource | Get-DPMRecoveryPoint -Online
PS C:\> Start-CloudRecatalog -RecoverableItem $RPoints[1]