---
title: "Set-VBRAzureExternalRepository"
description: "Modifies external Microsoft Azure Blob storage repository. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies external Microsoft Azure Blob storage repository added to the ba"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrazureexternalrepository.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > External Repositories > Set-VBRAzureExternalRepository"
dateModified: "2026-08-19"
---

# Set-VBRAzureExternalRepository

## Short Description
Modifies external Microsoft Azure Blob storage repository.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Set-VBRAzureExternalRepository -ExternalRepository <VBRAzureExternalRepository> [-Name <String>]
 [-Description <String>] [-MountServerOptions <VBRRepositoryMountServerOptions[]>] [-DecryptBackups]
 [-DecryptionKey <VBREncryptionKey>] [-GatewayServer <CHost>] [-AzureSubscription <VBRAzureSubscription>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies external Microsoft Azure Blob storage repository added to the backup infrastructure.

::: 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">AzureSubscription</span></p>
        </td>
        <td>
          <p>Specifies the subscriptions associated with a Microsoft Azure account.</p><p>Accepts the <code>VBRAzureSubscription</code> object. To get this object, run the  <a href="get-vbrazuresubscription.md"><code>Get- VBRAzureSubscription</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazuresubscription.md"><code>VBRAzureSubscription</code></a></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">DecryptBackups</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will decrypt encrypted backups.</p><p>Default: <code>False</code>.</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">DecryptionKey</span></p>
        </td>
        <td>
          <p>Specifies the password that Veeam Backup & Replication will use to decrypt the backup files.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBREncryptionKey</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of Microsoft Azure Blob storage repository that you want to add as an external repository.</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">ExternalRepository</span></p>
        </td>
        <td>
          <p>Specifies the Microsoft Azure Blob storage repository added as an external repository. The cmdlet will modify this repository.</p><p>Accepts the <code>VBRAzureExternalRepository</code> object. To get this object, run the <a href="get-vbrexternalrepository.md"><code>Get-VBRExternalRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRAzureExternalRepository</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">GatewayServer</span></p>
        </td>
        <td>
          <p>Specifies the gateway server. Veeam Backup & Replication will use this server to access Microsoft Azure Blob storage repository.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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">MountServerOptions</span></p>
        </td>
        <td>
          <p>Specifies the mount server settings for the servers that you plan to use as mount servers during the restore process.</p><p>Accepts the <code>VBRRepositoryMountServerOptions[]</code> object. To create this object, run the <a href="new-vbrrepositorymountserveroptions.md"><code>New-VBRRepositoryMountServerOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrepositorymountserveroptions.md"><code>VBRRepositoryMountServerOptions[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</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 of Microsoft Azure Blob storage repository that you want to add as an external repository.</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>
    </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
This cmdlet returns the `VBRAzureExternalRepository` object that contains settings of Microsoft Azure Blob storage repository added as an external repository.

## Examples

::: example
### Modifying Decryption Password of External Azure Blob Storage Repository

This example shows how to modify the decryption password of Microsoft Azure Blob storage repository named `Microsoft Azure Repository`.

```
$repository = Get-VBRExternalRepository -Name "Microsoft Azure Repository"
$securepassword = Read-Host -Prompt "Enter password" -AsSecureString
$key = Add-VBREncryptionKey -Password $securepassword
Set-VBRAzureExternalRepository -ExternalRepository $repository -DecryptBackups -DecryptionKey $key
```

Perform the following steps:

1. Run the [`Get-VBRExternalRepository`](get-vbrexternalrepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Specify the password to decrypt backup files:

   - Run the [`Read-Host`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host?view=powershell-6) cmdlet. Specify the `Prompt` parameter value. Provide the `AsSecureString` parameter. Save the result to the `$securepassword` variable.
   - Run the [`Add-VBREncryptionKey`](add-vbrencryptionkey.md) cmdlet. Set the `$securepassword` variable as the `Password` parameter value. Save the result to the `$key` variable.

3. Run the `Set-VBRAzureExternalRepository` cmdlet. Specify the following settings: 

   - Set the `$repository` variable as the `ExternalRepository` parameter value.
   - Provide the `DecryptBackups` parameter.
   - Set the `$key` variable as the `DecryptionKey` parameter value.

:::

## Related Commands

- [`Get-VBRExternalRepository`](get-vbrexternalrepository.md)
- [`Add-VBREncryptionKey`](add-vbrencryptionkey.md)