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>]

Related Commands

Get-VBRTapeMedium

Return Type

VBRTapeMedium[]

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 tapes for which you want to set protection.

Accepts VBRTapeMedium object, GUID or string type.

You can assign multiple tapes to this object.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

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 about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

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.

PS C:\PS> $tape = Get-VBRTapeMedium -Name "00140009"

PS C:\PS> Enable-VBRTapeProtection -Medium $tape -PassThru