---
title: "Set-VBRAzureContainer"
description: "Modifies a scope of Azure VMs, Azure tags or Azure Availability Zone for a protection group. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies a scope of Azure VMs, Azure tags or Azure Availability Z"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrazurecontainer.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Scope > Set-VBRAzureContainer"
dateModified: "2026-08-19"
---

# Set-VBRAzureContainer

## Short Description
Modifies a scope of Azure VMs, Azure tags or Azure Availability Zone for a protection group.

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

## Syntax
```
Set-VBRAzureContainer -Container <VBRAzureContainer> [-Subscription <VBRAzureSubscription>]
 [-Location <VBRAzureLocation>] [-Entity <Object[]>] [-ExcludeEntities] [-ExcludedEntity <Object[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies a scope of Azure VMs, Azure tags or Azure Availability Zone for a protection group.

::: 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">Container</span></p>
        </td>
        <td>
          <p>Specifies a scope of the following entities that you want to modify:</p><ul><li>Azure VMs.</li><li>Azure tags.</li><li>Azure Availability Zone.</li></ul><p>Accepts the <code>VBRAzureContainer</code> object. To create this object, run the <a href="new-vbrazurecontainer.md"><code>New-VBRAzureContainer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurecontainer.md"><code>VBRAzureContainer</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Entity</span></p>
        </td>
        <td>
          <p>Specifies an array of the following entities that the cmdlet till add to a scope of a protection group:</p><ul><li>Azure VMs.</li><li>Azure tags.</li><li>Azure Availability Zone.</li></ul><p>Accepts the <code>Object</code>[] object. To get this object, run the following  cmdlets:</p><ul><li><a href="get-vbrazurevm.md"><code>Get-VBRAzureVM</code></a></li><li><a href="new-vbrazuretag.md"><code>New-VBRAzureTag</code></a></li><li><a href="get-vbrazurelocation.md"><code>Get-VBRAzureLocation</code></a></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Object[]</code></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, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ExcludedEntity</span></p>
        </td>
        <td>
          <p>Specifies an array of the following entities that the cmdlet will exclude from a scope of a protection group:</p><ul><li>Azure VMs.</li><li>Azure tags.</li><li>Azure Availability Zone.</li></ul><p>Accepts the <code>Object[]</code> object. To get this object, run the following  cmdlets:</p><ul><li><a href="get-vbrazurevm.md"><code>Get-VBRAzureVM</code></a></li><li><a href="new-vbrazuretag.md"><code>New-VBRAzureTag</code></a></li><li><a href="get-vbrazurelocation.md"><code>Get-VBRAzureLocation</code></a></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Object[]</code></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, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ExcludeEntities</span></p>
        </td>
        <td>
          <p>Specifies an array of the following entities that the cmdlet will exclude from a scope of a protection group:</p><ul><li>Azure VMs.</li><li>Azure tags.</li><li>Azure Availability Zone.</li></ul>
        </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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Location</span></p>
        </td>
        <td>
          <p>Specifies Microsoft Azure region.</p><p>Accepts the <code>VBRAzureLocation</code> object. To get this object, run the <a href="get-vbrazurelocation.md"><code>Get-VBRAzureLocation</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurelocation.md"><code>VBRAzureLocation</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, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Subscription</span></p>
        </td>
        <td>
          <p>Specifies subscriptions associated with a Microsoft Azure account.</p><p>Accepts the <code>VBRAzureSubscription</code> object. To create 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>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
[`VBRAzureContainer`](vbrazurecontainer.md)

## Examples

::: example
### Modifying Scope of Azure Entities for Protection Group

This example shows how to modify the scope of Azure entities. The cmdlet will include Azure VMs into scope instead of Azure Availability Zone.

```
$account = Get-VBRAzureAccount -Type ResourceManager -Name "AzureRM@tech.com" 
$subscription = Get-VBRAzureSubscription -Account $account
$location = Get-VBRAzureLocation -Subscription $subscription
$scope = New-VBRAzureContainer -Subscription $subscription -Location $location -Entity $location
$VMs = Get-VBRAzureVM -Subscription $subscription -Location $location
$VMScope = Set-VBRAzureContainer -Container $scope -Entity $VMs
```

Perform the following steps:

1. Define the Azure Availability Zone protection scope:

   1. Run the [`Get-VBRAzureAccount`](get-vbrazureaccount.md) cmdlet. Specify the `Type` and the `Name` parameter values. Save the result to the `$account` variable.
   2. Run the [`Get-VBRAzureSubscription`](get-vbrazuresubscription.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Save the result to the `$subscription` variable.
   3. Run the [`Get-VBRAzureLocation`](get-vbrazurelocation.md) cmdlet. Set the `$subscription` variable as the `Subscription` parameter value. Save the result to the `$location` variable.
   4. Run the [`New-VBRAzureContainer`](new-vbrazurecontainer.md) cmdlet. Specify the `Subscription`, `Location` and `Entity` parameter values. Save the result to the `$scope` variable.

2. Run the [`Get-VBRAzureVM`](get-vbrazurevm.md) cmdlet. Set the `$subscription` variable as the `Subscription` parameter value. Set the `$location` variable as the `Location` parameter value. Save the result to the `$VMs` variable.
3. Run the `Set-VBRAzureContainer` cmdlet. Set the `$scope` variable as the `Container` parameter value. Set the `$VMs` variable as the `Entity` parameter value. Save the result to the `$VMScope` variable.

:::

## Related Commands

- [`Get-VBRAzureAccount`](get-vbrazureaccount.md)
- [`Get-VBRAzureSubscription`](get-vbrazuresubscription.md)
- [`Get-VBRAzureLocation`](get-vbrazurelocation.md)
- [`New-VBRAzureContainer`](new-vbrazurecontainer.md)
- [`Get-VBRAzureVM`](get-vbrazurevm.md)