Get-VBRTapeMedium

Short Description

Returns tapes.

Applies to

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

Syntax

This cmdlet provides parameter sets that allow you to:

Get-VBRTapeMedium [-Name <String[]>] [<CommonParameters>]

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

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

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

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

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

Detailed Description

This cmdlet returns tapes managed by Veeam Backup & Replication.

Parameters

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

Examples

Example 1. Getting Tape by Name

This command gets a tape named 00110001.

Get-VBRTapeMedium -Name "00110001"

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.

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.

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