Set-VBRTapeServer

Short Description

Modifies tape servers.

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

Syntax

Set-VBRTapeServer [-Description <String>] -TapeServer <VBRTapeServer> [-PassThru] [<CommonParameters>]

Detailed Description

This cmdlet modifies tape server that was created before.

Note

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

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Description

Specifies the new description you want to apply to the tape server.

String

False

Named

False

PassThru

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

SwitchParameter

False

Named

False

TapeServer

Specifies the tape server you want to modify.

Accepts the VBRTapeServer object. To get this object, run the Get-VBRTapeServerReturns tape servers. cmdlet.

VBRTapeServer

True

Named

True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

VBRTapeServer

Examples

Set-VBRTapeServerExample 1. Modifying Description of Tape Server [Using Variable]

This example shows how to modify the description of the Sydney_Tape_Server tape server.

$tapeserver = Get-VBRTapeServer -Name "Sydney_Tape_Server"

Set-VBRTapeServer -TapeServer $tapeserver -Description "Sydney_Remote_Tape_Server"

Perform the following steps:

  1. Run the Get-VBRServerReturns hosts connected to the backup infrastructure. cmdlet. Specify the Name parameter value. Save the result to the $tapeserver variable.
  2. Run the Set-VBRTapeServer cmdlet. Set the $tapeserver variable as the TapeServer parameter value. Specify the Description parameter value.

Set-VBRTapeServerExample 2. Modifying Description of Tape Server [Using Pipeline]

This example shows how to modify the description of the Sydney_Tape_Server tape server.

Get-VBRTapeServer -Name "Sydney_Tape_Server" | Set-VBRTapeServer -Description "Sydney_Remote_Tape_Server" -PassThru

Perform the following steps:

  1. Run the Get-VBRServerReturns hosts connected to the backup infrastructure. cmdlet. Specify the Name parameter value.
  2. Pipe the cmdlet output to the Set-VBRTapeServer cmdlet. Specify the Description parameter value. Provide the PassThru parameter.

Get-VBRTapeServerReturns tape servers.

Page updated 2026-08-19

Page content applies to build 13.1.1.18