Set-VBRTapeMedium

Short Description

Modifies tape properties.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Set-VBRTapeMedium -Medium <VBRTapeMedium> [-Name <String>] [-Description <String>] [-MarkAsFree] [-PassThru] [-WarningAction <ActionPreference>] [-WarningVariable <String>]  [<CommonParameters>]

Detailed Description

This cmdlet modifies properties of a selected tape. You can modify name and/or description of the tape, or mark it as free.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Medium

Specifies tape you want to modify.

Accepts the VBRTapeMedium object, GUID or string. To get this object, run the Get-VBRTapeMedium cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

Name

Specifies the new name you want to assign to the tape.

String

False

Named

False

Description

Specifies the new description you want to assign to the tape.

String

False

Named

False

MarkAsFree

If you provide this parameter, the cmdlet will mark the tape as free.

Veeam Backup & Replication will delete from backup and tape catalogs information about backup contents stored on tape.

SwitchParameter

False

Named

False

PassThru

Defines that the command returns the output object to the Windows PowerShell console.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

VBRTapeMedium

Examples

Set-VBRTapeMediumExample 1. Updating Tape Name and Description [Using Pipeline]

This command renames the 0014001F tape into SQL 9/2022 and sets a description for it.

Get-VBRTapeMedium -Name "0014001F" | Set-VBRTapeMedium -Name "SQL 9/2022" -Description "SQL DB monthly full backups: Sept/2022"

Perform the following steps:

  1. Run the Get-VBRTapeMedium cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Set-VBRTapeMedium cmdlet. Specify the Name parameter value. Specify the Description parameter value.

Set-VBRTapeMediumExample 2. Marking Tape as Free [Using Pipeline]

This command marks the 0014001F tape as free.

Get-VBRTapeMedium -Name "0014001F" | Set-VBRTapeMedium -MarkAsFree

Perform the following steps:

  1. Run the Get-VBRTapeMedium cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Set-VBRTapeMedium cmdlet. Provide the MarkAsFree parameter.

Related Commands

Get-VBRTapeMedium