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

Eject-VBRTapeDrive (obsolete)

In this article

    Short Description

    Ejects tape from the selected media drive.

    Eject-VBRTapeDrive (obsolete) Note:

    This cmdlet is obsolete. The cmdlet will still work but it is advised to rewrite your scripts using the Eject-VBRTapeMedium for added benefits.

    Applies to

    Platform: VMware, Hyper-V

    Syntax

    Eject-VBRTapeDrive -Drive <TapeDrive> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    Related Commands

    Get-VBRTapeDrive

    Detailed Description

    This cmdlet ejects tape from the specified drive. The tape returns to its original slot.

    Run Eject-VBRTapeMedium to eject a specific tape from drive.

    Run Export-VBRTapeMedium to get a tape out of the library.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Drive

    Specifies the drive you want to eject.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    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 ejects the tape from the drive named "Drive01". The drive object is obtained with Get-VBRTapeDrive and piped down.

    Get-VBRTapeDrive -Name "Drive01" | Eject-VBRTapeDrive

    Example 2

    This command ejects the tape from the drive represented by $drive variable. The drive object is obtained with Get-VBRTapeDrive and assigned to the variable beforehand.

    Eject-VBRTapeDrive -Drive $drive