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

Eject-VBRTapeMedium

Short Description

Ejects tape from drive.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Eject-VBRTapeMedium  [<CommonParameters>]

-OR-

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

-OR-

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

Detailed Description

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

You can eject a tape that is known to be located in drive, or eject a tape located in a selected drive, or eject tapes in all drives managed by Veeam Backup & Replication. This cmdlet provides three scenarios for each case.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Medium

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

Accepts VBRTapeMedium, GUID or string type.

True

Named

True (ByValue,
ByProperty
Name)

False

Drive

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

Accepts VBRTapeDrive, GUID or string type.

True

Named

True (ByValue,
ByProperty
Name)

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

None

Example

This command ejects tape named "00140009".

  1. Run Get-VBRTapeMedium to get the tape and save it to the $tape variable.
  2. Run Eject-VBRTapeMedium with this variable.

$tape = Get-VBRTapeMedium -Name "00140009"

Eject-VBRTapeMedium -Medium $tape

Related Commands

Get-VBRTapeMedium

Get-VBRTapeDrive