Troubleshooting ESXi VLAN Configurations using Command Line Tools

There are a few ways to troubleshoot network/VLAN configuration from a command line, using tools such as ESXCLI and vicfg/esxcfg either locally on the ESXi host or remotely using vCLI or the vMA. Here, I’ll aim to give examples using esxcfg commands ran from a vMA, and ESXCLI commands executed locally on the ESXi host.

Listing Port Group Settings

~ # esxcli network vswitch standard portgroup list
Name                Virtual Switch  Active Clients  VLAN ID
------------------  --------------  --------------  -------
Management Network  vSwitch0                     1        0
VM Network          vSwitch3                     0        0
vMotion             vSwitch0                     1        0

vi-admin@vma:~[192.168.88.134]> esxcfg-vswitch -l
Switch Name     Num Ports       Used Ports      Configured Ports    MTU     Uplinks
vSwitch0        128             5               128                 1500    vmnic1,vmnic0

   PortGroup Name                VLAN ID   Used Ports      Uplinks
   vMotion                       0         1               vmnic1
   Management Network            0         1               vmnic0

Switch Name     Num Ports       Used Ports      Configured Ports    MTU     Uplinks
vSwitch3        128             3               128                 1500    vmnic7,vmnic6

   PortGroup Name                VLAN ID   Used Ports      Uplinks
   VM Network                    0         0               vmnic7,vmnic6

DVS Name                 Num Ports   Used Ports  Configured Ports  Uplinks
DSwitch1                 256         5           256               vmnic4,vmnic5,vmnic8,vmnic9

   DVPort ID           In Use      Client
   8                   1           vmnic4
   9                   1           vmnic9
   10                  1           vmnic8
   11                  1           vmnic5
   0                   0
   1                   0

Configuring VLAN Tags

~ # esxcli network vswitch standard portgroup set -p vMotion --vlan-id 10
~ # esxcli network vswitch standard portgroup list
Name                Virtual Switch  Active Clients  VLAN ID
------------------  --------------  --------------  -------
Management Network  vSwitch0                     1        0
VM Network          vSwitch3                     0        0
vMotion             vSwitch0                     1       10
vi-admin@vma:~[192.168.88.134]> esxcfg-vswitch vSwitch0 -p vMotion -v 0

Adding and Removing Port Groups

esxcli network vswitch standard portgroup add -p testpg -v vSwitch0
~ # esxcli network vswitch standard portgroup set -p testpg --vlan-id 1000
~ # esxcli network vswitch standard portgroup list
Name                Virtual Switch  Active Clients  VLAN ID
------------------  --------------  --------------  -------
Management Network  vSwitch0                     1        0
VM Network          vSwitch3                     0        0
testpg              vSwitch0                     0     1000
vMotion             vSwitch0                     1        0
esxcfg-vswitch --add-pg testpg vSwitch1

To delete a port group:

~ # esxcli network vswitch standard portgroup remove -p testpg -v vSwitch0
~ # esxcli network vswitch standard portgroup list
Name                Virtual Switch  Active Clients  VLAN ID
------------------  --------------  --------------  -------
Management Network  vSwitch0                     1        0
VM Network          vSwitch3                     0        0
vMotion             vSwitch0                     1        0
esxcfg-vswitch --del-pg testpg vSwitch1

Useful Links and Resources

vSphere Command Line Guide

Related posts

VMware vSphere Virtual Machine Snapshots Explained

How to Enable SSH on All ESXi Hosts using PowerCLI

How to Install VMware Tools on Debian 11

This website uses cookies to improve your experience. We'll assume you're ok with this, but you can opt-out if you wish. Read More