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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Description	Specifies the description of the vault.	`String`	False	Named	False
Name	Specifies the name you want to assign to the vault.	`String`	False	Named	False
PassThru	Defines that the command returns the output object to the Windows PowerShell console.	`SwitchParameter`	False	Named	False
Protect	Defines that all tapes moved to this media vault are automatically protected.	`SwitchParameter`	False	Named	False
Vault	Specifies the vault you want to modify. Accepts the `VBRTapeVault` object, GUID or string. To get this object, run the `Get-VBRTapeVault` cmdlet.	`VBRTapeVault`	True	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

VBRTapeVault

Examples

Set-VBRTapeVault 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:

Run the Get-VBRTapeVault cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Set-VBRTapeVault cmdlet. Specify the Name and Description parameter values. Provide the PassThru parameter.

Set-VBRTapeVault 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:

Run the Get-VBRTapeVault cmdlet. Specify the Name parameter value. Save the result to the $vault variable.
Run the Set-VBRTapeVault cmdlet. Set the $vault variable as the Vault parameter values. Specify the Name parameter value.

Get-VBRTapeVault