Enable-VBRTapeProtection

Short Description

Sets overwrite protection for selected tapes.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Enable-VBRTapeProtection -Medium <VBRTapeMedium[]> [-PassThru]  [<CommonParameters>]

Detailed Description

This cmdlet sets software overwrite protection for selected tapes.

Protection overrides the retention settings of the media pool to set a lifelong retention period for the selected tapes.

You can set protection for both online or offline tapes that contain data.

The protection can be switched off at any time. The retention settings will be changed to the value set for the media pool. Run the Disable-VBRTapeProtection cmdlet to switch off the protection.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Medium

Specifies the array of tapes. The cmdlet will set protection to these tapes.

Accepts the VBRTapeMedium object, GUID or string. To get this object, run the Get-VBRTapeMedium cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

PassThru

Defines that the command returns the output object to the Windows PowerShell console.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

VBRTapeMedium[]

Examples

Setting Overwrite Protection to Selected Tape

This example shows how to set protection for the tape named 00140009.

$tape = Get-VBRTapeMedium -Name "00140009"

Enable-VBRTapeProtection -Medium $tape -PassThru

Perform the following steps:

  1. Run the Get-VBRTapeMedium cmdlet. Specify the Name parameter value. Save the result to the $tape variable.
  2. Run the Enable-VBRTapeProtection cmdlet. Set the $tape variable as the Medium parameter value. Provide the PassThru parameter.

Related Commands

Get-VBRTapeMedium