Sun Microsystems VERSION 3.1.0_BETA2 user manual VBoxManage dhcpserver

8VBoxManage 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