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 | Accept |
Name | Specifies the array of tape names. The cmdlet will return tapes with these names. | False | Named | True (ByValue, | 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, | 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, | 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, | 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, | 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, | False |
<CommonParameters>
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
