PowerCLI Reference

Set-VDPortgroupOverridePolicy

Synopsis

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

Syntax

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

Related Commands

Online version
Get-VDPortgroupOverridePolicy

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.

Parameters

Name	Type	Description	Required?	Pipeline Input
Policy	VDPortgroupOverridePolicy[]	Specifies the port group overriding policy that you want to configure.	true	true (ByValue)
BlockOverrideAllowed	Boolean	Specifies whether overriding port blocking settings is allowed.	false	false
Confirm	SwitchParameter	If 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.	false	false
ResetPortConfigAtDisconnect	Boolean	Specifies whether the port configuration is reset when the port is disconnected.	false	false
SecurityOverrideAllowed	Boolean	Specifies whether overriding security settings is allowed.	false	false
TrafficShapingOverrideAllowed	Boolean	Specifies whether overriding traffic shaping settings is allowed.	false	false
UplinkTeamingOverrideAllowed	Boolean	Specifies whether overriding uplink teaming settings is allowed.	false	false
VlanOverrideAllowed	Boolean	Specifies whether overriding VLAN settings is allowed.	false	false
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	false

Return Type

The modified VDPortgroupOverridePolicy objects

Notes

Examples

-------------- 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.