Copy-DPMTapeData

Copies the recovery point data from a tape.

Syntax

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

Description

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

Required Parameters

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

Specifies the location of a dataset to copy.

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

Specifies a label that identifies the tape.

Type:String
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TargetPath

Specifies a target path.

Type:String
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AdhocJobsContext

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

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

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DPMServerName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
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
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.

Type:NotificationObject
Position:Named
Default value:None
Accept pipeline input:False
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Restore

Indicates that the cmdlet performs a restore operation.

Type:SwitchParameter
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
Position:Named
Default value:None
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Job