---
title: "New-VBRProtectionGroupDeploymentOptions"
description: "Defines protection group deployment settings. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: AllParameterSets (Default) InstallApplicationPlugins The cmdle"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrprotectiongroupdeploymentoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Groups > New-VBRProtectionGroupDeploymentOptions"
dateModified: "2026-08-19"
---

# New-VBRProtectionGroupDeploymentOptions

## Short Description
Defines protection group deployment settings.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
New-VBRProtectionGroupDeploymentOptions [-DistributionServer <CHost>]
 [-DistributionRepository <VBRObjectStorageRepository>] [-InstallAgent] [-UpgradeAutomatically]
 [-InstallDriver] [-InstallNoSnapAgent] [-RebootIfRequired] [-InstallApplicationPlugins] [-InstallCDPAgent] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>InstallApplicationPlugins</code></p>

```
New-VBRProtectionGroupDeploymentOptions [-DistributionServer <CHost>]
 [-DistributionRepository <VBRObjectStorageRepository>] [-InstallAgent] [-UpgradeAutomatically]
 [-InstallDriver] [-InstallNoSnapAgent] [-RebootIfRequired] [-InstallApplicationPlugins]
 [-ApplicationTypes <VBRApplicationType[]>] [-InstallCDPAgent] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
The cmdlet creates the [`VBRProtectionGroupDeploymentOptions`](vbrprotectiongroupdeploymentoptions.md) object. This object contains the deployment settings for a protection group. You can use these settings to automatically install and upgrade Veeam Agent or Veeam Plug-Ins on discovered computers.

Run the [`Set-VBRProtectionGroup`](set-vbrprotectiongroup.md) cmdlet to apply deployment settings to a protection group.

## 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">ApplicationTypes</span></p>
        </td>
        <td>
          <p>Specifies an array of Veeam Plug-Ins that you want to install on the protected computers:</p><ul><li><strong>OracleRMAN</strong>: for Veeam Plug-In for Oracle RMAN</li><li><strong>SAPHANA</strong>: for Veeam Plug-In for SAP HANA</li><li><strong>SAPOnOracle</strong>: for Veeam Plug-In for SAP on Oracle</li></ul><p>Accepts the <code>VBRApplicationType[]</code> object. To get this object, run the <a href="get-vbrdiscoveredapplication.md"><code>Get-VBRDiscoveredApplication</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRApplicationType[]</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)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DistributionRepository</span></p>
        </td>
        <td>
          <p>For protection groups for cloud machines.</p><p>Specifies an object storage repository (either Microsoft Azure blob storage or Amazon S3 object storage repository) that will act as a distribution repository. Veeam Backup & Replication will use this repository to upload Veeam Agent setup files to cloud machines added to the protection group.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRObjectStorageRepository</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">DistributionServer</span></p>
        </td>
        <td>
          <p>Specifies a distribution server. The cmdlet will instruct Veeam Backup & Replication to use this server to upload Veeam Agent or Veeam Plug-In setup files and private fixes to computers added to the protection group.</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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallAgent</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will automatically install Veeam Agent on all discovered computers of the protection group.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallApplicationPlugins</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will automatically install Veeam Plug-In on all discovered computers of the protection group.</p><p>Use the <code>ApplicationTypes</code> parameter to specify Veeam Plug-Ins that Veeam Backup & Replication will install.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallCDPAgent</span></p>
        </td>
        <td>
          <p>Installs the Veeam CDP Agent Service and Veeam CDP Volume Filter Driver.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallDriver</span></p>
        </td>
        <td>
          <p>Used only for Veeam Agent for Microsoft Windows.</p><p>Defines that Veeam Backup & Replication will automatically install the CBT driver on discovered computers.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">InstallNoSnapAgent</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will deploy the nosnap Veeam Agent on the discovered computers of the protection group.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RebootIfRequired</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will reboot discovered computers if required.</p><p><strong>Note</strong>: Reboot is required after the CBT driver installation.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">UpgradeAutomatically</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will automatically upgrade Veeam Agent or Veeam Plug-In on discovered computers when the new Veeam Agent version or private fix appears on the distribution server.</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>True (ByPropertyName)</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
[`VBRProtectionGroupDeploymentOptions`](vbrprotectiongroupdeploymentoptions.md)

## Examples

::: example
### Example 1. Creating Discovery Schedule for Protection Group

This example shows how to create an object containing the following Veeam Agent deployment settings:

- Veeam Agents will be installed automatically on discovered computers.
- Veeam Agents will be upgraded automatically to the version of Veeam Agent on the distribution server.
- Veeam Agents will be deployed in the nosnap mode.

```
$server = Get-VBRServer -Name support.east.local
New-VBRProtectionGroupDeploymentOptions -DistributionServer $server -InstallAgent -UpgradeAutomatically -InstallNoSnapAgent
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the `New-VBRProtectionGroupDeploymentOptions` cmdlet. Set the `$server` variable as the `DistributionServer` parameter value. Provide the `InstallAgent`, `UpgradeAutomatically` and `InstallNoSnapAgent` parameters.

:::

::: example
### Example 2. Creating and Applying Discovery Schedule for Protection Group

This example shows how to apply Veeam Agent deployment settings to a protection group. Per these settings, Veeam Backup & Replication will automatically install Veeam Agents on discovered computers and automatically upgrade them.

```
$server = Get-VBRServer -Name support.east.local
$deployment = New-VBRProtectionGroupDeploymentOptions -DistributionServer $server -InstallAgent -UpgradeAutomatically -InstallNoSnapAgent
$group = Get-VBRProtectionGroup -Name "East Computers"
Set-VBRProtectionGroup -ProtectionGroup $group -DeploymentOptions $deployment
```

Perform the following steps:

1. Create an object with Veeam Agent deployment settings:

   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the `New-VBRProtectionGroupDeploymentOptions` cmdlet. Set the `$server` variable as the `DistributionServer` parameter value. Provide the `InstallAgent`, `UpgradeAutomatically` and `InstallNoSnapAgent` parameters. Save the result to the `$deployment` variable.

2. Apply Veeam Agent deployment settings to a protection group:

   - Run the [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$group` variable.
   - Run the [`Set-VBRProtectionGroup`](set-vbrprotectiongroup.md) cmdlet. Set the `$group` variable as the `ProtectionGroup` parameter value. Set the `$deployment` variable as the `DeploymentOptions` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md)
- [`Set-VBRProtectionGroup`](set-vbrprotectiongroup.md)