Copy-DPMTapeData

Copy-DPMTapeData

Copies the data from a tape for a given recovery point.

Syntax

Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -SourceLibrary <Library> -TapeLabel <String> -TapeOption <TapeOptions> -TargetLibrary <Library> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryPointLocation <RecoverySourceLocation>] [<CommonParameters>]


Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -OverwriteType <OverwriteType> -Tape <Media> -TargetPath <String> -TargetServer <String> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <Notification>] [-RecoveryPointLocation <RecoverySourceLocation>] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity <SwitchParameter>] [<CommonParameters>]


Copy-DPMTapeData -DPMServerName <String> -IncompleteDataset <HeadlessDataset> -OverwriteType <OverwriteType> -Tape <Media> -TargetPath <String> -TargetServer <String> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <Notification>] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity <SwitchParameter>] [<CommonParameters>]

Detailed Description

The Copy-DPMTapeData cmdlet copies the data from a tape for a given recovery point.

Parameters

-RecoveryPoint

The recovery point to use.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

0

-DPMServerName

The name of a DPM server.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-IncompleteDataset

Indicates that in the case of data that spans multiple tapes, the operation will be carried out only on the part of the data present on the current tape.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

named

-OverwriteType

Indicates the action to be taken when the file being recovered already exists. The possible values are CreateCopy, Skip, and Overwrite.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-SourceLibrary

Indicates the location from which the dataset will be copied.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Tape

Indicates a tape object.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

named

-TapeLabel

The label to identify the tape.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-TapeOption

Indicates where compression or encryption, or neither, should be performed to the data on the tape. The possible values are 0, 1, or 2 for Compress, Encrypt, and NoCompressAndNoEncrypt, respectively.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-TargetLibrary

Indicates the target library to which the data set should be copied.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-TargetPath

The path to the target.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-TargetServer

The server to which recovery is made.

When using the New-RecoveryOption cmdlet in a clustered environment, the target server parameter should be in the following format - ResourceGroupName.ClusterName.DomainName.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-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

-RecoveryNotification

Notifies you when recovery has been completed. The notification object is returned by the New-NotificationObject cmdlet.

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 example, 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

-RecreateReparsePoint

Indicates whether the reparse point has to be recreated.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Restore

Indicates a restore operation.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-RestoreSecurity

Indicates the security settings to use during a restore operation.
This is a switch parameter. When you use the -RestoreSecurity parameter in the cmdlet, it indicates that the security settings from the recovery point will be used. If the -RestoreSecurity parameter is not used, it indicates that the security settings of the destination server will be used.

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

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

Examples