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 <TapeOptions> -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 an ad hoc job. Do not use this parameter from Windows PowerShell.

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.

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>

Indicates that the cmdlet displays the status of the operation to the user.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OverwriteType<OverwriteType>

Specifies the action to take when recovering an existing file. Acceptable values for this parameter 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 completes. 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.

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. A recovery item may exist in more than one location for the same point in 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 the cmdlet 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 object.

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<TapeOptions>

Specifies that the copy operation compress or encrypt the data on the tape. Acceptable values for this parameter 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 a recovery server.

When you use the New-RecoveryOption cmdlet in a clustered environment, format the target server parameter as 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

Notes

  • For more information, type "Get-Help Copy-DPMTapeData -detailed".

Examples

Example 1:

PS C:\> 

Test-DPMTapeData