PowerCLI Reference



This cmdlet modifies the policy for overriding port group settings at port level.


Set-VDPortgroupOverridePolicy [-Policy] <VDPortgroupOverridePolicy[]> [-BlockOverrideAllowed <Boolean>] [-ResetPortConfigAtDisconnect <Boolean>] [-SecurityOverrideAllowed <Boolean>] [-TrafficShapingOverrideAllowed <Boolean>] [-UplinkTeamingOverrideAllowed <Boolean>] [-VlanOverrideAllowed <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version

Detailed Description

This cmdlet modifies the policy for overriding port group settings at port level. At least one of the Bool parameters must be specified.


NameTypeDescriptionRequired?Pipeline InputDefault Value
PolicyVDPortgroupOverridePolicy[]Specifies the port group overriding policy that you want to configure.truetrue (ByValue)
BlockOverrideAllowedBooleanSpecifies whether overriding port blocking settings is allowed.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
ResetPortConfigAtDisconnectBooleanSpecifies whether the port configuration is reset when the port is disconnected.falsefalse
SecurityOverrideAllowedBooleanSpecifies whether overriding security settings is allowed.falsefalse
TrafficShapingOverrideAllowedBooleanSpecifies whether overriding traffic shaping settings is allowed.falsefalse
UplinkTeamingOverrideAllowedBooleanSpecifies whether overriding uplink teaming settings is allowed.falsefalse
VlanOverrideAllowedBooleanSpecifies whether overriding VLAN settings is allowed.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 VDPortgroupOverridePolicy objects



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

Get-VDPortgroup "MyVDPortgroup" | Get-VDPortgroupOverridePolicy | Set-VDPortgroupOverridePolicy -BlockOverrideAllowed $true

Retrieves a distributed port group named "MyVDPortgroup" and updates its overriding policy to allow the port blocking settings to override the default settings at port group level.

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

Get-VDSwitch "MyVDSwitch" |
Get-VDPortgroup | Get-VDPortgroupOverridePolicy |
Set-VDPortgroupOverridePolicy -ResetPortConfigAtDisconnect $true
-TrafficShapingOverrideAllowed $true

Retrieves all port groups inside a distributed switch named "MyVDSwitch" and updates their overriding policies with the options to override the traffic shaping setting at port level, and to reset the distributed port network settings back to the port group settings.

Copyright © VMware, Inc. All rights reserved.