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

Disable-VBRTapeProtection

Short Description

Disables protection set for tapes.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

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

Detailed Description

This cmdlet disables protection that was previously enabled for tapes.

You can disable protection of tapes that are both online or offline. When you disable protection, the tape retention period returns to media pool settings.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Medium

Specifies the array of protected tapes. The cmdlet will disable protection for 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 turns off protections for the tapes named "00140009" and "00140010".

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

$tape = Get-VBRTapeMedium -Name "00140009","00140010"

Disable-VBRTapeProtection -Medium $tape

Related Commands

Get-VBRTapeMedium