147
For scripting, a useful technique is passing --minimal on the command line, causing xe to print only the
first field in a comma-separated list. For example, the command xe vm-list --minimal on a XenServer host
with three VMs installed gives the three UUIDs of the VMs, for example:
a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
42c044de-df69-4b30-89d9-2c199564581d
xe command reference
This section provides a reference to the xe commands. They are grouped by objects that the commands
address, and listed alphabetically.
Bonding commands
Commands for working with network bonds, for resilience with physical interface failover. See the section
called “Creating NIC bonds on a standalone host” for details.
The bond object is a reference object which glues together master and member PIFs. The master PIF is
the bonding interface which must be used as the overall PIF to refer to the bond. The member PIFs are a
set of 2 or more physical interfaces which have been combined into the high-level bonded interface.
Bond parameters
Bonds have the following parameters:
Parameter Name Description Type
uuid unique identifier/object reference for the
bond
read only
master UUID for the master bond PIF read only
members set of UUIDs for the underlying bonded
PIFs
read only set parameter
bond-create
bond-create network-uuid=<network_uuid> pif-uuids=<pif_uuid_1,pif_uuid_2,...>
Create a bonded network interface on the network specified from a list of existing PIF objects. The command
will fail if PIFs are in another bond already, if any member has a VLAN tag set, if the referenced PIFs are
not on the same XenServer host, or if fewer than 2 PIFs are supplied.
bond-destroy
host-bond-destroy uuid=<bond_uuid>
Delete a bonded interface specified by its UUID from the XenServer host.
