Команда "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" описанной выше.