New-VBRProtectionGroupAdvancedWindowsOptions

Short Description

Creates additional settings for Veeam Agent for Microsoft Windows.

Applies to

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

Syntax

New-VBRProtectionGroupAdvancedWindowsOptions [-EnableBandwidthThrottling] [-BandwidthThrottlingValue <int>] [-BandwidthThrottlingUnitType <VBRSpeedUnit> {MbitPerSec | MbytePerSec | KbytePerSec}] [-DisableBackupOverMeteredConnection] [-DisableBackupOverVPNConnections] [-UseSpecifiedWiFiNetworks] [-WiFiNetworks <string[]>] [-EnableAgentThrottling] [-ThrottleAgentOn <VBREpThrottlingAgentType> {Workstations | Servers | AllHosts}] [-EnableFLRWithoutAdministrativeAccount]  [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRProtectionGroupAdvancedWindowsOptions object. This object contains additional settings for Veeam Agent for Microsoft Windows machines. These settings will be applied to Veeam Agent deployed on computers added to a protection group. You can specify the following types of settings:

  • Network usage settings
  • Throttling settings
  • Security settings

Tip

To apply the settings to an existing protection group, save the VBRProtectionGroupAdvancedWindowsOptions object to the variable and run the Set-VBRProtectionGroup cmdlet.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

EnableBandwidthThrottling

Enables the bandwidth limit.

Use the BandwidthThrottlingValue and the BandwidthThrottlingUnitType parameters to set the value and the unit type for bandwidth limit.

SwitchParameter

False

Named

True (ByProperty
Name)

BandwidthThrottlingValue

Specifies the bandwidth limit value.

Int

False

Named

True (ByProperty
Name)

BandwidthThrottlingUnitType

Specifies the measure units for measure limit. You can select the following type of measure units:

  • MbitPerSec: for megabit per second unit
  • MbytePerSec: for megabyte per second unit
  • KbytePerSec: for kilobyte per second unit

VBRSpeedUnit

False

Named

True (ByProperty
Name)

DisableBackupOverMeteredConnection

Defines that backup over metered connections will be disabled.

SwitchParameter

False

Named

True (ByPropertyName)

DisableBackupOverVPNConnections

Defines that backup over VPN connections will be disabled.

SwitchParameter

False

Named

True (ByPropertyName)

UseSpecifiedWiFiNetworks

Defines that Veeam Backup & Replication will restrict the WiFi usage to the specified networks.

Use the WiFiNetworks parameter to specify the networks over which backup will be allowed.

SwitchParameter

False

Named

True (ByPropertyName)

WiFiNetworks

Specifies the SSID of the Wi-Fi network. Veeam Agent will perform backup over the specified SSID only.

String[]

False

Named

True (ByPropertyName)

EnableAgentThrottling

Enables throttling for Veeam Agent activities during backup.

Use the ThrottleAgentOn parameter to specify the type of computers.

SwitchParameter

False

Named

True (ByPropertyName)

ThrottleAgentOn

Specifies the type of computers. Veeam Backup & Replication will throttle Veeam Agent activities during backup on computers of these types.

You can select one of the following types of the computers:

  • Workstations
  • Servers
  • AllHosts

VBREpThrottlingAgentType

False

Named

True (ByPropertyName)

EnableFLRWithoutAdministrativeAccount

Defines that users without administrative privileges will be able to perform file-level restore on Veeam Agent computers.

Note: This parameter works only for backups located on Veeam Backup & Replication.

SwitchParameter

False

Named

True (ByPropertyName)

<CommonParameters>

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

Output Object

VBRProtectionGroupAdvancedWindowsOptions

Examples

New-VBRProtectionGroupAdvancedWindowsOptionsExample 1. Creating Additional Settings for Microsoft Windows Machines

New-VBRProtectionGroupAdvancedWindowsOptionsExample 2. Applying Additional Settings to Protection Group

Related Commands

Page updated 5/3/2024

Page content applies to build 12.3.1.1139