Copy-DPMTapeData
Copy-DPMTapeData
Copies the data from a tape for a given recovery point.
Syntax
Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -SourceLibrary <Library> -TapeLabel <String> -TapeOption <TapeOptions> -TargetLibrary <Library> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryPointLocation <RecoverySourceLocation>] [<CommonParameters>]
Copy-DPMTapeData [-RecoveryPoint] <RecoverySource> -OverwriteType <OverwriteType> -Tape <Media> -TargetPath <String> -TargetServer <String> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <Notification>] [-RecoveryPointLocation <RecoverySourceLocation>] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity <SwitchParameter>] [<CommonParameters>]
Copy-DPMTapeData -DPMServerName <String> -IncompleteDataset <HeadlessDataset> -OverwriteType <OverwriteType> -Tape <Media> -TargetPath <String> -TargetServer <String> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-RecoveryNotification <Notification>] [-RecreateReparsePoint] [-Restore] [-RestoreSecurity <SwitchParameter>] [<CommonParameters>]
Detailed Description
The Copy-DPMTapeData cmdlet copies the data from a tape for a given recovery point.
Parameters
-RecoveryPoint
The recovery point to use.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
0 |
-DPMServerName
The name of a DPM server.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-IncompleteDataset
Indicates that in the case of data that spans multiple tapes, the operation will be carried out only on the part of the data present on the current tape.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
named |
-OverwriteType
Indicates the action to be taken when the file being recovered already exists. The possible values are CreateCopy, Skip, and Overwrite.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-SourceLibrary
Indicates the location from which the dataset will be copied.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Tape
Indicates a tape object.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
named |
-TapeLabel
The label to identify the tape.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-TapeOption
Indicates where compression or encryption, or neither, should be performed to the data on the tape. The possible values are 0, 1, or 2 for Compress, Encrypt, and NoCompressAndNoEncrypt, respectively.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-TargetLibrary
Indicates the target library to which the data set should be copied.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-TargetPath
The path to the target.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-TargetServer
The server to which recovery is made.
When using the New-RecoveryOption cmdlet in a clustered environment, the target server parameter should be in the following format - ResourceGroupName.ClusterName.DomainName.
Attributes
| Name | Value |
|---|---|
Required? |
true |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-JobStateChangedEventHandler
The JobStateChangedEventHandler is used along with the -Async parameter so that the user can be informed of the status of the operation. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RecoveryNotification
Notifies you when recovery has been completed. The notification object is returned by the New-NotificationObject cmdlet.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RecoveryPointLocation
The location of the recovery point. This is necessary if a recovery item exists in more than one location for the same point in time. For example, on a disk and tape or on two tapes.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
true (ByValue) |
Position? |
named |
-RecreateReparsePoint
Indicates whether the reparse point has to be recreated.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-Restore
Indicates a restore operation.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-RestoreSecurity
Indicates the security settings to use during a restore operation.
This is a switch parameter. When you use the -RestoreSecurity parameter in the cmdlet, it indicates that the security settings from the recovery point will be used. If the -RestoreSecurity parameter is not used, it indicates that the security settings of the destination server will be used.
Attributes
| Name | Value |
|---|---|
Required? |
false |
Accept wildcard characters? |
false |
Accept Pipeline Input? |
false |
Position? |
named |
-CommonParameter
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Notes
For more information, type "Get-Help Copy-DPMTapeData -detailed".
For technical information, type "Get-Help Copy-DPMTapeData -full".Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.