--- title: "Get-VBRTapeMedium" description: "Returns tapes. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet returns tapes managed by Veeam Backup & Replication." canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrtapemedium.html" breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Managing Tapes > Get-VBRTapeMedium" dateModified: "2026-08-19" --- # 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 ] [] ```
Drive
``` Get-VBRTapeMedium -Drive [-Name ] [] ```
Id
``` Get-VBRTapeMedium -Id [-Name ] [] ```
Library
``` Get-VBRTapeMedium [-Name ] -Library [] ```
MediaPool
``` Get-VBRTapeMedium [-Name ] -MediaPool [] ```
Vault
``` Get-VBRTapeMedium [-Name ] -Vault [] ```

## Detailed Description This cmdlet returns tapes managed by Veeam Backup & Replication. ## 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)

`` This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7). ## Output Object [`VBRTapeMedium[]`](vbrtapemedium.md) ## Examples ::: example ### Example 1. Getting Tape by Name This command gets a tape named `00110001`. ``` Get-VBRTapeMedium -Name "00110001" ``` ::: ::: example ### 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: 1. Run the `Get-VBRTapeMedium` cmdlet to get all tapes. 2. Pipe the cmdlet output to the `Where-Object` cmdlet. Specify the `Barcode` value to equal `00233400`. ::: ::: example ### 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: 1. Run the [`Get-VBRTapeMediaPool`](get-vbrtapemediapool.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$IncrementalBackups` variable. 2. Run the `Get-VBRTapeMedium` cmdlet. Set the `$IncrementalBackups` variable as the `MediaPool` parameter value. ::: ::: example ### 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: 1. Run the [`Get-VBRTapeVault`](get-vbrtapevault.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$Sydney` variable. 2. Run the `Get-VBRTapeMedium` cmdlet. Set the `$Sydney` variable as the `Vault` parameter value. 3. Pipe the cmdlet output to the query to find all expired tapes. ::: ## Related Commands - [`Get-VBRBackup`](get-vbrbackup.md) - [`Get-VBRTapeMediaPool`](get-vbrtapemediapool.md) - [`Get-VBRTapeLibrary`](get-vbrtapelibrary.md)