Citrix Systems 6 manual Vlan Commands, Vif-create, Vif-destroy, Vif-plug, Vif-unplug

Parameter Name	Description			Type
other-config:promiscuous	true to a VIF to be			read write
	promiscuous on the bridge, so
	that	it sees	all traffic over
	the bridge. Useful for running
	an Intrusion Detection System
	(IDS) or similar in a VM.
network-uuid	the	unique	identifier/object	read only
	reference of the virtual network
	to which this VIF is connected
network-name-label	the descriptive name of the			read only
	virtual network to which this VIF
	is connected
io_read_kbs	average read rate in kB/s for this			read only
	VIF
io_write_kbs	average write rate in kB/s for			read only
	this VIF

vif-create

vif-createvm-uuid=<uuid_of_the_vm>device=<see below> network-uuid=<uuid_of_the_network_the_vif_will_connect_to>[mac=<mac_address>]

Create a new VIF on a VM.

Appropriate values for the device field are listed in the parameter allowed-VIF-deviceson the specified VM. Before any VIFs exist there, the allowable values are integers from 0-15.

The mac parameter is the standard MAC address in the form aa:bb:cc:dd:ee:ff. If you leave it unspecified, an appropriate random MAC address will be created. You can also explicitly set a random MAC address by specifying mac=random.

vif-destroy

vif-destroy uuid=<uuid_of_vif>

Destroy a VIF.

vif-plug

vif-pluguuid=<uuid_of_vif>

Attempt to attach the VIF while the VM is in the running state.

vif-unplug

vif-unplug uuid=<uuid_of_vif>

Attempts to detach the VIF from the VM while it is running.

VLAN Commands

Commands for working with VLANs (virtual networks). To list and edit virtual interfaces, refer to the PIF commands, which have a VLAN parameter to signal that they have an associated virtual network (see the section called “PIF Commands”). For example, to list VLANs you need to use xe pif-list.

166