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

Copyright © VMware, Inc. All rights reserved.