This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBRNetworkTrafficRule

Short Description

Creates network traffic rules.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Add-VBRNetworkTrafficRule -Name <String> -SourceIPStart <IPAddress> -SourceIPEnd <IPAddress> -TargetIPStart <IPAddress> -TargetIPEnd <IPAddress> [-EnableEncryption [<SwitchParameter>]] [-EnableThrottling [<SwitchParameter>]] [-ThrottlingUnit <VBRSpeedUnit>] [-ThrottlingValue <Int32>] [-EnableThrottlingWindow [<SwitchParameter>]] [-ThrottlingWindowOptions <VBRBackupWindowOptions>] [<CommonParameters>]

Detailed Description

This cmdlet creates network traffic rules. With network traffic rules, you can limit the traffic throughput between components in the backup infrastructure.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Name

Specifies a name that you want to assign to a network traffic rule.

True

Named

False

False

SourceIPStart

Specifies the first IP address of the IP source range.

True

Named

False

False

SourceIPEnd

Specifies the last IP address of the IP source range.

True

Named

False

False

TargetIPStart

Specifies the first IP address of the IP target range.

True

Named

False

False

TargetIPEnd

Specifies the last IP address of the IP target range.

True

Named

False

False

EnableEncryption

Enables encryption for a network traffic rule. Veeam Backup & Replication will encrypt the data that is passed between backup infrastructure components on the source and target side.

False

Named

False

False

EnableThrottling

Enables throttling for a network traffic rule. Veeam Backup & Replication will limit the traffic throughput between the backup infrastructure components within the specified IP range.

Use the following parameters to set the maximum value:

  • ThrottlingValue
  • ThrottlingUnit

False

Named

False

False

ThrottlingValue

Specifies the maximum speed value that must be used to transfer VM machine data from source to target.

False

Named

False

False

ThrottlingUnit

For the EnableThrottling parameter.

Specifies the measuring unit for the ThrottlingValue parameter: You can set the following units:

  • MbitPerSec
  • MbytePerSec
  • KbytePerSec

Default: MbitPerSec.

False

Named

False

False

EnableThrottlingWindow

Indicates that a schedule for a network traffic rule is enabled.

False

Named

False

False

ThrottlingWindowOptions

Specifies the time interval during which Veeam Backup & Replication must apply a network traffic rule.

Accepts the  VBRBackupWindowOptions type.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Example

This command creates a network traffic rule.

Add-VBRNetworkTrafficRule -Name "New rule" -SourceIPStart 192.168.0.1 -SourceIPEnd 192.168.0.255 -TargetIPStart 192.168.0.1 -TargetIPEnd 192.168.0.255 -EnableThrottling -ThrottlingValue 5 -ThrottlingUnit MbitPerSec