Команда "guestproperty" позволяет вам получить или установить свойства работающей виртуальной машины. Для вводного ознакомления с предметом обратитесь к Section 4.9, “Guest properties”. Как там объяснялось, гостевые свойства являются произвольными строковыми парами ключ/ значение, которые можно записывать и считывать из гостя и хоста, так они могут использоваться как низкоуровневые каналы для передачи строковых значений. Кроме того, целый ряд значений, которые начинаются с "/VirtualBox/" автоматически устанавливаются и поддерживаются гостевыми дополнениями.
Доступны следующие расширения команды (где <vm> может быть именем ВМ или ее UUID, как и в других командах VBoxManage):
enumerate <vm> [-patterns <pattern>] : Отображает список всех свойств гостя для указанной виртуальной машины. Этот список будет ограничен, в случае отсутствия соединения с процессом гостевого сервиса, например если ВМ не запущена или не установлены гостевые дополнения.
Если указан параметр --patterns <pattern>, то выводится список свойств ограниченный указанным шаблоном. Шаблон может содержать следующие символы:
* (звездочка): представлять любое количество символов; например, " /VirtualBox* " соответствует всем свойствам начинающимся с "/VirtualBox".
? (знак вопроса): представляет один произвольный символ; например, " fo? " соответствует "foo" и "for".
| (вертикальная черта): может использоваться для указания нескольких альтернативных шаблонов; например, " s*|t* " соответствует любой строке начинающейся с "s" или "t".
get <vm> : Возвращает значение только одного свойства. Если значение свойства не может быть получено (например гостевая система не запущена), то выводится строка "No value set!".
set <vm> <property> [<value> [-flags <flags>]] : Позволяет вам установить значение свойства. Если <value> не указано, то свойство удаляется. С помощью --flags вы можете использовать расширенное поведение команды (возможно использование комбинаций флагов, разделенных запятой):
TRANSIENT : значение не будет сохраняться при завершении работы ВМ;
RDONLYGUEST : значение может изменяться только с хост системы, а для гостя доступно только для чтения;
RDONLYHOST : значение может быть изменено только гостем, а хостом только прочитано;
READONLY : значение не может быть изменено.
wait <vm> <pattern> --timeout <timeout> : Ожидает события создания, изменения или удаления значения одного из свойств, описанных шаблоном. Правила создания шаблонов те же, что и в команде "enumerate" описанной выше.