Get-VBRTapeMedium

Short Description

Returns tapes.

Applies to

Platform: VMware, Hyper-V

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Get tapes by names.

Get-VBRTapeMedium [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

  • Get tapes in selected drives.

Get-VBRTapeMedium -Drive <VBRTapeDrive[]> [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

  • Get tapes by IDs.

Get-VBRTapeMedium -Id <Guid[]> [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

  • Get tapes in selected libraries.

Get-VBRTapeMedium [-Name <String[]>] -Library <VBRTapeLibrary[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

  • Get tapes in selected media pools.

Get-VBRTapeMedium [-Name <String[]>] -MediaPool <VBRTapeMediaPool[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

  • Get tapes in selected vaults.

Get-VBRTapeMedium [-Name <String[]>] -Vault <VBRTapeVault[]> [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

Detailed Description

This cmdlet returns tapes managed by Veeam Backup & Replication.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Name

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

String[]

False

Named

True (ByValue,
ByProperty
Name)

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.

True

Named

True (ByValue,
ByProperty
Name)

Id

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

Accepts GUID[] or string[].

True

Named

True (ByValue,
ByProperty
Name)

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.

True

Named

True (ByValue,
ByProperty
Name)

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.

True

Named

True (ByValue,
ByProperty
Name)

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.

True

Named

True (ByValue,
ByProperty
Name)

<CommonParameters>

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

Output Object

VBRTapeMedium[]

Examples

Get-VBRTapeMediumExample 1. Getting Tape by Name

This command gets a tape named 00110001.

Get-VBRTapeMedium -Name "00110001"

Get-VBRTapeMediumExample 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.

Get-VBRTapeMediumExample 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 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.

Get-VBRTapeMediumExample 4. Getting Expired Tapes in Vault

This command looks 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 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