Get-VBRTapeMedium

Short Description

Returns tapes.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

Get tapes by names.

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

Get tapes in selected drives.

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

Get tapes by IDs.

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

Get tapes in selected libraries.

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

Get tapes in selected media pools.

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

Get tapes in selected vaults.

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

Detailed Description

This cmdlet returns tapes managed by Veeam Backup & Replication.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Name	Specifies the array of tape names. The cmdlet will return tapes with these names.	String[]	False	Named	True (ByValue, ByProperty Name)
Drive	Specifies the array of drives. The cmdlet will return tapes located in these drives.	Accepts the VBRTapeDrive[] object, GUID or string. To get this object, run the Get-VBRTapeDrive cmdlet.	True	Named	True (ByValue, ByProperty Name)
Id	Specifies the array of tape IDs. The cmdlet will return tapes with these IDs.	Accepts GUID[] or string[].	True	Named	True (ByValue, ByProperty Name)
Library	Specifies the array of tape libraries. The cmdlet will return tapes in these libraries.	Accepts the VBRTapeLibrary[] object, GUID or string. To get this object, run the Get-VBRTapeLibrary cmdlet.	True	Named	True (ByValue, ByProperty Name)
MediaPool	Specifies the array of media pools. The cmdlet will return tapes in these media pools.	Accepts the VBRTapeMediaPool[] object, GUID or string. To get this object, run the Get-VBRTapeMediaPool cmdlet.	True	Named	True (ByValue, ByProperty Name)
Vault	Specifies the array of vaults. The cmdlet will return tapes in these vaults.	Accepts the VBRTapeVault[] object, GUID or string. To get this object, run the Get-VBRTapeVault cmdlet.	True	Named	True (ByValue, ByProperty Name)

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

Output Object

VBRTapeMedium[]

Examples

Get-VBRTapeMedium Example 1. Getting Tape by Name

This command gets a tape named 00110001.

Get-VBRTapeMedium -Name "00110001"

Get-VBRTapeMedium Example 2. Getting Tape by Barcode

This example shows how to get a tape with the 00233400 barcode.

Get-VBRTapeMedium | Where-Object {$_.Barcode -eq "00233400"}

Perform the following steps:

Run the Get-VBRTapeMedium cmdlet to get all tapes.
Pipe the cmdlet output to the Where-Object cmdlet. Specify the Barcode value to equal 00233400.

Get-VBRTapeMedium Example 3. Getting Tapes in Media Pool

This example shows how to get the list of tapes in the Incremental Backups media pool.

$IncrementalBackups = Get-VBRTapeMediaPool -Name "Incremental Backups"

Get-VBRTapeMedium -MediaPool $IncrementalBackups

Perform the following steps:

Run the Get-VBRTapeMediaPool cmdlet. Specify the Name parameter value. Save the result to the $IncrementalBackups variable.
Run the Get-VBRTapeMedium cmdlet. Set the $IncrementalBackups variable as the MediaPool parameter value.

Get-VBRTapeMedium Example 4. Getting Expired Tapes in Vault

This example shows how to look for the expired tapes within the Sydney vault.

$Sydney = Get-VBRTapeVault -Name "Sydney"

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

Perform the following steps:

Run the Get-VBRTapeVault cmdlet. Specify the Name parameter value. Save the result to the $Sydney variable.
Run the Get-VBRTapeMedium cmdlet. Set the $Sydney variable as the Vault parameter value.
Pipe the cmdlet output to the query to find all expired tapes.

Related Commands