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

Get-VBRTapeMedium

Short Description

Returns tapes.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Get-VBRTapeMedium [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Get-VBRTapeMedium -Drive <VBRTapeDrive[]> [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Get-VBRTapeMedium -Id <Guid[]> [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Get-VBRTapeMedium [-Name <String[]>] -Library <VBRTapeLibrary[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Get-VBRTapeMedium [-Name <String[]>] -MediaPool <VBRTapeMediaPool[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Get-VBRTapeMedium [-Name <String[]>] -Vault <VBRTapeVault[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet returns tapes managed by Veeam Backup & Replication.

You can get the list of all tapes, or search for instances directly by name or ID, or get the list of tapes in a particular library, media pool, vault or drive. Use an appropriate scenario for each case.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Name

Specifies the array of tape names. The cmdlet will return tapes with these names.

False

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

True

Drive

Specifies the array of drives. The cmdlet will return tapes located in these drives.

Accepts VBRTapeDrive, GUID or string type.

True

Named

False

False

Id

Specifies the array of tape IDs. The cmdlet will return tapes with these IDs.

Accepts GUID or string type.

True

Named

False

False

Library

Specifies the array of tape libraries. The cmdlet will return tapes in these libraries.

Accepts VBRTapeLibrary, GUID or string type.

True

Named

False

False

MediaPool

Specifies the array of media pools. The cmdlet will return tapes in these media pools.

Accepts VBRTapeMediaPool, GUID or string type.

True

Named

False

False

Vault

Specifies the array of vaults. The cmdlet will return tapes  in these vaults.

Accepts VBRTapeVault, GUID or string type.

True

Named

False

False

<CommonParameters>

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

Example 1

The following command gets a tape named "00110001".

PS C:\PS> Get-VBRTapeMedium -Name "00110001"

Example 2

The following command gets a tape with the barcode "00233400".

Run Get-VBRTapeMedium to get all tapes. Pass the result to the Where-Object cmdlet to select the tapes with the Barcode property that equals "00233400".

PS C:\PS> Get-VBRTapeMedium | Where-Object {$_.Barcode -eq "00233400"}

Example 3

This command looks for the list of tapes belonging to the media pool named "Incremental Backups". The media pool is obtained with Get-VBRTapeMediaPool and assigned to the '$IncrementalBackups' variable beforehand.

PS C:\PS> Get-VBRTapeMedium -MediaPool $IncrementalBackups

Example 4

This command looks for the expired tapes within the Sydney vault. The vault is obtained with Get-VBRTapeVault and assigned to the '$Sydney' variable beforehand.

PS C:\PS> Get-VBRTapeMedium -Vault $Sydney | ?{$_.IsExpired}

Related Commands

Get-VBRBackup

Get-VBRTapeMediaPool

Get-VBRTapeLibrary

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