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

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 (ByValue, ByProperty Name)	True
Drive	Specifies the array of drives. The cmdlet will return tapes located in these drives. Accepts VBRTapeDrive, GUID or string type.	True	Named	True (ByValue, ByProperty Name)	False
Id	Specifies the array of tape IDs. The cmdlet will return tapes with these IDs. Accepts GUID or string type.	True	Named	True (ByValue, ByProperty Name)	False
Library	Specifies the array of tape libraries. The cmdlet will return tapes in these libraries. Accepts VBRTapeLibrary, GUID or string type.	True	Named	True (ByValue, ByProperty Name)	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	True (ByValue, ByProperty Name)	False
Vault	Specifies the array of vaults. The cmdlet will return tapes in these vaults. Accepts VBRTapeVault, GUID or string type.	True	Named	True (ByValue, ByProperty Name)	False

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

Example 1

The following command gets a tape named "00110001".

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".

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.

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.

Get-VBRTapeMedium -Vault $Sydney | ?{$_.IsExpired}

Related Commands

Get-VBRBackup

Get-VBRTapeMediaPool

Get-VBRTapeLibrary