---
title: "Set-VBRTapeServer"
description: "This cmdlet modifies tape server that was created before. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrtapeserver.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Servers > Set-VBRTapeServer"
dateModified: "2026-08-19"
---

# 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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies the new description you want to apply to the tape server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command returns the output object to the Windows PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TapeServer</span></p>
        </td>
        <td>
          <p>Specifies the tape server you want to modify.</p><p>Accepts the <a href="vbrtapeserver.md"><code>VBRTapeServer</code></a> object. To get this object, run the <a href="get-vbrtapeserver.md"><code>Get-VBRTapeServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapeserver.md"><code>VBRTapeServer</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRTapeServer`](vbrtapeserver.md)

## Examples

::: example
### Example 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-VBRServer`](get-vbrserver.md) 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.

:::

::: example
### Example 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-VBRServer`](get-vbrserver.md) 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.

:::

## Related Commands

[`Get-VBRTapeServer`](get-vbrtapeserver.md)