Start-VBRTapeCopy

Short Description

Starts tape copy jobs.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Start-VBRTapeCopy -TapeMedium <VBRTapeMedium[]> -TargetMediaPool <VBRTapeMediaPoolBase> [-Wait] [-DependentTapeMedium <VBRTapeMedium[]>] [-EnableHardwareCompression] [-SkipDependencyCheck] [-SkipEncryptedBackups] [-AddDependentMediumAutomatically] [-PreserveOriginalRetention] [-ExportSourceTape] [-ExportTargetTape] [-TargetLibrary <VBRTapeLibrary>] [<CommonParameters>]

Detailed Description

This cmdlet starts tape copy jobs.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
TapeMedium	Specifies an array of tapes. The cmdlet will add this array of tapes to the tape copy job.	Accepts the VBRTapeMedium[] object. To get this object, run the Get-VBRTapeMedium cmdlet.	True	Named	False
TargetMediaPool	Specifies a media pool. The cmdlet will copy the tape data to this media pool. Note: If the target media pool contains several tape libraries, the TargetLibrary parameter is required.	Accepts the VBRTapeMediaPoolBase object. To get this object, run the Get-VBRTapeMediaPool cmdlet.	True	Named	False
Wait	Defines that the command waits for the process to complete before accepting more input.	SwitchParameter	False	Named	False
DependentTapeMedium	Specifies an array of dependent tapes. The cmdlet will add this array of dependent tapes to the tape copy job. When a backup file does not fit on one tape, it is divided into parts and written to several tapes. These tapes are considered dependent. Note: If you do not specify the DependentTapeMedium and SkipDependencyCheck parameters, but dependent media exist, you will get the warning about that with the prompt to add these media to the tape copy job.	Accepts the VBRTapeMedium[] object. To get this object, run the Get-VBRTapeCopyDependentMedium cmdlet.	False	Named	False
EnableHardwareCompression	Enables the hardware compression option. If set to False, the the hardware compression option is disabled. If you do not provide this parameter, the hardware compression option is still enabled.	SwitchParameter	False	Named	False
SkipDependencyCheck	Defines that the existence of dependent tapes is not checked. Note: If you do not specify the DependentTapeMedium and SkipDependencyCheck parameters, but dependent media exist, you will get the warning about that with the prompt to add these media to the tape copy job.	SwitchParameter	False	Named	False
SkipEncryptedBackups	Defines that the cmdlet will skip encrypted backups stored on the source tape from the tape copy job. If you do not provide this parameter and there are encrypted backups on tapes to copy, the cmdlet cannot copy these encrypted backups and will return a warning.	SwitchParameter	False	Named	False
AddDependentMediumAutomatically	Defines that the cmdlet will add dependent tapes to the tape copy job automatically. If you do not provide this parameter and there are dependent tapes, the cmdlet cannot copy files written to dependent tapes and will return a warning.	SwitchParameter	False	Named	False
PreserveOriginalRetention	Defines that retention settings of the source media pool are copied to the target media pool. If set to False, the target media pool will use its own retention settings. If you do not provide this parameter, retention settings are still copied from the source media pool to the target media pool.	SwitchParameter	False	Named	False
ExportSourceTape	Defines that the source tapes will be exported after the tape copy job finishes. If you do not provide this parameter, the source tapes will not be exported after the tape copy job finishes.	SwitchParameter	False	Named	False
ExportTargetTape	Defines that the target tapes will be exported after the tape copy job finishes. If you do not provide this parameter, the target tapes will not be exported after the tape copy job finishes.	SwitchParameter	False	Named	False
TargetLibrary	Specifies a tape library. The cmdlet will copy the tape data to this tape library. Note: This parameter is required if the target media pool contains several tape libraries.	Accepts the VBRTapeLibrary object. To get this object, run the Get-VBRTapeLibrary cmdlet.	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

None.

Examples

Starting Tape Copy Job

This example shows how to start a tape copy job with the following settings:

The copy job will process data that is stored on the 0021000C tape and all dependent tapes.
The copy job will copy data to the Copy media pool.
The copy job will apply retention settings of the original medial pool to the target media pool.
The copy job will run with the enabled hardware compression option.

$tape = Get-VBRTapeMedium -Name "0021000C"

$pool = Get-VBRTapeMediaPool -Name "Copy"

Start-VBRTapeCopy -TapeMedium $tape -TargetMediaPool $pool -Wait -EnableHardwareCompression -AddDependentMediumAutomatically -PreserveOriginalRetention

Perform the following steps:

Run the Get-VBRTapeMedium cmdlet. Specify the Name parameter value. Save the result to the $tape variable.
Run the Get-VBRTapeMediaPool cmdlet. Specify the Name parameter value. Save the result to the $pool variable.
Run the Start-VBRTapeCopy cmdlet. Specify the following settings:

Set the $tape variable as the TapeMedium parameter value.
Set the $pool variable as the TargetMediaPool parameter value.
Provide the Wait parameter.
Provide the EnableHardwareCompression parameter.
Provide the AddDependentMediumAutomatically parameter.
Provide the PreserveOriginalRetention parameter.

Related Commands