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

Disable-VBRTapeDrive

Short Description

Disables a selected tape library drive.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Disable-VBRTapeDrive -Drive <VBRTapeDrive[]> [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet disables a selected tape library recording drive. When you disable a drive, Veeam Backup & Replication stops using it for read or write operations. You can disable a drive, for example, for maintenance.

Run Enable-VBRTapeDrive to enable the drive.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Drive	Specifies the array of drives. The cmdlet will disable these drives. Accepts VBRTapeDrive type.	True	Named	True (ByValue, ByProperty Name)	False
WhatIf	Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.	False	Named	False	False
Confirm	Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.	False	Named	False	False

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Drive

Specifies the array of drives. The cmdlet will disable these drives.

Accepts VBRTapeDrive type.

True

Named

True (ByValue,
ByProperty
Name)

False

WhatIf

Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.

False

Named

False

Confirm

Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.

False

Named

False

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

Return Type

None

Example 1

This command disables one drive of the selected library.

Run Get-VBRTapeLibrary to get the library. Pipe it to Get-VBRTapeDrive and select the last drive in the list. Pipe this all to Disable-VBRTapeDrive.

Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00" | Get-VBRTapeDrive | Select -Last 1 | Disable-VBRTapeDrive

Example 2

This command disables a drive represented by the $drive variable.

Run Get-VBRTapeLibrary to get the library. Save it to the $library variable.
Run Get-VBRTapeDrive with the $library variable to get the drives of this library. Select the first drive. Save it to the $drive variable.
Run Disable-VBRTapeDrive with the $drive variable.

$library = Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00"

$drive = Get-VBRTapeDrive -Library $library | Select -First 1

Disable-VBRTapeDrive -Drive $drive

Related Commands

Get-VBRTapeDrive