PowerCLI Reference

Set-VDTrafficShapingPolicy

Synopsis

This cmdlet modifies the traffic shaping policy for distributed ports.

Syntax

Set-VDTrafficShapingPolicy [-Policy] <TrafficShapingPolicy[]> [-Enabled <Boolean>] [-EnabledInherited <Boolean>] [-AverageBandwidth <Int64>] [-AverageBandwidthInherited <Boolean>] [-BurstSize <Int64>] [-BurstSizeInherited <Boolean>] [-PeakBandwidth <Int64>] [-PeakBandwidthInherited <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VDTrafficShapingPolicy

Detailed Description

This cmdlet modifies the traffic shaping policy for distributed ports or the default port policy at port group or switch level (depending on the input policy).

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
PolicyTrafficShapingPolicy[]Specifies the traffic shaping policy that you want to configure.truetrue (ByValue)
AverageBandwidthInt64Specifies the average bandwidth of the traffic shaping policy for the corresponding distributed port, port group, or switch. The value is in bits per second.falsefalse
AverageBandwidthInheritedBooleanSpecifies whether the AverageBandwidth setting is inherited from a parent object, such as a distributed port group or switch.falsefalse
BurstSizeInt64Specifies the burst size of the traffic shaping policy for the corresponding distributed port, port group, or switch. The value is in bits per second.falsefalse
BurstSizeInheritedBooleanSpecifies whether the BurstSize setting is inherited from a parent object, such as a distributed port group or switch.falsefalse
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
EnabledBooleanSpecifies whether traffic shaping is enabled for the corresponding distributed port, port group, or switch.falsefalse
EnabledInheritedBooleanSpecifies whether the Enabled setting is inherited from a parent object, such as a distributed port group or switch.falsefalse
PeakBandwidthInt64Specifies the peak bandwidth of the traffic shaping policy for the corresponding distributed port, port group, or switch. The value is in bits per second.falsefalse
PeakBandwidthInheritedBooleanSpecifies whether the PeakBandwidth setting is inherited from a parent object, such as a distributed port group or switch.falsefalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

The modified TrafficShapingPolicy objects

Notes

Examples

-------------- Example 1 --------------

Get-VDSwitch "MyVDSwitch" | Get-VDPortgroup "MyVDPortgroup" | Get-VDPort -Key 4| Get-VDTrafficShapingPolicy -Direction In | Set-VDTrafficShapingPolicy -Enabled $true -AverageBandwidth 100000

Enables traffic shaping for a specific port in a distributed port group named "MyVDPortgroup" and updates the average bandwidth settings in their traffic shaping policies.

-------------- Example 2 --------------

Get-VDPortgroup "MyVDPortgroup" | Get-VDTrafficShapingPolicy | Set-VDTrafficShapingPolicy -BurstSizeInherited

Retrieves a distributed port group named "MyVDPortgroup" and updates its traffic shaping policy by inheriting the burst size from its corresponding parent.


Copyright © VMware, Inc. All rights reserved.