configure vm add virtual-interface

configure vm vm_name add virtual-interface port port {vlan vlan_id} {name vf_name}

Description

Adds a virtual interface to a guest virtual machine (VM).

Syntax Description

vm Virtual machine.
vm_name Specifies the VM to add the virtual interface to.
add Specifies adding a virtual interface.
virtual-interface Specifies the virtual interface to add.
name Specifies adding an optional name to the virtual interface.
vf_name Specifies an optional name (unique within this VM) for the virtual interface to add to the VM.
port Specifies the associated dedicated port (physical function for this virtual interface).
port Specifies the dedicated port number.
vlan Specifies an optional VLAN mapped to this virtual interface.
vlan_id Specifies the VLAN ID tag between 1 and 4,094.

Default

N/A.

Usage Guidelines

The maximum number of virtual interfaces that you can attach is 16. The dedicated port specified cannot already be a dedicated port within the VM.

To delete a virtual interface from a guest VM, use the configure vm vm_name delete virtual-interface [name vf_name | mac mac_addr] command.

Example

The following example add a virtual interface to the VM "vm1" on port 7:

# configure vm vm1 add virtual-interface port 7

History

This command was first available in ExtremeXOS 30.5.

Platform Availability

This command is available on all platforms that support the Integrated Application Hosting (IAH) feature and have a Core or Premier license installed. For a list of platforms that support the IAH feature and for information about licenses, see the ExtremeXOS 32.1 Feature License Requirements .