Eject-VBRTapeMedium

Short Description

Ejects tapes from drive.

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

Syntax

This cmdlet provides the following parameter sets:

  • AllParameterSets (Default)

    Eject-VBRTapeMedium [<CommonParameters>]

  • Medium

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

  • 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

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

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-VBRTapeDriveReturns tape drives. cmdlet.

VBRTapeDrive[]

True

Named

True (ByPropertyName, ByValue)

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-VBRTapeMediumReturns tapes. cmdlet.

VBRTapeMedium[]

True

Named

True (ByPropertyName, ByValue)

<CommonParameters>

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

Examples

Ejecting Selected Tape

This example shows how to eject tape named 00140009.

$tape = Get-VBRTapeMedium -Name "00140009"

Eject-VBRTapeMedium -Medium $tape

Perform the following steps:

  1. Run the Get-VBRTapeMediumReturns tapes. 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.

Page updated 2026-08-19

Page content applies to build 13.1.1.18