Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
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 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.

  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.

$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

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions Reference

Veeam Availability for Nutanix AHV Documentation

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation