Sun Microsystems VIRTUALBOX VERSION 3.1.0_BETA2 - Manual (Page 133)

8 VBoxManage reference
• enumerate <vm> [-patterns <pattern>]: This lists all the guest prop-
erties that are available for the given VM, including the value. This list will be
very limited if the guest’s service process cannot be contacted, e.g. because the
VM is not running or the Guest Additions are not installed.
If --patterns <pattern> is specified, it acts as a filter to only list properties
that match the given pattern. The pattern can contain the following wildcard
characters:
– * (asterisk): represents any number of characters; for example,
“/VirtualBox*“ would match all properties beginning with “/VirtualBox”.
– ? (question mark): represents a single arbitrary character; for example,
“fo?“ would match both “foo” and “for”.
– | (pipe symbol): can be used to specify multiple alternative patterns; for
example, “s*|t*“ would match anything starting with either “s” or “t”.
• get <vm>: This retrieves the value of a single property only. If the property
cannot be found (e.g. because the guest is not running), this will print “No value
set¡‘.
• set <vm> <property> [<value> [-flags <flags>]]: This allows
you to set a guest property by specifying the key and value. If <value> is
omitted, the property is deleted. With --flags you can optionally specify ad-
ditional behavior (you can combine several by separating them with commas):
– TRANSIENT: the value will not be stored with the VM data when the VM
exits;
– RDONLYGUEST: the value can only be changed by the host, but the guest
can only read it;
– RDONLYHOST: reversely, the value can only be changed by the guest, but
the host can only read it;
– READONLY: a combination of the two, the value cannot be changed at all.
• wait <vm> <pattern> --timeout <timeout>: This waits for a particu-
lar value described by “pattern” to change or to be deleted or created. The
pattern rules are the same as for the “enumerate” subcommand above.
8.26 VBoxManage dhcpserver
The “dhcpserver” commands allow you to control the DHCP server that is built into
VirtualBox. You may find this useful when using internal or host-only networking.
(Theoretically, you can enable it for a bridged network as well, but that will likely
cause conflicts with other DHCP servers in your physical network.)
Use the following command line options:
133