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

Disable-VBRTapeDrive

In this article

Short Description

Disables a selected tape library drive.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

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

Related Commands

Get-VBRTapeDrive

Return Type

None

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 drive you want to disable. Accepts VBRTapeDrive object. You can assign multiple drives to this object.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	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

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

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.

PS C:\PS> 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.

PS C:\PS> $library = Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00"

PS C:\PS> $drive = Get-VBRTapeDrive -Library $library | Select -First 1

PS C:\PS> Disable-VBRTapeDrive -Drive $drive