## PowerCLI Reference

# Set-VDUplinkLacpPolicy

## Synopsis

This cmdlet modifies the Link Aggregation Control Protocol policy for uplink ports.

Syntax

Set-VDUplinkLacpPolicy [-Policy] <UplinkLacpPolicy[]> [-Enabled <Boolean>] [-EnabledInherited <Boolean>] [-Mode <UplinkLacpMode>] [-ModeInherited <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VDUplinkLacpPolicy

Detailed Description

This cmdlet modifies the Link Aggregation Control Protocol policy for uplink ports at switch or uplink port group level.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Policy | UplinkLacpPolicy[] | Specifies the Link Aggregation Control Protocol policy that you want to configure. | true | true (ByValue)
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
Enabled | Boolean | Specifies whether the Link Aggregation Control Protocol is enabled for the corresponding uplink port group or vSphere distributed switch. | false | false
EnabledInherited | Boolean | Specifies whether the Enabled setting is inherited from a parent object, such as a vSphere distributed switch. | false | false
Mode | UplinkLacpMode | Specifies the mode of the Link Aggregation Control Protocol policy for the corresponding uplink port group or vSphere distributed switch. The value can be Active or Passive. | false | false
ModeInherited | Boolean | Specifies whether the Mode setting is inherited from a parent object, such as a vSphere distributed switch. | 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 VDUplinkLacpPolicy objects

Notes

Examples

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

    Get-VDSwitch "MyVDSwitch" | Get-VDUplinkLacpPolicy | Set-VDUplinkLacpPolicy -Enabled $true -Mode Active

Retrieves a vSphere distributed switch named "MyVDSwitch" and updates its policy to enable the Link Aggregation Control Protocol, and sets the corresponding policy mode to active.

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

    Get-VDPortgroup "MyVDPortgroup" | Get-VDUplinkLacpPolicy | Set-VDUplinkLacpPolicy -ModeInherited $true

Retrieves a distributed port group named "MyVDPortgroup" and updates its Link Aggregation Control Protocol mode based on its parent object's setting values.

Copyright © VMware, Inc. All rights reserved.