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

Related topics

Get-DPMTape

Test-DPMTapeData