Get-VBRTapeMedium

In this article

    Short Description

    Returns tapes.

    Applies to

    Platform: VMware, Hyper-V

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

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

    Accept
    Wildcard
    Characters

    Name

    Specifies the array of tape names. The cmdlet will return tapes with these names.

    False

    Named

    True (ByValue,
    ByProperty
    Name)

    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,
    ByProperty
    Name)

    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,
    ByProperty
    Name)

    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,
    ByProperty
    Name)

    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,
    ByProperty
    Name)

    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,
    ByProperty
    Name)

    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

    Get-VBRBackup

    Get-VBRTapeMediaPool

    Get-VBRTapeLibrary