Start-DPMOnlineRecatalog
Start-DPMOnlineRecatalog
Returns a detailed list of data for a DPM recovery point.
Syntax
Parameter Set: Default
Start-DPMOnlineRecatalog [-RecoveryPoint] <RecoverySource> [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryPointLocation <RecoverySourceLocation> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Start-DPMOnlineRecatalog cmdlet returns a detailed list of data for a System Center 2012 – Data Protection Manager (DPM) recovery point. You can use this information to perform partial recoveries or recovery of selected files.
Parameters
-JobStateChangedEventHandler<JobStateChangedEventHandler>
Specifies an event handler for changes in the status of a job. You can use this parameter to update a GUI that runs in Windows PowerShell, but do not use it in the Windows PowerShell console.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RecoveryPoint<RecoverySource>
Specifies a recovery point object. To obtain a recovery point object, use the Get-DPMRecoveryPoint cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-RecoveryPointLocation<RecoverySourceLocation>
Specifies a recovery point location object. To obtain a recovery point location object, use the Get-DPMRecoveryPointLocation cmdlet. You need to specify the location of recovery point if a recovery item exists in more than one recovery point.
Aliases |
none |
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.
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.
- Job
Notes
- For more information, type "
Get-Help Start-DPMOnlineRecatalog -detailed".
Examples
Example 1: Start online catalog
This example performs on online catalog action of a recovery point on a DPM server. The first command uses the Get-ProtectionGroup to get a protection group for the DPM server named DPMServer07, and stores the protection group object in the $DPMPG variable.
The second command uses the Get-DPMDatasource cmdlet to get a data source for the protection group object specified in the $DPMPG variable, and stores the data source object in the $DPMDS variable.
The third command uses the Get-DPMRecoveryPoint cmdlet to get recovery points for the data source object stored in the $DPMDS variable, and stores the recovery point objects in the $DPMRP variable.
The fourth command uses the Get-DPMRecoveryPointLocation cmdlet to get a recovery point location for the recovery point objects stored in the $DPMRP variable, and stores the recovery point location object in the $DPMRPL variable.
The fifth command starts a catalog action for a recovery point stored in the $DPMRP variable. The command uses standard array syntax to select the second member of that array. The command specifies the recovery point location as the object stored in the $DPMRPL variable.
PS C:\> $DPMPG = Get-DPMProtectionGroup -DPMServerName "DPMServer07"
PS C:\> $DPMDS = Get-DPMDatasource -ProtectionGroup $DPMPG
PS C:\> $DPMRP = Get-DPMRecoveryPoint -Datasource $DPMDS
PS C:\> $DPMRPL = Get-DPMRecoveryPointLocation -RecoveryPoint $DPMRP
PS C:\> Start-DPMOnlineRecatalog -RecoveryPoint $DPMRP[1] -RecoveryPointLocation $DPMRPL