Get-VBRTapeMedium

Short Description

Returns tapes.

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

Syntax

This cmdlet provides the following parameter sets:

AllParameterSets (Default)

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

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

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

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

Get-VBRTapeMedium [-Name <String[]>] -MediaPool <VBRTapeMediaPoolBase[]> [<CommonParameters>]
Vault

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
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.	`VBRTapeDrive[]`	True	Named	True (ByPropertyName, ByValue)
Id	Specifies the array of tape IDs. The cmdlet will return tapes with these IDs. Accepts `Guid[]` or `String[]`.	`Guid[]`	True	Named	True (ByPropertyName, ByValue)
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.	`VBRTapeLibrary[]`	True	Named	True (ByPropertyName, ByValue)
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.	`VBRTapeMediaPoolBase[]`	True	Named	True (ByPropertyName, ByValue)
Name	Specifies the array of tape names. The cmdlet will return tapes with these names.	`String[]`	False	Named	True (ByPropertyName, ByValue)
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.	`VBRTapeVault[]`	True	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

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.