Syntax
Set-VDPortgroupOverridePolicy [-Policy] <VDPortgroupOverridePolicy[]> [-BlockOverrideAllowed [<Boolean>]] [-ResetPortConfigAtDisconnect [<Boolean>]] [-SecurityOverrideAllowed [<Boolean>]] [-TrafficShapingOverrideAllowed [<Boolean>]] [-UplinkTeamingOverrideAllowed [<Boolean>]] [-VlanOverrideAllowed [<Boolean>]] [-WhatIf] [-Confirm] [<CommonParameters>]Related Commands
Online versionDetailed 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 | Default Value |
---|---|---|---|---|---|
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 objectsNotes
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.