---
title: "Set-VBRProtectionGroup"
description: "This cmdlet modifies settings of a protection group. 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-vbrprotectiongroup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Groups > Set-VBRProtectionGroup"
dateModified: "2026-08-19"
---

# Set-VBRProtectionGroup

## Short Description
Modifies protection groups.

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

## Syntax
```
Set-VBRProtectionGroup -ProtectionGroup <VBRProtectionGroup> [-Name <String>] [-Description <String>]
 [-Container <VBRProtectionGroupContainer>] [-ScheduleOptions <VBRProtectionGroupScheduleOptions>]
 [-DeploymentOptions <VBRProtectionGroupDeploymentOptions>]
 [-AdvancedOptions <VBRProtectionGroupAdvancedWindowsOptions>]
 [-NotificationOptions <VBRProtectionGroupNotificationOptions>] [-CacheRepository <VBRBackupRepository>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of 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">AdvancedOptions</span></p>
        </td>
        <td>
          <p>Specifies settings for Veeam Agent for Windows deployed on computers in the protection group. You can specify the following settings:</p><ul><li>Network usage settings</li><li>Throttling settings</li><li>Security settings</li></ul><p>Accepts the <a href="vbrprotectiongroupadvancedwindowsoptions.md"><code>VBRProtectionGroupAdvancedWindowsOptions</code></a> object. To get this object, run the <a href="new-vbrprotectiongroupadvancedwindowsoptions.md"><code>New-VBRProtectionGroupAdvancedWindowsOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrprotectiongroupadvancedwindowsoptions.md"><code>VBRProtectionGroupAdvancedWindowsOptions</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">CacheRepository</span></p>
        </td>
        <td>
          <p>Specifies the cache repository for the protection group. Veeam Backup & Replication will keep the .VCACHE files on this repository. This parameter applies only to protection groups with the IrisServers container type. You cannot change the cache repository using this cmdlet. To change the cache repository, use the Veeam Backup & Replication console wizard.</p><p>Accepts the <code>VBRBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRBackupRepository</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">Container</span></p>
        </td>
        <td>
          <p>Specifies the protection scope. The protection scope can contain the following objects:</p><ul><li>Active Directory objects.</li><li>Individual computers.</li><li>Cloud machines.</li><li>Computers imported from a CSV file.</li><li>Computers with pre-installed backup agents.</li><li>MongoDB Replica sets.</li><li>InterSystems IRIS servers.</li></ul><p>The cmdlet will modify the protection group with this protection scope.</p><p>Accepts the following objects:</p><ul><li><a href="vbradcontainer.md"><code>VBRADContainer</code></a></li><li><a href="vbrindividualcomputercontainer.md"><code>VBRIndividualComputerContainer</code></a></li><li><a href="vbramazonec2container.md"><code>VBRAmazonEC2Container</code></a></li><li><a href="vbrazurecontainer.md"><code>VBRAzureContainer</code></a></li><li><a href="vbrcsvcontainer.md"><code>VBRCSVContainer</code></a></li><li><a href="vbrmanuallydeployedcontainer.md"><code>VBRManuallyDeployedContainer</code></a></li><li><a href="vbrmongodbcontainer.md"><code>VBRMongoDBContainer</code></a></li><li><a href="vbririscontainer.md"><code>VBRIrisContainer</code></a></li></ul><p>To get this object, run one of the following cmdlets:</p><ul><li><a href="new-vbradcontainer.md"><code>New-VBRADContainer</code></a></li><li><a href="new-vbrindividualcomputercontainer.md"><code>New-VBRIndividualComputerContainer</code></a></li><li><a href="new-vbramazonec2container.md"><code>New-VBRAmazonEC2Container</code></a></li><li><a href="new-vbrazurecontainer.md"><code>New-VBRAzureContainer</code></a></li><li><a href="new-vbrcsvcontainer.md"><code>New-VBRCSVContainer</code></a></li><li><a href="new-vbrmanuallydeployedcontainer.md"><code>New-VBRManuallyDeployedContainer</code></a></li><li><a href="new-vbrmongodbcontainer.md"><code>New-VBRMongoDBContainer</code></a></li><li><a href="new-vbririscontainer.md"><code>New-VBRIrisContainer</code></a></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRProtectionGroupContainer</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">DeploymentOptions</span></p>
        </td>
        <td>
          <p>Specifies Veeam Agent deployment settings. The cmdlet will use these settings to install Veeam Agent on the discovered computers in the protection group.</p><p>Accepts the <a href="vbrprotectiongroupdeploymentoptions.md"><code>VBRProtectionGroupDeploymentOptions</code></a> object. To get this object, run the <a href="new-vbrprotectiongroupdeploymentoptions.md"><code>New-VBRProtectionGroupDeploymentOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrprotectiongroupdeploymentoptions.md"><code>VBRProtectionGroupDeploymentOptions</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the protection group.</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 protection group.</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">NotificationOptions</span></p>
        </td>
        <td>
          <p>Specifies notification settings for the protection group.</p><p>Accepts the <a href="vbrprotectiongroupnotificationoptions.md"><code>VBRProtectionGroupNotificationOptions</code></a> object. To get this object, run the <a href="new-vbrprotectiongroupnotificationoptions.md"><code>New-VBRProtectionGroupNotificationOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrprotectiongroupnotificationoptions.md"><code>VBRProtectionGroupNotificationOptions</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">ProtectionGroup</span></p>
        </td>
        <td>
          <p>Specifies the protection group you want to modify.</p><p>Accepts the <a href="vbrprotectiongroup.md"><code>VBRProtectionGroup</code></a> object. To get this object, run the <a href="get-vbrprotectiongroup.md"><code>Get-VBRProtectionGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrprotectiongroup.md"><code>VBRProtectionGroup</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">ScheduleOptions</span></p>
        </td>
        <td>
          <p>Specifies the discovery schedule. The cmdlet will use this schedule to perform discovery operations for computers in the protection group.</p><p>Accepts the <a href="vbrprotectiongroupscheduleoptions.md"><code>VBRProtectionGroupScheduleOptions</code></a> object. To get this object, run the <a href="new-vbrprotectiongroupscheduleoptions.md"><code>New-VBRProtectionGroupScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrprotectiongroupscheduleoptions.md"><code>VBRProtectionGroupScheduleOptions</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>
    </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
[`VBRProtectionGroup`](vbrprotectiongroup.md)

## Examples

::: example
### Example 1. Adding Computer to Protection Group

This example shows how to add a computer to an existing protection group.

```
$group = Get-VBRProtectionGroup -Name Computers
$comp = $group.Container.CustomCredentials
$supervisor = New-VBRIndividualComputerCustomCredentials -HostName support.east.local -Credentials support\jsmith
$comp += $supervisor
$newcomp = Set-VBRIndividualComputerContainer -Container $group.Container -CustomCredentials $comp
Set-VBRProtectionGroup -ProtectionGroup $group -Container $newcomp
```

Perform the following steps:

1. Run the [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$group` variable.
2. Use the `Container.CustomCredentials` property of the `$group` variable. Save the result to the `$comp` variable.
3. Run the [`New-VBRIndividualComputerCustomCredentials`](new-vbrindividualcomputercustomcredentials.md) cmdlet. Specify the `HostName` and the `Credentials` parameter values. Save the result to the `$supervisor` variable.
4. Add the computer to the group of computers in the `$comp` variable. Use the `+=` operator.
5. Run the [`Set-VBRIndividualComputerContainer`](set-vbrindividualcomputercontainer.md) cmdlet. Set the `Container` property of the `$group` variable as the `Container` parameter value. Set the `$comp` variable as the `CustomCredentials` parameter value. Save the result to the `$newcomp` variable.
6. Run the `Set-VBRProtectionGroup` cmdlet. Set the `$group` variable as the `ProtectionGroup` parameter value. Set the `$newcomp` variable as the `Container` parameter value.

:::

::: example
### Example 2. Removing Exclusions from Protection Group

This example shows how to remove exclusions from a protection group for Microsoft Active Directory Objects.

```
$group = Get-VBRProtectionGroup -Name "AD PG"
$ADcontainer = $group.Container
$newcontaineroptions = @{
    Entity = $ADcontainer.Entity
    Domain = $ADcontainer.Domain
    ExcludeVMs = $ADcontainer.ExcludeVMs
    ExcludeOfflineComputers = $ADcontainer.ExcludeOfflineComputers
    ExcludeComputers = $False
    MasterCredentials = $ADcontainer.MasterCredentials
    UseCustomCredentials = $ADcontainer.UseCustomCredentials
    CustomCredentials = $ADcontainer.CustomCredentials
}
$newADcontainer = New-VBRADContainer @newcontaineroptions
Set-VBRProtectionGroup -ProtectionGroup $group -Container $newADcontainer
```

Perform the following steps:

1. Run the [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$group` variable.
2. Use the `Container` property of the `$group` variable. Save the result to the `$ADcontainer` variable.
3. Define the scope and settings of AD objects for the new container by creating a hashtable:

   - Use the `Entity` property of the `$ADcontainer` variable. Save the result as the `Entity` key value.
   - Use the `Domain` property of the `$ADcontainer` variable. Save the result as the `Domain` key value.
   - Use the `ExcludeVMs` property of the `$ADcontainer` variable. Save the result as the `ExcludeVMs` key value.
   - Use the `ExcludeOfflineComputers` property of the `$ADcontainer` variable. Save the result as the `ExcludeOfflineComputers` key value.
   - Set `$False` as the `ExcludeComputers` property value.
   - Use the `MasterCredentials` property of the `$ADcontainer` variable. Save the result as the `MasterCredentials` key value.
   - Use the `UseCustomCredentials` property of the `$ADcontainer` variable. Save the result as the `UseCustomCredentials` key value.
   - Use the `CustomCredentials` property of the `$ADcontainer` variable. Save the result as the `CustomCredentials` key value.

   Save the result to the `$newcontaineroptions` variable.

4. Run the [`New-VBRADContainer`](new-vbradcontainer.md) cmdlet. Use the `$newcontaineroptions` variable with splatting to define the scope and settings of AD objects for the new container. Save the result to the `$newADcontainer` variable.
5. Run the `Set-VBRProtectionGroup` cmdlet. Set the `$group` variable as the `ProtectionGroup` parameter value. Set the `$newADcontainer` variable as the `Container` parameter value.

:::

## Related Commands

- [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md)
- [`New-VBRIndividualComputerCustomCredentials`](new-vbrindividualcomputercustomcredentials.md)
- [`Set-VBRIndividualComputerContainer`](set-vbrindividualcomputercontainer.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)