This command is used to display information about virtual ports on a fabric. Virtual ports track switch information across nodes on the fabric.


Informational Note:  The output fields for hypervisor and VM information is not automatically populated. In future releases, this information is gathered using a multicast communication across the fabric.

Syntax   vport-show

owner node name 

Displays the owner name.

mac mac-address

Displays the MAC address of the vPort.

vnet vnet-name

Displays the VNET name.

Specify up to two of the following options:

vlan vlan-id

Displays a VLAN from 0 to 4095.

public-vlan vlan-id

Displays the ID of the public VLAN.

vxlan vxlan-id

Displays a VXLAN from 0 to 16777215.

ip ip-address

DisplaysDisplays an IP address.

num-ips num-ips-number

Displays the number of IP addresses for the vPort.

Displays any of the following options:

config-intf config-intf-number

Displays the configuration interface number.

ports port-list

Displays the list of ports.

state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned|peer-port-not-cluster-link|

Displays the vPort state.

svc-name svc-name-string

Displays the name of the vCenter connection service.

hostname hostname-string

Displays the hypervisor or switch host name.

entity entity-string

Displays the VM or KVM device name.

power none|powered-off|powered-on|

Displays the vPort entry status.

cpus cpus-number

Displays the number of CPUs assigned to the VM.

os os-string

Displays an operating system, such as CentOS or Ubuntu, on the VM.

portgroup portgroup-string

Displays the port group name associated with the VM MAC address.

pg-vlans vlan-list

Displays the VLANs assigned to a port group.

vswitch vswitch-string

Displays the name of the virtual switch associated with a NIC.

vs-type none|host-vs|distributed-vs|

Displays the type of virtual switch.

vnic-type untagged|tagged|trunked|vm-mgmt|vm-kernel|vMotion|vSAN|FTL|    rep|p-NFC|r-NFC|mgmt|unknown

Displays the type of vNIC associated with the VM or VM-Kernel.

config none|owner|ip|port|hostname|entity|cpus|os

Displays the configuration type for the virtual switch.

rem-switch node name

Displays the name of the remote switch.

rem-intf rem-intf-number

Displays the remote interface number.

rem-ports port-list

Displays the remote switch ports.

peer-intf peer-intf-number

Displays the peer interface number.

peer-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peerport-missing|peer-port-not-vlag|peer-port-not orphaned|peer-port-not-cluster-links|sw-active|anycast|

Displays the state of the peer vPorts.

peer-owner-state active|static|vrrp|tunnel|software|needs-peer-status|port-mac|hit|ageout-check|moving|loop-probe|local-tunnel|igmp-mac|user-flush|vxlan-loopback|router|update-peer-only|active-state-mismatch|peerport-missing|peer-port-not-vlag|peer-port-not orphaned|peer-port-not-cluster-links|sw-active|anycast|

Displays the state of the peer owner vPorts.

status phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|   PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|no-pktin|no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|remote-l3-port|vdp|dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|vlag-active|vlag-blocked|

Displays the vPort status.

tunnel tunnel-string

Displays the vPort tunnel.

create-time date/time: yyyy-mm-ddTHH:mm:ss

Displays the vPort create time.

last-seen date/time: yyyy-mm-ddTHH:mm:ss

Displays the last time the vPorts was seen.

vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss

Displays the time and date of the VXLAN LRU.

hit hit-number

Displays the number of hits.

migrate migrate-number

Displays the number of times the entry migrated.

drops drops-number

Displays the number of dropped packets.

hw-index hw-index-number

Displays the hardware index number.

rt-if rt-if-string

Displays the router interface.

hw-flags invalid-vlan|invalid-port

Displays hardware flags.



Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI


Version 2.2

Command introduced.

Version 2.2.6

The parameters, stp-edge-port|LACP-wait| adjacency-wait|adjacency-check|vlag-wait|multicast-router, added.

Version 2.3

The parameters, num-ips and vm-status, added.

Version 2.4.1

The parameter, public-vlan, added.

Version 2.6.2

The parameter, svc-name, power, entity, portgroup, pg-vlans, vswitch, vs-type, and vnic-type, added.

The parameters, hypervisor, vm-id, vm-name, vm-flavor, vm-status, memory, deprecated.

Version 3.0.0

The options, anycast, invalid-vlan, and owner-lost, added to state, peer-state, and peer-owner-state.

Usage   Use this command to display vPort information on the switch. vPorts are mirrored across the fabric so that every switch knows about all the L2 entries on the fabric. This is useful for troubleshooting connections across the fabric.

Examples  To display vPorts, use the following syntax:

CLI network-admin@switch > vport-show format all layout vertical

mac:          66:0e:94:21:64:74

vlan:         103

config-intf:  70

config:       port

switch-id:    pleiades24

mac:          00:00:5e:00:01:0a

vlan:         107

config:       switch

rem-switch:   pleiades25

switch-id:    pleiades25

mac:          66:0e:94:21:a9:6c

vlan:         100


intf:         65

ports:        65

state:        active

hostname:     pleiades25

status:       PN-internal

create-time:  09-10,15:17:47

last-seen:    09-15,10:55:22

hit:          2

migrate:      1

switch-id:    pleiades24

mac:          66:0e:94:21:64:74

vlan:         100


intf:         65

ports:        65

hostname:     pleiades24

status:       PN-internal

create-time:  09-10,15:17:48

last-seen:    09-10,15:17:48

hit:          1

switch-id:    pleiades24