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

Get-VBRTapeDrive

Short Description

Returns tape drives.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Get-VBRTapeDrive  [<CommonParameters>]

-OR-

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

-OR-

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

-OR-

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

-OR-

Get-VBRTapeDrive -Address <int[]>  [<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

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Library

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

Accepts VBRTapeLibrary, GUID or string type.

False

Named

True (ByValue,
ByProperty
Name)

False

Name

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

False

Named

True (ByValue,
ByProperty
Name)

True

Id

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

Accepts GUID or string type.

False

Named

True (ByValue,
ByProperty
Name)

False

Address

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

False

Named

True (ByValue,
ByProperty
Name)

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

VBRTapeDrive[]

Example 1

This command looks for a tape drives in the library named 'HP MSL G3 Series 3.00'.

Run Get-VBRTapeLibrary to get the library and pipe it down.

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

Example 2

This command looks for a tape drive named "Drive1".

Get-VBRTapeDrive -Name "Drive1"

Related Commands

Get-VBRTapeLibrary