---
title: "Set-VBRTapeVault"
description: "This cmdlet modifies tape vault 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. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrtapevault.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Vaults > Set-VBRTapeVault"
dateModified: "2026-08-19"
---

# Set-VBRTapeVault

## Short Description
Modifies a tape vault.

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

## Syntax
```
Set-VBRTapeVault -Vault <VBRTapeVault> [-Name <String>] [-Description <String>] [-Protect] [-PassThru] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies tape vault 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 description of the vault.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name you want to assign to the vault.</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">Protect</span></p>
        </td>
        <td>
          <p>Defines that all tapes moved to this media vault are automatically protected.</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">Vault</span></p>
        </td>
        <td>
          <p>Specifies the vault you want to modify.</p><p>Accepts the <a href="vbrtapevault.md"><code>VBRTapeVault</code></a> object, GUID or string. To get this object, run the <a href="get-vbrtapevault.md"><code>Get-VBRTapeVault</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapevault.md"><code>VBRTapeVault</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
[`VBRTapeVault`](vbrtapevault.md)

## Examples

::: example
### Example 1. Modifying Tape Vault Name and Description [Using Pipeline]

This example shows how to modify the name and the description of the vault named `Vault 01`.

```
Get-VBRTapeVault -Name "Vault 01" | Set-VBRTapeVault -Name "Sydney Remote Storage" -Description "Secondary Sydney Remote Storage" -PassThru
Location    : Sydney Offsite Storage
Medium      : {}
Id          : 4be3b4c9-a620-4abd-a68b-b8a697115781
Name        : Sydney Remote Storage 02
Description : Secondary Sydney Remote Storage
```

Perform the following steps:

1. Run the [`Get-VBRTapeVault`](get-vbrtapevault.md) cmdlet. Specify the `Name` parameter value.
2. Pipe the cmdlet output to the `Set-VBRTapeVault` cmdlet. Specify the `Name` and `Description` parameter values. Provide the `PassThru` parameter.

:::

::: example
### Example 2. Modifying Tape Vault Name [Using Variable]

This example shows how to modify the name of the vault to `Sydney Remote Storage 02`.

```
$vault = Get-VBRTapeVault -Name "Sydney Remote Storage 01"
Set-VBRTapeVault -Vault $vault -Name "Sydney Remote Storage 02"
```

Perform the following steps:

1. Run the [`Get-VBRTapeVault`](get-vbrtapevault.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vault` variable.
2. Run the `Set-VBRTapeVault` cmdlet. Set the `$vault` variable as the `Vault` parameter values. Specify the `Name` parameter value.

:::

## Related Commands

[`Get-VBRTapeVault`](get-vbrtapevault.md)