Eject-VBRTapeDrive (obsolete)

Short Description

Ejects tape from the selected media drive.

Note

This cmdlet is obsolete. The cmdlet still works, but it is recommended to rewrite your scripts using the Eject-VBRTapeMedium cmdlet.

Applies to

Platform: VMware, Hyper-V

Syntax

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

Detailed Description

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

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

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

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Drive	Specifies the drive you want to eject.	Accepts the TapeDrive object. To get this object, run the Get-VBRTapeDrive cmdlet.	True	Named	True (ByValue, ByProperty Name)

Examples

Example 1. Ejecting Tape from Drive [Using Pipeline]

This example shows how to eject the tape from the Drive01 drive.

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

Perform the following steps:

Example 2. Ejecting Tape from Drive [Using Variable]

This example shows how to eject the tape from the Drive01 drive.

$drive = Get-VBRTapeDrive -Name "Drive01"

Eject-VBRTapeDrive -Drive $drive

Perform the following steps:

Run the Get-VBRTapeDrive cmdlet. Specify the Name parameter value. Save the result to the $drive variable.
Pipe the cmdlet output to the Eject-VBRTapeDrive cmdlet. Set the $drive variable as the Drive parameter value.

Related Commands