Start-OnlineRecatalog
Start-OnlineRecatalog
Returns a detailed list of data on a tape.
Syntax
Start-OnlineRecatalog [-RecoveryPoint] <RecoverySource> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryPointLocation <RecoverySourceLocation>] [<CommonParameters>]
Detailed Description
The Start-OnlineRecatalog cmdlet returns a detailed list of data on a tape. This is required to perform partial recoveries or recovery of selected files.
Parameters
-RecoveryPoint
The recovery point to use.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
0 |
-JobStateChangedEventHandler
The JobStateChangedEventHandler is used along with the -Async parameter so that the user can be informed of the status of the operation. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RecoveryPointLocation
The location of the recovery point. This is necessary if a recovery item exists in more than one location for the same point in time. For e.g. on a disk and tape, or on two tapes.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Start-OnlineRecatalog -detailed".
For technical information, type "Get-Help Start-OnlineRecatalog -full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.
Examples
EXAMPLE 1
$pg = Get-ProtectionGroup -DPMServerName TestingServer
$ds = Get-Datasource -ProtectionGroup $pg
$rp = Get-RecoveryPoint -Datasource $ds
$rsl = Get-RecoveryPointLocation -RecoveryPoint $rp
Start-OnlineRecatalog -RecoveryPoint $rp[1] -RecoveryPointLocation $rsl
This command performs on online catalog of the recovery point on TestingServer.