Copy-DPMTapeData

Copy-DPMTapeData

Copies the recovery point data from a tape.

Syntax

Parameter Set: CopyToMedia
Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -SourceLibrary <Library> -TapeLabel <String> -TapeOption <DbEnums+TapeOptions> {Compress | Encrypt | NoCompressAndNoEncrypt} -TargetLibrary <Library> [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryPointLocation <RecoverySourceLocation> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: DumpMediaHeadlessDataset
Copy-DPMTapeData -IncompleteDataset <HeadlessDataset> -OverwriteType <OverwriteType> {Overwrite | NoOverwrite | CopyOnExist} -Tape <Media> -TargetPath <String> -TargetServer <String> [-DPMServerName <String> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryNotification <NotificationObject> ] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: DumpMediaRecoveryPoint
Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -OverwriteType <OverwriteType> {Overwrite | NoOverwrite | CopyOnExist} -Tape <Media> -TargetPath <String> -TargetServer <String> [-AdhocJobsContext <AdhocJobsContext> ] [-JobStateChangedEventHandler <JobStateChangedEventHandler> ] [-RecoveryNotification <NotificationObject> ] [-RecoveryPointLocation <RecoverySourceLocation> ] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Copy-DPMTapeData cmdlet copies the recovery point data from a tape in System Center 2012 – Data Protection Manager (DPM).

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?

True (ByValue)

Accept Wildcard Characters?

false

-DPMServerName<String>

Specifies the name of a DPM server on which this cmdlet acts.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-IncompleteDataset<HeadlessDataset>

Indicates that the operation occurs only on the portion of the data present on the current tape. In some situations, data spans multiple tapes.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

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

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OverwriteType<OverwriteType>

Specifies the action that DPM takes when the file that it is recovering already exists. Valid values are:

-- CreateCopy
-- Skip
-- Overwrite

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RecoveryNotification<NotificationObject>

Specifies that the recovery operation send a notification when the recovery operation finishes. The New-NotificationObject cmdlet returns the notification object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RecoveryPoint<RecoverySource>

Specifies a recovery point that this cmdlet copies. To obtain a recovery point location 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 the location of a recovery point that this cmdlet copies. To obtain a recovery point location object, use the Get-DPMRecoveryPointLocation cmdlet. A recovery item may exist in more than one location for the same time, such as on a disk and tape, or on two separate tapes.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-RecreateReparsePoint

Indicates that the cmdlet recreates the reparse point.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Restore

Indicates that the cmdlet performs a restore operation.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RestoreSecurity

Indicates that DPM uses the security settings of the recovery point during a restore operation. When you specify the RestoreSecurity parameter, the cmdlet uses the security settings from the recovery point. Otherwise, the cmdlet uses the security settings of the destination server.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SourceLibrary<Library>

Specifies the location of a dataset to copy.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Tape<Media>

Specifies a tape from which this cmdlet copies a recovery point. To obtain a Tape object, use the Get-DPMTape cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-TapeLabel<String>

Specifies a label that identifies the tape.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TapeOption<DbEnums+TapeOptions>

Specifies that the copy operation compress or encrypt the data on the tape. Valid values are:
-- 0 Compress
-- 1 Encrypt
-- 2 NoCompressAndNoEncrypt

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetLibrary<Library>

Specifies the target library to which to copy the data set.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetPath<String>

Specifies a target path.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetServer<String>

Specifies the target server for recovery.

If you use this cmdlet in a clustered environment, specify the target server parameter in the format ResourceGroupName.ClusterName.DomainName.

Aliases

none

Required?

true

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.

  • Job

Get-DPMTape

Test-DPMTapeData