<?xml version="1.0" encoding="UTF-8"?>
<!--
    manpage, user manual, usage: VBoxManage guestcontrol
-->
<!--
    Copyright (C) 2006-2023 Oracle and/or its affiliates.

    This file is part of VirtualBox base platform packages, as
    available from https://www.virtualbox.org.

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License
    as published by the Free Software Foundation, in version 3 of the
    License.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, see <https://www.gnu.org/licenses>.

    SPDX-License-Identifier: GPL-3.0-only
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
<!ENTITY % all.entities SYSTEM "all-entities.ent">
%all.entities;
]>
<refentry id="vboxmanage-guestcontrol" lang="en">
  <refentryinfo>
    <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate>
    <title>VBoxManage guestcontrol</title>
  </refentryinfo>

  <refmeta>
    <refentrytitle>VBoxManage-guestcontrol</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>VBoxManage-guestcontrol</refname>
    <refpurpose>управляет виртуальной машиной из хост-системы</refpurpose>
    <refclass>&product-name;</refclass>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-run">
<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">run</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--dos2unix</arg>
      <arg>--exe=<replaceable>имя-файла</replaceable></arg>
      <arg>--ignore-orphaned-processes</arg>
      <group>
        <arg choice="plain">--no-wait-stderr</arg>
        <arg choice="plain">--wait-stderr</arg>
      </group>
      <group>
        <arg choice="plain">--no-wait-stdout</arg>
        <arg choice="plain">--wait-stdout</arg>
      </group>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--profile</arg>
      <arg>--putenv=<replaceable>имя-переменной</replaceable>=[<replaceable>значение</replaceable>]</arg>
      <arg>--quiet</arg>
      <arg>--timeout=<replaceable>миллисекунды</replaceable></arg>
      <arg>--unix2dos</arg>
      <arg>--unquoted-args</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req">-- <replaceable>программа/аргумент0</replaceable> <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-start">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">start</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--exe=<replaceable>имя-файла</replaceable></arg>
      <arg>--ignore-orphaned-processes</arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--profile</arg>
      <arg>--putenv=<replaceable>имя-переменной</replaceable>=[<replaceable>значение</replaceable>]</arg>
      <arg>--quiet</arg>
      <arg>--timeout=<replaceable>миллисекунды</replaceable></arg>
      <arg>--unquoted-args</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req">-- <replaceable>программа/аргумент0</replaceable> <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyfrom">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">copyfrom</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--follow</arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--no-replace</arg>
      <arg>--recursive</arg>
      <arg>--target-directory=<replaceable>хост-директория-назначения</replaceable></arg>
      <arg>--update</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req"><replaceable>гостевой-источник0</replaceable></arg>
      <arg choice="plain"><replaceable>гостевой-источник1</replaceable> [...]</arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyto">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">copyto</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--follow</arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--no-replace</arg>
      <arg>--recursive</arg>
      <arg>--target-directory=<replaceable>гостевая-директория-назначения</replaceable></arg>
      <arg>--update</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req"><replaceable>хост-источник0</replaceable></arg>
      <arg choice="plain"><replaceable>хост-источник1</replaceable> [...]</arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mkdir">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">mkdir</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--mode=<replaceable>режим</replaceable></arg>
      <arg>--parents</arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rmdir">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">rmdir</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--recursive</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rm">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">rm</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--force</arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mv">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">mv</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req" rep="repeat"><replaceable>источник</replaceable></arg>
      <arg choice="req"><replaceable>директория-назначения</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mktemp">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">mktemp</arg>
      <arg>--directory</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <arg>--mode=<replaceable>режим</replaceable></arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--secure</arg>
      <arg>--tmpdir=<replaceable>имя-директории</replaceable></arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req"><replaceable>имя-шаблона</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-stat">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">stat</arg>
      <arg>--domain=<replaceable>имя-домена</replaceable></arg>
      <group>
        <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
        <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
      <arg>--verbose</arg>
      <arg choice="req"><replaceable>имя-файла</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-list">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">list</arg>
      <group choice="req">
        <arg choice="plain">all</arg>
        <arg choice="plain">files</arg>
        <arg choice="plain">processes</arg>
        <arg choice="plain">sessions</arg>
      </group>
      <arg>--quiet</arg>
      <arg>--verbose</arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closeprocess">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">closeprocess</arg>
      <group>
        <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
        <arg choice="plain">--session-name=<replaceable>имя-или-шаблон</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--verbose</arg>
      <arg choice="req" rep="repeat"><replaceable>PID</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closesession">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">closesession</arg>
      <group>
        <arg choice="plain">--all</arg>
        <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
        <arg choice="plain">--session-name=<replaceable>имя-или-шаблон</replaceable></arg>
      </group>
      <arg>--quiet</arg>
      <arg>--verbose</arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-updatega">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">updatega</arg>
      <arg>--quiet</arg>
      <arg>--verbose</arg>
      <arg>--source=<replaceable>дополнения_гостевой_ос.ISO</replaceable></arg>
      <arg>--wait-start</arg>
      <arg>-- <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
    </cmdsynopsis>

    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-watch">
      <command>VBoxManage guestcontrol</command>
      <group choice="req">
        <arg choice="plain"><replaceable>uuid</replaceable></arg>
        <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
      </group>
      <arg choice="plain">watch</arg>
      <arg>--quiet</arg>
      <arg>--verbose</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Описание</title>
    <para>
      Команда <command>VBoxManage guestcontrol</command> позволяет
      управлять гостевой виртуальной машиной (ВМ) из хост-системы.
      Смотрите <xref linkend="guestadd-guestcontrol" />.
    </para>
    <refsect2>
      <title>Общие опции и операнды</title>
      <para>
        Следующие опции могут быть использованы с любой подкомандой
        <command>VBoxManage guestcontrol</command>:
      </para>
      <variablelist>
        <varlistentry>
          <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term>
          <listitem><para>
              Задает Универсальный Уникальный Идентификатор (UUID) или
              имя ВМ.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--quiet</option></term>
          <listitem><para>
              Указывает, что команда производит более тихий вывод.
            </para><para>
              Краткая форма этой опции <option>-q</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--verbose</option></term>
          <listitem><para>
              Указывает, что команда производит более подробный вывод.
            </para><para>
              Краткая форма этой опции <option>-v</option>.
            </para></listitem>
        </varlistentry>
      </variablelist>
      <para>
        Некоторые подкоманды <command>VBoxManage guestcontrol</command>
        требуют, чтобы предоставили гостевые учетные данные для
        идентификации. Эти подкоманды:
        <command>copyfrom</command>, <command>copyto</command>,
        <command>mkdir</command>, <command>mktemp</command>,
        <command>mv</command>, <command>rmdir</command>,
        <command>rm</command>, <command>run</command>,
        <command>start</command> и <command>stat</command>.
      </para>
      <para>
        Хотя вы не можете выполнять анонимные операции, пароль учетной
        записи пользователя не является обязательным и зависит от
        политики безопасности гостевой ОС. Если у пользователя
        пароль не установлен, укажите пустой пароль. В ОС, таких как
        Windows, возможно необходимо подстроить политику безопасности,
        чтобы разрешить пользовательские учетные записи с пустым паролем.
        В дополнение, могут применяться глобальные правила домена, и
        поэтому они не могут быть изменены.
      </para>
      <para>
        Следующие опции используются для аутентификации в гостевой ВМ:
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--domain=<replaceable>имя-домена</replaceable></option></term>
          <listitem><para>
              Задает имя домена для гостевых Windows ВМ.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--password=<replaceable>пароль</replaceable></option></term>
          <listitem><para>
              Задает пароль указанного пользователя. Если пароль не
              указан в командной строке или файл с паролем пуст,
              считается что у пользователя пустой пароль.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--passwordfile=<replaceable>имя-файла</replaceable></option></term>
          <listitem><para>
              Задает абсолютный путь к файлу в гостевой ОС, содержащему
              пароль для указанного пользователя. Если файл с паролем
              пуст или не указан пароль в командной строке, считается
              что у пользователя пустой пароль.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--username=<replaceable>имя-пользователя</replaceable></option></term>
          <listitem><para>
              Задает существующего пользователя в гостевой ОС, от имени
              которого запускается процесс. Если не указан, процесс
              запускается от имени пользователя хоста.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2>
      <title>Ограничения на гостевой процесс</title>
      <para>
        По умолчанию, можно запустить до пяти гостевых процессов
        одновременно. Если запускается новый гостевой процесс, который
        превысил этот лимит, старый не выполняющийся процесс удаляется
        для запуска нового. Вы не сможете получить вывод из удаленного
        гостевого процесса. Если все пять гостевых процессов активны и
        выполняются, попытка запустить новый гостевой процесс будет
        неудачна.
      </para>
      <para>
        Можно модифицировать ограничения на выполнение гостевого процесса
        двумя способами:
      </para>
      <itemizedlist>
        <listitem><para>
            Используя команду <command>VBoxManage setproperty</command>
            для обновления значения гостевого свойства
            <literal>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</literal>.
          </para></listitem>
        <listitem><para>
            Используя команду <command>VBoxService</command> и указывая
            опцию <option>--control-procs-max-kept=<replaceable>value</replaceable></option>.
          </para></listitem>
      </itemizedlist>
      <para>
        Необходимо перезагрузить гостевую ОС после изменения ограничения.
      </para>
      <para>
        Можно обслуживать неограниченное количество гостевых процессов
        путем указания значения <literal>0</literal>, однако, это не
        рекомендуется.
      </para>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-run">
      <title>Запуск команды в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> run</command> позволяет
        исполнять программу в гостевой ВМ. Стандартные потоки ввода,
        вывода и ошибок перенаправляются из ВМ в хост-систему до
        завершения программы.
      </para>
      <note>
        <para>
          ОС Windows навязывает определенные ограничения на графические
          приложения. Смотрите <xref linkend="KnownIssues" />.
        </para>
      </note>
      <variablelist>
        <varlistentry>
          <term><option>--exe=<replaceable>путь-до-исполняемого-файла</replaceable></option></term>
          <listitem><para>
              Указывает абсолютный путь к исполняемому файлу для запуска
              в гостевой ВМ. Например <filename>C:\Windows\System32\calc.exe</filename>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
          <listitem><para>
              Указывает максимальное время в миллисекундах,
              выделенное для работы программы. Во время работы
              программы <command>VBoxManage</command> получает ее
              вывод.
            </para><para>
              Если не указывается величина ожидания, <command>VBoxManage</command>
              ждет до бесконечности окончания программы или возникновения ошибки.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</option></term>
          <listitem><para>
              Устанавливает, изменяет или удаляет переменные окружения
              в окружении гостевой ВМ.
            </para><para>
              Когда создается гостевой процесс, он работает в
              стандартной среде гостевой ОС задаваемой по умолчанию.
              Используйте эту опцию, чтобы изменить переменные окружения
              в среде по умолчанию.
            </para><para>
              Используйте опцию
              <option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</option>
              для установки или изменения переменной окружения указываемой через <replaceable>имя</replaceable>.
            </para><para>
              Используйте опцию
              <option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значения</replaceable>]</option>
              для удаления переменной окружения указанной через <replaceable>имя</replaceable>.
            </para><para>
              Убедитесь, что переменная или значение, содержащие
              пробелы должны быть заключены в кавычки.
            </para><para>
              Необходимо указать опцию <option>--putenv</option>
              для каждой модифицируемой переменной окружения.
            </para><para>
              Краткая форма этой опции <option>-E</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--unquoted-args</option></term>
          <listitem><para>
              Отключает экранированные двойные кавычки аргументов,
              передаваемые программе. Например <literal>\"fred\"</literal>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--ignore-orphaned-processes</option></term>
          <listitem><para>
              Игнорирует процессы-сироты. Еще не реализовано.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--profile</option></term>
          <listitem><para>
              Использует профиль оболочки, чтобы указать используемое
              окружение. Еще не реализовано.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--no-wait-stdout</option></term>
          <listitem><para>
              Не ждет завершения гостевого процесса или получения его
              кода завершения и каких-либо объяснений сбоя.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--wait-stdout</option></term>
          <listitem><para>
              Ждет завершения процесса, чтобы получить его код
              завершения и любые объяснения сбоя. Команда
              <command>VBoxManage</command> принимает данные со
              стандартного потока вывода гостевого процесса во
              время выполнения процесса.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--no-wait-stderr</option></term>
          <listitem><para>
              Не ждет завершения гостевого процесса, чтобы
              получить его код завершения, сообщения об
              ошибках и флаги.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--wait-stderr</option></term>
          <listitem><para>
              Ждет завершения гостевого процесса для получения
              его кода завершения, сообщений об ошибках и флаги.
              Команда <command>VBoxManage</command> принимает данные
              со стандартного потока ошибок гостевого процесса во
              время выполнения процесса.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--dos2unix</option></term>
          <listitem><para>
              Преобразует гостевой DOS или Windows вывод в UNIX или
              Linux вывод. Это преобразование изменяет завершения строк
              с CR + LF на LF. Еще не реализовано.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--unix2dos</option></term>
          <listitem><para>
              Преобразует гостевой UNIX или Linux вывод в DOS или
              Windows вывод. Это преобразование изменяет завершения строк
              с LF на CR + LF.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>-- <replaceable>программа/аргумент0</replaceable> [<replaceable>аргумент</replaceable>...]</option></term>
          <listitem><para>
              Задает имя программы и любые аргументы, передаваемые
              программе.
            </para><para>
              Убедитесь, что все аргументы команды, содержащие пробелы,
              заключены в кавычки.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-start">
      <title>Запуск команды в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> start</command> позволяет
        выполнить гостевую программу до ее завершения.
      </para>
      <note>
        <para>
          ОС Windows навязывает определенные ограничения на графические
          приложения. Смотрите <xref linkend="KnownIssues" />.
        </para>
      </note>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-copyfrom">
      <title>Копирование файла из гостевой виртуальной машины в директорию в хост-системы</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> copyfrom</command> позволяет
        скопировать файл из гостевой ВМ в хост-систему.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--dereference</option></term>
          <listitem><para>
              Включает следование по символическим ссылкам в гостевой
              файловой системе.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--no-replace</option></term>
          <listitem><para>
              Only copies a file if it does not exist on the host yet.
            </para><para>
              The short form of this option is <option>-n</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--recursive</option></term>
          <listitem><para>
              Рекурсивно копирует файлы и директории из указанной
              директории в гостевой ВМ.
            </para><para>
              Краткая форма этой опции <option>-R</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--target-directory=<replaceable>хост-директория-назначения</replaceable></option></term>
          <listitem><para>
              Задает абсолютный путь к директории назначения в
              хост-системе. Например <filename>C:\Temp</filename>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--update</option></term>
          <listitem><para>
              Only copies a file if the guest file is newer than on the host.
            </para><para>
              The short form of this option is <option>-u</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>гостевой-источник0</replaceable> [<replaceable>гостевой-источник1</replaceable> [...]]</literal></term>
          <listitem><para>
              Задает абсолютный путь одного или нескольких файлов
              для копирования из гостевой ВМ. Например
              <filename>C:\Windows\System32\calc.exe</filename>. Можно
              использовать подстановочные знаки. Например
              <filename>C:\Windows\System*\*.dll</filename>.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-copyto">
      <title>Копирует файл в директорию на гостевой виртуальной машине из хост-системы</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> copyto</command> позволяет
        скопировать файл из хост-системы в гостевую ВМ.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--dereference</option></term>
          <listitem><para>
              Включает следование по символическим ссылкам в хост-системе.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--no-replace</option></term>
          <listitem><para>
              Only copies a file if it does not exist on the guest yet.
            </para><para>
              The short form of this option is <option>-n</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--recursive</option></term>
          <listitem><para>
              Рекурсивно копирует файлы и директории из указанной
              директории в хост-системе.
            </para><para>
              Краткая форма этой опции <option>-R</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--target-directory=<replaceable>гостевая-директория-назначения</replaceable></option></term>
          <listitem><para>
              Задает абсолютный путь директории назначения в гостевой
              ВМ. Например <filename>C:\Temp</filename>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--update</option></term>
          <listitem><para>
              Only copies a file if the host file is newer than on the guest.
            </para><para>
              The short form of this option is <option>-u</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>хост-источник0</replaceable> [<replaceable>хост-источник1</replaceable> [...]]</literal></term>
          <listitem><para>
              Задает абсолютный путь одного или нескольких файлов для
              копирования из хост-системы. Например
              <filename>C:\Windows\System32\calc.exe</filename>. Можно
              использовать подстановочные знаки для указания нескольких
              файлов. Например <filename>C:\Windows\System*\*.dll</filename>.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-mkdir">
      <title>Создает директорию в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> mkdir</command> позволяет
        создать один или несколько директорий в гостевой ВМ.
      </para>
      <para>
        Альтернативные формы этой подкоманды: <command>md</command>,
        <command>createdir</command> и <command>createdirectory</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--parents</option></term>
          <listitem><para>
              Создает все отсутствующие родительские директории по
              отношению к указанной.
            </para><para>
              Например, если попытаться создать директорию
              <filename>D:\Foo\Bar</filename> и директория
              <filename>D:\Foo</filename> не существует, использование
              <option>--parents</option> создаст отсутствующую
               директорию <filename>D:\Foo</filename>. Однако, если
               попытаться создать <filename>D:\Foo\Bar</filename> и
               не указать опцию <option>--parents</option>, команда
               завершится неудачей.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--mode=<replaceable>режим</replaceable></option></term>
          <listitem><para>
              Задает режим разрешений для указанной директории.
              Если также используется опция <option>--parents</option>,
              этот режим задается также для всех ее родительских
              директорий. <replaceable>режим</replaceable> - это
              четыре восьмеричные цифры, например <literal>0755</literal>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>гостевая-директория</replaceable> [<replaceable>гостевая-директория</replaceable>...]</literal></term>
          <listitem><para>
              Задает абсолютный путь к одной или нескольким директориям
              для создания в гостевой ВМ. Например <filename>D:\Foo\Bar</filename>.
            </para><para>
              Если все относящиеся к указанной родительские директории
              не существуют в гостевой ВМ, необходимо использовать
              опцию <option>--parents</option>.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ, чтобы
              создать указанную и ее родительские директории.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-rmdir">
      <title>Удалить директорию из гостевой виртуальной машины</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> rmdir</command> позволяет
        удалить указанную директорию из гостевой ВМ.
      </para>
      <para>
        Альтернативные формы этой подкоманды <command>removedir</command>
        и <command>removedirectory</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--recursive</option></term>
          <listitem><para>
              Рекурсивно удаляет директории из указанной в гостевой ВМ.
            </para><para>
              Краткая форма этой опции <option>-R</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>гостевая-директория</replaceable> [<replaceable>гостевая-директория</replaceable>...]</literal></term>
          <listitem><para>
              Задает абсолютный путь к одной или нескольким директориям
              для удаления в гостевой ВМ. Можно использовать
              подстановочные знаки в именах директорий. Например
              <filename>D:\Foo\*Bar</filename>.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ, чтобы
              удалить указанную и ее родительские директории.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-rm">
      <title>Удалить файл из гостевой виртуальной машины</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> rm</command> позволяет
        удалить указанный файл из гостевой ВМ.
      </para>
      <para>
        Альтернативная форма этой подкоманды <command>removefile</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--force</option></term>
          <listitem><para>
              Принудительно выполняет операцию и отменяет любые
              запросы подтверждения.
            </para><para>
              Краткая форма этой опции <option>-f</option>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>гостевой-файл</replaceable> [<replaceable>гостевой-файл</replaceable>...]</literal></term>
          <listitem><para>
              Задает абсолютный путь одного или нескольких файлов для
              удаления из гостевой ВМ. Можно использовать
              подстановочные знаки в именах файлов. Например
              <filename>D:\Foo\Bar\text*.txt</filename>.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ, чтобы
              удалить указанный файл.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-mv">
      <title>Переименовать файл или директорию в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> mv</command> позволяет
        переименовать файлы и директории в гостевой ВМ.
      </para>
      <para>
        Альтернативная форма этой подкоманды <command>move</command>,
        <command>ren</command> и <command>rename</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><literal><replaceable>гостевой-источник</replaceable> [<replaceable>гостевой-источник</replaceable>...]</literal></term>
          <listitem><para>
              Задает абсолютный путь к файлу или единичной директории
              для перемещения или переименования в гостевой ВМ. Можно
              использовать подстановочные знаки в именах файлов.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ для
              доступа к указанному файлу или директории.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><replaceable>назначение</replaceable></term>
          <listitem><para>
              Задает абсолютный путь к переименовываемым файлу или
              директории, или директории назначения, куда
              перемещать файлы. Если перемещается только один
              файл, <replaceable>назначение</replaceable> может
              быть как файлом так и директорией, иначе
              <replaceable>назначение</replaceable> должно быть
              директорией.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ для
              доступа к файлу или директории назначения.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-mktemp">
      <title>Создать временный файл или директорию в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> mktemp</command> позволяет
        создать временный файл или директорию в гостевой ВМ. Можно
        использовать эту команду для помощи с последующим копированием
        файлов из хост-системы в гостевую ВМ. По умолчанию, эта команда
        создает файл или директорию в платформо-зависимой директории
        <filename>temp</filename> гостевой ВМ.
      </para>
      <para>
        Альтернативные формы этой подкоманды <command>createtemp</command>
        и <command>createtemporary</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--directory</option></term>
          <listitem><para>
              Создает временную директорию указанную в операнде
              <replaceable>шаблон</replaceable>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--secure</option></term>
          <listitem><para>
              Обеспечивает безопасное создание файлов и каталогов,
              устанавливая режим разрешений <literal>0755</literal>.
              Любая операция, которая не может быть произведена
              безопасно приведет к неудаче.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--mode=<replaceable>режим</replaceable></option></term>
          <listitem><para>
              Задает режим разрешений, используемый указанной директорией.
              <replaceable>режим</replaceable> - это четыре восьмеричные
              цифры, например <literal>0755</literal>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--tmpdir=<replaceable>директория</replaceable></option></term>
          <listitem><para>
              Задает абсолютный путь к директории в гостевой ВМ, где
              создавать указанный файл или директорию. Если не указан,
              <replaceable>директория</replaceable> - это
              платформо-зависимая директория <filename>temp</filename>.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><replaceable>шаблон</replaceable></term>
          <listitem><para>
              Задает шаблон имени для временного файла без пути к
              директории. Шаблон имени файла должен содержать как
              минимум одну последовательности трех последовательных
              символов X или должен заканчиваться ими.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-stat">
      <title>Показать статус файла или файловой системы в гостевой виртуальной машине.</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> stat</command> позволяет
        отобразить статус файлов или или файловых систем в гостевой
        ВМ.
      </para>
      <variablelist>
        <varlistentry>
          <term><literal><replaceable>файл</replaceable> [<replaceable>файл</replaceable> ...]</literal></term>
          <listitem><para>
              Задает абсолютный путь к файлу или файловой системе в
              гостевой ВМ. Например <filename>/home/foo/a.out</filename>.
            </para><para>
              У вас должно быть достаточно прав в гостевой ВМ для
              доступа к указанным файлам или файловым системам.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-list">
      <title>Показать настройки и информацию о статусе гостевой виртуальной машины</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> list</command> позволяет
        показать настройки гостевого управления и информацию о статусе.
        Например, вывол показывает открытые гостевые сессии, гостевые
        процессы и файлы.
      </para>
      <variablelist>
        <varlistentry>
          <term><literal>all</literal>|<literal>sessions</literal>|<literal>processes</literal>|<literal>files</literal></term>
          <listitem><para>
              Указывает тип отображаемой информации.
              <literal>all</literal> показывает все доступные данные,
              <literal>sessions</literal> показывает гостевые сессии,
              <literal>processes</literal> показывает процессы и
              <literal>files</literal> показывает файлы.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-closeprocess">
      <title>Завершить процесс в сессии гостевой виртуальной машины</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> closeprocess</command> позволяет
        завершить гостевой процесс работающий в гостевой сессии.
        Указывайте процесс через идентификатор процесса (PID) и сессию,
        используя ID сессии или имя.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--session-id=<replaceable>ID</replaceable></option></term>
          <listitem><para>
              Задает ID гостевой сессии.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--session-name=<replaceable>имя</replaceable>|<replaceable>шаблон</replaceable></option></term>
          <listitem><para>
              Задает имя гостевой сессии. Используйте шаблон,
              содержащий подстановочные знаки для указания
              нескольких сессий.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><literal><replaceable>PID</replaceable> [<replaceable>PID</replaceable> ...]</literal></term>
          <listitem><para>
              Задает список PID гостевых процессов для завершения.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-closesession">
      <title>Закрыть сессию гостевой виртуальной машины</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> closesession</command> позволяет
        закрыть гостевую сессию. Указывайте гостевую сессию или через ID
        сессии или через имя.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--session-id=<replaceable>ID</replaceable></option></term>
          <listitem><para>
              Задает ID гостевой сессии.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--session-name=<replaceable>имя</replaceable>|<replaceable>шаблон</replaceable></option></term>
          <listitem><para>
              Задает имя гостевой сессии. Используйте шаблон,
              содержащий подстановочные знаки для указания
              нескольких сессий.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--all</option></term>
          <listitem><para>
              Закрывает все гостевые сессии.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-updatega">
      <title>Обновить ПО Дополнений Гостевой ОС в гостевой виртуальной машине</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> updatega</command> позволяет
        обновить ПО Дополнений Гостевой ОС, установленное в указанной
        гостевой ВМ.
      </para>
      <para>
        Альтернативные формы этой подкоманды
        <command>updateadditions</command> и
        <command>updateguestadditions</command>.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--source=<replaceable>новый-путь-к-iso</replaceable></option></term>
          <listitem><para>
              Задает абсолютный путь к <filename>.ISO</filename> файлу
              Дополнений Гостевой ОС в гостевой ВМ.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--reboot</option></term>
          <listitem><para>
              Автоматический перезагружает гостевую систему после успешного
              обновления Дополнений Гостевой ОС.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
          <listitem><para>
              Задает максимальное время ожидания (в миллисекундах) заверешения
              полного обновления Дополнений Гостевой ОС. По умолчанию, максимальное
              время ожидания не используется.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--verify</option></term>
          <listitem><para>
              Проверяет, что Дополнения Гостевой ОС обновлены успешно после
              успешной установки. Перезагрузка гостя обязательна.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--wait-ready</option></term>
          <listitem><para>
              Ждет когда текущие Дополения Гостевой ОС готовы для
              обновления Дополений Гостевой ОС.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><option>--wait-start</option></term>
          <listitem><para>
              Запускает <command>VBoxManage</command> процесс обновления
              в гостевой ВМ и ждет начала обновления Дополений Гостевой ОС
              перед завершения процесса <command>VBoxManage</command>.
            </para><para>
              По умолчанию, команда <command>VBoxManage</command> ждет
              завершения обновления Дополений Гостевой ОС перед
              завершением. Используйте эту опцию когда работающий
              процесс <command>VBoxManage</command> влияет на
              взаимодействие между установщиком и гостевой ОС.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option>-- <replaceable>аргумент</replaceable> [<replaceable>аргумент</replaceable> ...]</option></term>
          <listitem><para>
              Задает необязательные аргументы командной строки, которые
              передаются программе обновления Дополнений Гостевой ОС.
              Можно использовать опцию <option>--</option> для передачи
              соответствующих аргументов программе обновления для
              модернизации еще не установленных функций.
            </para><para>
              Убедитесь, что командные аргументы, содержащие пробелы,
              заключены в кавычки.
            </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-waitrunlevel">
      <title>Ждать гостевой уровень выполнения</title>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> waitrunlevel</command> позволяет
        ожидать достижения гостевого уровня выполнения.
      </para>
      <variablelist>
        <varlistentry>
          <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
          <listitem><para>
              Задать максимальное время ожидания (в миллисекундах)
              достижения уровня выполнения. По умолчанию максимальное
              время ожидания не используется.
            </para></listitem>
        </varlistentry>
        <varlistentry>
          <term><option><replaceable>system</replaceable>|<replaceable>userland</replaceable>|<replaceable>desktop</replaceable></option></term>
          <listitem><para>
            Задает ожидаемый уровень выполнения
          </para></listitem>
        </varlistentry>
      </variablelist>
    </refsect2>
    <refsect2 id="vboxmanage-guestcontrol-watch">
      <title>Показать текущую активность гостевого управления.</title>
      <remark role="help-copy-synopsis"/>
      <para>
        Команда <command>VBoxManage guestcontrol
        <replaceable>имя-ВМ</replaceable> watch</command> позволяет
        показать текущую активность гостевого управления.
      </para>
    </refsect2>
  </refsect1>

  <refsect1>
    <title>Примеры</title>
    <remark role="help-scope" condition="GLOBAL"/>
    <para>
      Следующая команда <command>VBoxManage guestcontrol run</command>
      выполняет команду <command>ls -l /usr</command> в Oracle Linux ВМ
      <literal>My OL VM</literal> от имени пользователя
      <literal>user1</literal>.
    </para>
<screen>
$ VBoxManage --nologo guestcontrol "My OL VM" run --exe "/bin/ls" \
--username user1 --passwordfile pw.txt --wait-stdout -- -l /usr
</screen>
    <para>
      Опция <option>--exe</option> указывает абсолютный путь команды
      для запуска в гостевой ВМ, <filename>/bin/ls</filename>.
      Используйте опцию <option>--</option> для передачи любых
      аргументов, следующих после команды <command>ls</command>.
    </para>
    <para>
      Используйте опцию <option>--username</option> для указания
      имени пользователя, <literal>user1</literal> и опцию
      <option>--passwordfile</option> для указания имения файлы,
      содержащего пароль для пользователя <literal>user1</literal>,
      <filename>pw.txt</filename>.
    </para>
    <para>
      Опция <option>--wait-stdout</option> ожидает завершения
      гостевого процесса <command>ls</command> перед передачей
      кода заверешения и вывода команды. Опция <option>--nologo</option>
      подавляет вывод информации о логотипе.
    </para>
    <para>
      Следующая команда <command>VBoxManage guestcontrol run</command>
      выполняет команду <command>ipconfig</command> в Windows ВМ
      <literal>My Win VM</literal> от имени пользователя
      <literal>user1</literal>. Стандартные потоки ввода, вывода
      и ошибок перенаправляются из ВМ в хост-систему до завершения
      программы.
    </para>
<screen>
$ VBoxManage --nologo guestcontrol "My Win VM" run \
--exe "c:\\windows\\system32\\ipconfig.exe" \
--username user1 --passwordfile pw.txt --wait-stdout
</screen>
    <para>
      Опция <option>--exe</option> задает абсолютный путь команды для
      запуска в гостевой ВМ,
      <filename>c:\windows\system32\ipconfig.exe</filename>. Двойные
      слеши показанные в этом примере требуются только в UNIX
      хост-системах.
    </para>
    <para>
      Используйте опцию <option>--username</option> для указания имени
      пользователя, <literal>user1</literal> и опцию
      <option>--passwordfile</option> для указания имени файла,
      содержащего пароль для пользователя <literal>user1</literal>,
      <filename>pw.txt</filename>.
    </para>
    <para>
      Опция <option>--wait-stdout</option> ожидает завершения
      гостевого процесса <command>ls</command> перед передачей
      кода заверешения и вывода команды. Опция <option>--nologo</option>
      подавляет вывод информации о логотипе.
    </para>
    <para>
      Следующая команда <command>VBoxManage guestcontrol start</command>
      выполняет команду <command>ls -l /usr</command> в Oracle Linux ВМ
      <literal>My OL VM</literal> до завершения программы.
    </para>
<screen>
$ VBoxManage --nologo guestcontrol "My Win VM" start \
--exe "c:\\windows\\system32\\ipconfig.exe" \
--username user1 --passwordfile pw.txt --wait-stdout
</screen>
  </refsect1>
</refentry>
