PowerCLI Reference

Set-VDVlanConfiguration

Synopsis

This cmdlet modifies the virtual distributed port's VLAN configuration.

Syntax

Set-VDVlanConfiguration -VDPortgroup <VDPortgroup[]> [-DisableVlan] [-VlanId <Int32>] [-VlanTrunkRange <VlanRangeList>] [-PrivateVlanId <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Set-VDVlanConfiguration -VDSwitch <VDSwitch[]> [-DisableVlan] [-VlanId <Int32>] [-VlanTrunkRange <VlanRangeList>] [-PrivateVlanId <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Set-VDVlanConfiguration -VDPort <VDPort[]> [-DisableVlan] [-VlanId <Int32>] [-VlanTrunkRange <VlanRangeList>] [-PrivateVlanId <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version

Detailed Description

This cmdlet modifies the virtual distributed port's VLAN configuration. For vSphere distributed switch and port group parameter sets, the cmdlet modifies the respective default port configuration.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
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
DisableVlanSwitchParameterSets the VLAN type to None.falsefalse
PrivateVlanIdInt32Specifies the secondary VLAN ID of a vSphere distributed switch's private VLAN configuration entry. The VLAN IDs of 0 and 4095 are reserved and cannot be used.falsefalse
VDPortVDPort[]Specifies the port whose VLAN configuration you want to modify.truetrue (ByValue)
VDPortgroupVDPortgroup[]Specifies the port group whose default VLAN port configuration you want to modify.truetrue (ByValue)
VDSwitchVDSwitch[]Specifies the vSphere distributed switch whose default VLAN port configuration you want to modify.truetrue (ByValue)
VlanIdInt32Specifies a new VLAN ID. The VLAN IDs of 0 and 4095 are reserved and cannot be used.falsefalse
VlanTrunkRangeVlanRangeListSpecifies a new VLAN trunk range. Valid values are strings representing ranges of IDs. For example, "1-4, 6, 8-9".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 updated entity - VDPort, VDPortgroup, or VDSwitch

Notes

Examples

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

Get-VDSwitch "MyVDSwitch" | Get-VDPort -ActiveOnly | Set-VDVlanConfiguration -PrivateVlanId 4

Assigns all active ports of a specific vSphere distributed switch named "MyVDSwitch" to a private VLAN with ID "4".

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

Get-VDPortgroup "MyVDPorgroup" | Get-VDPort | Set-VDVlanConfiguration -VlanId 3

Assigns all ports of a specific distributed port group named "MyVDPorgroup" to a VLAN with ID "3".


Copyright © VMware, Inc. All rights reserved.