Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Eject-VBRTapeMedium

Short Description

Ejects tape from drive.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

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 (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

Drive

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

Accepts VBRTapeDrive, GUID or string type.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

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.

PS C:\PS> $tape = Get-VBRTapeMedium -Name "00140009"

PS C:\PS> Eject-VBRTapeMedium -Medium $tape

Related Commands

Get-VBRTapeMedium

Get-VBRTapeDrive

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation