This is an archive version of the document. To get the most up-to-date information, see the current version.

Get-VBRTapeMedium

In this article

    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>]

    Related Commands

    Get-VBRBackup

    Get-VBRTapeMediaPool

    Get-VBRTapeLibrary

    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
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Name

    Specifies the name of tape you want to get.

    You can specify multiple names separated by commas.

    False

    Named

    True (by Value
    FromPipeline, ValueFromPipeline
    ByPropertyName)

    True

    Drive

    Specifies the drive in which you want to look for tapes.

    Accepts VBRTapeDrive  object, GUID or string type.

    True

    Named

    False

    False

    Id

    Specifies the ID of the tape(s) you want to get.

    Accepts GUID or string type.

    You can specify multiple IDs separated by commas.

    True

    Named

    False

    False

    Library

    Specifies the library in which you want to look for tapes.

    Accepts VBRTapeLibrary  object, GUID or string type.

    True

    Named

    False

    False

    MediaPool

    Specifies the media pool in which you want to look for tapes.

    Accepts VBRTapeMediaPool object, GUID or string type.

    True

    Named

    False

    False

    Vault

    Specifies the vault in which you want to look for tapes.

    Accepts VBRTapeVault object, GUID or string type.

    True

    Named

    False

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    Example 1

    The following command gets a tape named "00110001".

    PS C:\PS> 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".

    PS C:\PS> 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.

    PS C:\PS> 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.

    PS C:\PS> Get-VBRTapeMedium -Vault $Sydney | ?{$_.IsExpired}