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:\>