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

Get-VBRTapeDrive

In this article

    Short Description

    Returns tape drives.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus

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

    Related Commands

    Get-VBRTapeLibrary

    Return Type

    VBRTapeDrive[]

    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 that the tape drive belongs to.

    False

    Named

    True (by Value
    FromPipeline,
    ValueFromPipeline
    ByPropertyName)

    False

    Name

    Specifies the tape drive name(s), or search conditions.

    You can specify multiple names separated by commas.

    False

    Named

    True (by Value
    FromPipeline,
    ValueFromPipeline
    ByPropertyName)

    True

    Id

    Specifies the ID of the VBRTapeDrive object you want to get.

    Accepts GUID or string type.

    You can assign multiple IDs to this object.

    False

    Named

    True (by Value
    FromPipeline,
    ValueFromPipeline
    ByPropertyName)

    False

    Address

    Specifies the slot number where the drive in connected.

    False

    Named

    True (by Value
    FromPipeline,
    ValueFromPipeline
    ByPropertyName)

    False

    <CommonParameters>

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

    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.

    PS C:\PS> Get-VBRTapeLibrary -Name "HP MSL G3 Series 3.00" | Get-VBRTapeDrive

    Example 2

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

    PS C:\PS> Get-VBRTapeDrive -Name "Drive1"