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

    <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