This is an archive version of the document. To get the most up-to-date information, see the current version.

Enable-VBRTapeProtection

Short Description

Sets overwrite protection for selected tapes.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

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 Disable-VBRTapeProtection to switch off the protection.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Medium

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

Accepts VBRTapeMedium, GUID or string type.

True

Named

True (ByValue,
ByProperty
Name)

False

PassThru

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

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

VBRTapeMedium[]

Example

This command sets protections for the tape named "00140009".

  1. Run Get-VBRTapeMedium to get the tape and save it to the $tape variable.
  2. Run Enable-VBRTapeProtection with this variable.

$tape = Get-VBRTapeMedium -Name "00140009"

Enable-VBRTapeProtection -Medium $tape -PassThru

Related Commands

Get-VBRTapeMedium