Copy-DPMTapeData

Reference

Module:: DataProtectionManager

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	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
Required:	False
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
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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
Required:	False
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
Accepted values:	Overwrite, NoOverwrite, CopyOnExist
Position:	Named
Default value:	None
Required:	True
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
Required:	False
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
Required:	True
Accept pipeline input:	True
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RecreateReparsePoint

Indicates that the cmdlet recreates the reparse point.

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

-Restore

Indicates that the cmdlet performs a restore operation.

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

-SourceLibrary

Specifies the location of a dataset to copy.

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

-TapeLabel

Specifies a label that identifies the tape.

Type:	String
Position:	Named
Default value:	None
Required:	True
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
Accepted values:	Compress, Encrypt, NoCompressAndNoEncrypt
Position:	Named
Default value:	None
Required:	True
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetPath

Specifies a target path.

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

Outputs

Job