Eject-VBRTapeMedium

Short Description

Ejects tapes from drive.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Eject tapes in all drives.

Eject-VBRTapeMedium  [<CommonParameters>]

  • Eject a selected tape.

Eject-VBRTapeMedium -Medium <VBRTapeMedium[]>  [<CommonParameters>]

  • Eject a tape located in a selected drive.

Eject-VBRTapeMedium -Drive <VBRTapeDrive[]>  [<CommonParameters>]

Detailed Description

This cmdlet ejects the tape that is located in drive. The ejected tape is moved to a standard library slot.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Medium

Specifies the array of tapes. The cmdlet will eject these tapes.

Accepts the VBRTapeMedium object, GUID or string. To get this object, run the Get-VBRTapeMedium cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

Drive

Specifies the array of drives. The cmdlet will eject tapes from these drives.

Accepts the VBRTapeDrive object, GUID or string. To get this object, run the Get-VBRTapeDrive cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

<CommonParameters>

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

Output Object

None.

Examples

Ejecting Selected Tape

This command ejects tape named 00140009.

$tape = Get-VBRTapeMedium -Name "00140009"

Eject-VBRTapeMedium -Medium $tape

Perform the following steps:

  1. Run the Get-VBRTapeMedium cmdlet. Specify the Name parameter value. Save it to the $tape variable.
  2. Run the Eject-VBRTapeMedium cmdlet. Set the $tape variable as the Medium parameter value.

Related Commands