Get-VBRTapeDrive

Short Description

Returns tape drives.

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

Syntax

This cmdlet provides the following parameter sets:

  • AllParameterSets (Default)

    Get-VBRTapeDrive [<CommonParameters>]

  • Library

    Get-VBRTapeDrive [-Library <VBRTapeLibrary>] [<CommonParameters>]

  • Name

    Get-VBRTapeDrive [-Name <String[]>] [<CommonParameters>]

  • Id

    Get-VBRTapeDrive [-Id <Guid[]>] [<CommonParameters>]

  • Address

    Get-VBRTapeDrive -Address <Int32[]> [<CommonParameters>]

Detailed Description

This cmdlet returns tape recording drives. You can also view the model name, the state of the drive and whether it is enabled or disabled.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Address

Specifies the array of drive addresses (slot numbers). The cmdlet will return drives in these slots.

Int32[]

True

Named

True (ByPropertyName, ByValue)

Id

Specifies the array of drive IDs. The cmdlet will return drives with these IDs.

Guid[]

False

Named

True (ByPropertyName, ByValue)

Library

Specifies the tape library. The cmdlet will return drives that belong to this library.

Accepts the VBRTapeLibrary object, GUID or string. To get this object, run the Get-VBRTapeLibraryReturns tape libraries. cmdlet.

VBRTapeLibrary

False

Named

True (ByPropertyName, ByValue)

Name

Specifies the array of tape drive names. The cmdlet will return drives with these names.

String[]

False

Named

True (ByPropertyName, ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRTapeDrive[]

Examples

Get-VBRTapeDriveExample 1. Getting Drives of Selected Library [Using Pipeline]

This example shows how to get drives of the HP MSL G3 Series 3.00 library.

Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00" | Get-VBRTapeDrive

Perform the following steps:

  1. Run the Get-VBRTapeLibraryReturns tape libraries. cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Get-VBRTapeDriveReturns tape drives. cmdlet.

Get-VBRTapeDriveExample 2. Getting Drive by Name

This command looks for the Drive1 tape drive.

Get-VBRTapeDrive -Name "Drive1"

Get-VBRTapeLibraryReturns tape libraries.

Page updated 2026-08-19

Page content applies to build 13.1.1.18