Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Disable-VBRTapeDrive

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

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

<CommonParameters>

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

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.

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.

  1. Run Get-VBRTapeLibrary to get the library. Save it to the $library variable.
  2. Run Get-VBRTapeDrive with the $library variable to get the drives of this library. Select the first drive. Save it to the $drive variable.
  3. 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

Related Commands

Get-VBRTapeDrive

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation