Copy-DPMTapeData

Copies the recovery point data from a tape.

Syntax

Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> [-AdhocJobsContext <AdhocJobsContext>]
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] -OverwriteType <OverwriteType>
 [-RecoveryNotification <NotificationObject>] [-RecoveryPointLocation <RecoverySourceLocation>]
 [-RecreateReparsePoint] [-Restore] [-RestoreSecurity] -Tape <Media> -TargetPath <String>
 -TargetServer <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> [-AdhocJobsContext <AdhocJobsContext>]
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryPointLocation <RecoverySourceLocation>]
 -SourceLibrary <Library> -TapeLabel <String> -TapeOption <TapeOptions> -TargetLibrary <Library> [-Confirm]
 [-WhatIf] [<CommonParameters>]
Copy-DPMTapeData [-DPMServerName <String>] -IncompleteDataset <HeadlessDataset>
 [-JobStateChangedEventHandler <JobStateChangedEventHandler>] -OverwriteType <OverwriteType>
 [-RecoveryNotification <NotificationObject>] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity]
 -Tape <Media> -TargetPath <String> -TargetServer <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Description

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

Parameters

-AdhocJobsContext

Specifies the context details of the ad hoc job. Do not use this parameter from the Windows PowerShell command line.

Type:AdhocJobsContext
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DPMServerName

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

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IncompleteDataset

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

Type:HeadlessDataset
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-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.

Type:JobStateChangedEventHandler
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OverwriteType

Specifies the action that DPM takes when the file that it is recovering already exists.

The acceptable values for this parameter are:

- CreateCopy

  • Skip
  • Overwrite

Type:OverwriteType
Parameter Sets:Overwrite, NoOverwrite, CopyOnExist
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecoveryNotification

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

Type:NotificationObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecoveryPoint

Specifies a recovery point that this cmdlet copies. To obtain a recovery point location object, use the Get-DPMRecoveryPoint cmdlet.

Type:RecoverySource
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RecoveryPointLocation

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.

Type:RecoverySourceLocation
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.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Restore

Indicates that the cmdlet performs a restore operation.

Type:SwitchParameter
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.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceLibrary

Specifies the location of a dataset to copy.

Type:Library
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tape

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

Type:Media
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-TapeLabel

Specifies a label that identifies the tape.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TapeOption

Specifies that the copy operation compress or encrypt the data on the tape.

The acceptable values for this parameter are:

  • 0 Compress
  • 1 Encrypt
  • 2 NoCompressAndNoEncrypt

Type:TapeOptions
Parameter Sets:Compress, Encrypt, NoCompressAndNoEncrypt
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TargetLibrary

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

Type:Library
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TargetPath

Specifies a target path.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TargetServer

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.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Job