Adding upstream version 7.0.14-dfsg.upstream/7.0.14-dfsg

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 1288 insertions, 0 deletions

diff --git a/doc/manual/ru_RU/man_VBoxManage-guestcontrol.xml b/doc/manual/ru_RU/man_VBoxManage-guestcontrol.xml
new file mode 100644
index 00000000..8201aec8
--- /dev/null
+++ b/doc/manual/ru_RU/man_VBoxManage-guestcontrol.xml
@@ -0,0 +1,1288 @@
+<?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>