Start-TapeRecatalog

Start-TapeRecatalog

Returns information about the data on a tape.

Syntax

Start-TapeRecatalog [-Tape] <Media> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [<CommonParameters>]

Detailed Description

The Start-TapeRecatalog cmdlet returns information about the data on a tape. This is required to be done before recovering data from the tape.

Use the Start-OnlineRecatalog cmdlet to do a partial recovery of data on a tape.

Parameters

-Tape

Indicates a tape object.

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

-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-TapeRecatalog -detailed".
    For technical information, type "Get-Help Start-TapeRecatalog -full".

    Additionally, any updated information about the cmdlet will be available at http://go.microsoft.com/fwlink/?LinkId=95130.

Examples

EXAMPLE 1

$DPMLib = Get-DPMLibrary -DPMServerName "TestingServer" 
$Tape = Get-Tape -DPMLibrary $DPMLib 
Start-TapeRecatalog -Tape $Tape[2]

This command performs an online re-catalog of the data on the specified tape.