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:

AllParameterSets (Default)

New-VBRProtectionGroupDeploymentOptions [-DistributionServer <CHost>]

[-DistributionRepository <VBRObjectStorageRepository>] [-InstallAgent] [-UpgradeAutomatically]

[-InstallDriver] [-InstallNoSnapAgent] [-RebootIfRequired] [-InstallApplicationPlugins] [-InstallCDPAgent] [<CommonParameters>]

InstallApplicationPlugins

New-VBRProtectionGroupDeploymentOptions [-DistributionServer <CHost>]

[-DistributionRepository <VBRObjectStorageRepository>] [-InstallAgent] [-UpgradeAutomatically]

[-InstallDriver] [-InstallNoSnapAgent] [-RebootIfRequired] [-InstallApplicationPlugins]

[-ApplicationTypes <VBRApplicationType[]>] [-InstallCDPAgent] [<CommonParameters>]

Detailed Description

The cmdlet creates the VBRProtectionGroupDeploymentOptions 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 cmdlet to apply deployment settings to a protection group.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
ApplicationTypes	Specifies an array of Veeam Plug-Ins that you want to install on the protected computers: OracleRMAN: for Veeam Plug-In for Oracle RMAN SAPHANA: for Veeam Plug-In for SAP HANA SAPOnOracle: for Veeam Plug-In for SAP on Oracle Accepts the `VBRApplicationType[]` object. To get this object, run the `Get-VBRDiscoveredApplication` cmdlet.	`VBRApplicationType[]`	False	Named	True (ByPropertyName)
DistributionRepository	For protection groups for cloud machines. 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.	`VBRObjectStorageRepository`	False	Named	True (ByPropertyName, ByValue)
DistributionServer	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.	`CHost`	False	Named	True (ByPropertyName, ByValue)
InstallAgent	Defines that Veeam Backup & Replication will automatically install Veeam Agent on all discovered computers of the protection group.	`SwitchParameter`	False	Named	True (ByPropertyName)
InstallApplicationPlugins	Defines that Veeam Backup & Replication will automatically install Veeam Plug-In on all discovered computers of the protection group. Use the `ApplicationTypes` parameter to specify Veeam Plug-Ins that Veeam Backup & Replication will install.	`SwitchParameter`	False	Named	True (ByPropertyName)
InstallCDPAgent	Installs the Veeam CDP Agent Service and Veeam CDP Volume Filter Driver.	`SwitchParameter`	False	Named	True (ByPropertyName)
InstallDriver	Used only for Veeam Agent for Microsoft Windows. Defines that Veeam Backup & Replication will automatically install the CBT driver on discovered computers.	`SwitchParameter`	False	Named	True (ByPropertyName)
InstallNoSnapAgent	Defines that Veeam Backup & Replication will deploy the nosnap Veeam Agent on the discovered computers of the protection group.	`SwitchParameter`	False	Named	True (ByPropertyName)
RebootIfRequired	Defines that Veeam Backup & Replication will reboot discovered computers if required. Note: Reboot is required after the CBT driver installation.	`SwitchParameter`	False	Named	True (ByPropertyName)
UpgradeAutomatically	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.	`SwitchParameter`	False	Named	True (ByPropertyName)

<CommonParameters>

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

Output Object

VBRProtectionGroupDeploymentOptions

Examples

New-VBRProtectionGroupDeploymentOptions 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:

Run the Get-VBRServer 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.

New-VBRProtectionGroupDeploymentOptions 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:

Create an object with Veeam Agent deployment settings:
- Run the Get-VBRServer 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.
Apply Veeam Agent deployment settings to a protection group:
- Run the Get-VBRProtectionGroup cmdlet. Specify the Name parameter value. Save the result to the $group variable.
- Run the Set-VBRProtectionGroup cmdlet. Set the $group variable as the ProtectionGroup parameter value. Set the $deployment variable as the DeploymentOptions parameter value.