XenServer Administrator's Guide 4.1.0

Command line interface
56
Host selectors
Several of the commands listed here have a common mechanism for selecting one or more XenServer Hosts
on which to perform the operation. The simplest is by supplying the argument host=<UUID or name-
label>. XenServer Hosts can also be specified by filtering the full list of hosts on the values of fields. For
example, specifying enabled=true will select all XenServer Hosts whose enabled field is equal to true.
Where multiple XenServer Hosts are matching, and the operation can be performed on multiple XenServer
Hosts, the option --multiple must be specified to perform the operation. The full list of parameters that
can be matched is described at the beginning of this section, and can be obtained by the command xe host-
list params=all. If no parameters to select XenServer Hosts are given, the operation will be performed on
all XenServer Hosts.
Host parameters
XenServer Hosts have the following parameters:
Parameter Name Description Type
uuid The unique identifier/object reference for
the XenServer Host
read only
name-label The name of the XenServer Host read/write
name-description The description string of the XenServer
Host
read only
enabled false if disabled which prevents any new
VMs from starting on them, which prepares
the XenServer Hosts to be shut down
or rebooted; true if the host is currently
enabled
read only
API-version-major major version number read only
API-version-minor minor version number read only
API-version-vendor read only
API-version-vendor-
implementation
details of vendor implementation read only map parameter
logging logging configuration read/write map parameter
suspend-image-sr-uuid the unique identifier/object reference for
the SR where suspended images are put
read/write
crash-dump-sr-uuid the unique identifier/object reference for
the SR where crash dumps are put
read/write
software-version list of versioning parameters and their
values
read only map parameter
capabilities list of Xen versions that the XenServer
Host can run
read only set parameter
other-config A list of key/value pairs that specify
additional configuration parameters for the
XenServer Host
read/write map parameter
hostname XenServer Host hostname read only
address XenServer Host IP address read only
supported-bootloaders list of bootloaders that the XenServer Host
supports, for example, pygrub, eliloader
read only set parameter