Technical Documentation

Supported Platforms
EX Series

show vlans

Syntax

show vlans <brief | detail | extensive><dot1q-tunneling><management-vlan><sort-by (name | tag)><summary><vlan-name><vlan-range-name>

Release Information

Command introduced in Junos OS Release 9.0 for EX Series switches.

Command modified in Junos OS Release 9.2 for EX Series switches to display support for MAC-based VLANs and sort-by (name |tag) and vlan-range-name options.

Command modified in Junos OS Release 9.4 for EX Series switches to display whether MAC learning is disabled and to include the management-vlan option.

Command modified in Junos OS Release 9.5 for EX Series switches to include the summary option.

Command modified in Junos OS Release 10.0 for EX Series switches to display output for the MAC aging timer and MVRP dynamic VLANs.

Description

Display information about VLANs configured on bridged Ethernet interfaces. For interfaces configured to support a VoIP VLAN and a data VLAN, the show vlans command displays both tagged and untagged membership for those VLANs.

Note: When a series of VLANs is created with the vlan-range statement, such VLAN names are prefixed and suffixed with a double underscore. For example, a series of VLANs using the VLAN range 1–3 and the base VLAN name marketing are displayed as __marketing_1__, __marketing_2__, and __marketing_3__.

Note: To display an 802.1X supplicant successfully authenticated in multiple-supplicant mode with dynamic VLAN movement, use the show vlans vlan-name extensive operational mode command, where vlan-name is the dynamic VLAN.

Options

none: Display information for all VLANs. VLAN information is displayed by VLAN name in ascending order.
brief | detail | extensive: (Optional) Display the specified level of output.
dot1q-tunneling: (Optional) Display VLANs with the Q-in-Q tunneling feature enabled.
management-vlan: (Optional) Display management VLANs.
sort-by (name | tag): (Optional) Display VLANs in ascending order of VLAN IDs or VLAN names.
summary: (Optional) Display the total number of VLANs and counts of VLANs by type—for example, the number of dynamic, 802.1Q, and Q-in-Q tunneled VLANs.
vlan-name: (Optional) Display information for the specified VLAN.
vlan-range-name: (Optional) Display information for the specified VLAN range. To see information for all members of the VLAN range, specify the base VLAN name—for example, employee for a VLAN range that includes __employee_1__ through __employee_10__.

Required Privilege Level

view

List of Sample Output

show vlans
show vlans brief
show vlans detail
show vlans extensive (MAC-based)
show vlans extensive (Port-based)
show vlans sort-by tag
show vlans sort-by name
show vlans employee (vlan-range-name)
show vlans summary

Output Fields

Table 1 lists the output fields for the show vlans command. Output fields are listed in the approximate order in which they appear.

Table 1: show vlans Output Fields

Field Name	Field Description	Level of Output
Name	Name of a VLAN.	none, brief
Tag	The 802.1Q tag applied to this VLAN. If none is displayed, no tag is applied.	All levels
Interfaces	Interface associated with learned MAC addresses or all-members (flood entry). An asterisk (*) beside the interface indicates that the interface is UP.	All levels
Address	The IP address.	none, brief
Ports Active / Total	The number of interfaces associated with a VLAN. The Active column indicates interfaces that are UP, and the Total column indicates interfaces that are active and inactive.	brief
VLAN	Name of a VLAN.	detail, extensive
Admin state	Indicates whether the physical link is operational and can pass packets.	detail, extensive
Dot1q Tunneling Status	Indicates whether Q-in-Q tunneling is enabled.	detail, extensive
MAC learning Status	Indicates whether MAC learning is disabled.	detail, extensive
Description	A description for the VLAN.	detail,extensive
Primary IP	Primary IP address associated with a VLAN.	detail
Number of interfaces	The number of interfaces associated with a VLAN. Both the total number of interfaces and the number of active interfaces associated with a VLAN are displayed.	detail, extensive
STP	The spanning tree associated with a VLAN.	detail, extensive
RTG	The redundant trunk group associated with a VLAN.	detail, extensive
Tagged interfaces	The tagged interfaces to which a VLAN is associated.	detail, extensive
Untagged interfaces	The untagged interfaces to which a VLAN is associated.	detail. extensive
Customer VLAN Ranges	Lists the customer VLAN (C-VLAN) ranges associated with this service VLAN (S-VLAN).	extensive
Private VLAN Mode	The private VLAN mode for this VLAN. Values are Primary, Isolated, and Community.	extensive
Primary VLAN	The primary VLAN tag for this secondary VLAN.	extensive
Interrnal Index	VLAN index internal to Junos OS.	extensive
Origin	The manner in which the VLAN was created. Values are static and learn.	extensive
Protocol	Port-based VLAN or MAC-based VLAN. MAC-based protocol is displayed when VLAN assignment is done either statically or dynamically through 802.1X.	extensive
Mac aging time	The MAC aging timer.	extensive
IP addresses	IP address associated with a VLAN.	extensive
Number of MAC entries	For MAC-based VLANs created either statically or dynamically, the MAC addresses associated with an interface.	extensive
Secondary VLANs	The secondary VLANs associated with a primary VLAN.	extensive
Isolated VLANs	The isolated VLANs associated with a primary VLAN.	extensive
Community VLANs	The community VLANs associated with a primary VLAN.	extensive
VLANs summary	VLAN counts: Total—Total number of VLANs on the switch. Configured VLANs—Number of VLANs that are based on user-configured settings. Internal VLANs—Number of VLANs created by the system with no explicit configuration or protocol—for example, the default VLAN and the VLAN created when a trunk interface is not configured with native VLAN membership. Temporary VLANs—Number of VLANs from the previous configuration that the system retains for a limited time after restart. Temporary VLANs are converted into one of the other types of VLAN, or are removed from the system if the current configuration does not require them.	All levels
Dot1q VLANs summary	802.1Q VLAN counts: Total—Total number of 802.1Q VLANs on the switch. Tagged VLANs—Number of tagged 802.1Q VLANs. Untagged VLANs—Number of untagged 802.1Q VLANs. Private VLAN—Counts of the following kinds of 802.1Q private VLANs (PVLANs): Primary VLANs—Number of primary forwarding private VLANs. Community VLANs—Number of secondary transporting and forwarding private VLANs. Isolated VLANs—Number of secondary receiving and forwarding private VLANs.	All levels
Dot1q Tunneled VLANs summary	Q-in-Q VLAN counts: Total—Total number of Q-in-Q VLANs on the switch. Private VLAN—Counts of primary, community, and isolated Q-in-Q private VLANs (PVLANs).	All levels
Dynamic VLANs	Counts of VLANs assigned or created dynamically by a protocol: Total—Total number of dynamic VLANs on the switch. Dot1x—Number of 802.1X VLANs authenticated and assigned when the switch learns the MAC address of a supplicant host from a packet’s source MAC address. MVRP—Number of VLANs created by the Multiple VLAN Registration Protocol (MVRP).	All levels

Sample Output

show vlans

user@switch>  show vlans

Name           Tag     Interfaces
default        None
                       ge-0/0/34.0, ge-0/0/33.0, ge-0/0/32.0, ge-0/0/31.0,
                       ge-0/0/30.0, ge-0/0/29.0, ge-0/0/28.0, ge-0/0/27.0,
                       ge-0/0/26.0, ge-0/0/25.0, ge-0/0/19.0, ge-0/0/18.0,
                       ge-0/0/17.0, ge-0/0/16.0, ge-0/0/15.0, ge-0/0/14.0,
                       ge-0/0/13.0, ge-0/0/11.0, ge-0/0/9.0, ge-0/0/8.0,
                       ge-0/0/3.0, ge-0/0/2.0, ge-0/0/1.0
v0001          1
                       ge-0/0/24.0, ge-0/0/23.0, ge-0/0/22.0, ge-0/0/21.0
v0002          2
                       None
v0003          3
                       None
v0004          4
                       None
v0005          5
                       None

show vlans brief

user@switch> show vlans brief

                                           Ports
Name           Tag     Address             Active/Total
default        None                        0/23
v0001          1                           0/4
v0002          2                           0/0
v0003          3                           0/0
v0004          4                           0/0
v0005          5                           0/0
v0006          6                           0/0
v0007          7                           0/0
v0008          8                           0/0
v0009          9                           0/0
v0010          10                          0/2
v0011          11                          0/0
v0012          12                          0/0
v0013          13                          0/0
v0014          14                          0/0
v0015          15                          0/0
v0016          16                          0/0

show vlans detail

user@switch> show vlans detail

VLAN: default, Tag: Untagged, Admin state: Enabled
  Description: None
  Primary IP: None, Number of interfaces: 23 (Active = 0)
  STP: None, RTG: None
  Untagged interfaces: ge-0/0/34.0, ge-0/0/33.0, ge-0/0/32.0, ge-0/0/31.0,
  ge-0/0/30.0, ge-0/0/29.0, ge-0/0/28.0, ge-0/0/27.0, ge-0/0/26.0,
  ge-0/0/25.0, ge-0/0/19.0, ge-0/0/18.0, ge-0/0/17.0, ge-0/0/16.0,
  ge-0/0/15.0, ge-0/0/14.0, ge-0/0/13.0, ge-0/0/11.0, ge-0/0/9.0, ge-0/0/8.0,
  ge-0/0/3.0, ge-0/0/2.0, ge-0/0/1.0,
  Tagged interfaces: None

VLAN: v0001, Tag: 802.1Q Tag 1, Admin state: Enabled
  Description: None
  Primary IP: None, Number of interfaces: 4 (Active = 0)
  Dot1q Tunneling Status: Enabled
  STP: None, RTG: None
  Untagged interfaces: None
  Tagged interfaces: ge-0/0/24.0, ge-0/0/23.0, ge-0/0/22.0, ge-0/0/21.0,

VLAN: v0002, Tag: 802.1Q Tag 2, Admin state: Enabled
  Description: None
  Primary IP: None, Number of interfaces: 0 (Active = 0)
  STP: None, RTG: None
  Untagged interfaces: None
  Tagged interfaces: None

VLAN: v0003, Tag: 802.1Q Tag 3, Admin state: Enabled
  Description: None
  Primary IP: None, Number of interfaces: 0 (Active = 0)
  STP: None, RTG: None
  Untagged interfaces: None
  Tagged interfaces: None

VLAN: vlan4000, 802.1Q Tag: Untagged, Admin State: Enabled
MAC learning Status: Disabled
Number of interfaces: 0 (Active = 0)

show vlans extensive (MAC-based)

user@switch> show vlans extensive

VLAN: default, Created at: Thu May 15 13:43:09 2008
Internal index: 3, Admin State: Enabled, Origin: Static
Protocol: Port Mode, Mac aging time: 300 seconds
Number of interfaces: Tagged 0 (Active = 0), Untagged  2 (Active = 2)
      ge-0/0/0.0*, untagged, access
      ge-0/0/14.0*, untagged, access
 
VLAN: vlan_dyn, Created at: Thu May 15 13:43:09 2008
Internal index: 4, Admin State: Enabled, Origin: Static
Protocol: Port Mode
Number of interfaces: Tagged 0 (Active = 0), Untagged  0 (Active = 0)
Protocol: MAC Based  
Number of MAC entries: 6 
      ge-0/0/0.0*
                  00:00:00:00:00:02 (untagged)
                  00:00:00:00:00:03 (untagged)
                  00:00:00:00:00:04 (untagged)
                  00:00:00:00:00:05 (untagged)
                  00:00:00:00:00:06 (untagged)
                  00:00:00:00:00:07 (untagged)

show vlans extensive (Port-based)

user@switch> show vlans extensive

VLAN: default, created at Mon Feb  4 12:13:47 2008
  Tag: None, Internal index: 0, Admin state: Enabled, Origin: static
  Description: None
  Dot1q Tunneling Status: Enabled
  Customer VLAN ranges:
                     1-4100
  Private VLAN Mode: Primary
  Protocol: Port based, Layer 3 interface: None
  IP addresses: None
  STP: None, RTG: None.
  Number of interfaces: Tagged 0 (Active = 0), Untagged 23 (Active = 0)
    ge-0/0/34.0 (untagged, access)
    ge-0/0/33.0 (untagged, access)
    ge-0/0/32.0 (untagged, access)
    ge-0/0/31.0 (untagged, access)
    ge-0/0/30.0 (untagged, access)
    ge-0/0/29.0 (untagged, access)
    ge-0/0/28.0 (untagged, access)
    ge-0/0/27.0 (untagged, access)
    ge-0/0/26.0 (untagged, access)
    ge-0/0/25.0 (untagged, access)
    ge-0/0/19.0 (untagged, access)
    ge-0/0/18.0 (untagged, access)
    ge-0/0/17.0 (untagged, access)
    ge-0/0/16.0 (untagged, access)
    ge-0/0/15.0 (untagged, access)
    ge-0/0/14.0 (untagged, access)
    ge-0/0/13.0 (untagged, access)
    ge-0/0/11.0 (untagged, access)
    ge-0/0/9.0 (untagged, access)
    ge-0/0/8.0 (untagged, access)
    ge-0/0/3.0 (untagged, access)
    ge-0/0/2.0 (untagged, access)
    ge-0/0/1.0 (untagged, access)

Secondary VLANs: Isolated 1, Community  1
  Isolated VLANs :
      __pvlan_pvlan_ge-0/0/3.0__
  Community VLANs :
      comm1

VLAN: v0001, created at Mon Feb  4 12:13:47 2008
  Tag: 1, Internal index: 1, Admin state: Enabled, Origin: static
  Description: None
  Protocol: Port based, Layer 3 interface: None
  IP addresses: None
  STP: None, RTG: None.
  Number of interfaces: Tagged 4 (Active = 0), Untagged 0 (Active = 0)
    ge-0/0/24.0 (tagged, trunk)
    ge-0/0/23.0 (tagged, trunk)
    ge-0/0/22.0 (tagged, trunk)
    ge-0/0/21.0 (tagged, trunk)

VLAN: v0002, created at Mon Feb  4 12:13:47 2008
  Tag: 2, Internal index: 2, Admin state: Enabled, Origin: static
  Description: None
  Protocol: Port based, Layer 3 interface: None
  IP addresses: None
  STP: None, RTG: None.
  Number of interfaces: Tagged 0 (Active = 0), Untagged 0 (Active = 0)
    None

VLAN: v0003, created at Mon Feb  4 12:13:47 2008
  Tag: 3, Internal index: 3, Admin state: Enabled, Origin: static
  Description: None
  Protocol: Port based, Layer 3 interface: None
  IP addresses: None
  STP: None, RTG: None.
  Number of interfaces: Tagged 0 (Active = 0), Untagged 0 (Active = 0)
    None

show vlans sort-by tag

user@switch> show vlans sort-by tag

Name           Tag     Interfaces
default                None
__vlan-x_1__   1
                       None
__vlan-x_2__   2
                       None
__vlan-x_3__   3
                       None
__vlan-x_4__   4
                       None
__vlan-x_5__   5
                       None
__vlan-x_6__   6
                       None
__vlan-x_7__   7
                       None
__vlan-x_8__   8
                       None
__vlan-x_9__   9
                       None
__vlan-x_10__  10
                       None
__vlan-x_11__  11
                       None
__vlan-x_12__  12
                       None
__vlan-x_13__  13
                       None
__vlan-x_14__  14
                       None
__vlan-x_15__  15
                       None
__vlan-x_16__  16
                       None
__vlan-x_17__  17
                       None
__vlan-x_18__  18
                       None
__vlan-x_19__  19
                       None
__vlan-x_20__  20
                       None

show vlans sort-by name

user@switch> show vlans sort-by name

Name             Tag   Interfaces

__employee_120__ 120
                       ge-0/0/22.0*
__employee_121__ 121
                       ge-0/0/22.0*
__employee_122__ 122
                       ge-0/0/22.0*
__employee_123__ 123
                       ge-0/0/22.0*
__employee_124__ 124
                       ge-0/0/22.0*
__employee_125__ 125
                       ge-0/0/22.0*
__employee_126__ 126
                       ge-0/0/22.0*
__employee_127__ 127
                       ge-0/0/22.0*
__employee_128__ 128
                       ge-0/0/22.0*
__employee_129__ 129
                       ge-0/0/22.0*
__employee_130__ 130
                       ge-0/0/22.0*

show vlans employee (vlan-range-name)

user@switch> show vlans employee

Name             Tag   Interfaces

__employee_120__ 120
                       ge-0/0/22.0*
__employee_121__ 121
                       ge-0/0/22.0*
__employee_122__ 122
                       ge-0/0/22.0*
__employee_123__ 123
                       ge-0/0/22.0*
__employee_124__ 124
                       ge-0/0/22.0*
__employee_125__ 125
                       ge-0/0/22.0*
__employee_126__ 126
                       ge-0/0/22.0*
__employee_127__ 127
                       ge-0/0/22.0*
__employee_128__ 128
                       ge-0/0/22.0*
__employee_129__ 129
                       ge-0/0/22.0*
__employee_130__ 130
                       ge-0/0/22.0*

show vlans summary

user@switch> show vlans summary

VLANs summary:
         Total: 8,   Configured VLANs: 5
         Internal VLANs: 1,  Temporary VLANs: 0
   
     Dot1q VLANs summary:
         Total: 8,  Tagged VLANs: 2, Untagged VLANs: 6
         Private VLAN:
             Primary VLANs: 2,  Community VLANs: 2, Isolated VLANs: 3
   
     Dot1q Tunneled VLANs summary:
         Total: 0
         Private VLAN:
             Primary VLANs: 0,  Community VLANs: 0, Isolated VLANs: 0
   
     Dynamic VLANs:
        Total: 2,  Dot1x: 2, MVRP: 0

Technical Documentation

show vlans

Syntax

Release Information

Description

Options

Required Privilege Level

Related Topics

List of Sample Output

Output Fields

Sample Output

Sample Output

Published: 2010-06-22