diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-11 08:17:27 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-11 08:17:27 +0000 |
commit | f215e02bf85f68d3a6106c2a1f4f7f063f819064 (patch) | |
tree | 6bb5b92c046312c4e95ac2620b10ddf482d3fa8b /doc/manual/ru_RU | |
parent | Initial commit. (diff) | |
download | virtualbox-upstream/7.0.14-dfsg.tar.xz virtualbox-upstream/7.0.14-dfsg.zip |
Adding upstream version 7.0.14-dfsg.upstream/7.0.14-dfsg
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
57 files changed, 19438 insertions, 0 deletions
diff --git a/doc/manual/ru_RU/docbook-refentry-link-replacement-xsl-gen.xsl b/doc/manual/ru_RU/docbook-refentry-link-replacement-xsl-gen.xsl new file mode 100644 index 00000000..4c94f59c --- /dev/null +++ b/doc/manual/ru_RU/docbook-refentry-link-replacement-xsl-gen.xsl @@ -0,0 +1,44 @@ +<?xml version="1.0"?> +<!-- + docbook-refentry-link-replacement-xsl-gen.xsl: + XSLT stylesheet for generate a stylesheet that replaces links + to the user manual in the manpages. +--> +<!-- + 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 +--> + +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:str="http://xsltsl.org/string" + > + + <xsl:import href="../docbook-refentry-link-replacement-xsl-gen.xsl"/> + + <!-- Translated strings --> + <xsl:variable name="sChapter" select="'глава'"/> + <xsl:variable name="sSection" select="'секция'"/> + <xsl:variable name="sOfManual" select="'руководства пользователя'"/> + <xsl:variable name="sInManual" select="'руководства пользователя'"/> + +</xsl:stylesheet> + diff --git a/doc/manual/ru_RU/docbook-refentry-to-C-help.xsl b/doc/manual/ru_RU/docbook-refentry-to-C-help.xsl new file mode 100644 index 00000000..362d7bd8 --- /dev/null +++ b/doc/manual/ru_RU/docbook-refentry-to-C-help.xsl @@ -0,0 +1,42 @@ +<?xml version="1.0"?> +<!-- + docbook-refentry-to-manual-sect1.xsl: + XSLT stylesheet for nicking the refsynopsisdiv bit of a + refentry (manpage) for use in the command overview section + in the user manual. +--> +<!-- + 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 +--> + +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:str="http://xsltsl.org/string" + > + + <xsl:import href="../docbook-refentry-to-C-help.xsl"/> + + <!-- Translated strings --> + <xsl:variable name="sUsage" select="'Использование'"/> + <xsl:variable name="sUsageUnderscore" select="'============='"/> + +</xsl:stylesheet> diff --git a/doc/manual/ru_RU/man_VBoxManage-adoptstate.xml b/doc/manual/ru_RU/man_VBoxManage-adoptstate.xml new file mode 100644 index 00000000..60c798f1 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-adoptstate.xml @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage adoptstate +--> +<!-- + 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-adoptstate" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage adoptstate</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-adoptstate</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-adoptstate</refname> + <refpurpose>изменение состояния виртуальной машины на основе файла сохраненного состояния</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-adoptstate"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage adoptstate</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-файла-состояния</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage adoptstate</command> позволяет изменить + состояние виртуальной машины (ВМ) на состояние, описываемое в файле + сохраненного состояния (<filename>.sav</filename>). Это действие + упоминается как ВМ, <emphasis>принимающая</emphasis> файл сохраненного + состояния. Файл сохраненного состояния должен быть отдельным от + конфигурации ВМ. + </para> + <para> + Когда ВМ запускается после данной команды, ВМ восстанавливает свое + состояние из указанного файла. + </para> + <para> + Используйте эту команду только для нестандартного развертывания ПО. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-файла-состояния</replaceable></term> + <listitem><para> + Указывает имя файла сохраненного состояния. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда запускает ВМ с именем <literal>vm2</literal>, используя + файл сохраненного состояния с именем <filename>mystate.sav</filename>. + </para> +<screen>$ VBoxManage adoptstate vm2 /home/user/mystate.sav</screen> + </refsect1> + + <refsect1> + <title>Смотрите Также</title> + <para> + <xref linkend="vboxmanage-discardstate"/> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-bandwidthctl.xml b/doc/manual/ru_RU/man_VBoxManage-bandwidthctl.xml new file mode 100644 index 00000000..ca2ecca9 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-bandwidthctl.xml @@ -0,0 +1,305 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage bandwidthctl +--> +<!-- + 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-bandwidthctl" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage bandwidthctl</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-bandwidthctl</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-bandwidthctl</refname> + <refpurpose>управление группами полосы пропускания</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-add"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage bandwidthctl</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">add</arg> + <arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg> + <arg choice="req">--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k|m|g|K|M|G]</arg> + <arg choice="req">--type=disk|network</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-list"> + <command>VBoxManage bandwidthctl</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">list</arg> + <arg>--machinereadable</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-remove"> + <command>VBoxManage bandwidthctl</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">remove</arg> + <arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-set"> + <command>VBoxManage bandwidthctl</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">set</arg> + <arg choice="req"><replaceable>имя-группы-полосы-пропускания</replaceable></arg> + <arg choice="req">--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k|m|g|K|M|G]</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage bandwidthctl</command> позволяет управлять + группами полосы пропускания для виртуальных машин (ВМ). Группа полосы + пропускания указывает лимит полосы пропускания для дисков или сетевых + адаптеров ВМ. + </para> + <para> + Обратите внимание, что лимит полосы пропускания сети применяется только + к исходящему траффику ВМ. Входящий траффик не ограничивается. + </para> + <refsect2 id="vboxmanage-bandwidthctl-add"> + <title>Создание группы полосы пропускания</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage bandwidthctl add</command> создает группу + полосы пропускания для указанной ВМ. Вы должны указать назначение + группы полосы пропускания: для дисков или сетей, а также указать + лимит полосы пропускания. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option><replaceable>имя-группы-полосы-пропускания</replaceable></option></term> + <listitem><para> + Указывает имя группы полосы пропускания. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--type=disk|network</option></term> + <listitem><para> + Указывает тип группы полосы пропускания: + <literal>disk</literal> и <literal>network</literal>. + Для дополнительной информации смотрите + <xref linkend="storage-bandwidth-limit" /> или <xref linkend="network_bandwidth_limit" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k|m|g|K|M|G]</option></term> + <listitem><para> + Указывает лимит для группы полосы пропускания. По умолчанию, + указывается в мегабайтах в секунду. Можно изменить это значение + пока ВМ работает. + </para><para> + Можно изменить единицы измерения, добавляя следующие спецификаторы + к лимиту полосы пропускания: + </para><itemizedlist> + <listitem><para> + <literal>k</literal> – килобит в секунду + </para></listitem> + <listitem><para> + <literal>m</literal> – мегабит в секунду + </para></listitem> + <listitem><para> + <literal>g</literal> – гигабит в секунду + </para></listitem> + <listitem><para> + <literal>K</literal> – килобайт в секунду + </para></listitem> + <listitem><para> + <literal>M</literal> – мегабайт в секунду + </para></listitem> + <listitem><para> + <literal>G</literal> – гигабайт в секунду + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-bandwidthctl-list"> + <title>Отображение групп полосы пропускания</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage bandwidthctl list</command> показывает + все группы полосы пропускания, определенные для указанной ВМ. + Используйте опцию <option>--machinereadable</option> для вывода + в машино-читаемом формате, который использует пары имя-значение. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает UUID или имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--machinereadable</option></term> + <listitem><para> + Выводит информацию о группах полосы пропускания в виде + пар имя-значение. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-bandwidthctl-remove"> + <title>Удаление группы полосы пропускания</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage bandwidthctl remove</command> удаляет + группу полосы пропускания. + </para> + <note> + <para> + Для успешного удаления группы полосы пропускания, убедитесь + что она не ссылается на диск или адаптер работающей ВМ. + </para> + </note> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает UUID или имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option><replaceable>имя-группы-полосы-пропускания</replaceable></option></term> + <listitem><para> + Указывает имя группы полосы пропускания. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-bandwidthctl-set"> + <title>Изменение лимита группы полосы пропускания</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage bandwidthctl set</command> изменяет + лимит группы полосы пропускания. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает UUID или имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option><replaceable>bandwidth-group-name</replaceable></option></term> + <listitem><para> + Указывает имя группы полосы пропускания. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--limit=<replaceable>лимит-полосы-пропускания</replaceable>[k|m|g|K|M|G]</option></term> + <listitem><para> + Указывает лимит для группы полосы пропускания. По умолчанию, + указывается в мегабайтах в секунду. Можно изменить это значение + пока ВМ работает. + </para><para> + Можно изменить единицы измерения, добавляя следующие спецификаторы + к лимиту полосы пропускания: + </para><itemizedlist> + <listitem><para> + <literal>k</literal> – килобит в секунду + </para></listitem> + <listitem><para> + <literal>m</literal> – мегабит в секунду + </para></listitem> + <listitem><para> + <literal>g</literal> – гигабит в секунду + </para></listitem> + <listitem><para> + <literal>K</literal> – килобайт в секунду + </para></listitem> + <listitem><para> + <literal>M</literal> – мегабайт в секунду + </para></listitem> + <listitem><para> + <literal>G</literal> – гигабайт в секунду + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующий пример показывает, как использовать команду + <command>VBoxManage bandwidthctl</command> для создания группы + полосы пропускания <literal>Limit</literal> с лимитом в 20 Мбит/с. + Затем используется команда <command>VBoxManage modifyvm</command> + для назначения этой группы первому и второму адаптерам ВМ + <literal>vm1</literal>. + </para> +<screen>$ VBoxManage bandwidthctl "vm1" add Limit --type network --limit 20m +$ VBoxManage modifyvm "vm1" --nicbandwidthgroup1 Limit +$ VBoxManage modifyvm "vm1" --nicbandwidthgroup2 Limit</screen> + <para> + Можно динамически менять лимит группы полосы пропускания пока + ВМ работает. Следующий пример показывает как изменить лимит + для группы полосы пропускания <literal>Limit</literal> с 20 + Мбит/с в 100 кбит/с: + </para> +<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 100k</screen> + <para> + Следующая команда отключает ограничения для всех адаптеров в + группе полосы пропускания <literal>Limit</literal> путем установки + лимита в ноль (<literal>0</literal>): + </para> +<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 0</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-checkmediumpwd.xml b/doc/manual/ru_RU/man_VBoxManage-checkmediumpwd.xml new file mode 100644 index 00000000..9c51d56c --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-checkmediumpwd.xml @@ -0,0 +1,111 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage checkmediumpwd +--> +<!-- + 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-checkmediumpwd" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage checkmediumpwd</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-checkmediumpwd</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-checkmediumpwd</refname> + <refpurpose>проверка пароля носителя или образа диска, зашифрованного DEK</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-checkmediumpwd"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage checkmediumpwd</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg choice="req"><replaceable>файл-с-паролем</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage checkmediumpwd</command> проверяет + текущий пароль, используемый для шифрования носителя или образа + диска, зашифрованными DEK. Смотрите <xref linkend="diskencryption-encryption" />. + </para> + <para> + Ответ команды показывает корректен ли указанный пароль. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает Уникальный Универсальный Идентификатор (UUID) или + абсолютный путь к носителю или образу. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>файл-с-паролем</replaceable></term> + <listitem><para> + Указывает идентификатор пароля для проверки. Идентификатор + пароля может быть указан через абсолютный путь к файлу, + содержащему пароль, или через дефис (<literal>-</literal>). + Во втором случае будет предложено ввести пароль. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующий пример проверяет пароль шифрования у образа диска + с именем <filename>ol7u4-1.vdi</filename>. Идентификатор + пароля - это файл с именем <filename>pwfile</filename>. + </para> + <para> + Команда возвращает сообщение, показывающее что пароль корректен. + </para> +<screen>$ VBoxManage checkmediumpwd "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" /home/user/pwfile + Указанный пароль корректен</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-encryptmedium" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-clonemedium.xml b/doc/manual/ru_RU/man_VBoxManage-clonemedium.xml new file mode 100644 index 00000000..3df62365 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-clonemedium.xml @@ -0,0 +1,214 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage clonemedium +--> +<!-- + 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-clonemedium" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage clonemedium</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-clonemedium</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-clonemedium</refname> + <refpurpose>создание клона носителя</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-clonemedium"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage clonemedium</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>носитель-источник</replaceable></arg> + </group> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>носитель-назначения</replaceable></arg> + </group> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <arg>--existing</arg> + <arg>--format=<group choice="plain"> + <arg choice="plain">VDI</arg> + <arg choice="plain">VMDK</arg> + <arg choice="plain">VHD</arg> + <arg choice="plain">RAW</arg> + <arg choice="plain"><replaceable>другие</replaceable></arg> + </group></arg> + <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage clonemedium</command> позволяет клонировать + существующий носитель (виртуальный диск, DVD, или флоппи). В основном, + это файл образа. Оригинальный образ от клонированного отличаются + только Уникальным Универсальным Идентификатором (UUID). + </para> + <para> + Можно использовать Менеджер Виртуальных Носителей для передачи + клонированного носителя на другой хост или импортировать его в &product-name;. + Смотрите <xref linkend="virtual-media-manager" /> и <xref linkend="cloningvdis" />. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>носитель-источник</replaceable></term> + <listitem><para> + Указывает UUID или абсолютное или относительное имя файла + носителя-источника для клонирования. UUID можно указать + только если он зарегистрирован. Используйте команду <command>VBoxManage + list hdds</command> для отображения зарегистрированных образов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>носитель-назначения</replaceable></term> + <listitem><para> + Указывает UUID или абсолютное или относительное имя файла + носителя назначения (клонированного носителя). UUID можно + указать только если он зарегистрирован. Используйте + команду <command>VBoxManage list hdds</command> для отображения + зарегистрированных образов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>disk</literal> | <literal>dvd</literal> | <literal>floppy</literal></term> + <listitem><para> + Указывает тип носителя для клонирования. Допустимые значения: + <literal>disk</literal>, <literal>dvd</literal> и + <literal>floppy</literal>. <literal>disk</literal> используется + по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--existing</option></term> + <listitem><para> + Производит операцию клонирования путем перезаписывания + носителя назначения. В результате записывается только + та часть носителя-источника, которая умещается в + существующий носитель назначения. + </para><para> + Если носитель назначения меньше источника, копируется + только порция источника размером с носитель назначения. + </para><para> + Если носитель назначения больше источника, оставшаяся + часть носителя назначения остается неизменной. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--format</option></term> + <listitem><para> + Указывает формат файла носителя назначения, если он + отличается от источника. Допустимые значения: + <literal>VDI</literal>, <literal>VMDK</literal>, + <literal>VHD</literal>, <literal>RAW</literal> и + <replaceable>другие</replaceable>. + </para><remark> + Какие могут быть быть <replaceable>другие</replaceable> + форматы файлов? + </remark></listitem> + </varlistentry> + <varlistentry> + <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term> + <listitem><para> + Указывает варианты формата файла носителя назначения, + указанные через запятую. Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>Standard</literal> является типом образа диска + по умолчанию с динамически изменяемым размером файла. + </para></listitem> + <listitem><para> + <literal>Fixed</literal> использует образ диска + фиксированного размера. + </para></listitem> + <listitem><para> + <literal>Split2G</literal> показывает, что образ диска + делится на сегменты по 2 ГБ. Это значение только для + VMDK. + </para></listitem> + <listitem><para> + <literal>Stream</literal> оптимизирует образ диска + для загрузки. Это значение только для VMDK. + </para></listitem> + <listitem><para> + <literal>ESX</literal> используется на некоторых + продуктах VMWare. Это значение только для VMDK. + </para></listitem> + </itemizedlist><para> + Заметим, что не все комбинации вариантов допустимы. + Указание неполного списка вариантов приводит к сообщению + об ошибке. + </para></listitem> + </varlistentry> + </variablelist> + <note> + <para> + Для совместимости с ранними версиями &product-name;, можно + использовать команды <command>clonevdi</command> и + <command>clonehd</command> вместо команды + <command>clonemedium</command>. + </para> + </note> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает клон файла образа диска + <filename>disk01.vdi</filename>. Клон называется + <filename>disk02.vdi</filename>. + </para> +<screen>$ VBoxManage clonemedium disk01.vdi disk02.vdi</screen> + <para> + Следующая команда создает клон файла образа диска + <filename>disk01.vdi</filename>. Клон имеет формат + VMDK и называется <filename>disk02.vmdk</filename>. + </para> +<screen>$ VBoxManage clonemedium disk01.vdi disk02.vmdk --format VMDK</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-clonevm.xml b/doc/manual/ru_RU/man_VBoxManage-clonevm.xml new file mode 100644 index 00000000..c65763c5 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-clonevm.xml @@ -0,0 +1,270 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage clonevm +--> +<!-- + 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-clonevm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage clonevm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-clonevm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-clonevm</refname> + <refpurpose>создание клона существующей виртуальной машины &product-name;</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-clonevm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage clonevm</command> + <arg choice="req"><replaceable>имя-ВМ|uuid</replaceable></arg> + + <arg>--basefolder=<replaceable>основная-папка</replaceable></arg> + + <arg rep="repeat">--groups=<replaceable>группа</replaceable>,</arg> + + <group choice='opt'> + <arg choice='plain'>--mode=machine</arg> + <arg choice='plain'>--mode=machinechildren</arg> + <arg choice='plain'>--mode=all</arg> + </group> + + <arg>--name=<replaceable>имя</replaceable></arg> + + <arg rep="repeat">--options=<replaceable>опция</replaceable>,</arg> + + <arg>--register</arg> + + <arg>--snapshot=<replaceable>имя-снимка</replaceable></arg> + + <arg>--uuid=<replaceable>uuid</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage clonevm</command> создает клон существующей + виртуальной машины (ВМ). Клон может быть либо полной копией ВМ + либо связанной копией. + </para> + <para> + Вы должны указать имя или универсальный уникальный идентификатор + (UUID) клонируемой машины. + </para> + </refsect1> + + <refsect1> + <title>Командные операнды и опции</title> + <para> + Следующий список описывает операнды и опции, которые можно использовать + с командой <command>VBoxManage clonevm</command>: + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-ВМ|uuid</replaceable></term> + <listitem><para> + Указывает имя или UUID клонируемой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--basefolder=<replaceable>основная-папка</replaceable></option></term> + <listitem><para> + Указывает имя папки, в которую сохраняется конфигурация + новой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--groups=<replaceable>группа</replaceable>,...</option></term> + <listitem><para> + Добавляет клон в группу или в группы. Несколько групп + указываются через запятую. + </para><para> + Обратите внимание, что каждая группа идентифицируется по ID + группы, начинающийся с символа <computeroutput>/</computeroutput>, + поэтому группы могут быть вложенные. По умолчанию, клон + всегда добавляется в группу <computeroutput>/</computeroutput>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mode=machine|machineandchildren|all</option></term> + <listitem><para> + Указывает режим клонирования: + </para><itemizedlist> + <listitem><para> + Режим <computeroutput>machine</computeroutput> клонирует + текущее состояние существующей ВМ без снимков. Это + режим по умолчанию. + </para></listitem> + <listitem><para> + Режим <computeroutput>machineandchildren</computeroutput> + клонирует снимок, указанный через опцию + <option>--snapshot</option>, и все его дочерние + снимки. + </para></listitem> + <listitem><para> + Режим <computeroutput>all</computeroutput> клонирует + все снимки и текущее состояние существующей ВМ. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--name=<replaceable>имя</replaceable></option></term> + <listitem><para> + Указывает имя для новой ВМ. Значение по умолчанию - это + <computeroutput>Копия <replaceable>исходное-имя</replaceable></computeroutput>, + где <replaceable>исходное-имя</replaceable> - это имя + исходной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--options=<replaceable>опция</replaceable>,...</option></term> + <listitem><para> + Указывает как создать новый клон.</para> + <para>Аргумент <option>--options</option> может быть использован + несколько раз для указания нескольких опций или опции могут быть + указаны списком через запятую. Опции не чувствительны к регистру.</para> + <para>Распознаются следующие опции (не чувствительны к регистру):</para> + <variablelist> + <varlistentry> + <term><option>Link</option></term> + <listitem><para> + Создает связанный клон только из снимка. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>KeepAllMACs</option></term> + <listitem><para> + Указывает, что новый клон использует MAC адреса + всех сетевых карт существующей ВМ. + </para><para> + Если вы не укажете эту опцию или опцию + <option>--options=keepnatmacs</option>, то + МАС адреса каждой сетевой карты новой ВМ + инициализируются новыми значениями. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>KeepNATMACs</option></term> + <listitem><para> + Указывает, что новый клон использует MAC адреса + всех сетевых карт существующей ВМ, если используется + сеть типа NAT. + </para><para> + Если вы не укажете эту опцию или опцию + <option>KeepAllMACs</option>, то МАС адреса каждой + сетевой карты новой ВМ инициализируются новыми значениями. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>KeepDiskNames</option></term> + <listitem><para> + Указывает, что новый клон использует те же имена + образов дисков что и существующая ВМ. По умолчанию + образы дисков переименовываются. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>KeepHwUUIDs</option></term> + <listitem><para> + Указывает, что новый клон использует идентификаторы + аппаратного обеспечения из существующей ВМ. По + умолчанию назначаются новые UUID. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + <varlistentry> + <term><option>--register</option></term> + <listitem><para> + Автоматически регистрирует новый клон в &product-name;. + Позже можно зарегистрировать новую ВМ вручную с помощью + команды <command>VBoxManage registervm</command>. + Смотрите <xref linkend="vboxmanage-registervm" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--snapshot=<replaceable>имя-снимка</replaceable></option></term> + <listitem><para> + Указывает снимок, являющийся основой для новой ВМ. По + умолчанию клон создается из текущего состояния указанной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Указывает UUID для новой ВМ. Убедитесь, что ID является + уникальным в экземпляре &product-name; если вы решили + зарегистрировать новую ВМ. По умолчанию, &product-name; + сам назначает новый UUID. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <para> + Следующая команда создает и регистрирует точный клон ВМ + <computeroutput>ol7</computeroutput>. Клон называется + <computeroutput>ol7-dev-001</computeroutput>. + </para> + <para> + Новый клон включает все снимки исходной ВМ. Новая ВМ использует + те же самые MAC адреса всех сетевых интерфейсов, имена дисков + и UUIDы исходной ВМ. + </para> +<screen> +$ VBoxManage clonevm ol7 --name="ol7-dev-001" --register --mode=all \ + --options=keepallmacs --options=keepdisknames --options=keephwuuids +</screen> + <para> + Следующая команда создает и регистрирует клон снимка + <computeroutput>Снимок 1</computeroutput> ВМ + <computeroutput>ol7</computeroutput>. Клон называется + <computeroutput>ol7-dev-002</computeroutput>. + </para> +<screen> +$ VBoxManage clonevm ol7 --name="ol7-dev-002" --register --snapshot="Снимок 1" +</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-registervm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-closemedium.xml b/doc/manual/ru_RU/man_VBoxManage-closemedium.xml new file mode 100644 index 00000000..8ef5232a --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-closemedium.xml @@ -0,0 +1,121 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage closemedium +--> +<!-- + 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-closemedium" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage closemedium</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-closemedium</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-closemedium</refname> + <refpurpose>удаляет образ жесткого диска, DVD, или флоппи из реестра носителей</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-closemedium"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage closemedium</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg>--delete</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage closemedium</command> удаляет образ + жесткого диска, DVD или флоппи из списка известных носителей, + используемых &product-name;. После выполнения данной команды + указанный образ нельзя будет выбрать в Менеджере Виртуальных + Носителей. + </para> + <para> + Для использования этой команды образ не должен быть подключен + к какой-либо ВМ. + </para> + <para> + Дополнительно можно запросить удаление образа. + </para> + <variablelist> + <varlistentry> + <term>disk|dvd|floppy</term> + <listitem><para> + Указывает тип носителя. Допустимые значения: + <literal>disk</literal> (жесткий диск), + <literal>dvd</literal> или <literal>floppy</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-файла</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) + или абсолютный путь к носителю или образу. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--delete</option></term> + <listitem><para> + Удаляет файл образа. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда удаляет файл образа диска с именем + <filename>disk01.vdi</filename> из реестра. + </para> +<screen>$ VBoxManage closemedium disk01.vdi</screen> + <para> + Следующая команда удаляет файл образа диска с именем + <filename>disk01.vdi</filename> из реестра и удаляет + файл образа. + </para> +<screen>$ VBoxManage closemedium disk01.vdi --delete</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-cloud.xml b/doc/manual/ru_RU/man_VBoxManage-cloud.xml new file mode 100644 index 00000000..318fa5df --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-cloud.xml @@ -0,0 +1,655 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage cloud +--> +<!-- + Copyright (C) 2018-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-cloud" lang="en"> + <refentryinfo> + <title>VBoxManage cloud</title> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-cloud</refentrytitle> + <manvolnum>1</manvolnum> + <refmiscinfo class="manual">Oracle VM VirtualBox</refmiscinfo> + </refmeta> + + <refnamediv> + <refname>VBoxManage-cloud</refname> + <refpurpose>Управление облачными сущностями</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <!-- Cloud list --> + <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-cloudlist-instances"> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">list</arg> + <arg choice="plain">instances</arg> + <arg>--state=<replaceable>строка</replaceable></arg> + <arg>--compartment-id=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudlist-images"> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">list</arg> + <arg choice="plain">images</arg> + <arg choice="req">--compartment-id=<replaceable>строка</replaceable></arg> + <arg>--state=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + + <!-- Cloud instance commands --> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-create" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">instance</arg> + <arg choice="plain">create</arg> + <arg choice="req">--domain-name=<replaceable>имя</replaceable></arg> + <group choice="req"> + <arg choice="req">--image-id=<replaceable>id</replaceable></arg> + <arg choice="req">--boot-volume-id=<replaceable>id</replaceable></arg> + </group> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg choice="req">--shape=<replaceable>тип</replaceable></arg> + <arg choice="req">--subnet=<replaceable>id</replaceable></arg> + <arg>--boot-disk-size=<replaceable>размер в ГБ</replaceable></arg> + <arg>--publicip=<replaceable>true/false</replaceable></arg> + <arg>--privateip=<replaceable>IP адрес</replaceable></arg> + <arg rep="repeat">--public-ssh-key=<replaceable>ключевая строка</replaceable></arg> + <arg>--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg> + <arg>--cloud-init-script-path=<replaceable>путь к скрипту</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-info" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">instance</arg> + <arg choice="plain">info</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-terminate" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">instance</arg> + <arg choice="plain">terminate</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-start" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">instance</arg> + <arg choice="plain">start</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-pause" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">instance</arg> + <arg choice="plain">pause</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + + <!-- Cloud image commands --> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">image</arg> + <arg choice="plain">create</arg> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + <arg>--instance-id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">image</arg> + <arg choice="plain">info</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">image</arg> + <arg choice="plain">delete</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">image</arg> + <arg choice="plain">import</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">image</arg> + <arg choice="plain">export</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + + <!-- Cloud network commands --> + <cmdsynopsis id="synopsis-vboxmanage-cloud-network-setup"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">network setup</arg> + <arg choice="req">--local-gateway-iso=<replaceable>путь</replaceable></arg> + <arg>--gateway-os-name=<replaceable>строка</replaceable></arg> + <arg>--gateway-os-version=<replaceable>строка</replaceable></arg> + <arg>--gateway-shape=<replaceable>строка</replaceable></arg> + <arg>--tunnel-network-name=<replaceable>строка</replaceable></arg> + <arg>--tunnel-network-range=<replaceable>строка</replaceable></arg> + <arg>--guest-additions-iso=<replaceable>путь</replaceable></arg> + <arg>--proxy=<replaceable>строка</replaceable></arg> + <arg>--compartment-id=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloud-network-create"> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <sbr/> + <arg choice="plain">network create</arg> + <arg choice="req">--name=<replaceable>строка</replaceable></arg> + <arg choice="req">--network-id=<replaceable>строка</replaceable></arg> + <group> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloud-network-update"> + <command>VBoxManage cloud network update</command> + <arg choice="req">--name=<replaceable>строка</replaceable></arg> + <arg>--network-id=<replaceable>строка</replaceable></arg> + <group> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloud-network-delete"> + <command>VBoxManage cloud</command> + <arg choice="plain">network delete</arg> + <arg choice="req">--name=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloud-network-info"> + <command>VBoxManage cloud</command> + <arg choice="plain">network info</arg> + <arg choice="req">--name=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <!-- Cloud commands common options --> + <refsect2 id="vboxmanage-cloud-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Слово "cloud" объединяет все команды, относящиеся к взаимодействию с облаком. Следующие + общие параметры необходимо разместить между "cloud" и последующими подкомандами:</para> + <variablelist> + <varlistentry> + <term>--provider=<replaceable>имя</replaceable></term> + <listitem><para>Короткое имя облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term>--profile=<replaceable>имя</replaceable></term> + <listitem><para>Имя профиля облака. </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <!-- Cloud list commands --> + <refsect2 id="vboxmanage-cloudlist-instances"> + <title>cloud list instances</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает список экземпляров указанной секции. + </para> + <variablelist> + <varlistentry> + <term>--state<replaceable>"running/paused/terminated"</replaceable></term> + <listitem> + <para>Состояние облачного экземпляра. На данный момент возможны следующие состояния: + "running/paused/terminated". Если состояние не указано, возвращается список экземпляров + со всеми возможными состояниями. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment-id</option></term> + <listitem> + <para>Секция - это логический контейнер, используемый для организации и изоляции + облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudlist-images"> + <title>cloud list images</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает список образов для указанной секции. + </para> + <variablelist> + <varlistentry> + <term>--state<replaceable>"available/disabled/deleted"</replaceable></term> + <listitem> + <para>Состояние облачного образа. На данный момент возможны следующие состояния: + "available/disabled/deleted". Если состояние не указано, возвращается список + образов со всеми возможными состояниями. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment-id</option></term> + <listitem> + <para>Секция - это логический контейнер, используемый для организации и изоляции + облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <!-- Cloud instance commands --> + <refsect2 id="vboxmanage-cloudinstance-create"> + <title>cloud instance create</title> + <remark role="help-copy-synopsis"/> + <para> + Создает новый экземпляр в облаке. + Существует два стандартных способа создать экземпляр в облаке: + 1. Создать экземпляр из существующего пользовательского образа. + 2. Создать экземпляр из существующего загрузочного тома. Этот загрузочный том не должен быть подключен + к какому-либо экземпляру. + Для первого способа требуются параметры: image-id, boot-disk-size. + Для второго способа требуются параметры: boot-volume-id. + Остальные параметры являются общими для обоих способов: + display-name, launch-mode, subnet-id, publicIP, privateIP, shape, domain. + </para> + <variablelist> + <varlistentry> + <term><option>--domain-name</option></term><listitem><para>Облачный домен, где создается экземпляр.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--image-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий пользовательский образ в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot-volume-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий загрузочный том в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового экземпляра в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--shape</option></term><listitem><para>Форма экземпляра, определяющая количество ЦПУ и размер RAM памяти.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--subnet</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий существующую подсеть в облаке для использования экземпляром.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot-disk-size</option></term><listitem><para>Размер загрузочного образа в ГБ. По умолчанию 50 ГБ.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--publicip</option></term><listitem><para>У экземпляра публичный IP или нет.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--privateip</option></term><listitem><para>Приватный IP адрес для созданного экземпляра.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--public-ssh-key</option></term> + <listitem> + <para>Публичный ключ SSH, используемый для подключения к экземпляру через + SSH. Этот параметр может быть указан несколько раз, если нужно указать + несколько ключей, например: "--public-ssh-key=firstSSHKey --public-ssh-key=secondSSHKey". + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--launch-mode</option></term><listitem><para>Наиболее известные значения здесь могут быть EMULATED, NATIVE, PARAVIRTUALIZED.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloud-init-script-path</option></term><listitem><para>Абсолютный путь к пользовательскому скрипту облачной инициализации.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-info"> + <title>cloud instance info</title> + <para> + Отображает информацию об облачном экземпляре с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-terminate"> + <title>cloud instance termination</title> + <para> + Удаляет облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-start"> + <title>cloud instance start</title> + <para> + Запускает облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-pause"> + <title>cloud instance pause</title> + <para> + Приостанавливает облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + + <!-- Cloud image commands --> + <refsect2 id="vboxmanage-cloudimage-create"> + <title>cloud image create</title> + <remark role="help-copy-synopsis"/> + <para> + Создает новый образ в облаке. + Существует два стандартных способа создать образ в облаке: + 1. Создать образ из объекта в облачном хранилище; + 2. Создать образ из существующего облачного экземпляра. + Для первого способа требуются параметры: + bucket-name - имя облачной корзины, где находится объект; + object-name - имя объекта в корзине; + display-name - имя для нового образа в облаке. + Для второго способа требуются параметры: + instance-id - Id экземпляра в облаке; + display-name - имя для нового образа в облаке. + </para> + <variablelist> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзине, где находится объект.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--instance-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-info"> + <title>cloud image info</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает информацию об облачном образе с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-delete"> + <title>cloud image delete</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет образ с указанным id из облака. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-import"> + <title>cloud image import</title> + <remark role="help-copy-synopsis"/> + <para> + Импортирует образ с указанным id из облака на локальный хост. + Результатом является объект в локальной папке "temp" локального хоста. + Возможный подход может состоят из двух основных этапов: + 1. Создать объект из образа в облачном хранилище; + 2. Загрузить объект на локальный хост. + Поэтому, следующие параметры могут потребоваться: + bucket-name - имя облачной корзины где будет создан объект; + object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использовано показанное имя образа. + Если первый этап не нужен, требуется только параметр "id". + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины, где будет создан объект.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term> + <listitem> + <para> + Имя созданного объекта в корзине. У загруженного объекта будет такое же имя. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-export"> + <title>cloud image export</title> + <remark role="help-copy-synopsis"/> + <para> + Экспортирует существующий образ VBox с указанным uuid из локального хоста в облако. + Результатом является новый образ в облаке. + Возможный подход может состоят из двух основных этапов: + 1. Загрузить образ VBox в облачное хранилище; + 2. Создать образ из загруженного объекта. + Поэтому, следующие параметры могут потребоваться: + bucket-name - имя облачной корзины куда будет загружен объект; + object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использован id образа; + display-name - имя для нового образа в облаке. + Если первый этап не нужен, требуются только параметры "id" и "display-name". + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор образа в VirtualBox.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины куда будет загружен образ (объект).</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + + <!-- Cloud network commands --> + <refsect2 id="vboxmanage-cloud-network-setup"> + <title>cloud network setup</title> + <remark role="help-copy-synopsis"/> + <para> + Настраивает окружение облачной сети для указанного облачного профиля. + </para> + <variablelist> + <varlistentry> + <term><option>--local-gateway-iso</option></term><listitem><para>Локальный путь к установочному носителю для локального шлюза.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--gateway-os-name</option></term><listitem><para>Имя ОС, используемой для облачного шлюза.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--gateway-os-version</option></term><listitem><para>Версия ОС, используемой для облачного шлюза.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--gateway-shape</option></term><listitem><para>Форма экземпляра, используемая для облачного шлюза.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tunnel-network-name</option></term><listitem><para>Имя VCN/подсети, используемой для туннелирования.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tunnel-network-range</option></term><listitem><para>Диапазон IP адресов, используемый для туннелирования.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--guest-additions-iso</option></term><listitem><para>Локальный путь к установочному носителю Дополнений Гостевой ОС VirtualBox.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--proxy</option></term><listitem><para>URL прокси, используемый в установке локального шлюза.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment-id</option></term><listitem><para>Секция, в которую создается туннель.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloud-network-create"> + <title>cloud network create</title> + <remark role="help-copy-synopsis"/> + <para> + Создает новый дескриптор облачной сети, связанный с существующей облачной подсетью. + </para> + <variablelist> + <varlistentry> + <term><option>--name</option></term><listitem><para>Имя для назначения дескриптору облачной сети.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--network-id</option></term><listitem><para>Уникальный идентификатор существующей подсети в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option>, --disable</term> + <listitem><para>Включить или выключить дескриптор сети. Если не указано, сеть будет включена.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloud-network-update"> + <title>cloud network update</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет существующий дескриптор облачной сети. + </para> + <variablelist> + <varlistentry> + <term><option>--name</option></term><listitem><para>Имя существующего дескриптора облачной сети.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--network-id</option></term><listitem><para>Уникальный идентификатор существующей подсети в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option>, --disable</term> + <listitem><para>Включить или выключить дескриптор сети.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloud-network-delete"> + <title>cloud network delete</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет существующий дескриптор облачной сети. + </para> + <variablelist> + <varlistentry> + <term><option>--name</option></term><listitem><para>Имя существующего дескриптора облачной сети.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloud-network-info"> + <title>cloud network info</title> + <remark role="help-copy-synopsis"/> + <para> + Показывает информацию о дескрипторе облачной сети. + </para> + <variablelist> + <varlistentry> + <term><option>--name</option></term><listitem><para>Имя существующего дескриптора облачной сети.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-cloudimage.xml b/doc/manual/ru_RU/man_VBoxManage-cloudimage.xml new file mode 100644 index 00000000..82b10554 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-cloudimage.xml @@ -0,0 +1,242 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage cloud image +--> +<!-- + Copyright (C) 2018-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-cloudimage" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage cloud image</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-cloudimage</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-cloudimage</refname> + <refpurpose>Управление облачными образами</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">image</arg> + <arg choice="plain">create</arg> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + <arg>--instance-id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">image</arg> + <arg choice="plain">info</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">image</arg> + <arg choice="plain">delete</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">image</arg> + <arg choice="plain">import</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" "> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">image</arg> + <arg choice="plain">export</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg>--bucket-name=<replaceable>имя</replaceable></arg> + <arg>--object-name=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-cloudimage-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Подкоманды <command>cloudimage</command> реализуют стандартные операции над облачными образами, как то + create/delete/show/import/export. Следующие общие параметры должны находиться между "cloud" и последующими подкомандами:</para> + <variablelist> + <varlistentry> + <term>--provider=<replaceable>имя</replaceable></term> + <listitem><para>Короткое имя облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term>--profile=<replaceable>имя</replaceable></term> + <listitem><para>Имя облачного профиля. </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-create"> + <title>cloud image create</title> + <remark role="help-copy-synopsis"/> + <para> + Создает новый образ в облаке. + Существует два стандартных способа создать образ в облаке: + 1. Создать образ из объекта в облачном хранилище; + 2. Создать образ из существующего облачного экземпляра. + Для первого способа требуются параметры: + bucket-name - имя облачной корзины где находится объект; + object-name - имя объекта в корзине; + display-name - имя для нового образа в облаке. + Для второго способа требуются параметры: + instance-id - Id экземпляра в облаке; + display-name - имя для нового образа в облаке. + </para> + <variablelist> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины где размещен объект.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--instance-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-info"> + <title>cloud image info</title> + <remark role="help-copy-synopsis"/> + <para> + Показывает информацию об облачном образе с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-delete"> + <title>cloud image delete</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет образ с указанным id из облака. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-import"> + <title>cloud image import</title> + <remark role="help-copy-synopsis"/> + <para> + Импортирует образ с указанным id из облака на локальный хост. + Результатом является объект в локальной папке "temp" локального хоста. + Возможный подход может состоят из двух основных этапов: + 1. Создать объект из образа в облачном хранилище; + 2. Загрузить объект на локальный хост. + Поэтому, следующие параметры могут потребоваться: + bucket-name - имя облачной корзины где будет создан объект; + object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использовано показанное имя образа. + Если первый этап не нужен, требуется только параметр "id". + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий образ в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины, где будет создан объект.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term> + <listitem> + <para> + Имя созданного объекта в корзине. У загруженного объекта будет такое же имя. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudimage-export"> + <title>cloud image export</title> + <remark role="help-copy-synopsis"/> + <para> + Экспортирует существующий образ VBox с указанным uuid из локального хоста в облако. + Результатом является новый образ в облаке. + Возможный подход может состоят из двух основных этапов: + 1. Загрузить образ VBox в облачное хранилище; + 2. Создать образ из загруженного объекта. + Поэтому, следующие параметры могут потребоваться: + bucket-name - имя облачной корзины куда будет загружен объект; + object-name - имя объекта в корзине. Если параметр "object-name" отсутствует, будет использован id образа; + display-name - имя для нового образа в облаке. + Если первый этап не нужен, требуются только параметры "id" и "display-name". + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор образа в VirtualBox.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового образа в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bucket-name</option></term><listitem><para>Имя облачной корзины куда будет загружен образ (объект).</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--object-name</option></term><listitem><para>Имя объекта в корзине.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-cloudinstance.xml b/doc/manual/ru_RU/man_VBoxManage-cloudinstance.xml new file mode 100644 index 00000000..b2bcee26 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-cloudinstance.xml @@ -0,0 +1,228 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- + manpage, user manual, usage: VBoxManage cloud instance +--> +<!-- + Copyright (C) 2018-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-cloudinstance" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage cloud instance</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-cloudinstance</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-cloudinstance</refname> + <refpurpose>Управление облачными экземплярами</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-create" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">instance</arg> + <arg choice="plain">create</arg> + <arg choice="req">--domain-name=<replaceable>имя</replaceable></arg> + <group choice="req"> + <arg choice="req">--image-id=<replaceable>id</replaceable></arg> + <arg choice="req">--boot-volume-id=<replaceable>id</replaceable></arg> + </group> + <arg choice="req">--display-name=<replaceable>имя</replaceable></arg> + <arg choice="req">--shape=<replaceable>тип</replaceable></arg> + <arg choice="req">--subnet=<replaceable>id</replaceable></arg> + <arg>--boot-disk-size=<replaceable>размер в ГБ</replaceable></arg> + <arg>--publicip=<replaceable>true/false</replaceable></arg> + <arg>--privateip=<replaceable>IP адрес</replaceable></arg> + <arg rep="repeat">--public-ssh-key=<replaceable>ключевая строка</replaceable></arg> + <arg>--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-info" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">instance</arg> + <arg choice="plain">info</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-terminate" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">instance</arg> + <arg choice="plain">terminate</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-start" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">instance</arg> + <arg choice="plain">start</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-pause" sepchar=" "> + <command moreinfo="none">VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">instance</arg> + <arg choice="plain">pause</arg> + <arg choice="req">--id=<replaceable>уникальный id</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-cloudinstance-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Подкоманды <command>cloudinstance</command> реализуют стандартные операции над облачными экземплярами, как то + start/pause/show/terminate. Следующие общие параметры должны быть помещены между "cloud" и последующими подкомандами:</para> + <variablelist> + <varlistentry> + <term>--provider=<replaceable>имя</replaceable></term> + <listitem><para>Короткое имя облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term>--profile=<replaceable>имя</replaceable></term> + <listitem><para>Имя облачного профиля. </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-create"> + <title>cloud instance create</title> + <remark role="help-copy-synopsis"/> + <para> + Создает новый экземпляр в облаке. + Существует два стандартных способа создать экземпляр в облаке: + 1. Создать экземпляр из существующего пользовательского образа. + 2. Создать экземпляр из существующего загрузочного тома. Этот загрузочный том не должен быть подключен + к какому-либо экземпляру. + Для первого способа требуются параметры: image-id, boot-disk-size. + Для второго способа требуются параметры: boot-volume-id. + Остальные параметры являются общими для обоих способов: + display-name, launch-mode, subnet-id, publicIP, privateIP, shape, domain. + </para> + <variablelist> + <varlistentry> + <term><option>--domain-name</option></term><listitem><para>Облачный домен, где создается экземпляр.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--image-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий пользовательский образ в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot-volume-id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий загрузочный том в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--display-name</option></term><listitem><para>Имя для нового экземпляра в облаке.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--shape</option></term><listitem><para>Форма экземпляра, определяющая количество ЦПУ и размер RAM памяти.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--subnet</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий существующую подсеть в облаке для использования экземпляром.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot-disk-size</option></term><listitem><para>Размер загрузочного образа в ГБ. По умолчанию 50 ГБ.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--publicip</option></term><listitem><para>У экземпляра публичный IP или нет.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--privateip</option></term><listitem><para>Приватный IP адрес для созданного экземпляра.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--public-ssh-key</option></term> + <listitem> + <para>Публичный ключ SSH, используемый для подключения к экземпляру через + SSH. Этот параметр может быть указан несколько раз если нужно указать + несколько ключей, например: "--public-ssh-key=firstSSHKey --public-ssh-key=secondSSHKey". + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--launch-mode</option></term><listitem><para>Наиболее известные значения здесь могут быть EMULATED, NATIVE, PARAVIRTUALIZED.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-info"> + <title>cloud instance info</title> + <para> + Показывает информацию об облачном экземпляре с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-terminate"> + <title>cloud instance termination</title> + <para> + Удаляет облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-start"> + <title>cloud instance start</title> + <para> + Запускает облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudinstance-pause"> + <title>cloud instance pause</title> + <para> + Приостанавливает облачный экземпляр с указанным id. + </para> + <variablelist> + <varlistentry> + <term><option>--id</option></term><listitem><para>Уникальный идентификатор, полностью идентифицирующий экземпляр в облаке.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-cloudlist.xml b/doc/manual/ru_RU/man_VBoxManage-cloudlist.xml new file mode 100644 index 00000000..e3b28460 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-cloudlist.xml @@ -0,0 +1,145 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage cloud list +--> +<!-- + Copyright (C) 2018-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-cloudlist" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage cloud list</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-cloudlist</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-cloudlist</refname> + <refpurpose>Команда cloud list дает информацию о некоторых стандартных сущностях в каждом облаке + и которая может быть представлена списком, например, списки экземпляров, образов дисков, сетей, т.д.</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-cloudlist-instances"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">list</arg> + <arg choice="plain">instances</arg> + <arg>--state=<replaceable>строка</replaceable></arg> + <arg>--compartment-id=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudlist-images"> + <command>VBoxManage cloud</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">list</arg> + <arg choice="plain">images</arg> + <arg choice="req">--compartment-id=<replaceable>строка</replaceable></arg> + <arg>--state=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <refsect2 id="vboxmanage-cloud-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Слово "cloud" объединяет все команды, связанные с взаимодействием с облаком. Следующие + общие параметры необходимо разместить между "cloud" и последующими подкомандами, в нашем случае "list":</para> + <variablelist> + <varlistentry> + <term>--provider=<replaceable>имя</replaceable></term> + <listitem><para>Короткое имя облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term>--profile=<replaceable>имя</replaceable></term> + <listitem><para>Имя облачного профиля. </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudlist-instances"> + <title>cloud list instances</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает список экземпляров указанной секции. + </para> + <variablelist> + <varlistentry> + <term>--state<replaceable>"running/paused/terminated"</replaceable></term> + <listitem> + <para>Состояние облачного экземпляра. На данный момент возможны следующие состояния: + "running/paused/terminated". Если состояние не указано, возвращается список экземпляров + со всеми возможными состояниями. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment-id</option></term> + <listitem> + <para>Секция - это логический контейнер, используемый для организации и изоляции + облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudlist-images"> + <title>cloud list images</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает список образов для указанной секции. + </para> + <variablelist> + <varlistentry> + <term>--state<replaceable>"available/disabled/deleted"</replaceable></term> + <listitem> + <para>Состояние облачного образа. На данный момент возможны следующие состояния: + "available/disabled/deleted". Если состояние не указано, возвращается список + образов со всеми возможными состояниями. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment-id</option></term> + <listitem> + <para>Секция - это логический контейнер, используемый для организации и изоляции + облачных ресурсов. У разных облачных провайдеров эта сущность называется по-разному. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-cloudprofile.xml b/doc/manual/ru_RU/man_VBoxManage-cloudprofile.xml new file mode 100644 index 00000000..b5349eea --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-cloudprofile.xml @@ -0,0 +1,191 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage cloudprofile +--> +<!-- + Copyright (C) 2018-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-cloudprofile" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage cloudprofile</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-cloudprofile</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-cloudprofile</refname> + <refpurpose>Управление облачными профилями</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-cloudprofile-add"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage cloudprofile</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">add</arg> + <arg>--clouduser=<replaceable>уникальный id</replaceable></arg> + <arg>--fingerprint=<replaceable>строка MD5</replaceable></arg> + <arg>--keyfile=<replaceable>путь</replaceable></arg> + <arg>--passphrase=<replaceable>строка</replaceable></arg> + <arg>--tenancy=<replaceable>уникальный id</replaceable></arg> + <arg>--compartment=<replaceable>уникальный id</replaceable></arg> + <arg>--region=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudprofile-update"> + <command>VBoxManage cloudprofile</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">update</arg> + <arg>--clouduser=<replaceable>уникальный id</replaceable></arg> + <arg>--fingerprint=<replaceable>строка MD5</replaceable></arg> + <arg>--keyfile=<replaceable>путь</replaceable></arg> + <arg>--passphrase=<replaceable>строка</replaceable></arg> + <arg>--tenancy=<replaceable>уникальный id</replaceable></arg> + <arg>--compartment=<replaceable>уникальный id</replaceable></arg> + <arg>--region=<replaceable>строка</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudprofile-delete"> + <command>VBoxManage cloudprofile</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">delete</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-cloudprofile-show"> + <command>VBoxManage cloudprofile</command> + <arg choice="req">--provider=<replaceable>имя</replaceable></arg> + <arg choice="req">--profile=<replaceable>имя</replaceable></arg> + <arg choice="plain">show</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-cloudprofile-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> Подкоманды <command>cloudprofile</command> реализуют стандартные CRUD операции над облачным профилем. + Следующие общие параметры должны быть помещены между "cloud" и последующими подкомандами:</para> + <variablelist> + <varlistentry> + <term>--provider=<replaceable>имя</replaceable></term> + <listitem><para>Короткое имя облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term>--profile=<replaceable>имя</replaceable></term> + <listitem><para>Имя облачного профиля.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudprofile-add"> + <title>cloudprofile add</title> + <remark role="help-copy-synopsis"/> + <para> + Добавляет новый облачный профиль для указанного облачного провайдера. + </para> + <variablelist> + <varlistentry> + <term><option>--clouduser</option></term><listitem><para>Имя, полностью идентифицирующее пользователя у указанного облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--fingerprint</option></term><listitem><para>Отпечаток используемой ключевой пары.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--keyfile</option></term><listitem><para>Полный путь и имя файла приватного ключа.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--passphrase</option></term><listitem><para>Парольная фраза используемая для ключа, если он зашифрован.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tenancy</option></term><listitem><para>ID вашей аренды.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment</option></term><listitem><para>ID вашей секции.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--region</option></term><listitem><para>Имя региона. Регион - это где вы планируете развертывать приложение.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudprofile-show"> + <title>cloudprofile show</title> + <remark role="help-copy-synopsis"/> + <para> + Показывает информацию об облачном профиле для указанного облачного провайдера. + </para> + </refsect2> + + <refsect2 id="vboxmanage-cloudprofile-update"> + <title>cloudprofile update</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет облачный профиль для указанного облачного провайдера. + </para> + <variablelist> + <varlistentry> + <term><option>--clouduser</option></term><listitem><para>Имя, полностью идентифицирующее пользователя у указанного облачного провайдера.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--fingerprint</option></term><listitem><para>Отпечаток используемой ключевой пары.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--keyfile</option></term><listitem><para>Полный путь и имя файла приватного ключа.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--passphrase</option></term><listitem><para>Парольная фраза используемая для ключа, если он зашифрован.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tenancy</option></term><listitem><para>ID вашей аренды.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--compartment</option></term><listitem><para>ID вашей секции.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--region</option></term><listitem><para>Имя региона. Регион - это где вы планируете развертывать приложение.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-cloudprofile-delete"> + <title>cloudprofile delete</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет облачный профиль для указанного облачного провайдера. + </para> + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-common.xml b/doc/manual/ru_RU/man_VBoxManage-common.xml new file mode 100644 index 00000000..3c370208 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-common.xml @@ -0,0 +1,279 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage +--> +<!-- + 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-common" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage</refname> + <refpurpose>&product-name; интерфейс командной строки</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-common"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage</command> + <group> + <arg choice="plain">-V</arg> + <arg choice="plain">--version</arg> + </group> + <arg>--dump-build-type</arg> + <group> + <arg choice="plain">-q</arg> + <arg choice="plain">--nologo</arg> + </group> + <arg>--settingspw=<replaceable>пароль</replaceable></arg> + <arg>--settingspwfile=<replaceable>файл с паролем</replaceable></arg> + <arg>@<replaceable>файл ответов</replaceable></arg> + <arg><arg>help</arg> <replaceable>подкоманда</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage</command> - это интерфейс командной + строки (CLI) для ПО &product-name;. CLI поддерживает весь + функционал, доступный из графического интерфейса &product-name; + (GUI). В дополнении, можно использовать команду + <command>VBoxManage</command> для управления функционалом + ядра виртуализации, недоступного из GUI. + </para> + <para> + Каждый раз, когда вы вызываете команду <command>VBoxManage</command>, + исполняется только одна команда. Однако заметим, что некоторые + подкоманды <command>VBoxManage</command> вызывают несколько + подкоманд. + </para> + <para> + Запустите команду <command>VBoxManage</command> из командной строки + операционной системы (ОС) хоста для управления ПО &product-name;. + </para> + <para> + Команда <command>VBoxManage</command> находится в следующих местах + в зависимости от операционной системы хоста: + </para> + <itemizedlist> + <listitem><para> + <emphasis role="bold">Linux:</emphasis> + <filename>/usr/bin/VBoxManage</filename> + </para></listitem> + <listitem><para> + <emphasis role="bold">Mac OS X:</emphasis> + <filename>/Applications/VirtualBox.app/Contents/MacOS/VBoxManage</filename> + </para></listitem> + <listitem><para> + <emphasis role="bold">Oracle Solaris:</emphasis> + <filename>/opt/VirtualBox/bin/VBoxManage</filename> + </para></listitem> + <listitem><para> + <emphasis role="bold">Windows:</emphasis> + <filename>C:\Program + Files\Oracle\VirtualBox\VBoxManage.exe</filename> + </para></listitem> + </itemizedlist> + <para> + В дополнении к управлению виртуальными машинами (ВМ) через CLI или + GUI, можно использовать <command>VBoxHeadless</command> CLI для + управления ВМ напрямую. + </para> + <para> + Команда <command>VBoxManage</command> производит специфические + задачи через подкоманды, такие как <command>list</command>, + <command>createvm</command> и <command>startvm</command>. Смотри + соответствующую информацию по каждой подкоманде + <command>VBoxManage</command>. + </para> + <para> + Если нужно, ВМ может быть указана по ее имени или универсальному + уникальному идентификатору (UUID). + </para> + <para> + Команда <command>VBoxManage list vms</command> может быть + использована для получения информации обо всех зарегистрированных + на данный момент ВМ, включая их имена и UUID. + </para> + <para> + Заметим, что имя ВМ должно быть заключено в кавычки если оно содержит + пробелы. + </para> + <refsect2 id="vboxmanage-common-options"> + <title>Общие настройки</title> + <variablelist> + <varlistentry> + <term><option>--nologo</option></term> + <listitem><para> + Подавляет вывод логотипа. Опция полезна для скриптов. + </para><para> + Краткая версия этой опции: <option>-q</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--settingspw=[<replaceable>пароль</replaceable>]</option></term> + <listitem><para> + Указывает пароль для доступа к настройкам. Опционально, можно + указать сам пароль в качестве аргумента к опции. Если этого + не будет сделано, команда <command>VBoxManage</command> + спросит пароль у вас. + </para><para> + Пароль для доступа к настройкам - это функция безопасности, + которая шифрует настройки. По умолчанию настройки сохраняются + обычным текстом в открытом виде. + </para><para> + Вы не можете расшифровать зашифрованные настройки. Так что, + если настройки зашифрованы, вы должны продолжать указывать + <option>--settingspw</option> или + <option>--settingspwfile</option>. + </para><para> + В настоящее время шифруется только пароль iSCSI. + </para><remark> + Данный дизайн не укладывается в Рекомендации по безопасности + Oracle. Вы не должны указывать пароль в командной строке как + аргумент, так как он может отображаться в списке процессов. + </remark></listitem> + </varlistentry> + <varlistentry> + <term><option>--settingspwfile=<replaceable>файл с паролем</replaceable></option></term> + <listitem><para> + Указывает файл, содержащий пароль к настройкам. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--version</option></term> + <listitem><para> + Показывает информацию о версии команды + <command>VBoxManage</command>. + </para><para> + Краткая версия это опции: <option>-V</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term>@<replaceable>файл ответов</replaceable></term> + <listitem><para> + Загружает аргументы из файла ответов в формате + Bourne shell. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>подкоманда</replaceable></term> + <listitem><para> + Указывает одну из подкоманд <command>VBoxManage</command>, + такие как <command>controlvm</command>, + <command>createvm</command>, <command>list</command>, + <command>modifyvm</command>, + <command>showvminfo</command>, <command>startvm</command>, + <command>storageattach</command> и + <command>storagectl</command>. + </para><para> + Каждая подкоманда описывается в своем топике, некоторые + из них показаны в секции 'Смотрите также'. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда создает виртуальную машину с именем + <literal>Win8</literal> и регистрирует ее в &product-name;, + используя опцию <option>--register</option>. + </para> +<screen>$ VBoxManage createvm --name "Win8" --register +Виртуальная машина 'Win8' создана и зарегистрирована. +UUID: <replaceable>строка UUID</replaceable> +Файл настроек: '/home/<replaceable>имя пользователя</replaceable>/VirtualBox VMs/Win8/Win8.vbox'</screen> + <para> + Вывод команды показывает, что ВМ <literal>Win8</literal> + назначен UUID и XML файл настроек машины. + </para> + <para> + Вы можете использовать команду <command>VBoxManage showvminfo</command> + для просмотра информации о конфигурации ВМ. + </para> + <para> + Следующий пример использует команду <command>VBoxManage + modifyvm</command> для изменения размера памяти у ВМ + <literal>Windows XP</literal> VM до 1024 мегабайта: + </para> +<screen>$ VBoxManage modifyvm "Windows XP" --memory 1024</screen> + <para> + Заметим, что вы можете использовать команду <command>VBoxManage modifyvm</command> + даже если ВМ выключена. + </para> + <para> + Вы можете использовать команду <command>VBoxManage storagectl</command> + или команду <command>VBoxManage storageattach</command> для + изменения конфигурации носителей у ВМ. Например, чтобы создать + SATA контроллер с именем <literal>sata01</literal> и добавить + его в ВМ <literal>ol7</literal> VM используйте: + </para> +<screen>$ VBoxManage storagectl ol7 --name "sata01" --add sata</screen> + <para> + Используйте команду <command>VBoxManage startvm</command> для старта + ВМ, которая сейчас выключена. Например, чтобы запустить ВМ + <literal>win7</literal> укажите: + </para> +<screen>$ VBoxManage startvm win7</screen> + <para> + Используйте команду <command>VBoxManage controlvm</command> + для приостановки или сохранения состояния ВМ, которая сейчас работает. + Вы также можете использовать эту команду для изменения настроек + ВМ. Например, чтобы включить аудио вход для ВМ <literal>ol6u9</literal> + используйте: + </para> +<screen>$ VBoxManage controlvm ol6u9 audioin on</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-controlvm" />, + <xref linkend="vboxmanage-createvm" />, + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-modifyvm" />, + <xref linkend="vboxmanage-showvminfo" />, + <xref linkend="vboxmanage-startvm" />, + <xref linkend="vboxmanage-storageattach" />, + <xref linkend="vboxmanage-storagectl" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-controlvm.xml b/doc/manual/ru_RU/man_VBoxManage-controlvm.xml new file mode 100644 index 00000000..0b990052 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-controlvm.xml @@ -0,0 +1,2174 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage controlvm +--> +<!-- + 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-controlvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage controlvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-controlvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-controlvm</refname> + <refpurpose>изменение состояния и настроек работающей виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-controlvm-pause"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">pause</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-resume"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">resume</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-reset"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">reset</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-poweroff"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">poweroff</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-savestate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">savestate</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpipowerbutton"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">acpipowerbutton</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpisleepbutton"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">acpisleepbutton</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-reboot"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">reboot</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-shutdown"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">shutdown</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputscancode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputscancode</arg> + <arg choice="req"><replaceable>hex</replaceable></arg> + <arg rep="repeat"><replaceable>hex</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputstring"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputstring</arg> + <arg choice="req"><replaceable>строка</replaceable></arg> + <arg rep="repeat"><replaceable>строка</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputfile"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">keyboardputfile</arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setlinkstate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setlinkstate<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nic"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nic<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">null</arg> + <arg choice="plain">nat</arg> + <arg choice="plain">bridged</arg> + <arg choice="plain">intnet</arg> + <arg choice="plain">hostonly</arg> + <arg choice="plain">generic</arg> + <arg choice="plain">natnetwork</arg> + </group> + <arg><replaceable>имя-устройства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictrace"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nictrace<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictracefile"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nictracefile<replaceable>N</replaceable></arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicproperty"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nicproperty<replaceable>N</replaceable></arg> + <arg choice="req"><replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicpromisc"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">nicpromisc<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">deny</arg> + <arg choice="plain">allow-vms</arg> + <arg choice="plain">allow-all</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">natpf<replaceable>N</replaceable></arg> + <group choice="req"> + <arg choice="plain">[<replaceable>имя-правила</replaceable>]<arg choice="plain">,tcp</arg></arg> + <arg choice="plain">udp,<arg><replaceable>IP-хоста</replaceable></arg>, + <arg choice="plain"><replaceable>порт-хоста</replaceable>,</arg> + <arg><replaceable>IP-гостя</replaceable></arg>, + <arg choice="plain"><replaceable>порт-гостя</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf-delete"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">natpf<replaceable>N</replaceable> delete</arg> + + <arg choice="req"><replaceable>имя-правила</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-guestmemoryballoon"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">guestmemoryballoon</arg> + <arg choice="req"><replaceable>размер-balloon-памяти</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbattach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">usbattach</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + </group> + <arg>--capturefile=<replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbdetach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">usbdetach</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioin"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">audioin</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioout"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">audioout</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-clipboard-mode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">clipboard mode</arg> + <group choice="req"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-draganddrop"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">draganddrop</arg> + <group choice="req"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrde"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrde</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeport"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdeport</arg> + <arg choice="req"><replaceable>port</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeproperty"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdeproperty</arg> + <arg choice="req"><replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdevideochannelquality"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vrdevideochannelquality</arg> + <arg choice="req"><replaceable>процент</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setvideomodehint"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setvideomodehint</arg> + <arg choice="req"><replaceable>разрешение-x</replaceable></arg> + <arg choice="req"><replaceable>разрешение-y</replaceable></arg> + <arg choice="req"><replaceable>бит/пиксел</replaceable></arg> + <arg><arg><replaceable>дисплей</replaceable></arg><group> + <arg choice="plain">enabled:yes | no</arg> + <arg><replaceable>начальная-точка-x</replaceable> <replaceable>начальная-точка-y</replaceable></arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setscreenlayout"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setscreenlayout</arg> + <arg choice="req"><replaceable>экран</replaceable></arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">primary <replaceable>начальная-точка-x</replaceable> <replaceable>начальная-точка-y</replaceable> <replaceable>разрешение-x</replaceable> <replaceable>разрешение-y</replaceable> <replaceable>бит/пиксел</replaceable></arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-screenshotpng"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">screenshotpng</arg> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + <arg><replaceable>display</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording</arg> + <group choice="req"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-screens"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording screens</arg> + <group choice="req"> + <arg choice="plain">all</arg> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>экран</replaceable>,[<replaceable>экран</replaceable>...]</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-filename"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording filename</arg> + <arg choice="req">filename</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videores"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videores</arg> + <arg choice="req"><replaceable>ширина</replaceable>x<replaceable>высота</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videorate"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videorate</arg> + <arg choice="req"><replaceable>битрейт</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videofps"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording videofps</arg> + <arg choice="req"><replaceable>кадров/сек</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxtime"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording maxtime</arg> + <arg choice="req"><replaceable>сек</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxfilesize"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">recording maxfilesize</arg> + <arg choice="req"><replaceable>МБ</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-setcredentials"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setcredentials</arg> + <arg choice="req"><replaceable>имя-пользователя</replaceable></arg> + <arg choice="plain">--passwordfile=<group choice="req"> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + <arg choice="plain"><replaceable>пароль</replaceable></arg> + </group></arg> + <arg choice="req"><replaceable>имя-домена</replaceable></arg> + <arg choice="plain">--allowlocallogon=<group choice="req"> + <arg choice="plain">yes</arg> + <arg choice="plain">no</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-teleport"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">teleport</arg> + <arg choice="req">--host=<replaceable>имя-хоста</replaceable></arg> + <arg choice="req">--port=<replaceable>имя-порта</replaceable></arg> + <arg>--maxdowntime=<replaceable>мсек</replaceable></arg> + <group> + <arg choice="plain">--passwordfile=<replaceable>имя-файла</replaceable></arg> + <arg choice="plain">--password=<replaceable>пароль</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-plugcpu"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">plugcpu</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-unplugcpu"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">unplugcpu</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-cpuexecutioncap"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">cpuexecutioncap</arg> + <arg choice="req"><replaceable>число</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-vm-process-priority"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">vm-process-priority</arg> + <group choice="req"> + <arg choice="plain">default</arg> + <arg choice="plain">flat</arg> + <arg choice="plain">low</arg> + <arg choice="plain">normal</arg> + <arg choice="plain">high</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-attach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam attach</arg> + <arg><replaceable>путь</replaceable><arg><replaceable>настройки</replaceable></arg></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-detach"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam detach</arg> + <arg><replaceable>путь</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-list"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">webcam list</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-addencpassword"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">addencpassword</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + <group choice="req"> + <arg choice="plain"><replaceable>файл-с-паролем</replaceable></arg> + <arg choice="plain">-</arg> + </group> + <arg>--removeonsuspend=<group choice="plain"> + <arg choice="plain">yes</arg> + <arg choice="plain">no</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeencpassword"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">removeencpassword</arg> + <arg choice="req"><replaceable>ID</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeallencpasswords"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">removeallencpasswords</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-changeuartmode"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">changeuartmode<replaceable>N</replaceable></arg> + <group choice="plain"> + <arg choice="plain">disconnected</arg> + <arg choice="plain">server <replaceable>имя-канала</replaceable></arg> + <arg choice="plain">client <replaceable>имя-канала</replaceable></arg> + <arg choice="plain">tcpserver <replaceable>порт</replaceable></arg> + <arg choice="plain">tcpclient <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable></arg> + <arg choice="plain">file <replaceable>имя-файла</replaceable></arg> + <arg choice="plain"><replaceable>имя-устройства</replaceable></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-autostart-enabled"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">autostart-enabled<replaceable>N</replaceable></arg> + <group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-controlvm-autostart-delay"> + <command>VBoxManage controlvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">autostart-delay<replaceable>секунд</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage controlvm</command> позволяет изменить + состояние работающей виртуальной машины (ВМ). Следующие секции + описывают подкоманды, которые можно использовать: + </para> + <refsect2 id="vboxmanage-controlvm-pause"> + <title>Приостановить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> pause</command> временно + приостанавливает выполнение ВМ. Когда ВМ приостановлена, ее + состояние не изменяется постоянно. + </para> + <para> + Окно ВМ становится серым и заголовок окна показывает, что ВМ + приостановлена на текущий момент. Это действие эквивалентно + выбору <emphasis role="bold">Приостановить</emphasis> из + меню <emphasis role="bold">Машина</emphasis> графического + интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-resume"> + <title>Возобновить выполнение приостановленной виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> resume</command> перезапускает + выполнение приостановленной ВМ. Это действие эквивалентно выбору + <emphasis role="bold">Возобновить</emphasis> из меню + <emphasis role="bold">Машина</emphasis> графического интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-reset"> + <title>Сбросить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> reset</command> производит + холодный сброс ВМ. У этой команды тот же эффект, как и нажатие + кнопки "сброс" у физического компьютера. + </para> + <para> + Холодная перезагрузка немедленно перезапускает и перезагружает + гостевую операционную системы (ОС). Состояние ВМ перед сбросом + не сохраняется, поэтому можно потерять данные. Это действие + эквивалентно выбору <emphasis role="bold">Сброс</emphasis> из + меню <emphasis role="bold">Машина</emphasis> графического + интерфейса. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-poweroff"> + <title>Выключить виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> poweroff</command> выключает + ВМ. У этой команды тот же эффект как и вытаскивание кабеля питания + из физического компьютера. + </para> + <para> + Состояние ВМ перед выключением не сохраняется, поэтому можно + потерять данные. Это действие эквивалентно выбору + <emphasis role="bold">Закрыть</emphasis> из меню + <emphasis role="bold">Машина</emphasis> графического интерфейса + или нажатию на кнопку "Закрыть" окна ВМ и затем выбору + <emphasis role="bold">Выключить машину</emphasis>. + </para> + <para> + Когда ВМ в состоянии "выключено", ее можно перезапустить. + Смотрите <xref linkend="vboxmanage-startvm" />. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-savestate"> + <title>Сохранить состояние виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> savestate</command> сохраняет + текущее состояние ВМ на диск и затем останавливает ВМ. + </para> + <para> + Действие эквивалентно выбору <emphasis role="bold">Закрыть</emphasis> + из меню <emphasis role="bold">Машина</emphasis> графического интерфейса + или нажатию на кнопку "Закрыть" окна ВМ и затем выбору + <emphasis role="bold">Сохранить состояние машины</emphasis>. + </para> + <para> + Когда ВМ в состоянии "выключено", ее можно перезапустить. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-acpipowerbutton"> + <title>Отправить ACPI сигнал выключения в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> acpipowerbutton</command> отправляет + ACPI сигнал выключения в ВМ. У этой команды тот же эффект как + и нажатие кнопки "Включить" на физическом компьютере. + </para> + <para> + Пока в ВМ работает гостевая ОС, обеспечивающая поддержку ACPI, + эта команда запускает правильный механизм остановки внутри ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-acpisleepbutton"> + <title>Отправить ACPI сигнал перехода в спящий режим в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> acpisleepbutton</command> отправляет + ACPI сигнал перехода в спящий режим в ВМ. + </para> + <para> + Пока в ВМ работает гостевая ОС, обеспечивающая поддержку ACPI, + эта команда запускает правильный механизм перехода в спящий + режим внутри ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-reboot"> + <title>Перезагрузить гостевую ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> reboot</command> просит + гостевую ОС перезагрузиться. + </para> + <para> + Эта команда работает только если установлена + последняя версия Дополнений Гостевой ОС. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-shutdown"> + <title>Выключить гостевую ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> shutdown</command> + просит гостевую ОС выключиться + </para> + <para> + Эта команда работает только если установлена + последняя версия Дополнений Гостевой ОС. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputscancode"> + <title>Отправить клавиатурные сканкоды в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputscancode</command> + отправляет команды клавиатурных сканкодов в ВМ. + </para> + <para> + По информации о клавиатурных сканкодах смотрите + <ulink url="http://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html" />. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputstring"> + <title>Отправить клавиатурные строки в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputstring</command> + отправляет клавиатурные строки в ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-keyboardputfile"> + <title>Отправить файл в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> keyboardputfile</command> + отправляет файл в ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-teleport"> + <title>Настроить цель для портирования виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> teleport</command> инициирует + операцию портирования между указанной ВМ и указанной системой + хоста. Смотрите <xref linkend="teleporting" />. + </para> + <para> + Если вы указываете пароль, он должен соответствовать паролю, + используемому при вызове команды <command>VBoxManage + modifyvm</command> для целевой машины. + </para> + <variablelist> + <varlistentry> + <term><option>--host=<replaceable>имя-хоста</replaceable></option></term> + <listitem><para> + Указывает имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port=<replaceable>порт</replaceable></option></term> + <listitem><para> + Указывает порт, который ВМ должна прослушивать для получения + запросов на портирование с других ВМ. Номер порта может быть + любой свободный TCP/IP порт, например <literal>6000</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--maxdowntime=<replaceable>мсек</replaceable></option></term> + <listitem><para> + Задает максимальное время простоя в миллисекундах для портируемой + целевой виртуальной машины. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--password=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Указывает пароль, используемый исходной машиной для запроса + на портирование. Запрос удовлетворяется только если + исходная машины указывает тот же самый пароль. + </para><remark> + Такой дизайн не соответствует рекомендациям Oracle по безопасности. + Вы не должны указывать пароль в командной строке, потому что + его можно увидеть в списке процессов. + </remark><para> + Опция <option>--password</option> является взаимоисключающей с опцией + <option>--passwordfile</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--passwordfile=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Указывает файл откуда берется пароль, испольуемый исходной + машиной для запроса на портирование. Запрос удовлетворяется + только если исходная машина указывает тот же самый пароль. + </para><para> + Если указатть в качестве имени файла <literal>stdin</literal>, + можно читать пароль со стандартного потока ввода. + </para><para> + Опция <option>--passwordfile</option> является взаимоисключающей + с опцией <option>--password</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setlinkstate"> + <title>Установить состояние сетевого подключения для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + setlinkstate<replaceable>N</replaceable></command> позволяет подключить + или отключить виртуальный сетевой кабель от экземпляра сетевого + интерфейса(<replaceable>N</replaceable>). Допустимые значения: + <literal>on</literal> и <literal>off</literal>. Значение по умолчанию + <literal>on</literal>. + </para> + <para> + Перед подключением виртуального сетевого кабеля используйте команду + <command>VBoxManage controlvm nictracefile<replaceable>N</replaceable> + </command> во время работы ВМ для задания имени файла для записи + журнала. Или используйте команду <command>VBoxManage modifyvm + --nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></command> + для этих же целей, если ВМ не работает. + </para> + <para> + Эта подкоманда не влияет прямо на состояние работы ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nic"> + <title>Задать тип сети, используемой виртуальной машиной</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nic<replaceable>N</replaceable></command> указывает тип сети + в указаной сетевой карте ВМ. + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. + </para> + <para> + Следующие допустимые типы сети также описаны в + <xref linkend="networkingmodes" />: + </para> + <itemizedlist> + <listitem><para> + <literal>null</literal> указывает, что ВМ не подключена к + хост-системе. + </para></listitem> + <listitem><para> + <literal>nat</literal> указывает, что ВМ использует сетевое + преобразование адресов (NAT). + </para></listitem> + <listitem><para> + <literal>bridged</literal> указывает, что ВМ использует + сетевой мост. + </para></listitem> + <listitem><para> + <literal>intnet</literal> указывает, что ВМ обменивается + с другими ВМ, используя внутреннюю сеть. + </para></listitem> + <listitem><para> + <literal>hostonly</literal> указывает, что ВМ использует + сеть хоста. + </para></listitem> + <listitem><para> + <literal>natnetwork</literal> указывает, что ВМ испльзует + сеть NAT. + </para></listitem> + <listitem><para> + <literal>generic</literal> указывает, что у ВМ есть доступ + у редко используемым под-режимами. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nictrace"> + <title>Отследить сетевой траффик виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictrace<replaceable>N</replaceable></command> позволяет + отслеживать сетевой траффик на указанной виртуальной сетевой + карте (<replaceable>N</replaceable>). + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. Допустимые значения: <literal>on</literal> и + <literal>off</literal>. Значение по умолчанию + <literal>off</literal>. + </para> + <para> + Когда устанавливается в <literal>on</literal>, необходимо + использовать то же самое значение <replaceable>N</replaceable> + для команды <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictracefile<replaceable>N</replaceable></command>, что было + использовано для указания пути и имени файла журнала, в который + производится запись результатов отслеживания. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nictracefile"> + <title>Задать файл журнала для отслеживания сетевого траффика виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictracefile<replaceable>N</replaceable></command> позволяет вам + задать имя файла журнала для отслеживания сетевого траффика для + указанной виртуальной сетевой карты (<replaceable>N</replaceable>). + Нумерация <replaceable>N</replaceable> начинается с + <literal>1</literal>. Убедитесь, что задано то же значение + <replaceable>N</replaceable>, какое использовано для команд + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nic<replaceable>N</replaceable></command> и + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nictrace<replaceable>N</replaceable></command>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nicpromisc"> + <title>Указать используемый неразборчивый режим для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nicpromisc<replaceable>N</replaceable></command> позволяет указать + как обрабатывать неразборчивый режим для сетевого моста. Значение + по умолчанию <literal>deny</literal> скрывает весь траффик, не + предназначенный для этой ВМ. Значение <literal>allow-vms</literal> + скрывает весь траффик хоста от этой ВМ, но позволяет ВМ просматривать + траффик с других ВМ. Значение <literal>allow-all</literal> убирает + это ограничение полностью. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-nicproperty"> + <title>Задать значение свойства сетевого бэкенда виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + nicproperty<replaceable>N</replaceable> + <replaceable>имя-свойства</replaceable>=<replaceable>значение-свойства</replaceable></command> + в комбинации с <literal>nicgenericdrv</literal> позволяет передать + значения свойств в редко используемые сетевые бэкенды. + </para> + <para> + Эти свойства специфичны для бэкенда и различны между драйверами + UDP туннеля и VDE бэкенда. Смотрите <xref linkend="network_udp_tunnel" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-natpf"> + <title>Задать правило для перенаправления портов NAT для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + natpf<replaceable>N</replaceable></command> задает правило перенаправления + портов NAT. Смотрите <xref linkend="natforward"/>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-natpf-delete"> + <title>Удалить правило для перенаправления портов NAT для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда<command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + natpf<replaceable>N</replaceable> delete</command> удаляет указанное + правило перенаправления портов NAT. Смотрите <xref linkend="natforward"/>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-guestmemoryballoon"> + <title>Изменить размер гостевого memory balloon виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> guestmemoryballoon</command> + изменяет размер гостевого memory balloon. Гостевой memory balloon - + это память выделенная Дополнениями Гостевой ОС &product-name; у + гостевой системы и возвращенная гипервизору для использования + другими ВМ. Значение указывается в мегабайтах. Смотрите + <xref linkend="guestadd-balloon" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-usbattach"> + <title>Сделать USB устройство хост-системы видимым для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> usbattach</command> динамически + подключает USB устройство хоста к ВМ, что делает его видимым. + Не нужно создавать фильтр. + </para> + <para> + Можно указывать USB устройство через Универсальный Уникальный + Идентификатор (UUID) или через адрес в хост-системе. используйте + команду <command>VBoxManage list usbhost</command> для получения + информации об USB устройствах хост-системы. + </para> + <para> + Используйте опцию <option>--capturefile</option> для задания + абсолютного пути к файлу для записи данных журналирования. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-usbdetach"> + <title>Сделать USB устройство хост-системы невидимым для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> usbdetach</command> динамически + отключает USB устройство хоста от ВМ, что делает его невидимым. + Не нужно создавать фильтр. + </para> + <para> + Можно указывать USB устройство через Универсальный Уникальный + Идентификатор (UUID) или через адрес в хост-системе. используйте + команду <command>VBoxManage list usbhost</command> для получения + информации об USB устройствах хост-системы. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-audioin"> + <title>Включить или выключить аудио захват из хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> audioin</command> указывает + включить или выключить аудио захват из хост-системы. Допустимые + значения: <literal>on</literal>, которая включает аудио захват и + <literal>off</literal>, которая выключает аудио захват. Значение + по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-audioout"> + <title>Включить или выключить аудио воспроизведение из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> audioout</command> указывает + включить или выключить аудио воспроизведение из гостевой ВМ. + Допустимые значения: <literal>on</literal>, которая включает + аудио воспроизведение и <literal>off</literal>, которая выключает + аудио воспроизведение. Значение по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-clipboard-mode"> + <title>Задать как предоставить общий доступ к буферам обмена хост ОС или гостевой ОС</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> clipboard mode</command> задает + как предоставить общий доступ к буферам обмена гостевой системы + или хоста хост-системе или ВМ. Допустимые значения: + <literal>disabled</literal>, <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и <literal>bidirectional</literal>. + Значение по умолчанию <literal>disabled</literal>. Смотрите + <xref linkend="generalsettings" />. + </para> + <para> + Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, + установленных в ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-draganddrop"> + <title>Задать режим Drag and Drop между хост-системой и виртуальной машиной</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> draganddrop</command> Задает + текущий режим drag and drop, используемый между хост-системой + и ВМ. Допустимые значения: <literal>disabled</literal>, + <literal>hosttoguest</literal>, <literal>guesttohost</literal> + и <literal>bidirectional</literal>. Значение по умолчанию + <literal>disabled</literal>. Смотрите <xref linkend="guestadd-dnd" />. + </para> + <para> + Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, + установленных в ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrde"> + <title>Включить или выключить VRDE сервер</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrde</command> включает или + выключает сервер Расширения Удаленного Рабочего Стола VirtualBox (VRDE), + если он установлен. Допустимые значения: <literal>on</literal> и + <literal>off</literal>. Значение по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdeport"> + <title>Задать порты VRDE сервера</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrdeport</command> задает + порт или диапазон портов к которым VRDE сервер может подключиться. + Значение по умолчанию <literal>default</literal> или + <literal>0</literal>, который обозначает стандартный RDP порт + <literal>3389</literal>. + </para> + <para> + Также смотрите описание опции <option>--vrde-port</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdeproperty"> + <title>Задать номера портов и IP адреса VRDE сервера</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vrdeproperty</command> указывает + номера портов и IP адрес в ВМ, к которым может подключиться VRDE + сервер. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <literal>TCP/Ports</literal> задает порт или диапазон портов + на которые может подключиться VRDE сервер. Значение по + умолчанию <literal>default</literal> или <literal>0</literal>, + который означает стандартный RDP порт <literal>3389</literal>. + </para><para> + Также смотрите описание опции <option>--vrde-port</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para></listitem> + <listitem><para> + <literal>TCP/Address</literal> указывает IP адрес сетевого + интерфейса хоста, к которому может подключиться VRDE сервер. + Если указан, сервер принимает подключения только к указанному + сетевому интерфейсу хоста. + </para><para> + Также смотрите описание опции <option>--vrde-address</option> в + <xref linkend="vboxmanage-modifyvm" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/Enabled</literal> позволяет подключить + видеоканал Протокола Удаленного Рабочего Стола (VRDP). + Допустимые значения <literal>1</literal> для включения + видеоканала и <literal>0</literal> для выключения. Значение + по умолчанию <literal>0</literal>. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/Quality</literal> указывает уровень + сжатия JPEG в видеоканале сервера VRDE. Допустимые значения + между 10% и 100% включительно. Меньшие значения подразумевают + худшее качество, но более высокое сжатие. Значение по умолчанию + <literal>100</literal>. Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + <listitem><para> + <literal>VideoChannel/DownscaleProtection</literal> позволяет + подключить функцию защиты от уменьшения масштаба видеоканала. + Укажите <literal>1</literal> для включения. По умолчанию + выключено. + </para><para> + Когда функция включена, если размер видео равен размеру теневого + буфера, видео отображается в полноэкранном режиме. Если размер + видео между полным экраном и порогом уменьшения масштаба, видео + не отображается, так как это может быть окно приложения, которое + может быть нечитаемым в случае уменьшения масштаба. Когда функция + отключена, функция защиты от уменьшения масштаба всегда пытается + отобразить видео. + </para></listitem> + <listitem><para> + <literal>Client/DisableDisplay</literal> позволяет отключить функцию + отображения сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию null. Смотрите + <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableInput</literal> позволяет отключить функцию + ввода сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableAudio</literal> позволяет отключить функцию + аудио сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableUSB</literal> позволяет отключить функцию + USB сервера VRDE. Допустимые значения <literal>1</literal>, + отключающее функцию и null (<literal>""</literal>), + включающую эту функцию. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableClipboard</literal> позволяет отключить + функцию буфера обмена сервера VRDE. Допустимые значения + <literal>1</literal>, отключающее функцию и null + (<literal>""</literal>), включающую эту функцию. + Используйте <literal>Client/DisableClipboard=</literal> для + включения этой функции. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableUpstreamAudio</literal> позволяет отключить + функцию загрузки аудио на сервер VRDE. Допустимые значения + <literal>1</literal>, отключающее функцию и null + (<literal>""</literal>), включающую эту функцию. + Используйте <literal>Client/DisableUpstreamAudio=</literal> для + включения этой функции. Значение по умолчанию <literal>1</literal>. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Client/DisableRDPDR</literal> позволяет отключить функцию + Перенаправления Устройств RDP Для Смарт-Карт сервера VRDE. + Допустимые значения <literal>1</literal>, отключающее функцию и + null (<literal>""</literal>), включающую эту функцию. + Значение по умолчанию <literal>1</literal>. Смотрите + <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>H3DRedirect/Enabled</literal> позволяет включить функцию + Перенаправления 3D сервера VRDE. Допустимые значения + <literal>1</literal>, включающее функцию и + null (<literal>""</literal>), отключающую эту функцию. + Смотрите <xref linkend="vrde-customization"/>. + </para></listitem> + <listitem><para> + <literal>Security/Method</literal> указывает метод безопасности, + используемый для подключения. Смотрите <xref linkend="vrde-crypt" />. + </para><itemizedlist> + <listitem><para> + <literal>Negotiate</literal> принимает RDP подключения, имеющие + и повышенный (TLS) и стандартный протокол безопасности. Метод + безопасности оговаривается с клиентом. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>RDP</literal> принимает только RDP подключения со + стандартным протоколом безопасности. + </para></listitem> + <listitem><para> + <literal>TLS</literal> принимает только RDP подключения с + повышенным протоколом безопасности. Клиент должен поддерживать + TLS. + </para></listitem> + </itemizedlist></listitem> + <listitem><para> + <literal>Security/ServerCertificate</literal> указывает абсолютный + путь к сертификату сервера, используемому в подключении. + Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Security/ServerPrivateKey</literal> указывает абсолютный + путь к приватному ключу сервера. Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Security/CACertificate</literal> указывает абсолютный + путь к корневому самоподписанному сертификату. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + <listitem><para> + <literal>Audio/RateCorrectionMode</literal> указывает используемый + режим коррекции битрейта. + </para><itemizedlist> + <listitem><para> + <literal>VRDP_AUDIO_MODE_VOID</literal> отображает что + режим коррекции не используется. Используйте это значение + для снятия ранее установленного режима. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_RC</literal> указывает, что надо + использовать режим коррекции скорости. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_LPF</literal> указывает, что надо + использовать режим НЧ фильтра. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_CS</literal> указывает, что надо + использовать режим синхронизации клиента для предотвращения + незаполненности или переполнения очереди клиента. + </para></listitem> + </itemizedlist></listitem> + <listitem><para> + <literal>Audio/LogPath</literal> указывает абсолютный путь к файлу + журнала аудио. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vrdevideochannelquality"> + <title>Указать качество изображения для перенаправления видео VRDP</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + vrdevideochannelquality</command> задает качество изображения как + значение уровня сжатия JPEG для перенаправления видео. Допустимые + значения между 10% и 100% включительно. Меньшие значения подразумевают + худшее качество, но более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setvideomodehint"> + <title>Указать режим видео для гостевой ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> setvideomodehint</command> + задает используемый режим видео для гостевой ВМ. У вас должны + быть установлены Дополнения Гостевой ОС. Заметим, что данная + функция работает не для всех гостевых систем. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setscreenlayout"> + <title>Задать макет экрана для монитора в гостевой ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> setscreenlayout</command> + может быть использована для настройки ВМ с несколькими мониторами. + Указанный экран гостевой ВМ может быть включен или отключен + или может быть настроен пользовательский макет экрана. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-screenshotpng"> + <title>Сделать снимок экрана с монитора виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> screenshotpng</command> делает + снимок экрана с монитора гостевой системы и сохраняет его в + формате PNG в указанном файле. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <replaceable>имя-файла</replaceable> задает имя создаваемого + PNG файла. + </para></listitem> + <listitem><para> + <replaceable>монитор</replaceable> задает номер монитора + откуда сделать снимок. Для ВМ с единственным монитором это + значение <literal>0</literal>. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording"> + <title>Включить или выключить запись сессии виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording</command> включает + или выключает запись сессии ВМ в WebM/VP8 файл. Допустимые значения + <literal>on</literal>, которое начинает запись, когда стартует + сессия ВМ и <literal>off</literal>, отключающее запись. Значение + по умолчанию <literal>off</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-screens"> + <title>Задать экран виртуальной машины для записи</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording screens</command> + позволяет задать экран ВМ для записи. Запись для каждого + указанного вами экрана сохраняется в отдельный файл в папке + машины. Нельзя изменять эту настройку пока запись включена. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <literal>all</literal> указывает, что записывать все экраны ВМ. + </para></listitem> + <listitem><para> + <literal>none</literal> указывает, что не надо записывать экраны. + </para></listitem> + <listitem><para> + <replaceable>ID-экрана</replaceable> задает один или больше экранов + ВМ для записи. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-filename"> + <title>Задать файл для сохранения записанной сессии виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording filename</command> + задает файл для сохранения записанной сессии. Нельзя изменять + эту настройку пока запись включена. + </para> + <para> + По умолчанию запись сохраняется в файл, находящийся в папке машины, + с именем ВМ в качестве имени файла и расширением + <filename>webm</filename>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videores"> + <title>Задать разрешение записанного видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + recording videores</command> задает разрешение записанного видео в + пикселах. Нельзя изменять эту настройку пока включена запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек записи видео, + основанных на разрешении (размере кадра). Смотрите поле Размер Кадра + во вкладке Запись страницы Монитор для просмотра значения по умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <para> + Разрешение задается в виде + <replaceable>ширина</replaceable><literal>x</literal><replaceable>высота</replaceable>: + </para> + <itemizedlist> + <listitem><para> + <replaceable>ширина</replaceable> задает ширину в пикселах. + </para></listitem> + <listitem><para> + <replaceable>высота</replaceable> задает высоту в пикселах. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videorate"> + <title>Задать битрейт видео</title> + <remark role="help-copy-synopsis"/> +<!-- @todo r=andy Clarify rate. --> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording videorate</command> + задает битрейт видео в килобит в секунду. Увеличение этого + значения улучшает качество видео за счет увеличения размера + файла. Нельзя изменять это значение пока включена запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек + записи видео, основанных на размере кадра. Смотрите поле + Качество Видео вкладки Запись страницы Монитор для просмотра + значения по умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-videofps"> + <title>Задать максимальную частоту видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording videofps</command> + задает максимальную частоту видео для записи. Частота видео + измеряется в кадрах в секунду (FPS). Запись пропускает кадры, + имеющие частоту выше, чем указанный максимум. Увеличение + частоты уменьшает количество пропущенных кадров и увеличивает + размер файла. Нельзя изменять эту настройку пока включена + запись. + </para> + <para> + Используйте инструмент Настройки для отображения настроек записи + видео, основанных на размере кадра. Смотрите поле Частота Кадров во + вкладке Запись страницы Монитор для просмотра значения по + умолчанию. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-maxtime"> + <title>Задать максимальное время записи видео</title> + <remark role="help-copy-synopsis"/> +<!-- @todo r=andy Clarify time format. --> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording maxtime</command> + задает максимальное время записи в секундах. Запись + останавливается по прошествии заданного количества секунд. + Если это значение равно нулю, запись продолжается пока + не будет остановлена принудительно. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-recording-maxfilesize"> + <title>Задать максимальный размер записанного видео</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> recording maxfilesize</command> + задает максимальный размер записанного видео в мегабайтах. + Запись останавливается когда файл достигает заданного размера. + Если это значение равно нулю, запись продолжается пока не будет + остановлена принудительно. Нельзя изменять эту настройку пока + включена запись. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-setcredentials"> + <title>Задать учетные данные для удаленного входа в виртуальные машины Windows</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>setcredentials</command> позволяет задать + учетные данные для удаленного входа в Windows ВМ. + Смотрите <xref linkend="autologon" />. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <itemizedlist> + <listitem><para> + <replaceable>имя-пользователя</replaceable> задает имя + пользователя под которым необходимо производить вход + в Windows ВМ. + </para></listitem> + <listitem><para> + Опция + <option>--passwordfile=<replaceable>имя-файла</replaceable></option> + задает файл откуда брать пароль для + <replaceable>имя-пользователя</replaceable>. + </para><para> + Опция <option>--passwordfile</option> взаимоисключающая с опцией + <option>--password</option>. + </para></listitem> + <listitem><para> + Опция + <option>--password=<replaceable>пароль</replaceable></option> + задает пароль для <replaceable>имя-пользователя</replaceable>. + </para><remark> + Такой дизайн не соответствует рекомендациям Oracle по + безопасности. Вы не должны указывать пароль в командной + строке, потому что он может быть виден в списке процессов. + </remark><para> + Опция <option>--password</option> взаимоисключающая с опцией + <option>--passwordfile</option>. + </para></listitem> + <listitem><para> + Опция <option>--allowlocallogin</option> позволяет включать или + отключать локальные входы. Допустимые значения + <literal>on</literal> для включения локальных входов и + <literal>off</literal> для отключения. + </para></listitem> + </itemizedlist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-plugcpu"> + <title>Добавить виртуальный ЦПУ в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> plugcpu</command> добавляет + виртуальный ЦПУ в указанную ВМ если горячее подключение ЦПУ + включено. <replaceable>ID</replaceable> задает индекс + добавляемого виртуального ЦПУ и он должен быть в диапазоне + от 0 до максимального количества настроенных ЦПУ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-unplugcpu"> + <title>Удалить виртуальный ЦПУ из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> unplugcpu</command> удаляет + виртуальный ЦПУ из указанной ВМ если горячее подключение ЦПУ + включено. <replaceable>ID</replaceable> задает индекс + удаляемого виртуального ЦПУ и он должен быть в диапазоне + от 0 до максимального количества настроенных ЦПУ. Нельзя + удалить ЦПУ 0. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-cpuexecutioncap"> + <title>Установить максимальное время физического ЦПУ, используемого виртуальным ЦПУ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> cpuexecutioncap</command> + задает максимальное количество времени физического ЦПУ + используемого виртуальным ЦПУ. Допустимые значения - это + процент между <literal>1</literal> и <literal>100</literal>. + Значение <literal>50</literal> указывает, что единственный + виртуальный ЦПУ может использовать до 50% физического ЦПУ. + По умолчанию установлено <literal>100</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-vm-process-priority"> + <title>Изменить приоритет процесса ВМ</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> vm-process-priority</command> + задает схему приоритета процесса ВМ используемую при старте + и работе ВМ. + </para> + <para> + Допустимые значения: + </para> + <itemizedlist> + <listitem><para> + <literal>default</literal> – Приоритет процесса + по умолчанию, определенный ОС. + </para></listitem> + <listitem><para> + <literal>flat</literal> – Предполагает политику + планирования, которая устанавливает для процесса + приоритет по умолчанию, при этом, всем потокам процесса + устанавливается один и тот же приоритет. + </para></listitem> + <listitem><para> + <literal>low</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + в основном ниже приоритета по умолчанию ОС хоста. + </para></listitem> + <listitem><para> + <literal>normal</literal> – Предполагает политику + планирования, которая честно разделяет ресурсы ЦПУ с + другими процессами, имеющими приоритет по умолчанию + ОС хоста. + </para></listitem> + <listitem><para> + <literal>high</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + выше приоритета по умолчанию ОС хоста. Эта политика + может повлиять на другие процессы, заставляя их ожидать + ресурса ЦПУ больше положенного времени, что может + привести к непредсказуемому поведению. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-attach"> + <title>Подключить вебкамеру к виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam attach</command> + подключает вебкамеру к работающей ВМ. Задайте вебкамеру + через абсолютный путь к камере в ОС хоста или через псевдоним. + Используйте команду <command>VBoxManage list webcams</command> + для получения псевдонимов вебкамер. + </para> + <para> + Обратите внимание, что псевдоним <literal>.0</literal> - это + устройство получения видео по умолчанию в ОС хоста. + <literal>.1</literal> - это первое устройство получения видео, + <literal>.2</literal> - второе, и т.д. Порядок устройств + зависит от системы хоста. + </para> + <para> + Можно указать необязательные настройки в виде пар имя-значение + разделенных точкой с запятой (<literal>;</literal>). Эти + свойства позволяют настроить устройство эмулируемой вебкамеры. + </para> + <para> + Поддерживаются следующие настройки: + </para> + <variablelist> + <varlistentry> + <term><literal>MaxFramerate</literal></term> + <listitem><para> + Задает максимальную частоту кадров с которой видео отправляется + в ВМ. Задается в кадрах в секунду. Более высокие значения + увеличивают нагрузку на ЦПУ, так что этот параметр можно + использовать для уменьшения нагрузки на ЦПУ. Значение + по умолчанию - <literal>no maximum limit</literal>. Это значение + позволяет ВМ использовать любую частоту кадров, поддерживаемую + вебкамерой. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>MaxPayloadTransferSize</literal></term> + <listitem><para> + Задает максимальное количество байтов, принимаемого ВМ из + эмулируемой камеры в одном буфере. Значение по умолчанию - + <literal>3060</literal> байт, используемое некоторыми + вебкамерами. Если ВМ способна использовать буферы большего + размера, это может немного уменьшить нагрузку на ЦПУ. + Заметим, что некоторые гостевые ОС могу не поддерживать + более высокие значения <literal>MaxPayloadTransferSize</literal>. + </para></listitem> + </varlistentry> + </variablelist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-detach"> + <title>Отключить вебкамеру от виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam detach</command> + отключает вебкамеру от работающей ВМ. Задайте вебкамеру + через абсолютный путь к камере в ОС хоста или через псевдоним. + Используйте команду <command>VBoxManage list webcams</command> + для получения псевдонимов вебкамер. + </para> + <para> + Когда вебкамера отключается от хоста, ОС хоста определяет поведение + эмулируемой вебкамеры. + </para> + <itemizedlist> + <listitem><para> + <emphasis role="bold">Хосты Windows:</emphasis> Устройство + эмулируемой вебкамеры отключается от ВМ автоматически. + </para></listitem> + <listitem><para> + <emphasis role="bold">Хосты Mac OS X, которые работают + по крайней мере под OS X 10.7:</emphasis> Устройство + эмулируемой вебкамеры остается подключенным к ВМ. Его + необходимо отключить вручную, используя команду + <command>VBoxManage controlvm webcam detach</command>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Хосты Linux:</emphasis> Устройство + эмулируемой вебкамеры отключается от ВМ автоматически + только если вебкамера активно транслирует видео. Если + эмулируемая камера не активна, необходимо отключить ее + вручную, используя команду <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam detach</command>. + </para></listitem> + </itemizedlist> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-webcam-list"> + <title>Отобразить вебкамеры, подключенные к виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam list</command> показывает + вебкамеры, подключенные к работающей ВМ. Вывод отображает список + абсолютных путей или псевдонимов подключенных к ВМ вебкамер, + используя команду <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> webcam attach</command>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-addencpassword"> + <title>Передать пароль шифрования в виртуальную машину</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> addencpassword</command> + обеспечивает шифрованную ВМ <replaceable>имя-ВМ</replaceable> + паролем шифрования для возможности старта в фоновом режиме. + Укажите абсолютный путь к файлу с паролем в хост-системе. + Если вместо <replaceable>имя-файла</replaceable> указан + <literal>-</literal>, <command>VBoxManage</command> предложит + ввести пароль. + </para> + <para> + Используйте опцию <option>--removeonsuspend</option> для указания + что пароль должен быть удален из памяти ВМ или сохранен когда + ВМ приостановлена. + </para> + <para> + Если ВМ приостановлена и пароль очищен используйте + <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + addencpassword</command>, чтобы указать пароль для продолжения + выполнения ВМ. Используйте эту функцию если не хотите оставлять + пароль в памяти ВМ пока ВМ приостановлена событием приостановки + хоста. + </para> + <note> + <para> + Можно шифровать данные, хранящиеся в образах жестких дисков, + испольуемых ВМ. &product-name; использует алгоритм AES в режиме + XTS и поддерживает 128 и 256 битные ключи шифрования данных + (DEK). Зашифрованный DEK хранится в свойствах носителя и + расшифровывается при старте ВМ когда вы передаете пароль + шифрования. + </para> + </note> + <para> + Используйте команду <command>VBoxManage encryptmedium</command> + для создания носителя зашифрованного DEK. Смотрите + <xref linkend="diskencryption-encryption" />. + </para> + <para> + Графический интерфейс &product-name; предложит ввести пароль + шифрования при старте зашифрованной ВМ. + </para> + <para> + Используйте следующую команду для старта в фоновом режиме + зашифрованной ВМ: + </para> +<screen> + $ VBoxManage startvm <replaceable>имя-ВМ</replaceable> --type headless + </screen> + <para> + Затем, используйте следующую команду для передачи пароля + шифрования: + </para> +<screen> + $ VBoxManage <replaceable>имя-ВМ</replaceable> controlvm addencpassword <replaceable>имя-ВМ</replaceable> - + Пароль: <replaceable>пароль-шифрования</replaceable> + </screen> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-removeencpassword"> + <title>Отозвать пароль шифрования из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> removeencpassword</command> + отзывает указанный пароль шифрования для всех зашифрованных + носителей, подключенных к ВМ. + </para> + <para> + <replaceable>ID</replaceable> - идентификатор пароля, который + вы хотите отозвать. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-removeallencpasswords"> + <title>Отозвать все пароли шифрования из виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable> + removeallencpasswords</command> отзывает все пароли шифрования + для всех зашифрованных носителей подключенных к ВМ. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-changeuartmode"> + <title>Изменить режим подключения виртуального последовательного порта в виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> changeuartmode</command> + изменяет режим подключения для указанного виртуального + последовательного порта. Допустимые значения последовательного + порта - это числа, начинающиеся с <literal>1</literal>. + </para> + <para> + Эта команда не влияет прямо на состояние выполнения ВМ. + </para> + <variablelist> + <varlistentry> + <term>disconnected</term> + <listitem><para> + Отключает устройство. + </para></listitem> + </varlistentry> + <varlistentry> + <term>server <replaceable>имя-канала</replaceable></term> + <listitem><para> + Указывает имя канала сервера. + </para></listitem> + </varlistentry> + <varlistentry> + <term>client <replaceable>имя-канала</replaceable></term> + <listitem><para> + Указывает имя канала клиента. + </para></listitem> + </varlistentry> + <varlistentry> + <term>tcpserver <replaceable>порт</replaceable></term> + <listitem><para> + Указывает номер порта сервера TCP. + </para></listitem> + </varlistentry> + <varlistentry> + <term>tcpclient <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable></term> + <listitem><para> + Указывает имя хоста и номер порта клиента TCP. + </para></listitem> + </varlistentry> + <varlistentry> + <term>file <replaceable>имя-файла</replaceable></term> + <listitem><para> + Указывает имя файла. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-устройства</replaceable></term> + <listitem><para> + Указывает имя устройства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-controlvm-autostart-enabled"> + <title>Включить автостарт ВМ во время загрузки хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> autostart-enabled</command> + указывает включить или отключить автоматический старт ВМ во + время загрузки хост-системы. Вы должны произвести некоторую + настройку хост-системы перед тем как вы сможете использовать + данный функционал. Смотрите <xref linkend="autostart" />. + Допустимые значения <literal>on</literal>, включающую + функцию автостарта для ВМ и <literal>off</literal>, + отключающую ее. Значение по умолчанию <literal>off</literal>. + </para> + </refsect2> + <refsect2 id="vboxmanage-controlvm-autostart-delay"> + <title>Установить задержку старта ВМ во время загрузки хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage controlvm + <replaceable>имя-ВМ</replaceable> autostart-delay</command> + задает задержку в секундах перед тем, как ВМ будет запущена + во время загрузки хост-системы. Смотрите + <xref linkend="autostart" />. + </para> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда временно останавливает выполнение ВМ + <filename>ol7</filename>. + </para> +<screen>$ VBoxManage controlvm ol7 pause</screen> + <para> + Следующая команда настраивает операции буфера обмена для ВМ + <filename>ol7</filename>. Копирование данных буфера обмена + разрешено в обоих направлениях между хостом и гостевой + системой. + </para> +<screen>$ VBoxManage controlvm ol7 clipboard mode bidirectional</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-modifyvm" />, + <xref linkend="vboxmanage-startvm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-convertfromraw.xml b/doc/manual/ru_RU/man_VBoxManage-convertfromraw.xml new file mode 100644 index 00000000..7e658e03 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-convertfromraw.xml @@ -0,0 +1,248 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage convertfromraw +--> +<!-- + 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-convertfromraw" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage convertfromraw</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-convertfromraw</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-convertfromraw</refname> + <refpurpose>преобразует образ raw диска в образ виртуального диска</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-convertfromraw-file"> + <command>VBoxManage convertfromraw</command> + <arg choice="req"><replaceable>входной-файл</replaceable></arg> + <arg choice="req"><replaceable>выходной-файл</replaceable></arg> + <arg>--format=<group choice="plain"> + <arg choice="plain">VDI</arg> + <arg choice="plain">VMDK</arg> + <arg choice="plain">VHD</arg> + </group></arg> + <arg>--uuid=<replaceable>uuid</replaceable></arg> + <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-convertfromraw-stdin"> + <command>VBoxManage convertfromraw stdin</command> + <arg choice="req"><replaceable>выходной-файл</replaceable></arg> + <arg>--format=<group choice="plain"> + <arg choice="plain">VDI</arg> + <arg choice="plain">VMDK</arg> + <arg choice="plain">VHD</arg> + </group></arg> + <arg>--uuid=<replaceable>uuid</replaceable></arg> + <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage convertfromraw</command> позволяет + преобразовать образ raw диска в образ виртуального диска + &product-name; (VDI). + </para> + <note> + <para> + Для совместимости с ранними версиями &product-name;, можно + использовать команду <command>VBoxManage convertdd</command> + вместо команды <command>VBoxManage convertfromraw</command>. + </para> + </note> + <refsect2 id="vboxmanage-convertfromraw-file"> + <title>Преобразовать файл raw диска в файл образа виртуального диска</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage convertfromraw</command> + преобразует указанный входной файл образа raw диска в + VDI файл &product-name; + </para> + <variablelist> + <varlistentry> + <term><replaceable>входной-файл</replaceable></term> + <listitem><para> + Указывает имя файла образа raw диска для преобразования. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>выходной-файл</replaceable></term> + <listitem><para> + Указывает имя файла, куда записывать VDI данные. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--format=VDI | VMDK | VHD</option></term> + <listitem><para> + Задает формат формат создаваемого образа диска. Допустимыми + значениями являются <literal>VDI</literal>, + <literal>VMDK</literal>, и <literal>VHD</literal>. Формат + по умолчанию <literal>VDI</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) + выходного файла. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term> + <listitem><para> + Задает требуемые варианты формата выходного файла. Это + список значений вариантов разделенный запятыми. Далее + указаны допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>Standard</literal> - тип образа диска + по умолчанию. Динамически расширяющийся файл. + </para></listitem> + <listitem><para> + <literal>Fixed</literal> использует файл образа диска + фиксированного размера. + </para></listitem> + <listitem><para> + <literal>Split2G</literal> показывает что образ диска + разделяется на сегменты по 2 ГБ. Это значение только + для VMDK. + </para></listitem> + <listitem><para> + <literal>Stream</literal> оптимизирует образ диска + для загрузки. Это значение только для VMDK. + </para></listitem> + <listitem><para> + <literal>ESX</literal> используется в некоторых + продуктах VMWare. Это значение только для VMDK. + </para></listitem> + </itemizedlist><para> + Заметим, что не все комбинации вариантов допустимы. + Указание несовместимых значений вариантов в списке + ведет к выдаче сообщения об ошибке. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-convertfromraw-stdin"> + <title>Преобразовать raw данные из стандартного потока ввода в файл образа виртуального диска</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage convertfromraw stdin</command> + читает содержимое образа диска из стандартного потока ввода. + Рассматривайте использование команды этой формы в + последовательности каналов. + </para> + <variablelist> + <varlistentry> + <term><replaceable>выходной-файл</replaceable></term> + <listitem><para> + Указывает имя файла, куда записывать VDI данные. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--format=VDI | VMDK | VHD</option></term> + <listitem><para> + Задает формат формат создаваемого образа диска. Допустимыми + значениями являются <literal>VDI</literal>, + <literal>VMDK</literal> и <literal>VHD</literal>. Формат + по умолчанию <literal>VDI</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Задает UUID выходного файла. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term> + <listitem><para> + Задает требуемые варианты формата выходного файла. Это + список значений вариантов разделенный запятыми. Далее + указаны допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>Standard</literal> - тип образа диска + по умолчанию. Динамически расширяющийся файл. + </para></listitem> + <listitem><para> + <literal>Fixed</literal> использует файл образа диска + фиксированного размера. + </para></listitem> + <listitem><para> + <literal>Split2G</literal> показывает что образ диска + разделяется на сегменты по 2 ГБ. Это значение только + для VMDK. + </para></listitem> + <listitem><para> + <literal>Stream</literal> оптимизирует образ диска + для загрузки. Это значение только для VMDK. + </para></listitem> + <listitem><para> + <literal>ESX</literal> используется в некоторых + продуктах VMWare. Это значение только для VMDK. + </para></listitem> + </itemizedlist><para> + Заметим, что не все комбинации вариантов допустимы. + Указание несовместимых значений вариантов в списке + ведет к выдаче сообщения об ошибке. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда преобразует входной файл образа raw диска + <filename>disk01.raw</filename>. Выходной файл - это VDI образ + диска называемый <filename>disk02.vdi</filename>. + </para> +<screen>$ VBoxManage convertfromraw disk01.raw disk02.vdi</screen> + <para> + Следующая команда преобразует входной файл образа raw диска + <filename>disk01.raw</filename>. Выходной файл - это VMDK образ + диска называемый <filename>disk02.vmdk</filename>. + </para> +<screen>$ VBoxManage convertfromraw disk01.raw disk02.vmdk --format VMDK</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-createmedium.xml b/doc/manual/ru_RU/man_VBoxManage-createmedium.xml new file mode 100644 index 00000000..74e32546 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-createmedium.xml @@ -0,0 +1,219 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage createmedium +--> +<!-- + 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-createmedium" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage createmedium</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-createmedium</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-createmedium</refname> + <refpurpose>создает новый носитель</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-createmedium"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage createmedium</command> + <group> + <arg choice="plain"><replaceable>disk</replaceable></arg> + <arg choice="plain"><replaceable>dvd</replaceable></arg> + <arg choice="plain"><replaceable>floppy</replaceable></arg> + </group> + <arg choice="req">--filename=<replaceable>имя-файла</replaceable></arg> + <group> + <arg choice="plain">--size=<replaceable>мегабайты</replaceable></arg> + <arg choice="plain">--sizebyte=<replaceable>байты</replaceable></arg> + </group> + <arg>--diffparent=<group choice="plain"> + <arg choice="plain"><replaceable>UUID</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group></arg> + <arg>--format=<group choice="plain"> + <arg choice="plain"><replaceable>VDI</replaceable></arg> + <arg choice="plain"><replaceable>VMDK</replaceable></arg> + <arg choice="plain"><replaceable>VHD</replaceable></arg> + </group></arg> + <arg>--variant Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk</arg> + <arg choice="plain" rep="repeat">--property + <replaceable>имя</replaceable>=<replaceable>значение</replaceable></arg> + <arg choice="plain" rep="repeat">--property-file + <replaceable>имя</replaceable>=<replaceable>/путь/к/файлу/со/значением</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage createmedium</command> создает новый + носитель, такой как файл образа диска. + </para> + <note> + <para> + Для совместимости с ранними версиями &product-name; можно + использовать команды <command>createvdi</command> и + <command>createhd</command> вместо команды + <command>createmedium</command>. + </para> + </note> + <variablelist> + <varlistentry> + <term>disk | dvd | floppy</term> + <listitem><para> + Указывает тип носителя. Значение по умолчанию + <literal>disk</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--filename=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Указывает абсолютный путь к файлу в файловой системе хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--size=<replaceable>мегабайты</replaceable></option></term> + <listitem><para> + Задает емкость образа в мегабайтах. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--sizebyte=<replaceable>байты</replaceable></option></term> + <listitem><para> + Задает емкость образа в байтах. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--diffparent=<replaceable>UUID</replaceable> | <replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) или + абсолютный путь к родительскому файлу разностного образа в + файловой системе хоста. + </para><para> + Используйте этот файл для совместного использования + базового образа диска между ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--format=VDI | VMDK | VHD</option></term> + <listitem><para> + Задает формат выходного файла. Допустимые форматы + <literal>VDI</literal>, <literal>VMDK</literal> и + <literal>VHD</literal>. Формат по умолчанию + <literal>VDI</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX,Formatted,RawDisk</option></term> + <listitem><para> + Задает варианты формата файла для целевого носителя в + виде списка значений разделенных запятыми. Допустимы + следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>Standard</literal> - это тип образа диска + по умолчанию. Динамически расширяющийся файл. + </para></listitem> + <listitem><para> + <literal>Fixed</literal> использует файл образа диска + фиксированного размера. + </para></listitem> + <listitem><para> + <literal>Split2G</literal> показывает, что образ диска + разделяется на сегменты по 2 ГБ. Это значение только + для VMDK. + </para></listitem> + <listitem><para> + <literal>Stream</literal> оптимизирует образ диска + для загрузки. Это значение только для VMDK. + </para></listitem> + <listitem><para> + <literal>ESX</literal> используется в некоторых + продуктах VMWare. Это значение только для VMDK. + </para></listitem> + <listitem><para> + <literal>Formatted</literal> + </para><para> + Только для образов флоппи. Автоматически форматирует + носитель. + </para></listitem> + <listitem><para> + <literal>RawDisk</literal> используется для создания + raw дисков. Это значение только для VMDK. + </para><para> + + </para></listitem> + </itemizedlist><para> + Заметим, что не все комбинации вариантов допустимы. Указание + несовместимых значений вариантов в списке ведет к выдаче + сообщения об ошибке. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--property <replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает требуемые параметры, зависящие от формата файла в + форме <literal>ключ=значение</literal>. Опционально. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--property-file <replaceable>name + </replaceable>=<replaceable>/path/to/file/with/value</replaceable></option></term> + <listitem><para> + Задает требуемые параметры, зависящие от формата файла в + форме <literal>key=файл/со/значением</literal>. Значение + берется из файла. Опционально. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает новый файл образа диска, называемый + <filename>disk01.vdi</filename>. Файл имеет размер 1024 мегабайта. + </para> +<screen>$ VBoxManage createmedium --filename disk01.vdi --size 1024</screen> + <para> + Следующая команда создает новый файл образа флоппи диска, называемый + <filename>floppy01.vdi</filename>. Файл имеет размер 1 мегабайт. + </para> +<screen>$ VBoxManage createmedium floppy --filename floppy01.img --size 1</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-createvm.xml b/doc/manual/ru_RU/man_VBoxManage-createvm.xml new file mode 100644 index 00000000..788c5cc5 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-createvm.xml @@ -0,0 +1,175 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage createvm +--> +<!-- + 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-createvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage createvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-createvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-createvm</refname> + <refpurpose>создает новую виртуальную машину</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-createvm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage createvm</command> + <arg choice="req">--name=<replaceable>имя-ВМ</replaceable></arg> + <arg>--basefolder=<replaceable>основная-папка</replaceable></arg> + <arg>--default</arg> + <arg>--group=<replaceable>ID-группы</replaceable>,...</arg> + <arg>--ostype=<replaceable>тип-ОС</replaceable></arg> + <arg>--register</arg> + <arg>--uuid=<replaceable>uuid</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage createvm</command> создает новый + XML-файл определения виртуальной машины (ВМ). + </para> + <para> + Необходимо указать имя ВМ, используя <option>--name + <replaceable>имя-ВМ</replaceable></option>. Это имя по умолчанию + используется как имя файла настроек, имеющего расширение + <filename>.vbox</filename>, а также как имя папки машины, + находящейся в директории <filename>$HOME/VirtualBox VMs</filename>. + </para> + <para> + Фактическое имя файла может не соответствовать имени ВМ если + оно нарушает требования к имени файла ОС хоста (например + использование разделителя пути или других зарезервированных + символов, все это будет заменено на символ подстановки). Если + ВМ будет позднее переименована, имена файла и папки будут + обновлены автоматически чтобы соответствовать новому имени. + </para> + </refsect1> + + <refsect1> + <title>Опции команды</title> + <para> + В дополнение к требуемому указанию имени или UUID ВМ, можно + указать следующие опции: + </para> + <variablelist> + <varlistentry> + <term><option>--basefolder=<replaceable>основная-папка</replaceable></option></term> + <listitem><para> + Задает имя папки в которую сохранять файл конфигурации + машины для новой ВМ. + </para><para> + Обратите внимание, что имена файла и папки не изменяются если + переименовать ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--default</option></term> + <listitem><para> + Применяет аппаратную конфигурацию по умолчанию для указанной + гостевой ОС. По умолчанию, ВМ создается с минимальным + оборудованием. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--group=<replaceable>ID-группы</replaceable>,...</option></term> + <listitem><para> + Назначает ВМ на указанные группы. Если указывается более + чем одна группа, разделите их запятыми. + </para><para> + Заметим, что каждая группа идентифицируется через ID группы, + начинающаяся с символа слэш (<literal>/</literal>), поэтому + группы могут быть вложенные. По умолчанию, ВМ всегда + назначается на группу <literal>/</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ostype=<replaceable>тип-ОС</replaceable></option></term> + <listitem><para> + Указывает гостевую ОС для запуска в ВМ. Запустите команду + <command>VBoxManage list ostypes</command> для просмотра + доступных типов ОС. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--register</option></term> + <listitem><para> + Регистрирует ВМ в &product-name;. По умолчанию команда + <command>VBoxManage createvm</command> создает только + XML конфигурацию для ВМ но не регистрирует ВМ. Если не + регистрировать ВМ при создании, можно запустить команду + <command>VBoxManage registervm</command> после создания. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) ВМ. + Убедитесь что этот UUID уникален в пространстве имен + &product-name; хоста или его членства в группах ВМ, если + хотите зарегистрировать ВМ. По умолчанию &product-name; + предоставляет UUID. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает ВМ называемую <literal>vm2</literal> + где планируется запускать 64 битную версию Orace Linux. + </para> +<screen>$ VBoxManage createvm --name "vm2" --ostype "Oracle_64"</screen> + <para> + Следующая команда создает и регистрирует ВМ называемую + <literal>vm3</literal>. + </para> +<screen>$ VBoxManage createvm --name "vm3" --register</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-registervm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-debugvm.xml b/doc/manual/ru_RU/man_VBoxManage-debugvm.xml new file mode 100644 index 00000000..0d7963b3 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-debugvm.xml @@ -0,0 +1,673 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage debugvm +--> +<!-- + 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-debugvm" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage debugvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-debugvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-debugvm</refname> + <refpurpose>интроспекция и гостевая отладка</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-dumpvmcore"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">dumpvmcore</arg> + <arg>--filename=<replaceable>name</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-info"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">info</arg> + <arg choice="req"><replaceable>элемент</replaceable></arg> + <arg rep="repeat"><replaceable>аргументы</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-injectnmi"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">injectnmi</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-log"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">log</arg> + <group><arg>--release</arg><arg>--debug</arg></group> + <arg rep="repeat"><replaceable>настройки-группы</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-logdest"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">logdest</arg> + <group><arg>--release</arg><arg>--debug</arg></group> + <arg rep="repeat"><replaceable>назначения</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-logflags"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">logflags</arg> + <group><arg>--release</arg><arg>--debug</arg></group> + <arg rep="repeat"><replaceable>флаги</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdetect"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">osdetect</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-osinfo"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">osinfo</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdmesg"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">osdmesg</arg> + <arg>--lines=<replaceable>строки</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-getregisters"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">getregisters</arg> + <arg>--cpu=<replaceable>id</replaceable></arg> + <arg rep="repeat"><replaceable>набор-регистров.имя-регистра</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-setregisters"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">setregisters</arg> + <arg>--cpu=<replaceable>id</replaceable></arg> + <arg rep="repeat"><replaceable>набор-регистров.имя-регистра</replaceable>=<replaceable>значение</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-show"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">show</arg> + <group><arg>--human-readable</arg><arg>--sh-export</arg><arg>--sh-eval</arg><arg>--cmd-set</arg></group> + <arg rep="repeat"><replaceable>элемент-настроек</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-stack"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">stack</arg> + <arg>--cpu=<replaceable>id</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-statistics"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">statistics</arg> + <arg>--reset</arg> + <arg>--descriptions</arg> + <arg>--pattern=<replaceable>шаблон</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-debugvm-guestsample"> + <command>VBoxManage debugvm</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">guestsample</arg> + <arg>--filename=<replaceable>имя-файла</replaceable></arg> + <arg>--sample-interval-us=<replaceable>интервал</replaceable></arg> + <arg>--sample-time-us=<replaceable>время</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + <refsect1> + <title>Описание</title> + + <para> + Команды "debugvm" предназначены для экспертов, которые хотят разобраться в деталях + исполнения виртуальной машины. Как и отладчик VM описанный в + <xref linkend="ts_debugger" />, эти команды полезны только если хорошо разбираетесь + в архитектуре PC и знаете как отлаживать программное обеспечение. + </para> + + <refsect2 id="vboxmanage-debugvm-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Все подкоманды <command>debugvm</command> выполняются в работающей виртуальной + машине:</para> + <variablelist> + <varlistentry> + <term><replaceable>uuid|имя-ВМ</replaceable></term> + <listitem><para>Или UUID или имя (чувствительно к регистру) ВМ.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-dumpvmcore"> + <title>debugvm dumpvmcore</title> + <remark role="help-copy-synopsis"/> + <para> + Создает файл системного дампа указанной ВМ. Этот файл будет иметь + стандартный формат ELF ядра (с пользовательскими секциями); Смотрите + <xref linkend="ts_guest-core-format" />. + </para> + <para> + Команда соответствует команде <command>writecore</command> отладчика. + </para> + <variablelist> + <varlistentry> + <term><option>--filename=<replaceable>имя-файла</replaceable></option></term> + <listitem><para>Имя выходного файла.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-info"> + <title>debugvm info</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает информацию относительно VMM, эмуляции устройств и + назначенных драйверов. + </para> + <para> + Команда соответствует команде <command>info</command> отладчика. + </para> + <variablelist> + <varlistentry> + <term><replaceable>элемент</replaceable></term> + <listitem> + <para>Имя элемента для отображения. Специальное имя + <option>help</option> показывает список всех доступных + элементов и подсказок по необязательным аргументам.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>аргументы</replaceable></term> + <listitem> + <para>Необязательная строка аргументов для обработчика элемента. + Большинство элементов не требуют дополнительных аргументов. Нераспознанные + аргументы в основном игнорируются. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-injectnmi"> + <title>debugvm injectnmi</title> + <remark role="help-copy-synopsis"/> + <para> + Внедряет немаскируемое прерывание (NMI) в гостевую систему. Это может быть + полезно для определенных сценариев отладки. Что точно произойдет, зависит + от гостевой операционной системы, однако NMI может вызвать крах всей + гостевой ОС. Не используйте если не знаете что вы делаете. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-log"> + <title>debugvm log</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет настройки группы для журналирования ВМ процесса в режимах отладки + (<option>--debug</option>) или выпуска (<option>--release</option>). + </para> + <para> + <replaceable>настройки-группы</replaceable> в основном строки в форме + <computeroutput>em.e.f.l</computeroutput>, <computeroutput>hm=~0</computeroutput> + и <computeroutput>-em.f</computeroutput>. Поддерживаются базовые подстановочные + знаки для сопоставления групп. Группа + <computeroutput>all</computeroutput> - это псевдоним для всех групп. + </para> + <para> + Пожалуйста, имейте ввиду, что настройки группы применяются как модификация + текущих настроек. + </para> + <para> + Эта команда соответствует команде <command>log</command> отладчика. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-logdest"> + <title>debugvm logdest</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет настройки назначения для журналирования ВМ процесса в режимах + отладки (<option>--debug</option>) или выпуска (<option>--release</option>). + Более подробную информацию по формату назначения лучше посмотреть в + src/VBox/Runtime/common/log/log.cpp. + </para> + <para> + <replaceable>назначения</replaceable> - это одна или несколько мнемоник, + которые могут предваряться "no" для их отключения. Некоторые из них берут + значения после разделителей ":" или "=". Множественные мнемоники могут + разделяться через пробел или задаваться как отдельные аргументы в командной + строке. + </para> + <para> + Список доступных назначений: + </para> + <variablelist> + <varlistentry> + <term><option>file[=<replaceable>файл</replaceable>], nofile</option></term> + <listitem><para>Указывает файл журнала. Если файл журнала не указан, он + будет сгенерирован на основе текущего времени UTC и имени процесса ВМ и + помещен в текущую директорию процесса ВМ. Заметим, что данная команда + не имеет силы если файл журнала уже открыт. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>dir=<replaceable>директория</replaceable>, nodir</option></term> + <listitem><para>Указывает директорию для файлов журналов. Заметим, что данная + команда не имеет силы если файл журнала уже открыт. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>history=<replaceable>количество</replaceable>, nohistory</option></term> + <listitem><para>Ненулевые значения включают историю журналов. Значение показывает + сколько хранить старых файлов журналов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>histsize=<replaceable>байт</replaceable></option></term> + <listitem><para>Максимальный размер файла журнала перед сменой файла. По умолчанию бесконечно.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>histtime=<replaceable>секунды</replaceable></option></term> + <listitem><para>Максимальный возраст (в секундах) файла журнала перед сменой файла. По умолчанию бесконечно.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>ringbuffer, noringbuffer</option></term> + <listitem><para>Записывать журнал только в буфер журнала до явного сброса на диск + (например через assertion). Это быстро и сохраняет дисковое пространство.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>stdout, nostdout</option></term> + <listitem><para>Записывать содержимое журнала в стандартный поток вывода.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>stdout, nostdout</option></term> + <listitem><para>Записывать содержимое журнала в стандартный поток ошибок.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>debugger, nodebugger</option></term> + <listitem><para>Записывать содержимое журнала в отладчик, если поддерживается ОС хоста.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>com, nocom</option></term> + <listitem><para>Записывать содержимое журнала в COM порт. Применимо только для raw-режима и ring-0 журналирования.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>user, nouser</option></term> + <listitem><para>Пользовательское назначение, не имеющее значения для процессов ВМ.</para></listitem> + </varlistentry> + </variablelist> + <para> + Эта команда соответствует команде <command>logdest</command> отладчика. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-logflags"> + <title>debugvm logflags</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет флаги журналирования ВМ процесса в режимах отладки + (<option>--debug</option>) или выпуска (<option>--release</option>). Пожалуйста, + имейте ввиду, что изменения применяются к существующим и не подменяют их. + </para> + <para> + <replaceable>флаги</replaceable> - это список мнемоник, опционально предваряемые + "no", "!", "~" или "-" для смены значения на противоположное. Префикс "+" может + использоваться для отмены предыдущего противоположного значения или как разделитель, + хотя лучше использовать пробел или отдельные аргументы. + </para> + <para> + Список мнемоник флагов с их противоположной формой, где применимо + (звездочка показывает значение по умолчанию): + </para> + <variablelist> + <varlistentry> + <term><option>enabled*, disabled</option></term> + <listitem><para>Включает или выключает журналирование.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>buffered, unbuffered*</option></term> + <listitem><para>Включает буферизацию вывода журнала перед записью в назначение.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>writethrough(/writethru)</option></term> + <listitem><para>Открывать ли файл назначения со сквозной буферизацией или нет.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>flush</option></term> + <listitem><para>Включает сброс выходного файла на диск после каждой записи в журнал.</para></listitem> + </varlistentry> + <!-- Prefixes --> + <varlistentry> + <term><option>lockcnts</option></term> + <listitem><para>Предварять каждую строку журнала количеством блокировок текущего потока.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>cpuid</option></term> + <listitem><para>Предварять каждую строку журнала ID текущего ЦПУ.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>pid</option></term> + <listitem><para>Предварять каждую строку журнала ID текущего процесса.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>flagno</option></term> + <listitem><para>Предварять каждую строку журнала числовыми значениями флагов соответствующих записи в журанал.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>flag</option></term> + <listitem><para>Предварять каждую строку журнала мнемониками флагов соответствующих записи в журанал.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>groupno</option></term> + <listitem><para>Предварять каждую строку журнала номером группы соответствующей записи в журанал.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>group</option></term> + <listitem><para>Предварять каждую строку журнала именем группы соответствующей записи в журанал.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>tid</option></term> + <listitem><para>Предварять каждую строку журнала ID текущего потока.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>thread</option></term> + <listitem><para>Предварять каждую строку журнала именем текущего потока.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>time</option></term> + <listitem><para>Предварять каждую строку журнала текущим временем UTC.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>timeprog</option></term> + <listitem><para>Предварять каждую строку журнала текущим монотонным временем, прошедшим с момента старта программы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>msprog</option></term> + <listitem><para>Предварять каждую строку журнала текущим монотонным временем в милисекундах, прошедшим с момента старта программы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>ts</option></term> + <listitem><para>Предварять каждую строку журнала текущим монотонным временем в наносекундах.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>tsc</option></term> + <listitem><para>Предварять каждую строку журнала текущим временем ЦПУ (TSC).</para></listitem> + </varlistentry> + <varlistentry> + <term><option>rel, abs*</option></term> + <listitem><para>Выбирает как отображать префиксы <computeroutput>ts</computeroutput> и + <computeroutput>tsc</computeroutput>: как время относительно предыдущей строки журнала + или как абсолютное время.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>hex*, dec</option></term> + <listitem><para>Выбирает как форматировать префиксы <computeroutput>ts</computeroutput> и + <computeroutput>tsc</computeroutput>: как шестнадцатиричные значения или как десятичные. + </para></listitem> + </varlistentry> + + <!-- Suffixes and weird stuff. --> + <varlistentry> + <term><option>custom</option></term> + <listitem><para>Пользовательский префикс записи журнала. По умолчанию не имеет значения для ВМ процессов.</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>usecrlf, uself*</option></term> + <listitem><para>Выводить используя окончания строк в стиле DOS (CRLF) или UNIX (LF).</para></listitem> + </varlistentry> + <varlistentry> + <term><option>overwrite*, append</option></term> + <listitem><para>Перезаписывать файл назначения или добавлять строки в конец файла.</para></listitem> + </varlistentry> + </variablelist> + + <para> + Эта команда соответствует команде <command>logflags</command> отладчика. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-osdetect"> + <title>debugvm osdetect</title> + <remark role="help-copy-synopsis"/> + <para> + Заставляет отладчик VMM (заново) определить гостевую операционную систему (ОС). + Команда сначала загружает все плагины отладчика. + </para> + <para> + Эта команда соответствует команде <command>detect</command> отладчика. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-osinfo"> + <title>debugvm osinfo</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает информацию о гостевой операционной системе (ОС), ранее + определенной отладчиком VMM. + </para> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-osdmesg"> + <title>debugvm osdmesg</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает журнал ядра гостевой ОС, если она определена и поддерживается. + </para> + <variablelist> + <varlistentry> + <term><option>--lines=<replaceable>строки</replaceable></option></term> + <listitem><para>Количество отображаемых строк. Счет ведется с конца журнала. + По умолчанию бесконечно.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-getregisters"> + <title>debugvm getregisters</title> + <remark role="help-copy-synopsis"/> + <para> + Получает значения регистров гостевых ЦПУ и эмулируемых устройств. + </para> + <variablelist> + <varlistentry> + <term><replaceable>набор-регистров.имя-регистра</replaceable></term> + <listitem> + <para>Один или несколько регистров, где каждый указывается в следующих формах:</para> + <orderedlist> + <listitem><para>набор-регистров.имя-регистра.под-поле</para></listitem> + <listitem><para>набор-регистров.имя-регистра</para></listitem> + <listitem><para>имя-регистра-цпу.под-поле</para></listitem> + <listitem><para>имя-регистра-цпу</para></listitem> + <listitem><para>all</para></listitem> + </orderedlist> + <para>Форма <replaceable>all</replaceable> показывает все регистры (без под-полей). + Имена регистров не чувствительно к регистру. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu=<replaceable>id</replaceable></option></term> + <listitem><para>Выбирает набор регистров ЦПУ при указании только + регистра ЦПУ (3-я и 4-я формы). По умолчанию 0.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-setregisters"> + <title>debugvm setregisters</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет значения регистров гостевой ОС и эмулируемых устройств. + </para> + <variablelist> + <varlistentry> + <term><replaceable>набор-регистров.имя-регистра=значение</replaceable></term> + <listitem> + <para>Присвоение значений одному или нескольким регистрами, где каждый + указывается в следующих формах:</para> + <orderedlist> + <listitem><para>набор-регистров.имя-регистра.под-поле=значение</para></listitem> + <listitem><para>набор-регистров.имя-регистра=значение</para></listitem> + <listitem><para>имя-регистра-цпу.под-поле=значение</para></listitem> + <listitem><para>имя-регистра-цпу=значение</para></listitem> + </orderedlist> + <para>Форматр значений должен быть в том же стиле, в каком отображаются + по команде <command>getregisters</command>, за исключением того, что + могут быть указаны восмеричные и десятичные значения вместо + шестнадцатиричных.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu=<replaceable>id</replaceable></option></term> + <listitem><para>Выбирает набор регистров ЦПУ при указании только + регистра ЦПУ (3-я и 4-я формы). По умолчанию 0.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-debugvm-show"> + <title>debugvm show</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает настройки журнала для ВМ. + </para> + <variablelist> + <varlistentry> + <term><option>--human-readable</option></term> + <listitem><para>Выбирает человеко-читаемый вывод.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--sh-export</option></term> + <listitem><para>Выбирает формат вывода в стиле bourne shell команды <command>export</command>.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--sh-eval</option></term> + <listitem><para>Выбирает формат вывода в стиле аргументов bourne shell команды <command>eval</command>.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cmd-set</option></term> + <listitem><para>Выбирает формат вывода в стиле команды DOS <command>SET</command>.</para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>settings-item</replaceable></term> + <listitem> + <para>Указывает что отображать. Один или несколько из следующих:</para> + <itemizedlist> + <listitem><para>logdbg-settings - настройки журнала в режиме отладки.</para></listitem> + <listitem><para>logrel-settings - настройки журнала в режиме выпуска.</para></listitem> + <listitem><para>log-settings - псевдоним для настроек журнала в режимах и отладки и выпуска.</para></listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + + </refsect2> + + <refsect2 id="vboxmanage-debugvm-stack"> + <title>debugvm stack</title> + <remark role="help-copy-synopsis"/> + <para> + Разматывает стеки гостевого ЦПУ в меру наших возможностей. Рекомендуется + сначала запустить команду <command>osdetect</command> чтобы получить + символы и возможно информацию для раскрутки стека. + </para> + <variablelist> + <varlistentry> + <term><option>--cpu=<replaceable>id</replaceable></option></term> + <listitem><para>Выбирает один гостевой ЦПУ, у которого надо отобразить стек. По умолчанию все ЦПУ.</para> </listitem> + </varlistentry> + </variablelist> + + </refsect2> + + <refsect2 id="vboxmanage-debugvm-statistics"> + <title>debugvm statistics</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает или сбрасывает статистики VMM. + </para> + <para> + Получает значения регистров для гостевых ЦПУ и эмулируемых устройств. + </para> + <variablelist> + <varlistentry> + <term><option>--pattern=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Шаблоны с подстановочными знаками в стиле DOS/NT для выбранных статистик. + Множественные шаблоны указываются через символ '|' (канал) в качестве разделителя.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--reset</option></term> + <listitem><para>Выбрать сброс вместо режима отображения.</para></listitem> + </varlistentry> + </variablelist> + + </refsect2> + + <refsect2 id="vboxmanage-debugvm-guestsample"> + <title>debugvm guestsample</title> + <remark role="help-copy-synopsis"/> + <para> + Создает отчет с выборками о гостевой активности. + </para> + <para> + Получает имя файла куда сбрасывать отчет. + </para> + <variablelist> + <varlistentry> + <term><option>--filename=<replaceable>имя-файла</replaceable></option></term> + <listitem><para>Имя файла куда сбрасывать отчет с выборками.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--sample-interval-us=<replaceable>интервал</replaceable></option></term> + <listitem><para>Интервал в микросекундах между гостевыми выборками.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--sample-time-us=<replaceable>time</replaceable></option></term> + <listitem><para>Количество микросекунд, в течение которых берется выборка.</para> + </listitem> + </varlistentry> + </variablelist> + + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-dhcpserver-dhcpoptions.xml b/doc/manual/ru_RU/man_VBoxManage-dhcpserver-dhcpoptions.xml new file mode 100644 index 00000000..d368c964 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-dhcpserver-dhcpoptions.xml @@ -0,0 +1,231 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + Manually generated from src/VBox/Main/idl/VirtualBox.xidl by 'kmk dhcpoptions'. + DO NOT EDIT! +--> +<!-- + Copyright (C) 2019-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 +--> + + <variablelist> + <varlistentry> + <term>1 - SubnetMask</term> + <listitem><para>IPv4 netmask. Set to the value of the --netmask option by default.</para></listitem> + </varlistentry> <varlistentry> + <term>2 - TimeOffset</term> + <listitem><para>UTC offset in seconds (32-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>3 - Routers</term> + <listitem><para>Space separated list of IPv4 router addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>4 - TimeServers</term> + <listitem><para>Space separated list of IPv4 time server (RFC 868) addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>5 - NameServers</term> + <listitem><para>Space separated list of IPv4 name server (IEN 116) addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>6 - DomainNameServers</term> + <listitem><para>Space separated list of IPv4 DNS addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>7 - LogServers</term> + <listitem><para>Space separated list of IPv4 log server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>8 - CookieServers</term> + <listitem><para>Space separated list of IPv4 cookie server (RFC 865) addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>9 - LPRServers</term> + <listitem><para>Space separated list of IPv4 line printer server (RFC 1179) addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>10 - ImpressServers</term> + <listitem><para>Space separated list of IPv4 imagen impress server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>11 - ResourseLocationServers</term> + <listitem><para>Space separated list of IPv4 resource location (RFC 887) addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>12 - HostName</term> + <listitem><para>The client name. See RFC 1035 for character limits. </para></listitem> + </varlistentry> <varlistentry> + <term>13 - BootFileSize</term> + <listitem><para>Number of 512 byte blocks making up the boot file (16-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>14 - MeritDumpFile</term> + <listitem><para>Client core file.</para></listitem> + </varlistentry> <varlistentry> + <term>15 - DomainName</term> + <listitem><para>Domain name for the client.</para></listitem> + </varlistentry> <varlistentry> + <term>16 - SwapServer</term> + <listitem><para>IPv4 address of the swap server that the client should use.</para></listitem> + </varlistentry> <varlistentry> + <term>17 - RootPath</term> + <listitem><para>The path to the root disk the client should use.</para></listitem> + </varlistentry> <varlistentry> + <term>18 - ExtensionPath</term> + <listitem><para>Path to a file containing additional DHCP options (RFC2123).</para></listitem> + </varlistentry> <varlistentry> + <term>19 - IPForwarding</term> + <listitem><para>Whether IP forwarding should be enabled by the client (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>20 - OptNonLocalSourceRouting</term> + <listitem><para>Whether non-local datagrams should be forwarded by the client (boolean)</para></listitem> + </varlistentry> <varlistentry> + <term>21 - PolicyFilter</term> + <listitem><para>List of IPv4 addresses and masks paris controlling non-local source routing.</para></listitem> + </varlistentry> <varlistentry> + <term>22 - MaxDgramReassemblySize</term> + <listitem><para>The maximum datagram size the client should reassemble (16-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>23 - DefaultIPTTL</term> + <listitem><para>The default time-to-leave on outgoing (IP) datagrams (8-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>24 - PathMTUAgingTimeout</term> + <listitem><para>RFC1191 path MTU discovery timeout value in seconds (32-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>25 - PathMTUPlateauTable</term> + <listitem><para>RFC1191 path MTU discovery size table, sorted in ascending order (list of 16-bit decimal values).</para></listitem> + </varlistentry> <varlistentry> + <term>26 - InterfaceMTU</term> + <listitem><para>The MTU size for the interface (16-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>27 - AllSubnetsAreLocal</term> + <listitem><para>Indicates whether the MTU size is the same for all subnets (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>28 - BroadcastAddress</term> + <listitem><para>Broadcast address (RFC1122) for the client to use (IPv4 address).</para></listitem> + </varlistentry> <varlistentry> + <term>29 - PerformMaskDiscovery</term> + <listitem><para>Whether to perform subnet mask discovery via ICMP (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>30 - MaskSupplier</term> + <listitem><para>Whether to respond to subnet mask requests via ICMP (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>31 - PerformRouterDiscovery</term> + <listitem><para>Whether to perform router discovery (RFC1256) (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>32 - RouterSolicitationAddress</term> + <listitem><para>Where to send router solicitation requests (RFC1256) (IPv4 address).</para></listitem> + </varlistentry> <varlistentry> + <term>33 - StaticRoute</term> + <listitem><para>List of network and router address pairs addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>34 - TrailerEncapsulation</term> + <listitem><para>Whether to negotiate the use of trailers for ARP (RTF893) (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>35 - ARPCacheTimeout</term> + <listitem><para>The timeout in seconds for ARP cache entries (32-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>36 - EthernetEncapsulation</term> + <listitem><para>Whether to use IEEE 802.3 (RTF1042) rather than of v2 (RFC894) ethernet encapsulation (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>37 - TCPDefaultTTL</term> + <listitem><para>Default time-to-live for TCP sends (non-zero 8-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>38 - TCPKeepaliveInterval</term> + <listitem><para>The interface in seconds between TCP keepalive messages (32-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>39 - TCPKeepaliveGarbage</term> + <listitem><para>Whether to include a byte of garbage in TCP keepalive messages for backward compatibility (boolean).</para></listitem> + </varlistentry> <varlistentry> + <term>40 - NISDomain</term> + <listitem><para>The NIS (Sun Network Information Services) domain name (string).</para></listitem> + </varlistentry> <varlistentry> + <term>41 - NISServers</term> + <listitem><para>Space separated list of IPv4 NIS server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>42 - NTPServers</term> + <listitem><para>Space separated list of IPv4 NTP (RFC1035) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>43 - VendorSpecificInfo</term> + <listitem><para>Vendor specific information. Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> <varlistentry> + <term>44 - NetBIOSNameServers</term> + <listitem><para>Space separated list of IPv4 NetBIOS name server (NBNS) addresses (RFC1001,RFC1002).</para></listitem> + </varlistentry> <varlistentry> + <term>45 - NetBIOSDatagramServers</term> + <listitem><para>Space separated list of IPv4 NetBIOS datagram distribution server (NBDD) addresses (RFC1001,RFC1002).</para></listitem> + </varlistentry> <varlistentry> + <term>46 - NetBIOSNodeType</term> + <listitem><para>NetBIOS node type (RFC1001,RFC1002): 1=B-node, 2=P-node, 4=M-node, and 8=H-node (8-bit decimal value).</para></listitem> + </varlistentry> <varlistentry> + <term>47 - NetBIOSScope</term> + <listitem><para>NetBIOS scope (RFC1001,RFC1002). Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> <varlistentry> + <term>48 - XWindowsFontServers</term> + <listitem><para>Space separated list of IPv4 X windows font server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>49 - XWindowsDisplayManager</term> + <listitem><para>Space separated list of IPv4 X windows display manager addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>62 - NetWareIPDomainName</term> + <listitem><para>Netware IP domain name (RFC2242) (string).</para></listitem> + </varlistentry> <varlistentry> + <term>63 - NetWareIPInformation</term> + <listitem><para>Netware IP information (RFC2242). Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> <varlistentry> + <term>64 - NISPlusDomain</term> + <listitem><para>The NIS+ domain name (string).</para></listitem> + </varlistentry> <varlistentry> + <term>65 - NISPlusServers</term> + <listitem><para>Space separated list of IPv4 NIS+ server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>66 - TFTPServerName</term> + <listitem><para>TFTP server name (string).</para></listitem> + </varlistentry> <varlistentry> + <term>67 - BootfileName</term> + <listitem><para>Bootfile name (string).</para></listitem> + </varlistentry> <varlistentry> + <term>68 - MobileIPHomeAgents</term> + <listitem><para>Space separated list of IPv4 mobile IP agent addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>69 - SMTPServers</term> + <listitem><para>Space separated list of IPv4 simple mail transport protocol (SMPT) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>70 - POP3Servers</term> + <listitem><para>Space separated list of IPv4 post office protocol 3 (POP3) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>71 - NNTPServers</term> + <listitem><para>Space separated list of IPv4 network news transport protocol (NTTP) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>72 - WWWServers</term> + <listitem><para>Space separated list of default IPv4 world wide web (WWW) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>73 - FingerServers</term> + <listitem><para>Space separated list of default IPv4 finger server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>74 - IRCServers</term> + <listitem><para>Space separated list of default IPv4 internet relay chat (IRC) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>75 - StreetTalkServers</term> + <listitem><para>Space separated list of IPv4 StreetTalk server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>76 - STDAServers</term> + <listitem><para>Space separated list of IPv4 StreetTalk directory assistance (STDA) server addresses.</para></listitem> + </varlistentry> <varlistentry> + <term>78 - SLPDirectoryAgent</term> + <listitem><para>Addresses of one or more service location protocol (SLP) directory agent, and an indicator of whether their use is mandatory. Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> <varlistentry> + <term>79 - SLPServiceScope</term> + <listitem><para>List of service scopes for the service location protocol (SLP) and whether using the list is mandator. Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> <varlistentry> + <term>119 - DomainSearch</term> + <listitem><para>Domain search list, see RFC3397 and section 4.1.4 in RFC1035 for encoding. Only accessible using --set-opt-hex.</para></listitem> + </varlistentry> + </variablelist> diff --git a/doc/manual/ru_RU/man_VBoxManage-dhcpserver.xml b/doc/manual/ru_RU/man_VBoxManage-dhcpserver.xml new file mode 100644 index 00000000..117c7b6c --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-dhcpserver.xml @@ -0,0 +1,611 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage dhcpserver +--> +<!-- + 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-dhcpserver" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage dhcpserver</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-dhcpserver</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-dhcpserver</refname> + <refpurpose>Управление DHCP сервером</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-add"> + <command>VBoxManage dhcpserver add</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + <arg choice="req">--server-ip=<replaceable>адрес</replaceable></arg> + <arg choice="req">--netmask=<replaceable>маска</replaceable></arg> + <arg choice="req">--lower-ip=<replaceable>адрес</replaceable></arg> + <arg choice="req">--upper-ip=<replaceable>адрес</replaceable></arg> + <group choice="req"> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + <sbr/> + <group rep="repeat"> + <arg>--global</arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--group=<replaceable>имя</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--incl-mac=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--excl-mac=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--incl-mac-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-mac-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--incl-vendor=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--excl-vendor=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--incl-vendor-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-vendor-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--incl-user=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--excl-user=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--incl-user-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-user-wild=<replaceable>шаблон</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--vm=<replaceable>имя|uuid</replaceable></arg> + <arg>--nic=<replaceable>1-N</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--fixed-address=<replaceable>адрес</replaceable></arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--mac-address=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--fixed-address=<replaceable>адрес</replaceable></arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-modify"> + <command>VBoxManage dhcpserver modify</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + <arg>--server-ip=<replaceable>адрес</replaceable></arg> + <arg>--lower-ip=<replaceable>адрес</replaceable></arg> + <arg>--upper-ip=<replaceable>адрес</replaceable></arg> + <arg>--netmask=<replaceable>маска</replaceable></arg> + <group> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + <sbr/> + <group rep="repeat"> + <arg>--global</arg> + <arg rep="repeat">--del-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unforce-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unsupress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--remove-config</arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--group=<replaceable>имя</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unforce-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unsupress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--del-mac=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--incl-mac=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--excl-mac=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--del-mac-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--incl-mac-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-mac-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--del-vendor=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--incl-vendor=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--excl-vendor=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--del-vendor-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--incl-vendor-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-vendor-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--del-user=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--incl-user=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--excl-user=<replaceable>строка</replaceable></arg> + <arg rep="repeat">--del-user-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--incl-user-wild=<replaceable>шаблон</replaceable></arg> + <arg rep="repeat">--excl-user-wild=<replaceable>шаблон</replaceable></arg> + <arg>--zap-conditions</arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--remove-config</arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--vm=<replaceable>имя|uuid</replaceable></arg> + <arg>--nic=<replaceable>1-N</replaceable></arg> + <arg rep="repeat">--del-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unforce-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unsupress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--fixed-address=<replaceable>адрес</replaceable></arg> + <arg>--remove-config</arg> + </group> + <sbr/> + <group rep="repeat"> + <arg choice="req">--mac-address=<replaceable>адрес</replaceable></arg> + <arg rep="repeat">--del-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></arg> + <arg rep="repeat">--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></arg> + <arg rep="repeat">--force-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unforce-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--supress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg rep="repeat">--unsupress-opt=<replaceable>номер-опции-dhcp</replaceable></arg> + <arg>--min-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--default-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--max-lease-time=<replaceable>секунды</replaceable></arg> + <arg>--fixed-address=<replaceable>адрес</replaceable></arg> + <arg>--remove-config</arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-remove"> + <command>VBoxManage dhcpserver remove</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-start"> + <command>VBoxManage dhcpserver start</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-restart"> + <command>VBoxManage dhcpserver restart</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-stop"> + <command>VBoxManage dhcpserver stop</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-findlease"> + <command>VBoxManage dhcpserver findlease</command> + <group choice="req"> + <arg choice="plain">--network=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--interface=<replaceable>имя-интерфейса</replaceable></arg> + </group> + <arg choice="req">--mac-address=<replaceable>mac</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <para> + Команды <command>dhcpserver</command> позволяют управлять встроенным в + VirtualBox DHCP сервером. Это может быть полезно при использовании + внутренней сети или сети хоста. Теоретически, его можно использовать + также и для сетевого моста, но это может вызвать конфликты с другими + DHCP серверами, находящимся в вашей физической сети. + </para> + + <refsect2 id="vboxmanage-dhcpserver-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Все подкоманды <command>dhcpserver</command> работают во внутренней + сети, идентифицируемой через ее имя или, в случае с сетью хоста, через + имя интерфейса:</para> + <variablelist> + <varlistentry> + <term>--network=<replaceable>имя-сети</replaceable></term> + <listitem><para>Имя внутренней сети. Это то же самое имя, которое было + задано в опции <command>VBoxManage modifyvm --intnet</command> при + настройке ВМ на внутреннюю сеть. Также его можно посмотреть в поле + "Имя сети VBox" вывода команд + <command>VBoxManage list intnets</command>, + <command>VBoxManage list natnets</command> или + <command>VBoxManage list hostonlyifs</command>. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--interface=<replaceable>имя-интерфейса</replaceable></term> + <listitem><para>Имя интерфейса сети хоста. Это то же самое имя, которое + было задано в опции <command>VBoxManage modifyvm --host-only-adapter</command> + при настройке ВМ на сеть хоста. Оно также может быть получено в поле "Имя" + вывода команды <command>VBoxManage list hostonlyifs</command>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-add"> + <title>dhcpserver add</title> + <remark role="help-copy-synopsis"/> + <para> + Добавляет новый DHCP сервер в сеть или интерфейс сети хоста. + </para> + <para> + Опции для настройки ядра DHCP сервера: + </para> + <variablelist> + <varlistentry> + <term><option>--server-ip=<replaceable>адрес</replaceable></option></term> + <listitem><para>IP адрес, который должен быть у DHCP сервера.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lower-ip=<replaceable>адрес</replaceable></option>, <option>--upper-ip=<replaceable>адрес</replaceable></option></term> + <listitem><para>Диапазон IP адресов в управлении у DHCP сервера. + Он не должен включать адрес самого DHCP сервера, но должен быть в + той же сети. Границы включены, так что и верхний и нижний адреса + также распределяются между клиентами.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--netmask=<replaceable>маска</replaceable></option></term> + <listitem><para>Сетевая маска. Обычно 255.255.255.0.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option>, --disable</term> + <listitem><para>Включает или выключает DHCP сервер. Если не указан, + сервер создается в выключенном состоянии и не распределяет адресов.</para></listitem> + </varlistentry> + </variablelist> + <para> + Опции, определяющие область настроек: + </para> + <variablelist> + <varlistentry> + <term><option>--global</option></term> + <listitem><para>Задать глобальную область настроек. Любые последующие опции + <option>--set-opt</option> будут применены ко всем клиентам DHCP.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vm=<replaceable>имя-ВМ|uuid</replaceable></option></term> + <listitem><para>Задать область настроек, ограниченную первым NIC указанной ВМ. + Любые последующие опции <option>--set-opt</option> будут применены только + к этому интерфейсу и никуда больше.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic=<replaceable>1-N</replaceable></option></term> + <listitem><para>Задать область настроек, ограниченную указанным номером интерфейса ВМ, + заданной через опцию <option>--vm</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mac-address=<replaceable>адрес</replaceable></option></term> + <listitem><para>Задать область настроек, ограниченную указанным MAC адресом.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--group=<replaceable>имя</replaceable></option></term> + <listitem><para>Задать область настроек, ограниченную указанной группой.</para></listitem> + </varlistentry> + </variablelist> + <para> + Опции для настройки текущей выбранной области: + </para> + <variablelist> + <varlistentry> + <term><option>--set-opt=<replaceable>номер-опции-dhcp значение</replaceable></option></term> + <listitem><para>Добавляет указанный номер опции DHCP (0-255) и значение. Формат значения + опции зависит от опции (обычно человеко-читаемый) и проверяется API и сервером DHCP. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--set-opt-hex=<replaceable>номер-опции-dhcp строка-hex</replaceable></option></term> + <listitem><para>Добавляет указанный номер опции DHCP (0-255) и значение. Значение параметра + задается в виде необработанной последовательности шестнадцатеричных байтов, которые могут + быть разделены двоеточием. Проверка этих значений не производится ни API, ни DHCP сервером, + они как есть передаются клиенту. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--force-opt=<replaceable>номер-опции-dhcp</replaceable></option></term> + <listitem><para>Принудительно отправляет указанный номер опции DHCP (0-255) клиенту + независимо от того, запрашивал он это или нет (при условии, что опция настроена + со значением на некотором уровне). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--suppress-opt=<replaceable>номер-опции-dhcp</replaceable></option></term> + <listitem><para> Предотвращает отправку клиенту указанного номера опции DHCP (0–255), + если он присутствует в этой или более высокой области настроек. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--min-lease-time=<replaceable>секунды</replaceable></option></term> + <listitem><para>Устанавливает минимальное время аренды для текущей области в секундах. + Ноль означает получение значения из более высокого уровня настроек или использование + значения по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--default-lease-time=<replaceable>секунды</replaceable></option></term> + <listitem><para>Задает время аренды по умолчанию для текущей области в секундах. Ноль + означает получение значения из более высокого уровня настроек или использование + значения по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--max-lease-time=<replaceable>секунды</replaceable></option></term> + <listitem><para>Устанавливает максимальное время аренды для текущей области в секундах. + Ноль означает получение значения из более высокого уровня настроек или использование + значения по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--fixed-address=<replaceable>адрес</replaceable></option></term> + <listitem><para>Назначение фиксированного адреса для области настроек + <option>--vm</option> или <option>--mac-address</option>. Пустой + <replaceable>адрес</replaceable> возвращает обратно назначение динамического + адреса. + </para></listitem> + </varlistentry> + </variablelist> + + <para> + Опции для настройки условий членства в группе (исключение, переопределение, включение): + </para> + <variablelist> + <varlistentry> + <term><option>--incl-mac=<replaceable>адрес</replaceable></option></term> + <listitem><para>Включает указанный MAC адрес в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-mac=<replaceable>адрес</replaceable></option></term> + <listitem><para>Исключает указанный MAC адрес из группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--incl-mac-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Включает указанный шаблон MAC адреса в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-mac-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Исключает указанный шаблон MAC адреса из группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--incl-vendor=<replaceable>строка</replaceable></option></term> + <listitem><para>Включает указанный ID класса поставщика в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-vendor=<replaceable>строка</replaceable></option></term> + <listitem><para>Исключает указанный ID класса поставщика из группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--incl-vendor-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Включает указанный шаблон ID класса поставщика в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-vendor-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Исключает указанный шаблон ID класса поставщика из группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--incl-user=<replaceable>строка</replaceable></option></term> + <listitem><para>Включает указанный ID класса пользователя в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-user=<replaceable>строка</replaceable></option></term> + <listitem><para>Исключает указанный ID класса пользователя из группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--incl-user-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Включает указанный шаблон ID класса пользователя в группу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--excl-user-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Исключает указанный шаблон ID класса пользователя из группы.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-modify"> + <title>dhcpserver modify</title> + <remark role="help-copy-synopsis"/> + <para> + Команда модифицирует существующую конфигурацию сервера DHCP. Она принимает те же + опции как и команда <command>add</command> и в дополнении нижеследующие, относящиеся + к области настроек: + </para> + <variablelist> + <varlistentry> + <term><option>--del-opt=<replaceable>номер-опции-dhcp</replaceable></option></term> + <listitem><para>Противоположность к <option>--set-opt</option>, которая удаляет + указанный номер опции DHCP (0-255) из настроек сервера. Как и у + <option>--set-opt</option>, область удаления регулируется опциями + <option>--global</option>, <option>--vm</option>, <option>--mac-address</option> + и <option>--group</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unforce-opt=<replaceable>номер-опции-dhcp</replaceable></option></term> + <listitem><para>Удаляет указанный номер опции DHCP (0-255) из списка принудительно + передаваемых клиенту опций (то есть обратная к <option>--force-opt</option>). Как и у + <option>--set-opt</option>, область удаления регулируется опциями + <option>--global</option>, <option>--vm</option>, <option>--mac-address</option> + и <option>--group</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unsuppress-opt=<replaceable>номер-опции-dhcp</replaceable></option></term> + <listitem><para>Удаляет указанный номер DHCP (0-255) из списка опций для подавления + передачи клиенту (то есть обратная к <option>--suppress-opt</option>). Как и у + <option>--set-opt</option>, область удаления регулируется опциями + <option>--global</option>, <option>--vm</option>, <option>--mac-address</option> + и <option>--group</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--remove-config</option></term> + <listitem><para>Удаляет настройки из текущей области. Область <option>--global</option> + нельзя удалить. После этой опции область настроек будет изменена на + <option>--global</option>. + </para></listitem> + </varlistentry> + </variablelist> + <para> + И дополнение к опциям условий членства в группах: + </para> + <variablelist> + <varlistentry> + <term><option>--del-mac=<replaceable>адрес</replaceable></option></term> + <listitem><para>Удаляет указанный MAC адрес из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--del-mac-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Удаляет указанный шаблон MAC адреса из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--del-vendor=<replaceable>строка</replaceable></option></term> + <listitem><para>Удаляет указанный ID класса поставщика из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--del-vendor-wild=<replaceable>шаблон</replaceable></option></term> + <listitem><para>Удаляет указанный шаблон ID класса поставщика из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--del-user=<replaceable>строка</replaceable></option></term> + <listitem><para>Удаляет указанный ID класса пользователя из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--del-user-wild=<replaceable>pattern</replaceable></option></term> + <listitem><para>Удаляет указанный шаблон ID класса пользователя из условий группы.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--zap-conditions</option></term> + <listitem><para>Удаляет все условия группы.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-remove"> + <title>dhcpserver remove</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет указанный сервер DHCP. + </para> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-start"> + <title>dhcpserver start</title> + <remark role="help-copy-synopsis"/> + <para> + Запускает указанный сервер DHCP. + </para> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-restart"> + <title>dhcpserver restart</title> + <remark role="help-copy-synopsis"/> + <para> + Перезапускает указанный сервер DHCP. Сервер DHCP должен работать на момент запуска команды. + </para> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-stop"> + <title>dhcpserver stop</title> + <remark role="help-copy-synopsis"/> + <para> + Останавливает указанный сервер DHCP. + </para> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-findlease"> + <title>dhcpserver findlease</title> + <remark role="help-copy-synopsis"/> + <para> + Производит просмотр базы данных аренды. Эта команда в основном + для получения IP адреса работающей ВМ. + </para> + <variablelist> + <varlistentry> + <term><option>--mac-address=<replaceable>mac</replaceable></option></term> + <listitem><para>MAC адрес для просмотра в базе данных аренды.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-dhcpserver-dhcpoptions"> + <title>Общие параметры DHCP:</title> + <remark role="help-scope" condition="DHCPSERVER_ADD|DHCPSERVER_MODIFY"/> + <!-- The following file is generated from src/VBox/Main/idl/VirtualBox.xidl: --> + <xi:include href="man_VBoxManage-dhcpserver-dhcpoptions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-discardstate.xml b/doc/manual/ru_RU/man_VBoxManage-discardstate.xml new file mode 100644 index 00000000..3c793f32 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-discardstate.xml @@ -0,0 +1,101 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage discardstate +--> +<!-- + 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-discardstate" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage discardstate</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-discardstate</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-discardstate</refname> + <refpurpose>удаление сохраненного состояния виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-discardstate"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage discardstate</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage discardstate</command> удаляет + сохраненное состояние виртуальной машины (ВМ) если она не + работает на текущий момент. Эта операция заставляет + операционную систему ВМ перезагрузиться при следующем старте ВМ. + </para> + <note> + <para> + Где возможно, избегайте этого действия. Эффект от этой команды + равносилен отсоединению кабеля питания из физической машины. + </para> + </note> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда удаляет файл сохраненного состояния ВМ, + называемой <filename>vm2</filename>. Когда в следующий раз + вы запустите ВМ, операционная система ВМ будет перезагружена. + </para> +<screen>$ VBoxManage discardstate vm2</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-adoptstate"/> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-encryptmedium.xml b/doc/manual/ru_RU/man_VBoxManage-encryptmedium.xml new file mode 100644 index 00000000..869935d1 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-encryptmedium.xml @@ -0,0 +1,169 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage encryptmedium +--> +<!-- + 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-encryptmedium" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage encryptmedium</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-encryptmedium</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-encryptmedium</refname> + <refpurpose>управляет образом или носителем, зашифрованными DEK</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-encryptmedium"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage encryptmedium</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg>--cipher=<replaceable>ID-шифра</replaceable></arg> + <arg>--newpassword=<replaceable>пароль</replaceable></arg> + <arg>--newpasswordid=<replaceable>ID-пароля</replaceable></arg> + <arg>--oldpassword=<replaceable>пароль</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage encryptmedium</command> позволяет + создавать или управлять образом или носителем, зашифрованными DEK. + Можно зашифровать образ, расшифровать образ, изменить пароль + шифрования образа. Смотрите <xref linkend="diskencryption-encryption" />. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + абсолютный путь шифруемого носителя или образа. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--newpassword=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Задает новый пароль шифрования. <replaceable>пароль</replaceable> + - это или абсолютный путь к файлу с паролем в хост-системе + или <literal>-</literal>. Во втором случае будет предложено + ввести пароль. + </para><para> + Необходимо использовать опцию <option>--newpasswordid</option> + вместе с этой опцией <option>--newpassword</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--oldpassword=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Задает исходный пароль шифрования. <replaceable>пароль</replaceable> + - это или абсолютный путь к файлу с паролем в хост-системе + или <literal>-</literal>. Во втором случае будет предложено + ввести пароль. + </para><para> + Эта опция позволяет получить доступ к зашифрованному + носителю или образу, чтобы произвести следующее: + </para><itemizedlist> + <listitem><para> + Расшифровать зашифрованный образ используя эту опцию. + </para></listitem> + <listitem><para> + Изменить пароль зашифрованного образа используя опцию + <option>--newpassword</option>. + </para></listitem> + <listitem><para> + Изменить шифр образа используя опцию + <option>--cipher</option>. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--cipher=<replaceable>ID-шифра</replaceable></option></term> + <listitem><para> + Указывает шифр для шифрования. Допустимые значения + <literal>AES-XTS128-PLAIN64</literal> или + <literal>AES-XTS256-PLAIN64</literal>. + </para><para> + Эта опция позволяет установить или изменить шифрование + носителя или образа. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--newpasswordid=<replaceable>ID-пароля</replaceable></option></term> + <listitem><para> + Указывает новый идентификатор пароля, используемого для + корректной идентификации, когда передаются несколько паролей + во время старта ВМ. + </para><para> + Если вы используете одни и те же пароль и идентификатор + пароля при шифровании нескольких образов то вам достаточно + указать пароль один раз во время старта ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующий пример показывает как зашифровать образ + <filename>ol7u4-1.vdi</filename>, используя шифр + <literal>AES-XTS128-PLAIN64</literal>, задавая идентификатор + пароля <literal>1001</literal> и используя файл пароля + <filename>$HOME/pwfile</filename>: + </para> +<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" \ + --cipher="AES-XTS128-PLAIN64" --newpasswordid="1001" --newpassword=$HOME/pwfile</screen> + <para> + Следующий пример показывает как расшифровать зашифрованный образ + называемый <filename>ol7u4-2.vdi</filename>: + </para> +<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-2.vdi" \ + --oldpassword=- + Пароль: <replaceable>исходный-пароль</replaceable></screen> + <para> + Следующий пример показывает как изменить пароль зашифрованного + образа называемого <filename>ol7u4-3.vdi</filename>. Команда + читает исходный пароль из файла <filename>$HOME/pwfile.orig</filename> + и назначает идентификатор пароля <literal>1001</literal>. + </para> +<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-3.vdi" \ + --oldpassword=$HOME/pwfile.orig --newpassword=$HOME/pwfile --newpasswordid="1001"</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-encryptvm.xml b/doc/manual/ru_RU/man_VBoxManage-encryptvm.xml new file mode 100644 index 00000000..2e2c8673 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-encryptvm.xml @@ -0,0 +1,199 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage encryptvm +--> +<!-- + 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-encryptvm" lang="en"> + <refentryinfo> + <pubdate>May 2021</pubdate> + <title>VBoxManage encryptvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-encryptvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-encryptvm</refname> + <refpurpose>изменение шифрования и паролей ВМ</refpurpose> + <refclass>Oracle VM VirtualBox</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-encryptvm-setencryption"> + <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage encryptvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">setencryption</arg> + <arg choice="plain">--old-password <replaceable>файл</replaceable></arg> + <arg choice="plain">--cipher <replaceable>идентификатор-шифра</replaceable></arg> + <arg choice="plain">--new-password <replaceable>файл</replaceable></arg> + <arg choice="plain">--new-password-id <replaceable>идентификатор-пароля</replaceable></arg> + <arg choice="plain">--force</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-encryptvm-checkpassword"> + <command>VBoxManage encryptvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">checkpassword</arg> + <arg choice="req"><replaceable>файл</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-encryptvm-addpassword"> + <command>VBoxManage encryptvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">addpassword</arg> + <arg choice="plain">--password <replaceable>файл</replaceable></arg> + <arg choice="plain">--password-id <replaceable>идентификатор-пароля</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-encryptvm-removepassword"> + <command>VBoxManage encryptvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="plain">removepassword</arg> + <arg choice="req"><replaceable>идентификатор-пароля</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage encryptvm</command> позволяет изменить + шифрование или добавить и удалить пароли пользователя виртуальной + машины (ВМ). Далее идут секции, описывающие поддерживаемые подкоманды: + </para> + <refsect2 id="vboxmanage-encryptvm-setencryption"> + <title>Задать шифрование виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage encryptvm + <replaceable>имя-ВМ</replaceable> setencryption</command> + изменяет шифрование ВМ. + </para> + <para> + Опция <option>--old-password</option> задает старый пароль + шифрования. Укажите абсолютный путь к файлу с паролем в + операционной системе хоста или <literal>-</literal>. Во втором + случае будет предложено ввести пароль. + </para> + <para> + Опция <option>--cipher</option> задает новый шифр для + шифрования ВМ. + </para> + <para> + Опция <option>--new-password</option> задает новый пароль + шифрования ВМ. Укажите абсолютный путь к файлу с паролем в + операционной системе хоста или <literal>-</literal>. Во втором + случае будет предложено ввести пароль. + </para> + <para> + Опция <option>--new-password-id</option> задает идентификатор + нового пароля шифрования ВМ. + </para> + <para> + Опция <option>--force</option> заставляет систему принудительно + перешифровать ВМ вместо простой смены пароля. + </para> + </refsect2> + <refsect2 id="vboxmanage-encryptvm-checkpassword"> + <title>Проверить заданный пароль на корректность</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage encryptvm + <replaceable>имя-ВМ</replaceable> checkpassword</command> проверяет + корректность указанного пароля. + </para> + <para> + Пароль может передан через файл. Укажите абсолютный путь к файлу + с паролем в операционной системе хоста или <literal>-</literal>. + Во втором случае будет предложено ввести пароль. + </para> + </refsect2> + <refsect2 id="vboxmanage-encryptvm-addpassword"> + <title>Добавить пароль для расшифровки виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage encryptvm + <replaceable>имя-ВМ</replaceable> addpassword</command> добавляет + пароль для расшифровки ВМ. + </para> + <para> + Опция <option>--password</option> задает пароль шифрования. + Укажите абсолютный путь к файлу с паролем в операционной + системе хоста или <literal>-</literal>. Во втором случае будет + предложено ввести пароль. + </para> + <para> + Опция <option>--password-id</option> задает id указанного пароля. + </para> + </refsect2> + <refsect2 id="vboxmanage-encryptvm-removepassword"> + <title>Отозвать пароль для расшифровки виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage encryptvm + <replaceable>имя-ВМ</replaceable> removepassword</command> отзывает + пароль для расшифровки ВМ. + </para> + <para> + Укажите идентификатор отзываемого пароля. Пароль становится + неизвестным и ВМ не может быть расшифрована. + </para> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда шифрует ВМ <filename>ol7</filename> с помощью + AES-256 получая пароль через приглашение командной строки: + </para> +<screen>$ VBoxManage encryptvm ol7 setencryption --cipher=AES-256 --new-password - --new-password-id vmid</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-createvm" />, + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-export.xml b/doc/manual/ru_RU/man_VBoxManage-export.xml new file mode 100644 index 00000000..3b3df38e --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-export.xml @@ -0,0 +1,438 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage export +--> +<!-- + 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-export" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage export</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-export</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-export</refname> + <refpurpose>экспорт одной или нескольких виртуальных машин в виртуальную конфигурацию или в облачную службу</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-export-ovf"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage export</command> + <arg choice="req"><replaceable>машины</replaceable></arg> + <arg choice="req">--output=<replaceable>имя</replaceable></arg> + <group> + <arg choice="plain">--legacy09</arg> + <arg choice="plain">--ovf09</arg> + <arg choice="plain">--ovf10</arg> + <arg choice="plain">--ovf20</arg> + </group> + <arg>--manifest</arg> + <arg>--options=<group choice="plain" rep="repeat"> + <arg choice="plain">manifest</arg> + <arg choice="plain">iso</arg> + <arg choice="plain">nomacs</arg> + <arg choice="plain">nomacsbutnat</arg> + </group></arg> + <arg>--vsys=<replaceable>номер-виртуальной-системы</replaceable></arg> + <arg>--description=<replaceable>описание</replaceable></arg> + <arg>--eula=<replaceable>текст-лицензии</replaceable></arg> + <arg>--eulafile=<replaceable>имя-файла</replaceable></arg> + <arg>--product=<replaceable>имя-продукта</replaceable></arg> + <arg>--producturl=<replaceable>URL-продукта</replaceable></arg> + <arg>--vendor=<replaceable>имя-поставщика</replaceable></arg> + <arg>--vendorurl=<replaceable>URL-поставщика</replaceable></arg> + <arg>--version=<replaceable>информация-о-версии</replaceable></arg> + <arg>--vmname=<replaceable>имя-ВМ</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-export-cloud"> + <command>VBoxManage export</command> + <arg choice="req"><replaceable>машина</replaceable></arg> + <arg choice="req">--output=<replaceable>провайдер-облачной-службы</replaceable></arg> + <arg>--opc10</arg> + <arg>--vmname=<replaceable>имя-ВМ</replaceable></arg> + <arg>--cloud=<replaceable>номер-виртуальной-системы</replaceable></arg> + <arg>--cloudprofile=<replaceable>имя-облачного-профиля</replaceable></arg> + <arg>--cloudshape=<replaceable>имя-облачной-формы</replaceable></arg> + <arg>--clouddomain=<replaceable>облачный-домен</replaceable></arg> + <arg>--clouddisksize=<replaceable>размер-диска-в-ГБ</replaceable></arg> + <arg>--cloudbucket=<replaceable>имя-корзины</replaceable></arg> + <arg>--cloudocivcn=<replaceable>OCI-VCN-ID</replaceable></arg> + <arg>--cloudocisubnet=<replaceable>ID-подсети-OCI</replaceable></arg> + <arg>--cloudkeepobject=<group choice="plain"> + <arg choice="plain">true</arg> + <arg choice="plain">false</arg> + </group></arg> + <arg>--cloudlaunchinstance=<group choice="plain"> + <arg choice="plain">true</arg> + <arg choice="plain">false</arg> + </group></arg> + <arg>--cloudlaunchmode=<group choice="plain"> + <arg choice="plain">EMULATED</arg> + <arg choice="plain">PARAVIRTUALIZED</arg> + </group></arg> + <arg>--cloudpublicip=<group choice="plain"> + <arg choice="plain">true</arg> + <arg choice="plain">false</arg> + </group></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage export</command> позволяет экспортировать + одну или несколько виртуальных машин (ВМ) из &product-name;. + Можно экспортировать ВМ в одно из следующих назначений: + </para> + <itemizedlist> + <listitem><para> + <emphasis role="bold">Виртуальная конфигурация в OVF формат.</emphasis> + Включает копирование ее виртуальных дисков в сжатый VMDK. + </para></listitem> + <listitem><para> + <emphasis role="bold">Облачная служба, например &oci;.</emphasis> + Экспортирует только одну машину VM. + </para></listitem> + </itemizedlist> + <para> + Для более детальной информации об экспорте ВМ из &product-name; + смотрите <xref linkend="ovf" /> + </para> + <refsect2 id="vboxmanage-export-ovf"> + <title>Экспорт виртуальной машины в виртуальную конфигурацию OVF</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage export</command> позволяет экспортировать + ВМ в виртуальную конфигурацию в формате OVF. + </para> + <variablelist> + <varlistentry> + <term><replaceable>машины</replaceable></term> + <listitem><para> + Задает список, разделенный запятыми, одной или нескольких + машин для экспорта в один файл OVF. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--output=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает файл назначения OVF. Файл может быть OVF, OVA или + файл ZIP сжатый через команду <command>gzip</command>. + Из-за того, что директория, содержащая файл назначения + OFV, также сохраняет экспортированные образы в формате + сжатого VMDK, убедитесь, что на диске, содержащем эту + директорию достаточно свободного места для сохранения + образов. + </para><para> + Краткая форма этой опции <option>-o</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--legacy09</option></term> + <listitem><para> + Экспортирует в устаревший OVF-0.9 формат если продукт + виртуализации не полностью совместим со стандартном + OVF-1.0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ovf09</option></term> + <listitem><para> + Экспортирует в формат OVF 0.9. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ovf10</option></term> + <listitem><para> + Экспортирует в формат OVF 1.0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ovf20</option></term> + <listitem><para> + Экспортирует в формат OVF 2.0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--manifest</option></term> + <listitem><para> + Создает манифест экспортированных файлов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--options=<replaceable>аргумент</replaceable>,...</option></term> + <listitem><para> + Указывает информацию для управления точным содержимым + файла конфигурации. Укажите один или несколько разделенных + запятыми аргументами: + </para><variablelist> + <varlistentry> + <term><literal>manifest</literal></term> + <listitem><para> + Создает файл манифеста, который обнаруживает + поврежденные конфигурации при импорте. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>iso</literal></term> + <listitem><para> + Экспортирует образы DVD в файл ISO. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>nomacs</literal></term> + <listitem><para> + Исключает все MAC адреса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>nomacsbutnat</literal></term> + <listitem><para> + Исключает все MAC адреса кроме тех, что в сети NAT. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Задает описание ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--eula=<replaceable>текст-лицензии</replaceable></option></term> + <listitem><para> + Задает текст лицензии конечного пользователя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--eulafile=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает файл лицензии конечного пользователя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--product=<replaceable>имя-продукта</replaceable></option></term> + <listitem><para> + Задает имя продукта. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--producturl=<replaceable>URL-продукта</replaceable></option></term> + <listitem><para> + Задает URL продукта. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vendor=<replaceable>имя-поставщика</replaceable></option></term> + <listitem><para> + Задает имя поставщика. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vendorurl=<replaceable>URL-поставщика</replaceable></option></term> + <listitem><para> + Задает URl поставщика. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--version=<replaceable>информация-о-версии</replaceable></option></term> + <listitem><para> + Задает информацию о версии. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vmname=<replaceable>имя-ВМ</replaceable></option></term> + <listitem><para> + Задает имя экспортируемой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vsys=<replaceable>номер-виртуальной-системы</replaceable></option></term> + <listitem><para> + Задает номер виртуальной системы. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-export-cloud"> + <title>Экспортировать виртуальную машину в &oci;</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage export</command> позволяет экспортировать + ВМ в провайдер облачной службы, например &oci;. По умолчанию + экспортированный образ диска преобразуется в формат сжатого VMDK. + Это минимизирует размер данных, передаваемых в облачную службу. + </para> + <para> + Некоторые из нижеследующих опций являются настройками конфигурации + экземпляра ВМ. Как результат, укажите Идентификатор Облака Oracle + (OCID) ресурса. Используйте консоль &oci; для просмотра OCID. + </para> + <variablelist> + <varlistentry> + <term><option>--output=<replaceable>провайдер-облачной-службы</replaceable></option></term> + <listitem><para> + Указывает краткое имя провайдера облачной службы, куда + необходимо экспортировать ВМ. Для &oci;, укажите + <literal>OCI://</literal>. + </para><para> + Краткая форма это опции <option>-o</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--opc10</option></term> + <listitem><para> + Экспорт в формат &oci;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloud=<replaceable>номер-виртуальной-системы</replaceable></option></term> + <listitem><para> + Задает номер, идентифицирующий экспортируемую ВМ. + Нумерация начинается с <literal>0</literal> для первой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vmname=<replaceable>имя-ВМ</replaceable></option></term> + <listitem><para> + Задает имя экспортируемой ВМ, используемое как имя + ВМ экземпляра в &oci;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudprofile=<replaceable>имя-облачного-профиля</replaceable></option></term> + <listitem><para> + Задает облачный профиль, используемый для подключения к + провайдеру облачной службы. Облачный профиль содержит ваши + данные учетной записи &oci;, например ваш OCID пользователя + и отпечаток вашего публичного ключа. + </para><para> + Для использования облачных профилей у вас должны быть + необходимые разрешения в &oci;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudshape=<replaceable>имя-облачной-формы</replaceable></option></term> + <listitem><para> + Задает форму, используемую экземпляром ВМ. Форма + определяет количество ЦПУ и размер памяти, выделенных + экземпляру ВМ. Убедитесь, что форма совместима с + экспортируемым образом. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--clouddomain=<replaceable>облачный-домен</replaceable></option></term> + <listitem><para> + Задает домен доступности, используемый экземпляром ВМ. + Введите полное имя домена доступности. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--clouddisksize=<replaceable>размер-диска-в-ГБ</replaceable></option></term> + <listitem><para> + Задает размер дискового пространства в гигабайтах, + используемый экспортированным образом диска. Допустимые + значения от 50 ГБ до 300 ГБ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudbucket=<replaceable>имя-корзины</replaceable></option></term> + <listitem><para> + Задает корзину где сохранять загруженные файлы. В &oci;, + корзина - это логический контейнер для хранения объектов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudocivcn=<replaceable>OCI-VCN-ID</replaceable></option></term> + <listitem><para> + Задает OCID виртуальной облачной сети (VCN), используемой + экземпляром ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudocisubnet=<replaceable>ID-подсети-OCI</replaceable></option></term> + <listitem><para> + Задает OCID подсети VCN, используемой экземпляром ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudkeepobject=true | false</option></term> + <listitem><para> + Указывает сохранять ли экспортированный образ диска + в хранилище объектов Oracle. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudlaunchinstance=true | false</option></term> + <listitem><para> + Указывает запускать ли экземпляр ВМ после завершения + экспорта в &oci;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudlaunchinstance=EMULATED | PARAVIRTUALIZED</option></term> + <listitem><para> + Указывает режим запуска экземпляра. + Паравиртуализированный режим дает более высокую + производительность. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudpublicip=true | false</option></term> + <listitem><para> + Указывает включать ли публичный IP адрес экземпляру ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примет</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующий пример показывает как экспортировать ВМ + <literal>myVM</literal> в &oci;. Аргументы опции команды + описывают конфигурацию ВМ <literal>myVM_Cloud</literal> + в &oci;. + </para> +<screen># VBoxManage export myVM --output=OCI:// --cloud=0 --vmname=myVM_Cloud \ +--cloudprofile="standard user" --cloudbucket=myBucket \ +--cloudshape=VM.Standard2.1 --clouddomain=US-ASHBURN-AD-1 --clouddisksize=50 \ +--cloudocivcn=ocid1.vcn.oc1.iad.aaaa... --cloudocisubnet=ocid1.subnet.oc1.iad.aaaa... \ +--cloudkeepobject=true --cloudlaunchinstance=true --cloudpublicip=true</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-extpack.xml b/doc/manual/ru_RU/man_VBoxManage-extpack.xml new file mode 100644 index 00000000..31b8d8b6 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-extpack.xml @@ -0,0 +1,159 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage extpack +--> +<!-- + 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-extpack" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage extpack</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-extpack</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-extpack</refname> + <refpurpose>управление пакетами расширения</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-extpack-install"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage extpack install</command> + <arg>--replace</arg> + <arg>--accept-license=<replaceable>sha256</replaceable></arg> + <arg choice="req"><replaceable>имя-tar-архива</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-extpack-uninstall"> + <command>VBoxManage extpack uninstall</command> + <arg>--force</arg> + <arg choice="req"><replaceable>имя</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-extpack-cleanup"> + <command>VBoxManage extpack cleanup</command> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-extpack-install"> + <title>extpack install</title> + <remark role="help-copy-synopsis"/> + <para> + Устанавливает новый пакет расширения в систему. Эта команда завершится с ошибкой, + если более старая версия этого пакет уже установлена. Опция <option>--replace</option> + может быть использована для удаления пакетов более старой версии перед установкой + новой. + </para> + <variablelist> + <varlistentry> + <term><option>--replace</option></term><listitem><para>Удалить существующую версию пакета расширения.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accept-license=<replaceable>sha256</replaceable></option></term> + <listitem> + <para>Принять текст лицензии с данным SHA-256 хеш значением.</para> + <para>VBoxManage отобразит SHA-256 значение при ручной установке. + Хэш, конечно может быть вычислен путем просмотра внутрь пакета + расширения и использования sha256sum или подобной на файле лицензии.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-tar-архива</replaceable></term> + <listitem> + <para>Файл, содержащий устанавливаемый пакет расширения.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-extpack-uninstall"> + <title>extpack uninstall</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет пакет расширения из системы. Подкоманда также завершится успешно, если + указанный пакет расширения отсутствует в системе. Можно использовать + <computeroutput>VBoxManage list extpacks</computeroutput> для просмотра имен + установленных пакетов расширений. + </para> + <variablelist> + <varlistentry> + <term><option>--force</option></term> + <listitem> + <para> Отменяет большинство отказов при удалении пакета расширений</para> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя</replaceable></term> + <listitem> + <para>Имя удаляемого пакета расширения.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-extpack-cleanup"> + <title>extpack cleanup</title> + <remark role="help-copy-synopsis"/> + <para> + Используется для удаления временных файлов и директорий, оставшихся после + предыдущих операций установки или удаления пакетов расширений. + </para> + </refsect2> + + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="EXTPACK_UNINSTALL,EXTPACK"/> + <para> + Как посмотреть список пакетов расширений: +<screen>$ VBoxManage list extpacks +Пакеты расширений: 1 +Пакет no. 0: Oracle VM VirtualBox Extension Pack +Версия: 4.1.12 +Ревизия: 77218 +Редакция: +Описание: USB 2.0 Host Controller, VirtualBox RDP, PXE ROM with E1000 support. +VRDE модуль: VBoxVRDP +Годный: да +Почему не годен:</screen></para> + + <para>Как удалить пакет расширения: +<screen>$ VBoxManage extpack uninstall "Oracle VM VirtualBox Extension Pack" +0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% +Успешно удалено "Oracle VM VirtualBox Extension Pack".</screen></para> + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-getextradata.xml b/doc/manual/ru_RU/man_VBoxManage-getextradata.xml new file mode 100644 index 00000000..99136467 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-getextradata.xml @@ -0,0 +1,150 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage getextradata +--> +<!-- + 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-getextradata" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-18 00:40:56 +0100 (Wed, 18 Jan 2023) $</pubdate> + <title>VBoxManage getextradata</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-getextradata</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-getextradata</refname> + <refpurpose>просмотр значений ключей, связанных с виртуальной машиной или конфигурацией</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-getextradata"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage getextradata</command> + <group choice="req"> + <arg choice="plain">global</arg> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <group choice="plain"> + <arg choice="req"><replaceable>ключ</replaceable></arg> + <arg>enumerate</arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage getextradata</command> позволяет получить + данные ключа, связанного с виртуальной машиной (ВМ) или с конфигурацией + &product-name;. + </para> + <variablelist> + <varlistentry> + <term><literal>global</literal></term> + <listitem><para> + Указывает, что надо получить информацию из конфигурации, + а не из ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>enumerate</literal></term> + <listitem><para> + Показывает все значения ключей для указанной ВМ + или конфигурации. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>ключ</replaceable></term> + <listitem><para> + Задает ключ, данные которого надо получить. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда получает значение ключа <literal>installdate</literal> + для ВМ <literal>Fedora5</literal>: + </para> +<screen>$ VBoxManage getextradata Fedora5 installdate +VirtualBox Command Line Management Interface Version <replaceable>номер-версии</replaceable> +Copyright (C) 2005-2023 Oracle and/or its affiliates + +Значение: 2006.01.01</screen> + <para> + Следующая команда получает информацию для всех ключей ВМ + <literal>OracleLinux7u4</literal>: + </para> +<screen>$ VBoxManage getextradata OracleLinux7u4 enumerate +Ключ: GUI/LastCloseAction, Значение: PowerOff +Ключ: GUI/LastGuestSizeHint, Значение: 1048,696 +Ключ: GUI/LastNormalWindowPosition, Значение: 851,286,1048,738</screen> + <para> + Следующая команда получает информацию для всех ключей в + конфигурации: + </para> +<screen>$ VBoxManage getextradata global enumerate +Ключ: GUI/Details/Elements, Значение: general,system,preview,display,storage,audio,network,usb,sharedFolders,description +Ключ: GUI/DetailsPageBoxes, Значение: general,system,preview,display,storage,audio,network,usb,sharedFolders,description +Ключ: GUI/GroupDefinitions/, Значение: m=43349dd8-2aa3-41b8-988f-0e255ce68090,m=9ebcd81e-5231-48ce-a27d-28218757f3fe,m=c690e8b1-93a0-4c95-9cd7-6437fff93251,m=f7c1e10d-3722-4891-887e-07b3c4104946 +Ключ: GUI/HideDescriptionForWizards, Значение: NewVM +Ключ: GUI/LastItemSelected, Значение: m=ol7u4 +Ключ: GUI/LastWindowPosition, Значение: 951,510,960,520 +Ключ: GUI/RecentFolderCD, Значение: C:/Users/user1 +Ключ: GUI/RecentListCD, Значение: C:\Users\user1\V1.iso,C:\Users\user1\V2.iso,C:\Users\user1\V3.iso +Ключ: GUI/SplitterSizes, Значение: 318,637 +Ключ: GUI/SuppressMessages, Значение: remindAboutMouseIntegration,remindAboutAutoCapture +Ключ: GUI/Toolbar/MachineTools/Order, Значение: Details +Ключ: GUI/Tools/LastItemsSelected, Значение: Welcome,Details +Ключ: GUI/UpdateCheckCount, Значение: 71 +Ключ: GUI/UpdateDate, Значение: 1 d, 2019-04-10, stable, 5.2.22 +Ключ: GUI/VirtualMediaManager/Details/Expanded, Значение: true</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-setextradata" /> + </para> + </refsect1> +</refentry> 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> diff --git a/doc/manual/ru_RU/man_VBoxManage-guestproperty.xml b/doc/manual/ru_RU/man_VBoxManage-guestproperty.xml new file mode 100644 index 00000000..772def2d --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-guestproperty.xml @@ -0,0 +1,334 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage guestproperty +--> +<!-- + 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-guestproperty" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage guestproperty</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-guestproperty</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-guestproperty</refname> + <refpurpose>управляет гостевыми свойствами виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-guestproperty-get"> + <command>VBoxManage guestproperty get</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + <arg>--verbose</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-guestproperty-enumerate"> + <command>VBoxManage guestproperty enumerate</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--patterns=<replaceable>шаблоны</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-guestproperty-set"> + <command>VBoxManage guestproperty set</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + <arg><replaceable>значение-свойства</replaceable><arg>--flags=<replaceable>флаги</replaceable></arg></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-guestproperty-unset"> + <command>VBoxManage guestproperty unset</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-guestproperty-wait"> + <command>VBoxManage guestproperty wait</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>шаблоны</replaceable></arg> + <arg>--timeout=<replaceable>миллисекунды</replaceable></arg> + <arg>--fail-on-timeout</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage guestproperty</command> позволяет + установить или получить свойства работающей виртуальной машины (ВМ). + Смотрите <xref linkend="guestadd-guestprops" />. Гостевые свойства - + это произвольные пары строк в виде имя-значение, которые могут + быть записаны и прочтены как с гостевой системы так и с хоста. + В результате эти свойства могут быть использованы как канал + связи небольшого объема для строк при условии, что гость работает + и установлены Дополнения Гостевой ОС. Также, Дополнения + Гостевой ОС автоматически устанавливают и поддерживают значения + ключей, начинающихся с <literal>/VirtualBox/</literal>. + </para> + <refsect2> + <title>Общие командные операнды</title> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-guestproperty-enumerate"> + <title>Показать все свойства виртуальной машины</title> + <para> + Команда <command>VBoxManage guestproperty enumerate</command> + показывает каждое гостевое свойство и его значение для + указанной ВМ. Заметим, что вывод ограничен если невозможно + подсоединиться к процессу гостевой службы, например потому + что ВМ не работает или не установлены Дополнения Гостевой ОС. + </para> + <variablelist> + <varlistentry> + <term><option>--patterns=<replaceable>шаблон</replaceable></option></term> + <listitem><para> + Фильтрует список свойств основанный на указанном + шаблоне, который может содержать следующие + подстановочные знаки: + </para><variablelist> + <varlistentry> + <term><literal>*</literal> (звездочка)</term> + <listitem><para> + Представляет любое количество произвольных символов. + Например, шаблон <literal>/VirtualBox*</literal> + соответствует всем свойствам, начинающимся с + <literal>/VirtualBox</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>?</literal> (знак вопроса)</term> + <listitem><para> + Представляет один произвольный символ. Например + шаблон <literal>fo?</literal> соответствует и + <literal>foo</literal> и <literal>for</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>|</literal> (канал)</term> + <listitem><para> + Задает несколько альтернативных шаблонов. + Например шаблон <literal>s*|t*</literal> + соответствует свойствам, начинающимся с + <literal>s</literal> или <literal>t</literal>. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-guestproperty-get"> + <title>Получить значение свойства виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage guestproperty get</command> + получает значение указанного свойства. Если свойство не + найдено, например, потому что гостевая система сейчас не + работает, команда выдает следующее сообщение: + </para> +<screen>No value set!</screen> + <variablelist> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--verbose</option></term> + <listitem><para> + Выдает значение свойства, метку времени и любые указанные + аттрибуты значения. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-guestproperty-set"> + <title>Задать значение свойства для виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage guestproperty set</command> позволяет + задать свойство гостевой системы, указывая свойство и его значение. + Если значение опущено, свойство удаляется. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>значение-свойства</replaceable></term> + <listitem><para> + Указывает значение свойства. Если значение не указано, + существующее значение удаляется. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--flags=<replaceable>флаги</replaceable></option></term> + <listitem><para> + Задает дополнительные аттрибуты значения. Могут быть указаны + следующие аттрибуты в виде списка значений разделенных запятыми: + </para><variablelist> + <varlistentry> + <term><literal>TRANSIENT</literal></term> + <listitem><para> + Удаляет значение с данными ВМ при завершении ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>TRANSRESET</literal></term> + <listitem><para> + Удаляет значение при завершении или рестарте ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>RDONLYGUEST</literal></term> + <listitem><para> + Задает значение, которое может быть изменено только + хостом. Гостевая система может только прочитать + значение свойства. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>RDONLYHOST</literal></term> + <listitem><para> + Задает значение, которое может быть изменено только + гостевой системой. Хост может только прочитать + значение свойства. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>READONLY</literal></term> + <listitem><para> + Задает неизменяемое значение. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-guestproperty-wait"> + <title>Ожидать создания, удаления или изменения значения свойства</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage guestproperty wait</command> ожидает + создания, удаления или изменения определенного свойства, + описанного строкой шаблона. + </para> + <variablelist> + <varlistentry> + <term><replaceable>шаблоны</replaceable></term> + <listitem><para> + Задает шаблон, соответствующий свойствам, необходимым + для ожидания. По информации о подстановочных знаках + в шаблоне смотрите описание опции + <option>--patterns</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--timeout<replaceable>миллисекунды</replaceable></option></term> + <listitem><para> + Задает количество миллисекунд ожидания. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--fail-on-timeout</option></term> + <listitem><para> + Указывает, что команда должна закончиться неудачей + если достигнут порог ожидания. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-guestproperty-unset"> + <title>Удалить значение свойства виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage guestproperty unset</command> + удаляет значение гостевого свойства. + </para> + <para> + Альтернативная формат этой подкоманды <command>delete</command>. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда выдает список гостевых свойств и их значений + для ВМ <literal>win8</literal>. + </para> +<screen>$ VBoxManage guestproperty enumerate win8</screen> + <para> + Следующая команда создает гостевое свойство называемое + <literal>region</literal> для ВМ <literal>win8</literal>. + Значение свойства устанавливается в <literal>west</literal>. + </para> +<screen>$ VBoxManage guestproperty set win8 region west</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-hostonlyif.xml b/doc/manual/ru_RU/man_VBoxManage-hostonlyif.xml new file mode 100644 index 00000000..8ad67bd1 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-hostonlyif.xml @@ -0,0 +1,199 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage hostonlyif +--> +<!-- + 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-hostonlyif" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage hostonlyif</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-hostonlyif</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-hostonlyif</refname> + <refpurpose>управление сетевыми интерфейсами хоста</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-ipconfig"> + <command>VBoxManage hostonlyif ipconfig</command> + <arg choice="req"><replaceable>имя-интерфейса</replaceable></arg> + <group> + <arg choice="plain">--dhcp</arg> + <arg choice="plain">--ip=<replaceable>IPv4-адрес</replaceable> <arg>--netmask=<replaceable>IPv4-маска</replaceable></arg></arg> + <arg choice="plain">--ipv6=<replaceable>IPv6-адрес</replaceable> <arg>--netmasklengthv6=<replaceable>длина</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-create"> + <command>VBoxManage hostonlyif create</command> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-remove"> + <command>VBoxManage hostonlyif remove</command> + <arg choice="req"><replaceable>имя-интерфейса</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage hostonlyif</command> позволяет + изменить IP конфигурацию интерфейса сети хоста. + Описание сетей хоста смотрите <xref linkend="network_hostonly" />. + Каждый интерфейс сети хоста идентифицируется через имя и + может использовать внутренний DHCP сервер или ручную настройку + IP, как IPv4 так и IPv6. + </para> + <refsect2 id="vboxmanage-hostonlyif-ipconfig"> + <title>Настроить интерфейс сети хоста</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage hostonlyif ipconfig</command> + настраивает интерфейс сети хоста. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-интерфейса</replaceable></term> + <listitem><para> + Задает имя сетевого интерфейса. Имя в форме + <literal>vboxnet</literal><replaceable>N</replaceable>, + где <replaceable>N</replaceable> - это экземпляр + интерфейса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dhcp</option></term> + <listitem><para> + Использует DHCP для сетевого интерфейса. + </para><para> + Эта опция не может использоваться с опциями + <option>--ip</option>, <option>--ipv6</option>, + <option>--netmask</option> и + <option>--netmasklengthv6</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ip=<replaceable>IPv4-адрес</replaceable></option></term> + <listitem><para> + Задает IPv4 адрес сетевого интерфейса. + </para><para> + Эта опция не может использоваться с опциями + <option>--dhcp</option>, <option>--ipv6</option> + и <option>--netmasklengthv6</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--netmask=<replaceable>IPv4-маска</replaceable></option></term> + <listitem><para> + Задает IPv4 маску сетевого интерфейса. Значение по + умолчанию <literal>255.255.255.0</literal>. + </para><para> + Эта опция не может использоваться с + опцией <option>--ip</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ipv6=<replaceable>IPv6-адрес</replaceable></option></term> + <listitem><para> + Задает IPv6 адрес сетевого интерфейса. + </para><para> + Эта опция не может использоваться с опциями + <option>--dhcp</option>, <option>--ip</option> + и <option>--netmask</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--netmasklengthv6=<replaceable>длина</replaceable></option></term> + <listitem><para> + Задает длину сетевого интерфейса IPv6. Значение по + умолчанию <literal>64</literal>. + </para><para> + Можно использовать эту опцию только с + опцией <option>--ipv6</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-hostonlyif-create"> + <title>Создать сетевой интерфейс в хост-системе</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage hostonlyif create</command> создает + новый интерфейс сети хоста в операционной сети хоста (ОС). + Имя сетевого интерфейса в форме + <literal>vboxnet</literal><replaceable>N</replaceable>, где + <replaceable>N</replaceable> это экземпляр интерфейса. Эта + команда должна запускаться перед тем, как подключать виртуальные + машины (ВМ) к сети хоста. + </para> + </refsect2> + <refsect2 id="vboxmanage-hostonlyif-remove"> + <title>Удалить сетевой интерфейс из хост-системы</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage hostonlyif remove</command> + удаляет указанный интерфейс сети хоста из ОС хоста. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-интерфейса</replaceable></term> + <listitem><para> + Задает имя сетевого интерфейса. Имя в форме + <literal>vboxnet</literal><replaceable>N</replaceable>, + где <replaceable>N</replaceable> - это экземпляр + интерфейса. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает новый интерфейс сети хоста. + </para> +<screen>$ VBoxManage hostonlyif create +0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% +Интерфейс 'vboxnet2' создан успешно</screen> + <para> + Следующая команда настраивает адрес IPv4 для интерфейса + сети хоста <literal>vboxnet2</literal>. + </para> +<screen>$ VBoxManage hostonlyif ipconfig vboxnet2 --ip 10.0.2.18</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-hostonlynet.xml b/doc/manual/ru_RU/man_VBoxManage-hostonlynet.xml new file mode 100644 index 00000000..ee1ee506 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-hostonlynet.xml @@ -0,0 +1,164 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage hostonlynet +--> +<!-- + Copyright (C) 2021-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-hostonlynet" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage hostonlynet</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-hostonlynet</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-hostonlynet</refname> + <refpurpose>управление сетью хоста</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-hostonlynet-add"> + <command>VBoxManage hostonlynet add</command> + <arg choice="req">--name=<replaceable>имя-сети</replaceable></arg> + <arg choice="opt">--id=<replaceable>id-сети</replaceable></arg> + <arg choice="req">--netmask=<replaceable>маска</replaceable></arg> + <arg choice="req">--lower-ip=<replaceable>адрес</replaceable></arg> + <arg choice="req">--upper-ip=<replaceable>адрес</replaceable></arg> + <group choice="opt"> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-hostonlynet-modify"> + <command>VBoxManage hostonlynet modify</command> + <group choice="req"> + <arg choice="plain">--name=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--id=<replaceable>id-сети</replaceable></arg> + </group> + <arg choice="opt">--lower-ip=<replaceable>адрес</replaceable></arg> + <arg choice="opt">--upper-ip=<replaceable>адрес</replaceable></arg> + <arg choice="opt">--netmask=<replaceable>маска</replaceable></arg> + <group choice="opt"> + <arg choice="plain">--enable</arg> + <arg choice="plain">--disable</arg> + </group> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-hostonlynet-remove"> + <command>VBoxManage hostonlynet remove</command> + <group choice="req"> + <arg choice="plain">--name=<replaceable>имя-сети</replaceable></arg> + <arg choice="plain">--id=<replaceable>id-сети</replaceable></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <para> + Команда <command>hostonlynet</command> позволяет управлять сетями + хоста. + </para> + + <refsect2 id="vboxmanage-hostonlynet-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> Все подкоманды <command>hostonlynet</command> оперируют над + сетью хоста, идентифицируемой через ее имя или UUID:</para> + <variablelist> + <varlistentry> + <term>--name=<replaceable>имя-сети</replaceable></term> + <listitem><para>Имя сети хоста. Его можно увидеть в поле + VBoxNetworkName вывода команды + <command>VBoxManage list hostonlynets</command>. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--id=<replaceable>id-сети</replaceable></term> + <listitem><para>UUID сети хоста. Если не указан при добавлении + новой сети, то будет сгенерирован автоматически. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-hostonlynet-add"> + <title>hostonlynet add</title> + <remark role="help-copy-synopsis"/> + <para> + Добавляет новую сеть хоста. + </para> + <para> + Опции для настройки сети хоста: + </para> + <variablelist> + <varlistentry> + <term><option>--netmask=<replaceable>маска</replaceable></option></term> + <listitem><para>Сетевая маска. Обычно 255.255.255.0.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lower-ip=<replaceable>адрес</replaceable></option>, <option>--upper-ip=<replaceable>адрес</replaceable></option></term> + <listitem><para> Диапазон IP адресов, распределяемых через DHCP. + Верхняя границы включается, тогда как нижняя - нет, поэтому + верхний адрес будет также распределен клиентам, тогда как + нижний используется самим хостом.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option>, --disable</term> + <listitem><para>Должная ли сеть хоста быть включена или выключена. Если не указано, + сеть создается во включенном состоянии.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-hostonlynet-modify"> + <title>hostonlynet modify</title> + <remark role="help-copy-synopsis"/> + <para> + Команда модифицирует существующую конфигурацию сети хоста. Она принимает те же + опции что и команда <command>add</command>. + </para> + </refsect2> + + <refsect2 id="vboxmanage-hostonlynet-remove"> + <title>hostonlynet remove</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет указанную сеть хоста. + </para> + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-import.xml b/doc/manual/ru_RU/man_VBoxManage-import.xml new file mode 100644 index 00000000..91d60d97 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-import.xml @@ -0,0 +1,456 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage import +--> +<!-- + 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-import" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage import</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-import</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-import</refname> + <refpurpose>импорт виртуальной конфигурации в формате OVF или из облачной службы и создание виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-import-ovf"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage import</command> + <group choice="req"> + <arg choice="plain"><replaceable>имя-ovf</replaceable></arg> + <arg choice="plain"><replaceable>имя-ova</replaceable></arg> + </group> + <arg>--dry-run</arg> + <arg>--options=<group choice="plain"> + <arg choice="plain">keepallmacs</arg> + <arg choice="plain">keepnatmacs</arg> + <arg choice="plain">importtovdi</arg> + </group></arg> + <arg>--vsys=<replaceable>n</replaceable></arg> + <arg>--ostype=<replaceable>тип-ос</replaceable></arg> + <arg>--vmname=<replaceable>имя</replaceable></arg> + <arg>--settingsfile=<replaceable>файл</replaceable></arg> + <arg>--basefolder=<replaceable>папка</replaceable></arg> + <arg>--group=<replaceable>группа</replaceable></arg> + <arg>--memory=<replaceable>МБ</replaceable></arg> + <arg>--cpus=<replaceable>n</replaceable></arg> + <arg>--description=<replaceable>текст</replaceable></arg> + <arg>--eula=<group choice="plain"> + <arg choice="plain">show</arg> + <arg choice="plain">accept</arg> + </group></arg> + <arg>--unit=<replaceable>n</replaceable></arg> + <arg>--ignore</arg> + <arg>--scsitype=<group choice="plain"> + <arg choice="plain">BusLogic</arg> + <arg choice="plain">LsiLogic</arg> + </group></arg> + <!-- <arg>--controller=<replaceable>n</replaceable></arg> --> + <arg>--disk=<replaceable>путь</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-import-cloud"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage import</command> + <arg choice="plain">OCI://</arg> + <arg choice="plain">--cloud</arg> + <arg>--ostype=<replaceable>тип-ос</replaceable></arg> + <arg>--vmname=<replaceable>имя</replaceable></arg> + <arg>--basefolder=<replaceable>папка</replaceable></arg> + <arg>--memory=<replaceable>МБ</replaceable></arg> + <arg>--cpus=<replaceable>n</replaceable></arg> + <arg>--description=<replaceable>текст</replaceable></arg> + <arg choice="req">--cloudprofile=<replaceable>профиль</replaceable></arg> + <arg choice="req">--cloudinstanceid=<replaceable>id</replaceable></arg> + <arg>--cloudbucket=<replaceable>корзина</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage import</command> импортирует виртуальную + конфигурацию из формата OVF или из облачной службы, например &oci;. + Импорт производится путем копирования образов виртуальных дисков + (по умолчанию в формает VMDK образа) и создания виртуальных машин (ВМ) + в &product-name;. Смотрите <xref linkend="ovf" />. + </para> + <para> + Необходимо указать путь к OVF файлу или OVA архиву в качестве входных + данных или заполнитель для облачного варианта. В случае OVF конфигураций, + убедитесь, что все образы дисков в той же директории, что и OVF файл. + </para> + <para> + Обратите внимание, что любые опции, указываемые для управления + импортированной виртуальной конфигурацией или для изменения + параметров импорта зависят от содержимого файла OVF или от + информации из облачной службы. + </para> + <para> + Перед использованием операции импорта для создания ВМ, произведите + пробный запуск для проверки корректности вашей конфигурации. Это + полезно с конфигурациями OVF и OVA, потому что в случае с облачной + службой, даже при пробном запуске необходимо произвести достаточно + много действий, занимающих ощутимое время. + </para> + <para> + Импорт из облачной службы загружает временный файл, содержащий и + загрузочный образ и некоторые метаданные, описывающие детали + экземпляра ВМ. Временный файл удаляется после успешного импорта. + </para> + <refsect2> + <title>Общие параметры</title> + <variablelist> + <varlistentry> + <term><replaceable>имя-ovf</replaceable> | <replaceable>имя-ova</replaceable></term> + <listitem><para> + Задает имя файла OVF или архив OVA, описывающий конфигурацию. + В случае облака, это обычно фиксированная строка, такая как + <literal>OCI://</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dry-run</option></term> + <!-- Does this option really work for cloud import? --> + <listitem><para> + Производит пробный запуск команды <command>VBoxManage + import</command> перед проведением реальной операции + импорта. Операция пробного запуска делает следующее: + </para><itemizedlist> + <listitem><para> + Выводит описание содержимого конфигурации, основанное + на указанном OVF или OVA файле. + </para></listitem> + <listitem><para> + Показывает, как конфигурация могла быть импортирована + в &product-name;. В дополнение, вывод показывает все + опции, которые можно использовать для изменения + поведения импорта. + </para></listitem> + </itemizedlist><para> + Краткая форма этой опции <option>-n</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--options=keepallmacs | keepnatmacs | importtovdi</option></term> + <!-- Does this option really work for cloud import? --> + <listitem><para> + Позволяет подстроить операцию импорта. + </para><para> + Допустимые аргументы нижеследующие: + </para><itemizedlist> + <listitem><para> + <literal>keepallmacs</literal>: Указывает, что + MAC адреса каждой виртуальной сетевой карты + остаются неизменными. + </para></listitem> + <listitem><para> + <literal>keepnatmacs</literal>: Указывает, что + MAC адреса каждой виртуальной сетевой карты + остаются неизменными если тип сети - NAT. + </para></listitem> + <listitem><para> + <literal>importtovdi</literal>: Указывает, что + все новые образы дисков в формате файла VDI. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--ostype=<replaceable>тип-ос</replaceable></option></term> + <listitem><para> + Задает информацию о гостевой операционной системе (ОС) для + ВМ. Используйте команду <command>VBoxManage list ostypes</command> + для отображения идентификаторов типов ОС. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vmname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя ВМ в &product-name;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--basefolder=<replaceable>папка</replaceable></option></term> + <!-- Does this option really work for cloud import? --> + <listitem><para> + Задает папку, где сохраняются файлы импортированной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--memory=<replaceable>МБ</replaceable></option></term> + <listitem><para> + Задает размер памяти в мегабайтах в импортированной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpus=<replaceable>n</replaceable></option></term> + <listitem><para> + Задает количество ЦПУ в импортированной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>текст</replaceable></option></term> + <listitem><para> + Задает текст описания, видимый в графическом и командном + интерфейсе при проверке деталей ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-import-ovf"> + <title>Опции импорта OVF / OVA</title> + <para> + Следующие опции предназначены для импорта виртуальной конфигурации + в форматах OVF или OVA. Такие конфигурации могут содержать один или + несколько ВМ. Поэтому требуется указать, какую конфигурацию ВМ надо + подстроить если вы хотите изменить ее. Смотрите + <xref linkend="ovf-import-appliance" />. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--vsys=<replaceable>n</replaceable></option></term> + <listitem><para> + Задает индекс конкретной ВМ внутри конфигурации. Влияет + на нижеследующие опции. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unit=<replaceable>n</replaceable></option></term> + <listitem><para> + Задает индекс конкретного элемента ВМ внутри конфигурации. + Влияет на нижеследующие опции. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--settingsfile=<replaceable>файл</replaceable></option></term> + <listitem><para> + Задает имя файла настроек ВМ (с указанием пути или без), + который будет создан как часть импорта. Обычно, более + предпочтительный способ это переопределение имени ВМ через + <option>--vmname</option> и, если нужно, указание папки, + где надо создать ВМ, через <option>--basefolder</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--group=<replaceable>группа</replaceable></option></term> + <listitem><para> + Задает первичную группу импортированной ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--eula=show | accept</option></term> + <listitem><para> + Позволяет вам отобразить или принять условия лицензии ВМ + внутри конфигурации. + </para><para> + Допустимы следующие аргументы: + </para><itemizedlist> + <listitem><para> + <literal>show</literal>: Показывает лицензионное соглашение ВМ. + </para></listitem> + <listitem><para> + <literal>accepts</literal>: Принимает лицензионное соглашение ВМ. + Все ВМ в конфигурации, имеющие лицензию, требуют ее принятия, + иначе импорт закончится неудачей. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--ignore</option></term> + <listitem><para> + Игнорирует текущий элемент импортируемой ВМ, эффективно + удаляя связанное аппаратное обеспечение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--scsitype=BusLogic | LsiLogic</option></term> + <listitem><para> + Позволяет выбрать тип SCSI контроллера текущего элемента + импортированной ВМ. + </para><para> + Допустимы следующие аргументы: + </para><itemizedlist> + <listitem><para> + <literal>BusLogic</literal>: Использует SCSI контроллер + типа BusLogic (очень старый). + </para></listitem> + <listitem><para> + <literal>LsiLogic</literal>: Использует SCSI контроллер + типа LsiLogic (более современный). + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-import-cloud"> + <title>Опции импорта из облака</title> + <para> + Следующие опции предназначены для импорта экземпляра ВМ из + провайдера облачной службы. Они всегда имеют дело только + с одной ВМ. Смотрите <xref linkend="cloud-import-oci" />. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--cloud</option></term> + <listitem><para> + Указывает, что импорт должен быть из облака. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudprofile=<replaceable>профиль</replaceable></option></term> + <listitem><para> + Задает облачный профиль используемый для соединения с + провайдером облачной службы. Облачный профиль содержит + детали вашей учетной записи &oci;, такие как ваш OCID + пользователя и отпечаток вашего публичного ключа. У вас + должны быть требуемые права в &oci;, чтобы использовать + облачный профиль. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudinstanceid=<replaceable>id</replaceable></option></term> + <listitem><para> + Задает ID существующего экземпляра в облаке. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cloudbucket=<replaceable>корзина</replaceable></option></term> + <listitem><para> + Задает имя корзины, куда сохранять объекты, созданные из + экземпляра. В &oci;, корзина - это логический контейнер для + сохранения объектов. По умолчанию, используется первая + доступная корзина в облачном профиле. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующий пример производит пробный запуск операции OVF импорта + примерной конфигурации, содержащей гостевую систему Windows 10: + </para> +<screen>$ VBoxManage import Windows10.ovf --dry-run +Интерпретация Windows10.ovf... +OK. +Виртуальная система 0: + 0: Предложенный тип ОС: "Windows10_64" + (изменить через "--vsys 0 --ostype <тип>"; используйте "list ostypes" для просмотра всех возможных значений) + 1: Предложенное имя ВМ "win10-appliance" + (изменить через "--vsys 0 --vmname <имя>") + 2: Предложенная группа ВМ "/" + (изменить через "--vsys 0 --group <группа>") + 3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox" + (изменить через "--vsys 0 --settingsfile <имя файла>") + 4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs" + (изменить через "--vsys 0 --basefolder <путь>") + 5: Лицензионное соглашение + (показать через "--vsys 0 --eula show"; + принять через "--vsys 0 --eula accept") + 6: Число ЦПУ: 1 + (изменить через "--vsys 0 --cpus <n>") + 7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory <MB>") + 8: Аудио карта (конфигурация ожидает "ensoniq1371", может быть изменена при импорте) + (отключить через "--vsys 0 --unit 5 --ignore") + 9: USB контроллер + (отключить через "--vsys 0 --unit 6 --ignore") +10: Сетевой адаптер: ориг. сетевой мост, конфиг. 2, экстра тип=сетевой мост +11: Флоппи + (отключить через "--vsys 0 --unit 8 --ignore") +12: SCSI контроллер, тип BusLogic + (изменить через "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}"; + отключить через "--vsys 0 --unit 9 --ignore") +13: IDE контроллер, тип PIIX4 + (отключить через "--vsys 0 --unit 10 --ignore") +14: Образ жесткого диска: образ источника=Windows10.vmdk, + путь назначения=/home/user1/disks/Windows10.vmdk, контроллер=9;канал=0 + (изменить путь назначения через "--vsys 0 --unit 11 --disk <путь>"; + отключить через "--vsys 0 --unit 11 --ignore")</screen> + <para> + Вывод пробного запуска показывает и нумерует индивидуальные + элементы настройки описанные в файле + <filename>Windows10.ovf</filename>. Некоторые из них включают + информацию о том, как отключить или изменить настройку элемента. + </para> + <para> + Можно отключить многие элементы, используя опции <option>--vsys + <replaceable>X</replaceable> --unit <replaceable>Y</replaceable> + --ignore</option>. <replaceable>X</replaceable> - это номер + виртуальной системы. Значение равно <literal>0</literal> если + конфигурация содержит только одно описание виртуальной системы. + <replaceable>Y</replaceable> - это номер элемента конфигурации. + </para> + <para> + Элемент 1 в выводе команды примера указывает имя целевой машины. + Элементы 12 и 13 указывают контроллеры IDE и SCSI жестких дисков + соответственно. + </para> + <para> + Элемент 14 показывает образ жесткого диска и опцию + <option>--disk</option>, задающую путь назначения, где сохранять + образ. Значение по умолчанию задается в файле OVF. + </para> + <para> + Можно комбинировать несколько элементов для той же самой + виртуальной системы, путем указания того же самого значения + для опции <option>--vsys</option>. Например, используйте + следующую команду для импорта машины как описано в OVF, + кроме аудио карты и USB контроллера, и образ диска должен + сохраняться с другим именем. + </para> +<screen>$ VBoxManage import Windows10.ovf --vsys 0 --unit 8 --ignore \ + --unit 9 --ignore --unit 14 --disk Windows10_disk0.vmdk</screen> + <para> + Следующий пример иллюстрирует как импортировать ВМ из &oci;. Для поиска + экземпляров ВМ в &oci;, а также их ID, можно вывести список всех доступных + экземпляров через: + </para> +<screen>$ VBoxManage cloud --provider=OCI --profile=<replaceable>имя-облачного-профиля</replaceable> list instances</screen> + <para> + Когда ID известно, следующая команда импортирует экземпляр из &oci;: + </para> +<screen>$ VBoxManage import OCI:// --cloud --vmname OCI_FreeBSD_VM --memory 4000 \ + --cpus 3 --ostype FreeBSD_64 --cloudprofile "standard user" \ + --cloudinstanceid ocid1.instance.oc1.iad.abuwc... --cloudbucket myBucket</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-list.xml b/doc/manual/ru_RU/man_VBoxManage-list.xml new file mode 100644 index 00000000..b2580b6a --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-list.xml @@ -0,0 +1,522 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage list +--> +<!-- + 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-list" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage list</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-list</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-list</refname> + <refpurpose>просмотр системной информации и детали конфигурации ВМ</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-list"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage list</command> + <arg>--long</arg> + <arg>--sorted</arg> + <group> + <arg choice="plain">bridgedifs</arg> + <arg choice="plain">cloudnets</arg> + <arg choice="plain">cloudprofiles</arg> + <arg choice="plain">cloudproviders</arg> + <arg choice="plain">cpu-profiles</arg> + <arg choice="plain">dhcpservers</arg> + <arg choice="plain">dvds</arg> + <arg choice="plain">extpacks</arg> + <arg choice="plain">floppies</arg> + <arg choice="plain">groups</arg> + <arg choice="plain">hddbackends</arg> + <arg choice="plain">hdds</arg> + <arg choice="plain">hostcpuids</arg> + <arg choice="plain">hostdrives</arg> + <arg choice="plain">hostdvds</arg> + <arg choice="plain">hostfloppies</arg> + <arg choice="plain">hostinfo</arg> + <arg choice="plain">hostonlyifs</arg> + <arg choice="plain">hostonlynets</arg> + <arg choice="plain">intnets</arg> + <arg choice="plain">natnets</arg> + <arg choice="plain">ostypes</arg> + <arg choice="plain">runningvms</arg> + <arg choice="plain">screenshotformats</arg> + <arg choice="plain">systemproperties</arg> + <arg choice="plain">usbfilters</arg> + <arg choice="plain">usbhost</arg> + <arg choice="plain">vms</arg> + <arg choice="plain">webcams</arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Подкоманды <command>VBoxManage list</command> позволяют получить + информацию о ПО &product-name;, ВМ и соответствующих службах, + созданных вами. + </para> + <refsect2 id="vboxmanage-list-common-options"> + <title>Общие настройки</title> + <variablelist> + <varlistentry> + <term><option>--long</option></term> + <listitem><para> + Показывает детальную информацию по каждому элементу, + если она доступна. Краткая форма этой опции: + <option>-l</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--sorted</option></term> + <listitem><para> + Сортирует элементы детального списка по алфавиту. + Краткая форма этой опции: <option>-s</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-list-bridgedifs"> + <title>Отображение сетевых интерфейсов типа "Сетевой мост" в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-bridgedifs"> + <command>VBoxManage list</command> + <arg choice="plain">bridgedifs</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list bridgedifs</command> отображает + интерфейсы типа "сетевой мост", доступные на данный момент + в системе хоста. Вывод показывает детальную информацию о конфигурации + каждого интерфейса. Смотрите <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-cloudnets"> + <title>Отображение облачных сетевых интерфейсов</title> + <cmdsynopsis id="synopsis-vboxmanage-list-cloudnets"> + <command>VBoxManage list</command> + <arg choice="plain">cloudnets</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list cloudnets</command> отображает + сконфигурированные облачные сетевые интерфейсы. Облачный сетевой + интерфейс обеспечивает соединение между локальной ВМ и облачной + сетью. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-cloudprofiles"> + <title>Отображение облачных профилей</title> + <cmdsynopsis id="synopsis-vboxmanage-list-cloudprofiles"> + <command>VBoxManage list</command> + <arg choice="plain">cloudprofiles</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list cloudprofiles</command> отображает + сконфигурированные облачные профили. Облачный профиль содержит + настройки для учетной записи службы облака. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-cloudproviders"> + <title>Отображение облачных провайдеров</title> + <cmdsynopsis id="synopsis-vboxmanage-list-cloudproviders"> + <command>VBoxManage list</command> + <arg choice="plain">cloudproviders</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list cloudproviders</command> показывает + облачных провайдеров, поддерживаемых &product-name;. + Примером облачного провайдера является Oracle Cloud Infrastructure. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-cpu-profiles"> + <title>Отображение известных профилей ЦПУ</title> + <cmdsynopsis id="synopsis-vboxmanage-list-cpu-profiles"> + <command>VBoxManage list</command> + <arg choice="plain">cpu-profiles</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list cpu-profiles</command> отображает + ЦПУ профили, известные в &product-name;. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-dhcpservers"> + <title>Отображение DHCP серверов в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-dhcpservers"> + <command>VBoxManage list</command> + <arg choice="plain">dhcpservers</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list dhcpservers</command> отображает + DHCP серверы, доступные в хост-системе. Вывод показывает + детальную информацию о конфигурации каждого DHCP сервера. + Смотрите <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-dvds"> + <title>Отображение образов виртуальных дисков DVD</title> + <cmdsynopsis id="synopsis-vboxmanage-list-dvds"> + <command>VBoxManage list</command> + <arg choice="plain">dvds</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list dvds</command> отображает + информацию об образах виртуальных дисков DVD, используемых + в данный момент в ПО &product-name;. Для каждого образа + вывод показывает все настройки, UUID, назначенные образу + в &product-name; и все файлы связанные с образом. + </para> + <para> + Эта команда выполняет ту же функцию, что и Менеджер виртуальных + носителей. Смотрите <xref linkend="virtual-media-manager"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-extpacks"> + <title>Отображение установленных пакетов расширения &product-name;</title> + <cmdsynopsis id="synopsis-vboxmanage-list-extpacks"> + <command>VBoxManage list</command> + <arg choice="plain">extpacks</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list extpacks</command> показывает + все пакеты расширения &product-name;, установленные в системе + на данный момент. Смотрите <xref linkend="intro-installing"/> и + <xref linkend="vboxmanage-extpack"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-floppies"> + <title>Отображение образов виртуальных флоппи дисков</title> + <cmdsynopsis id="synopsis-vboxmanage-list-floppies"> + <command>VBoxManage list</command> + <arg choice="plain">floppies</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list floppies</command> отображает + информацию об образах флоппи дисков, используемых в &product-name; + на данный момент. Для каждого образа вывод показывает все настройки, + UUID, назначенные образу в &product-name; и все файлы связанные + с образом. + </para> + <para> + Эта команда выполняет ту же функцию, что и Менеджер виртуальных + носителей. Смотрите <xref linkend="virtual-media-manager"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-groups"> + <title>Отображение групп виртуальных машин</title> + <cmdsynopsis id="synopsis-vboxmanage-list-groups"> + <command>VBoxManage list</command> + <arg choice="plain">groups</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list groups</command> показывает + все группы ВМ. Смотрите <xref linkend="gui-vmgroups"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hddbackends"> + <title>Отображение бэкендов виртуальных дисков</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hddbackends"> + <command>VBoxManage list</command> + <arg choice="plain">hddbackends</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hddbackends</command> отображает + все известные бэкенды виртуальных дисков ПО &product-name; + Для каждого такого формата, таких как VDI, VMDK или RAW, эта + команда показывает конфигурацию и возможности бэкенда. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hdds"> + <title>Отображение образов виртуальных жестких дисков</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hdds"> + <command>VBoxManage list</command> + <arg choice="plain">hdds</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hdds</command> отображает + информацию об образах виртуальных жестких дисков, которые + используются ПО &product-name; на данный момент. Для каждого + образа вывод показывает все настройки, UUID, назначенные образу + в &product-name; и все файлы связанные с образом. + </para> + <para> + Эта команда выполняет ту же функцию, что и Менеджер виртуальных + носителей. Смотрите <xref linkend="virtual-media-manager"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostcpuids"> + <title>Отображение информации CPUID для ЦПУ хост-системы</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostcpuids"> + <command>VBoxManage list</command> + <arg choice="plain">hostcpuids</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostcpuids</command> отображает + информацию CPUID для каждого ЦПУ хост-системы. Используйте эту + информацию для более тщательного анализа возможностей + виртуализации в хост-системе. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostdrives"> + <title>Отображение дисков в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostdrives"> + <command>VBoxManage list</command> + <arg choice="plain">hostdrives</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostdrives</command> отображает + диски в хост-системе, потенциально полезные для создания образов + VMDK raw дисков. Каждый элемент включает имя, используемое для + ссылки на них из &product-name;. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostdvds"> + <title>Отображение DVD дисков в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostdvds"> + <command>VBoxManage list</command> + <arg choice="plain">hostdvds</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostdvds</command> отображает + DVD диски хост-системы. Каждый элемент включает имя, используемое + для доступа к ним из &product-name;. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostfloppies"> + <title>Отображение флоппи дисков в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostfloppies"> + <command>VBoxManage list</command> + <arg choice="plain">hostfloppies</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostfloppies</command> + отображает флоппи диски в хост-системе. Каждый элемент + включает имя, используемое для доступа к ним из &product-name;. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostinfo"> + <title>Отображение информации о хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostinfo"> + <command>VBoxManage list</command> + <arg choice="plain">hostinfo</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostinfo</command> отображает + информацию о хост-системе. Вывод включает информацию о ЦПУ, + памяти и версии ОС. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostonlyifs"> + <title>Отображение сетевых интерфейсов виртуальной сети хоста</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostonlyifs"> + <command>VBoxManage list</command> + <arg choice="plain">hostonlyifs</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostonlyifs</command> отображает + интерфейсы виртуальной сети хоста, доступные в системе на данный + момент. Вывод показывает детальную информацию о конфигурации + каждого интерфейса. Смотрите <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-hostonlynets"> + <title>Отображение виртуальных сетей хоста</title> + <cmdsynopsis id="synopsis-vboxmanage-list-hostonlynets"> + <command>VBoxManage list</command> + <arg choice="plain">hostonlynets</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list hostonlynets</command> отображает + сконфигурированные виртуальные сети хоста. Виртуальная сеть хоста + обеспечивает соединение между хостом и локальными ВМ. Смотрите + <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-intnets"> + <title>Отображение внутренних сетей</title> + <cmdsynopsis id="synopsis-vboxmanage-list-intnets"> + <command>VBoxManage list</command> + <arg choice="plain">intnets</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list intnets</command> показывает + информацию о внутренних сетях. Смотрите + <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-natnets"> + <title>Отображение интерфейсов сетей NAT в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-natnets"> + <command>VBoxManage list</command> + <arg choice="plain">natnets</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list natnets</command> отображает + интерфейсы сетей NAT, доступные в хост-системе на данный момент. + Смотрите <xref linkend="networkingdetails"/>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-ostypes"> + <title>Отображение гостевых операционных систем</title> + <cmdsynopsis id="synopsis-vboxmanage-list-ostypes"> + <command>VBoxManage list</command> + <arg choice="plain">ostypes</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list ostypes</command> отображает + все гостевые операционные системы, известные ПО &product-name;. + Каждый элемент включает идентификатор, описание, идентификатор + семейства, описание семейства и имеет ли ОС 64 битную поддержку. + </para> + <para> + Можно изспользовать эти идентификаторы с командой <command>VBoxManage + modifyvm</command>. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-runningvms"> + <title>Отображение работающих виртуальных машин</title> + <cmdsynopsis id="synopsis-vboxmanage-list-runningvms"> + <command>VBoxManage list</command> + <arg choice="plain">runningvms</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list runningvms</command> отображает + все виртуальные машины (ВМ), работающие на данный момент. По + умолчанию она показывает компактный список, содержащий имя и + UUID каждой машины. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-screenshotformats"> + <title>Отображение доступных форматов снимков экрана</title> + <cmdsynopsis id="synopsis-vboxmanage-list-screenshotformats"> + <command>VBoxManage list</command> + <arg choice="plain">screenshotformats</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list screenshotformats</command> показывает + список доступных форматов снимков экрана. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-systemproperties"> + <title>Отображение системных свойств</title> + <cmdsynopsis id="synopsis-vboxmanage-list-systemproperties"> + <command>VBoxManage list</command> + <arg choice="plain">systemproperties</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list systemproperties</command> показывает + большую коллекцию глобальных настроек &product-name; + и лимитов, таких как минимальный и максимальный размер RAM + гостевой системы, размер виртуального жесткого диска, настройки + папки и используемая в данный момент библиотека аутентификации. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-usbfilters"> + <title>Отображение зарегистрированных глобальных USB фильтров</title> + <cmdsynopsis id="synopsis-vboxmanage-list-usbfilters"> + <command>VBoxManage list</command> + <arg choice="plain">usbfilters</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list usbfilters</command> отображает + все глобальные USB фильтры зарегистрированные в &product-name; + и показывает параметры фильтра. Глобальные USB фильтры - это + фильтры для устройств, доступные всем виртуальным машинам. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-usbhost"> + <title>Отображение USB устройств в хост-системе</title> + <cmdsynopsis id="synopsis-vboxmanage-list-usbhost"> + <command>VBoxManage list</command> + <arg choice="plain">usbhost</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list usbhost</command> отображает + информацию об USB устройствах, подключенных к хост-системе. + Вывод включает информацию, которую можно использовать для + построения USB фильтров и показывает, используется ли + устройство хост-системой на данный момент. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-vms"> + <title> Отображение виртуальных машин</title> + <cmdsynopsis id="synopsis-vboxmanage-list-vms"> + <command>VBoxManage list</command> + <arg choice="plain">vms</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list vms</command> отображает + все виртуальные машины (ВМ), зарегистрированные в &product-name; + на данный момент. По умолчанию эта команда показывает компактный + список, включающий имя и UUID каждой машины. + </para> + </refsect2> + <refsect2 id="vboxmanage-list-webcams"> + <title>Отображение вебкамер, подключенных к работающей виртуальной машине</title> + <cmdsynopsis id="synopsis-vboxmanage-list-webcams"> + <command>VBoxManage list</command> + <arg choice="plain">webcams</arg> + </cmdsynopsis> + <para> + Команда <command>VBoxManage list webcams</command> показывает + список вебкамер, подключенных к работающей ВМ. + </para> + <para> + Вывод состоит из списка абсолютных путей или псевдонимов, + используемых для подключения вебкамер к ВМ, используя команду + <command>VBoxManage webcam attach</command>. + </para> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда показывает группы ВМ, сконфигурированные в + &product-name;. + </para> +<screen>$ VBoxManage list groups +"/Linux-VMs" +"/Windows-VMs"</screen> + <para> + Следующая команда показывает работающие на данный момент ВМ. + </para> +<screen>$ VBoxManage list runningvms +"ol7" {<replaceable>ol7-UUID</replaceable>} +"win8" {<replaceable>win8-UUID</replaceable>}</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-mediumio.xml b/doc/manual/ru_RU/man_VBoxManage-mediumio.xml new file mode 100644 index 00000000..880a9e52 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-mediumio.xml @@ -0,0 +1,179 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage mediumio +--> +<!-- + Copyright (C) 2018-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-mediumio" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage mediumio</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-mediumio</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-mediumio</refname> + <refpurpose>доступ к содержимому носителя</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-mediumio-formatfat"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage mediumio</command> + <group choice="req"> + <arg choice="plain">--disk=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--dvd=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--floppy=<replaceable>uuid|имя-файла</replaceable></arg> + </group> + <arg>--password-file=<replaceable>-|имя-файла</replaceable></arg> + <arg choice="plain">formatfat</arg> + <arg>--quick</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-mediumio-cat"> + <command>VBoxManage mediumio</command> + <group choice="req"> + <arg choice="plain">--disk=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--dvd=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--floppy=<replaceable>uuid|имя-файла</replaceable></arg> + </group> + <arg>--password-file=<replaceable>-|имя-файла</replaceable></arg> + <arg choice="plain">cat</arg> + <arg>--hex</arg> + <arg>--offset=<replaceable>смещение-байт</replaceable></arg> + <arg>--size=<replaceable>байты</replaceable></arg> + <arg>--output=<replaceable>-|имя-файла</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-mediumio-stream"> + <command>VBoxManage mediumio</command> + <group choice="req"> + <arg choice="plain">--disk=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--dvd=<replaceable>uuid|имя-файла</replaceable></arg> + <arg choice="plain">--floppy=<replaceable>uuid|имя-файла</replaceable></arg> + </group> + <arg>--password-file=<replaceable>-|имя-файла</replaceable></arg> + <arg choice="plain">stream</arg> + <arg>--format=<replaceable>формат-образа</replaceable></arg> + <arg>--variant=<replaceable>вариант-образа</replaceable></arg> + <arg>--output=<replaceable>-|имя-файла</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-mediumio-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Все подкоманды <command>mediumio</command> оперируют носителем, который должен быть указан вместе с паролем + шифрования (необязательно). Следующие общие опции могут быть помещены перед или после подкоманд:</para> + <variablelist> + <varlistentry> + <term>--disk=<replaceable>uuid|имя-файла</replaceable></term> + <listitem><para>UUID или имя файла образа жесткого диска, например VDI, VMDK, VHD, и т.д.</para></listitem> + </varlistentry> + <varlistentry> + <term>--dvd=<replaceable>uuid|имя-файла</replaceable></term> + <listitem><para>UUID или имя файла образа DVD, например ISO, DMG, CUE.</para></listitem> + </varlistentry> + <varlistentry> + <term>--floppy=<replaceable>uuid|имя-файла</replaceable></term> + <listitem><para>UUID или имя файла образа флоппи, например IMG.</para></listitem> + </varlistentry> + <varlistentry> + <term>--password-file=<replaceable>-|имя-файла</replaceable></term> + <listitem><para>Имя файла, содержащего пароль шифрования носителя. Если указана опция <option>-</option>, + пароль читается из стандартного потока ввода. </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-mediumio-formatfat"> + <title>mediumio formatfat</title> + <remark role="help-copy-synopsis"/> + <para> + Форматирует носитель флоппи диска файловой системой FAT. Эта команда удаляет + содержимое носителя. + </para> + <variablelist> + <varlistentry> + <term><option>--quick</option></term><listitem><para>Быстрое форматирование носителя.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-mediumio-cat"> + <title>mediumio cat</title> + <remark role="help-copy-synopsis"/> + <para> + Сбрасывает содержимое носителя в стандартный поток вывода или в указанный файл. + </para> + <variablelist> + <varlistentry> + <term><option>--hex</option></term><listitem><para>Сбросить как hex байты.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--offset</option></term><listitem><para>Смещение в байтах с начала носителя, откуда начинать сброс дампа.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--size</option></term><listitem><para>Количество байтов для сброса.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--output</option></term> + <listitem><para>Имя выходного файла. Как обычно, <option>-</option> подразумевает стандартный поток вывода.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-mediumio-stream"> + <title>mediumio stream</title> + <remark role="help-copy-synopsis"/> + <para> + Преобразует носитель в потоковый формат и сбрасывает его в указанный выход. + </para> + <variablelist> + <varlistentry> + <term><option>--format</option></term><listitem><para>Формат образа назначения.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--variant</option></term><listitem><para>Вариант носителя назначения.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--output</option></term> + <listitem><para>Имя выходного файла. Как обычно, <option>-</option> подразумевает стандартный поток вывода.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-mediumproperty.xml b/doc/manual/ru_RU/man_VBoxManage-mediumproperty.xml new file mode 100644 index 00000000..2fe23724 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-mediumproperty.xml @@ -0,0 +1,219 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage mediumproperty +--> +<!-- + 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-mediumproperty" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage mediumproperty</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-mediumproperty</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-mediumproperty</refname> + <refpurpose>управлять свойствами носителя</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-set"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage mediumproperty</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <arg choice="plain">set</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + <arg choice="req"><replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-get"> + <command>VBoxManage mediumproperty</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <arg choice="plain">get</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-delete"> + <command>VBoxManage mediumproperty</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <arg choice="plain">delete</arg> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage mediumproperty</command> позволяет + установить, получить или удалить свойство носителя. + </para> + <refsect2 id="vboxmanage-mediumproperty-set"> + <title>Установить свойство носителя</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage mediumproperty set</command> + позволяет установить свойство носителя. + </para> + <variablelist> + <varlistentry> + <term><literal>disk | dvd | floppy</literal></term> + <listitem><para> + Указывает тип носителя. Допустимые значения + <literal>disk</literal> (жесткий диск), + <literal>dvd</literal> или <literal>floppy</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) + или абсолютный путь к носителю или образу. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>значение-свойства</replaceable></term> + <listitem><para> + Задает значение указанного свойства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-mediumproperty-get"> + <title>Получить значение свойства носителя</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage mediumproperty get</command> + позволяет получить значение свойства носителя. + </para> + <variablelist> + <varlistentry> + <term><literal>disk | dvd | floppy</literal></term> + <listitem><para> + Задает тип носителя. Допустимые значения + <literal>disk</literal> (жесткий диск), + <literal>dvd</literal> или <literal>floppy</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) + или абсолютный путь к носителю или образу. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-mediumproperty-delete"> + <title>Удалить свойство носителя</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage mediumproperty delete</command> + позволяет удалить свойство носителя. + </para> + <variablelist> + <varlistentry> + <term><literal>disk | dvd | floppy</literal></term> + <listitem><para> + Задает тип носителя. Допустимые значения + <literal>disk</literal> (жесткий диск), + <literal>dvd</literal> или <literal>floppy</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) + или абсолютный путь к носителю или образу. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-свойства</replaceable></term> + <listitem><para> + Задает имя свойства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда устанавливает свойство, называемое + <literal>prop1</literal> в значение <literal>val1</literal> + для образа диска <filename>ol7.vdi</filename>. + </para> +<screen>$ VBoxManage mediumproperty disk set ol7.vdi prop1 val1</screen> + <para> + Следующая команда получает значение свойства, называемого + <literal>prop1</literal> образа диска <filename>ol7.vdi</filename>. + </para> +<screen>$ VBoxManage mediumproperty disk get ol7.vdi prop1</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-metrics.xml b/doc/manual/ru_RU/man_VBoxManage-metrics.xml new file mode 100644 index 00000000..e7b36c47 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-metrics.xml @@ -0,0 +1,422 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage metrics +--> +<!-- + 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-metrics" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage metrics</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-metrics</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-metrics</refname> + <refpurpose>мониторинг использования системных ресурсов</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-metrics-collect"> + <command>VBoxManage metrics collect</command> + <arg>--detach</arg> + <arg>--list</arg> + <arg>--period=<replaceable>секунды</replaceable></arg> + <arg>--samples=<replaceable>количество</replaceable></arg> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-metrics-disable"> + <command>VBoxManage metrics disable</command> + <arg>--list</arg> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-metrics-enable"> + <command>VBoxManage metrics enable</command> + <arg>--list</arg> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-metrics-list"> + <command>VBoxManage metrics list</command> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-metrics-query"> + <command>VBoxManage metrics query</command> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-metrics-setup"> + <command>VBoxManage metrics setup</command> + <arg>--list</arg> + <arg>--period <replaceable>секунды</replaceable></arg> + <arg>--samples <replaceable>количество</replaceable></arg> + <group> + <arg choice="plain">*</arg> + <arg choice="plain">host</arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable> <arg><replaceable>список-метрик</replaceable></arg></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage metrics</command> позволяет наблюдать + за использованием системных ресурсов в хост-системе и в + виртуальных машинах (ВМ). Например, можно контролировать + определенную метрику, такую как процент времени, затрачиваемую + ЦПУ при выполнении в пользовательском режиме + (<literal>CPU/Load/User</literal>) в течение определенного + периода. + </para> + <para> + Пока она работает, процесс <command>VBoxSVC</command> собирает + и сохраняет данные указанной метрики внутри. Процесс + <command>VBoxSVC</command> завершает работу почти сразу после + закрытия всех ВМ и интерфейсов пользователя. Используйте команду + <command>VBoxManage metrics query</command> для получения данных + в любое время. + </para> + <para> + По умолчанию, метрики не собираются, пока не будет запущена + команда <command>VBoxManage metrics setup</command>, в которой + указывается интервал выборки в секундах и количество сохраняемых + метрик. + </para> + <para> + Заметим, что включить сбор метрик можно только для запущенных ВМ. + Собранные данные и настройки сбора данных для ВМ удаляются при + выключении ВМ. + </para> + <refsect2> + <title>Метрики</title> + <para> + У хоста и ВМ есть разные наборы соответствующих метрик, + которые можно отобразить через команду <command>VBoxManage + metrics list</command> + </para> + <para> + Каждая метрика представлена строкой состоящей из категории и + метрики. Опционально, строка метрик может включать любое из + следующих: подметрика, под-подметрика и агрегат. Строка + метрик имеет следующий формат: + </para> +<screen><replaceable>категория</replaceable>/<replaceable>метрика</replaceable>[/<replaceable>подметрика</replaceable>[/<replaceable>под-подметрика</replaceable>]][:<replaceable>агрегат</replaceable>]</screen> + <itemizedlist> + <listitem><para> + <replaceable>категория</replaceable> - это тип ресурса, + такой как <literal>CPU</literal>, <literal>RAM</literal>, + <literal>FS</literal>, <literal>Net</literal>. + </para></listitem> + <listitem><para> + <replaceable>метрика</replaceable> - это тип измерения, + связанной с категорией ресурса. Например, метрики + <literal>Load</literal> и <literal>MHz</literal> + связаны с категорией ресурса <literal>CPU</literal>. + </para></listitem> + <listitem><para> + <replaceable>подметрика</replaceable> - это опциональный + тип измерения, связанный с метрикой. Например, подметрики + <literal>User</literal>, <literal>Kernel</literal> и + <literal>Idle</literal> связаны с метрикой + <literal>Load</literal>. + </para></listitem> + <listitem><para> + <replaceable>под-подметрика</replaceable> - это опциональный + тип измерения связанный с подметрикой. Например, под-подметрики + <literal>Rx</literal> и <literal>Tx</literal> связаны с + подметрикой <literal>Rate</literal> категории ресурса + <literal>Net</literal>. Связанная метрика - это сетевой + интерфейс. + </para></listitem> + <listitem><para> + <replaceable>агрегат</replaceable> - это опциональная + функция для передачи минимального, максимального и среднего + значения измерений категории ресурса. Например, метрика + <literal>RAM/Usage/Free:min</literal> представляет + минимальное количество доступной памяти найденное во всех + сохраненных данных в хост-системе. + </para></listitem> + </itemizedlist> + <para> + По умолчанию, команды <command>VBoxManage metrics</command> + оперируют хост-системой и всеми ВМ и возвращают все метрики. + Можно опционально ограничить эти команды работой только по + хост-системе или только по определенной ВМ и возвращать + список одной или нескольких метрик. + </para> + </refsect2> + <refsect2 id="vboxmanage-metrics-common-options"> + <title>Общие параметры</title> + <variablelist> + <varlistentry> + <term><literal>*</literal> | <literal>host</literal> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает компонент для работы. По умолчанию, эта команда + работает по хост-системе и всем запущенным ВМ. + </para><para> + Если указать <literal>host</literal>, команда + <command>VBoxManage metrics</command> работает только по + хост-системе. Если указать звездочку (<literal>*</literal>), + команда работает по всем ВМ. Если указать имя ВМ, команда + <command>VBoxManage metrics</command> работает только + по этой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>список-метрик</replaceable></term> + <listitem><para> + Задает список одной или нескольких метрик, разделенный + запятыми. + </para><para> + Формат метрик должен включать <replaceable>категорию</replaceable> + и <replaceable>метрику</replaceable> в строке, разделенную + слэшем. + </para><para> + Заметим, что команды <command>VBoxManage metrics + enable</command> и <command>VBoxManage metrics + disable</command> требуют указания метрик как параметров. + Метрики должны включать только категорию ресурса и саму + метрику, например <literal>CPU/Load</literal> и + <literal>RAM/Usage</literal>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-metrics-collect"> + <title>Сбор данных метрик</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics collect</command> + собирает и выводит периодически данные, пока процесс не + будет остановлен нажатием Ctrl+C. + </para> + <variablelist> + <varlistentry> + <term><option>--detach</option></term> + <listitem><para> + Отключает сбор данных метрики, так что больше данных + не выводится. Использование этой опции равносильно + запуску команды <command>VBoxManage metrics setup</command>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--list</option></term> + <listitem><para> + Показывает какие метрики соответствуют указанному фильтру. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--period=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает количество секунд ожидания между выборками + данных метрик. По умолчанию 1. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--samples=<replaceable>количество</replaceable></option></term> + <listitem><para> + Задает количество сохраняемых выборок данных метрик. + Для просмотра сохраненных данных используйте команду + <command>VBoxManage metrics query</command>. По + умолчанию 1. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-metrics-disable"> + <title>Отключить сбор данных метрик</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics disable</command> + приостанавливает сбор данных. Эта команда не влияет ни на + свойства сбора данных, ни на сами собранные данные. Обратите + внимание, что указание подметрики в списке метрик не отключает + ее базовые метрики. + </para> + <para> + Заметим, что команда <command>VBoxManage metrics disable</command> + требует указания метрик как параметров. Метрики должны включать + только категорию ресурса и саму метрику, например + <literal>CPU/Load</literal> и <literal>RAM/Usage</literal>. + </para> + <variablelist> + <varlistentry> + <term><option>--list</option></term> + <listitem><para> + Показывает завершилась ли команда успешно как ожидалось. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-metrics-enable"> + <title>Включение сбора данных метрики</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics enable</command> возобновляет + сбор данных после того, как он был приостановлен командой + <command>VBoxManage metrics disable</command>. Заметим, что + указание подметрики в списке метрик не включает его базовые + метрики. + </para> + <para> + В отличие от команды <command>VBoxManage metrics setup</command> + команда <command>VBoxManage metrics enable</command> не удаляет + предыдущие накопленные выборки для указанного набора объектов и + метрик. + </para> + <para> + Заметим, что команда <command>VBoxManage metrics enable</command> + требует указания метрик как параметров. Метрики должны включать + только категорию ресурса и саму метрику, например + <literal>CPU/Load</literal> и <literal>RAM/Usage</literal>. + </para> + <variablelist> + <varlistentry> + <term><option>--list</option></term> + <listitem><para> + Показывает, завершилась ли команда успешно как ожидалось. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-metrics-list"> + <title>Показать значения метрик</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics list</command> показывает + доступные на текущий момент метрики. Обратите внимание, метрики, + относящиеся к ВМ, отображаются пока ВМ работает. + </para> + </refsect2> + <refsect2 id="vboxmanage-metrics-query"> + <title>Показать сохраненные данные метрики</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics query</command> + получает и показывает сохраненные данные метрики. + </para> + <para> + Заметим, что команда <command>VBoxManage metrics query</command> + не удаляет и не сбрасывает сохраненные данные, но старые + выборки заменяются на новые в течение времени. + </para> + </refsect2> + <refsect2 id="vboxmanage-metrics-setup"> + <title>Настройка свойств сбора метрик</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage metrics setup</command> настраивает + свойства сбора метрик. + </para> + <para> + Заметим, что эта команда удаляет любые ранее собранные выборки + для указанного набора объектов и метрик. Для включения и отключения + сбора метрик без удаления данных используйте команды + <command>VBoxManage metrics enable</command> и + <command>VBoxManage metrics disable</command> соответственно. + </para> + <variablelist> + <varlistentry> + <term><option>--list</option></term> + <listitem><para> + Показывает какие метрики были изменены в качестве результата + выполнения команды. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--period=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает количество секунд ожидания между выборками данных метрик. + По умолчанию 1. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--samples=<replaceable>количество</replaceable></option></term> + <listitem><para> + Задает количество сохраняемых выборок данных метрик. + Для просмотра сохраненных данных используйте команду + <command>VBoxManage metrics query</command>. По + умолчанию 1. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда включает сбор метрик использования + процессора и памяти хоста каждую секунду. Опция + <option>--samples</option> сохраняет пять последних + выборок. + </para> +<screen>$ VBoxManage metrics setup --period 1 --samples 5 host CPU/Load,RAM/Usage</screen> + <para> + Следующая команда показывает доступные метрики для хоста и ВМ: + </para> +<screen>$ VBoxManage metrics list</screen> + <para> + Заметим, что у хост-системы и ВМ разные наборы метрик. + </para> + <para> + Следующий пример показывает как запросить данные метрик о затраченном + времени ЦПУ в режимах пользователя и ядра для ВМ <literal>test</literal>: + </para> +<screen>$ VBoxManage metrics query test CPU/Load/User,CPU/Load/Kernel</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-modifymedium.xml b/doc/manual/ru_RU/man_VBoxManage-modifymedium.xml new file mode 100644 index 00000000..911b25dc --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-modifymedium.xml @@ -0,0 +1,254 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage modifymedium +--> +<!-- + 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-modifymedium" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage modifymedium</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-modifymedium</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-modifymedium</refname> + <refpurpose>изменяет характеристики существующего образа диска</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-modifymedium"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage modifymedium</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + <arg>--autoreset=on | off</arg> + <arg>--compact</arg> + <arg>--description=<replaceable>описание</replaceable></arg> + <arg>--move=<replaceable>путь</replaceable></arg> + <arg>--property=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</arg> + <arg>--resize=<replaceable>мегабайты</replaceable> | --resizebyte=<replaceable>байты</replaceable></arg> + <arg>--setlocation=<replaceable>путь</replaceable></arg> + <arg>--type=normal | writethrough | immutable | shareable | readonly | multiattach</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage modifymedium</command> позволяет + изменить характеристики существующего образа диска. + </para> + <note> + <para> + Для совместимости с более ранними версиями &product-name; + можно использовать команды <command>modifyvdi</command> и + <command>modifyhd</command>. + </para> + </note> + <variablelist> + <varlistentry> + <term>disk | dvd | floppy</term> + <listitem><para> + Задает тип носителя образа. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + путь к образу диска в файловой системе хоста. UUID можно + использовать, только если носитель зарегистрирован. + Используйте команду <command>VBoxManage list hdds</command> + для отображения зарегистрированных образов. Можно указывать + как абсолютный, так и относительный пути к носителю. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--autoreset=on | off</option></term> + <listitem><para> + Указывает, сбрасывать ли автоматически неизменяемый + жесткий диск при каждом старте виртуальной машины (ВМ). + Эта опция только для неизменяемых жестких дисков и + значение по умолчанию <literal>on</literal>. + Смотрите <xref linkend="hdimagewrites" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--compact</option></term> + <listitem><para> + Сжимает образы дисков путем удаления блоков содержащих + только нули. Эта опция уменьшает динамически расширяемый + образ и уменьшает <emphasis>физический</emphasis> размер + образа не влияя на логический размер виртуального диска. + </para><para> + Можно использовать эту опцию для базовых образов или + для разностных образов, созданных как часть снимка. + </para><note> + <para> + Перед сжатием образа, необходимо использовать подходящее + ПО для обнуления свободного пространства в гостевой + системе. Например: + </para> + <itemizedlist> + <listitem><para> + <emphasis role="bold">Гости Windows.</emphasis> Запустите + команду <command>sdelete -z</command>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Гости Linux.</emphasis> Используйте + утилиту <command>zerofree</command>, которая поддерживает + файловые системы <literal>ext2</literal> и + <literal>ext3</literal>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Гости Mac OS X.</emphasis> Используйте + команду <command>diskutil secureErase freespace 0 /</command>. + </para></listitem> + </itemizedlist> + </note><para> + Заметим, что эта опция может использоваться только для + сжатия VDI образов. Для сжатия не-VDI образов, можно + обнулить свободные блоки и затем клонировать диск в + любой другой динамически расширяемый формат. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Задает текстовое описание носителя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--move=<replaceable>путь</replaceable></option></term> + <listitem><para> + Задает относительный или абсолютный путь к носителю в + хост-системе. Используйте эту опцию для перемещения + носителя в другое расположения в хост-системе. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--property=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает имя и значение свойства носителя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--resize=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает новую емкость существующего образа в МБ. Эту опцию + можно использовать только для увеличения емкости образа. + Невозможно уменьшить емкость образа. + </para><para> + Заметим, можно изменить размер только динамически расширяемого + диска, использующих форматы VDI и VHD. Эта опция подстраивает + <emphasis>логический</emphasis> размер виртуального диска и + лишь немного влияет на физический размер. + </para><para> + Например, если ваш динамически расширяемый 10 ГБ диск полон, + можно использовать опцию <option>--resize 15360</option> + для увеличения емкости существующего диска до 15 ГБ + (15360 МБ). Эта операция позволяет избежать создания нового + диска и копирования всех данных со старого внутри ВМ. + </para><para> + Обратите внимание, эта опция меняет емкость диска. Поэтому, + может понадобиться воспользоваться впоследствии программой + управления разделами в гостевой системе для подгонки + разделов под изменившийся размер диска. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--resizebyte=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает новую емкость существующего образа в байтах. + Эта опция подобна опции <option>--resize</option>, + за исключением того, что размер задается в байтах а + не в МБ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--setlocation=<replaceable>путь</replaceable></option></term> + <listitem><para> + Задает новое расположение носителя в хост-системе после + перемещения. Путь может быть как относительно текущей + директории так и абсолютным. + </para><para> + Заметим, что команда <command>VBoxManage modifymedium</command> + не производит какие-либо проверки указанного пути. Убедитесь, + что путь корректен. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--type</option></term> + <listitem><para> + Задает новый тип режима существующего образа. Допустимые + значения <literal>normal</literal>, + <literal>immutable</literal>, + <literal>writethrough</literal>, + <literal>multi-attach</literal>, + <literal>shareable</literal>, and + <literal>readonly</literal>. Описание этих типов режимов + смотрите в <xref linkend="hdimagewrites" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда изменяет описание файла образа диска, называемого + <filename>disk01.vdi</filename>. + </para> +<screen>$ VBoxManage modifymedium disk disk01.vdi --description "Oracle Linux 7 image"</screen> + <para> + Следующая команда изменяет режим записи для файла образа диска, + называемого <filename>disk01.vdi</filename>. + </para> +<screen>$ VBoxManage modifymedium disk disk01.vdi --type writethrough</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-modifynvram.xml b/doc/manual/ru_RU/man_VBoxManage-modifynvram.xml new file mode 100644 index 00000000..5e0f9571 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-modifynvram.xml @@ -0,0 +1,242 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage modifynvram +--> +<!-- + Copyright (C) 2021-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-modifynvram" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage modifynvram</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-modifynvram</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-modifynvram</refname> + <refpurpose>Отображение и изменение содержимого NVRAM виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-inituefivarstore"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">inituefivarstore</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-enrollmssignatures"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">enrollmssignatures</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-enrollorclpk"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">enrollorclpk</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-enrollpk"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">enrollpk</arg> + <arg>--platform-key=<replaceable>имя-файла</replaceable></arg> + <arg>--owner-uuid=<replaceable>uuid</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-listvars"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">listvars</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-queryvar"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">queryvar</arg> + <arg>--name=<replaceable>имя</replaceable></arg> + <arg>--filename=<replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-deletevar"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">deletevar</arg> + <arg>--name=<replaceable>имя</replaceable></arg> + <arg>--owner-uuid=<replaceable>uuid</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-modifynvram-changevar"> + <command>VBoxManage modifynvram</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="plain">changevar</arg> + <arg>--name=<replaceable>имя</replaceable></arg> + <arg>--filename=<replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <para>Команды "modifynvram" предназначены для экспертов, которые хотят изучить и изменить + хранилище переменных UEFI виртуальной машины. Любые допущенные здесь ошибки могут + привести машину в нерабочее состояние.</para> + + <refsect2 id="vboxmanage-modifynvram-common-options"> + <title>Общие параметры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para>Все подкоманды <command>modifynvram</command> выполняются на работающей виртуальной + машине:</para> + <variablelist> + <varlistentry> + <term><replaceable>uuid|имя-ВМ</replaceable></term> + <listitem><para>Или UUID или имя ВМ (чувствительно к регистру).</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-inituefivarstore"> + <title>modifynvram inituefivarstore</title> + <remark role="help-copy-synopsis"/> + <para> + Инициализирует хранилище переменных UEFI в состояние по умолчанию. Все ранее + существовавшие хранилища переменных удаляются. Используйте с особой осторожностью! + </para> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-enrollmssignatures"> + <title>modifynvram enrollmssignatures</title> + <remark role="help-copy-synopsis"/> + <para> + Регистрирует стандартные подписи Microsoft KEK и DB, необходимые для безопасной загрузки UEFI. + </para> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-enrollorclpk"> + <title>modifynvram enrollorclpk</title> + <remark role="help-copy-synopsis"/> + <para> + Регистрирует ключ платформы по умолчанию, предоставленный Oracle, необходимый для безопасной загрузки UEFI. + </para> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-enrollpk"> + <title>modifynvram enrollpk</title> + <remark role="help-copy-synopsis"/> + <para> + Регистрирует пользовательский ключ платформы переданный пользователем, необходимый + для безопасной загрузки UEFI. Следующие команды используют openssl для генерации + нового ключа платформы: + </para> +<screen>$ openssl req -new -x509 -newkey rsa:2048 -keyout PK.key -out PK.crt</screen> +<screen>$ openssl x509 -in PK.crt -out PK.cer -outform DER</screen> + <variablelist> + <varlistentry> + <term><option>--platform-key=<replaceable>имя-файла</replaceable></option></term> + <listitem><para>Ключ платформы переданный в качестве X.509 подписи, зашифрованной DER.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--owner-uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para>UUID идентифицирующий владельца ключа платформы.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-listvars"> + <title>modifynvram listvars</title> + <remark role="help-copy-synopsis"/> + <para> + Показывает все переменные UEFI в хранилище виртуальной машины относительно UUID их владельца. + </para> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-queryvar"> + <title>modifynvram queryvar</title> + <remark role="help-copy-synopsis"/> + <para> + Запрашивает содержимое данной переменной UEFI по ее имени. + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>имя</replaceable></option></term> + <listitem><para>имя запрашиваемой переменной UEFI.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--filename=<replaceable>имя-файла</replaceable></option></term> + <listitem> + <para> + Куда сохранять содержимое переменной в случае успеха. Это необязательно. + Если не указан, содержимое будет выдано в терминал как hex дамп. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-deletevar"> + <title>modifynvram deletevar</title> + <remark role="help-copy-synopsis"/> + <para> + Удаляет данную переменную по ее имени и UUID владельца. + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>имя</replaceable></option></term> + <listitem><para>Имя удаляемой переменной UEFI.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--owner-uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para>UUID владельца удаляемой переменной.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-modifynvram-changevar"> + <title>modifynvram changevar</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет содержимое переменной UEFI на содержимое указанного файла. + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>имя</replaceable></option></term> + <listitem><para>Имя изменяемой переменной UEFI.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--filename=<replaceable>имя-файла</replaceable></option></term> + <listitem> + <para>Файл с данными.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml new file mode 100644 index 00000000..b1b0cc07 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml @@ -0,0 +1,2740 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage modifyvm +--> +<!-- + 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-modifyvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage modifyvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-modifyvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-modifyvm</refname> + <refpurpose>изменение настроек остановленной виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-general"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--name=<replaceable>имя</replaceable></arg> + <arg>--groups= <arg choice="plain"><replaceable>группа</replaceable> [,<replaceable>группа</replaceable>...]</arg></arg> + <arg>--description=<replaceable>описание</replaceable></arg> + <arg>--os-type=<replaceable>тип-ОС</replaceable></arg> + <arg>--icon-file=<replaceable>имя-файла</replaceable></arg> + <arg>--memory=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--page-fusion=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vram=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--acpi=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ioapic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hardware-uuid=<replaceable>UUID</replaceable></arg> + <arg>--cpus=<replaceable>число-ЦПУ</replaceable></arg> + <arg>--cpu-hotplug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--plug-cpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--unplug-cpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--cpu-execution-cap=<replaceable>число</replaceable></arg> + <arg>--pae=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--long-mode=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-exit=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--spec-ctrl=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--cpu-profile=<group choice="plain"> + <arg choice="plain">host</arg> + <arg choice="plain">Intel 8086</arg> + <arg choice="plain">Intel 80286</arg> + <arg choice="plain">Intel 80386</arg> + </group></arg> + <arg>--hpet=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hwvirtex=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--triple-fault-reset=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--x2apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--paravirt-provider=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">default</arg> + <arg choice="plain">legacy</arg> + <arg choice="plain">minimal</arg> + <arg choice="plain">hyperv</arg> + <arg choice="plain">kvm</arg> + </group></arg> + <arg>--paravirt-debug= <arg choice="plain"><replaceable>ключ</replaceable>=<replaceable>значение</replaceable> [,<replaceable>ключ</replaceable>=<replaceable>значение</replaceable>...]</arg></arg> + <arg>--nested-paging=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--large-pages=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtx-vpid=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtx-ux=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nested-hw-virt=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--virt-vmsave-vmload=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate-3d=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate-2d-video=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--chipset=<group choice="plain"> + <arg choice="plain">ich9</arg> + <arg choice="plain">piix3</arg> + </group></arg> + <arg>--iommu=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">automatic</arg> + <arg choice="plain">amd</arg> + <arg choice="plain">intel</arg> + </group></arg> + <arg>--tpm-type=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">1.2</arg> + <arg choice="plain">2.0</arg> + <arg choice="plain">host</arg> + <arg choice="plain">swtpm</arg> + </group></arg> + <arg>--tpm-location=<group choice="plain"> + <arg choice="plain"><replaceable>расположение</replaceable></arg> + </group></arg> + <arg>--bios-logo-fade-in=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bios-logo-fade-out=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bios-logo-display-time=<replaceable>миллисекунды</replaceable></arg> + <arg>--bios-logo-image-path=<replaceable>путь</replaceable></arg> + <arg>--bios-boot-menu=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">menuonly</arg> + <arg choice="plain">messageandmenu</arg> + </group></arg> + <arg>--bios-apic=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">apic</arg> + <arg choice="plain">x2apic</arg> + </group></arg> + <arg>--bios-system-time-offset=<replaceable>миллисекунды</replaceable></arg> + <arg>--bios-pxe-debug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--system-uuid-le=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--boot<replaceable>X</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">floppy</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">disk</arg> + <arg choice="plain">net</arg> + </group></arg> + <arg>--rtc-use-utc=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--graphicscontroller=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">vboxvga</arg> + <arg choice="plain">vmsvga</arg> + <arg choice="plain">vboxsvga</arg> + </group></arg> + <arg>--snapshot-folder=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>путь</replaceable></arg> + </group></arg> + <arg>--firmware=<group choice="plain"> + <arg choice="plain">bios</arg> + <arg choice="plain">efi</arg> + <arg choice="plain">efi32</arg> + <arg choice="plain">efi64</arg> + </group></arg> + <arg>--guest-memory-balloon=<replaceable>размер-в-МБ</replaceable></arg> + <arg>--default-frontend=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> +<!-- There are currently undocumented options --iocache and +--iocachesize which are scheduled for removal. Not worth spending +time on documenting it. --> + <arg>--vm-process-priority=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain">flat</arg> + <arg choice="plain">low</arg> + <arg choice="plain">normal</arg> + <arg choice="plain">high</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--nic<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">null</arg> + <arg choice="plain">nat</arg> + <arg choice="plain">bridged</arg> + <arg choice="plain">intnet</arg> + <arg choice="plain">hostonly</arg> + <arg choice="plain">hostonlynet</arg> + <arg choice="plain">generic</arg> + <arg choice="plain">natnetwork</arg> + </group></arg> + <arg>--nic-type<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">Am79C970A</arg> + <arg choice="plain">Am79C973</arg> + <arg choice="plain">82540EM</arg> + <arg choice="plain">82543GC</arg> + <arg choice="plain">82545EM</arg> + <arg choice="plain">virtio</arg> + </group></arg> + <arg>--cable-connected<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nic-trace<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></arg> + <arg>--nic-property<replaceable>N</replaceable>=<replaceable>имя</replaceable>= <arg><replaceable>значение</replaceable></arg></arg> + <arg>--nic-speed<replaceable>N</replaceable>=<replaceable>кбит-в-сек</replaceable></arg> + <arg>--nic-boot-prio<replaceable>N</replaceable>=<replaceable>приоритет</replaceable></arg> + <arg>--nic-promisc<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">deny</arg> + <arg choice="plain">allow-vms</arg> + <arg choice="plain">allow-all</arg> + </group></arg> + <arg>--nic-bandwidth-group<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--bridge-adapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--host-only-adapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--host-only-net<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--intnet<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--nat-network<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></arg> + <arg>--nic-generic-drv<replaceable>N</replaceable>=<replaceable>имя-драйвера</replaceable></arg> + <arg>--mac-address<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">auto</arg> + <arg choice="plain"><replaceable>MAC-адрес</replaceable></arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking-nat"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--nat-net<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain"><replaceable>сеть</replaceable></arg> + <arg choice="plain">default</arg> + </group></arg> + <arg>--nat-pf<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">[<replaceable>имя-правила</replaceable>],tcp</arg> + <arg choice="plain">udp,[<replaceable>IP-хоста</replaceable>],<replaceable>порт-хоста</replaceable>,[<replaceable>IP-гостя</replaceable>],<replaceable>порт-гостя</replaceable></arg> + </group></arg> + <arg>--nat-pf<replaceable>N</replaceable>=delete=<replaceable>имя-правила</replaceable></arg> + <arg>--nat-tftp-prefix<replaceable>N</replaceable>=<replaceable>префикс</replaceable></arg> + <arg>--nat-tftp-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></arg> + <arg>--nat-tftp-server<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></arg> + <arg>--nat-bind-ip<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></arg> + <arg>--nat-dns-pass-domain<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-dns-proxy<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-dns-host-resolver<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-localhostreachable<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nat-settings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>отправка-сокет</replaceable>],[<replaceable>прием-сокет</replaceable>],[<replaceable>отправка-tcp</replaceable>],[<replaceable>прием-tcp</replaceable>]</arg> + <arg>--nat-alias-mode<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain">[log],[proxyonly],[sameports]</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-other-hardware"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--mouse=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + <arg choice="plain">usbtablet</arg> + <arg choice="plain">usbmultitouch</arg> + </group></arg> + <arg>--keyboard=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + </group></arg> + <arg>--uart<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-база</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--uart-mode<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">disconnected</arg> + <arg choice="plain">server <replaceable>канал</replaceable></arg> + <arg choice="plain">client <replaceable>канал</replaceable></arg> + <arg choice="plain">tcpserver <replaceable>порт</replaceable></arg> + <arg choice="plain">tcpclient <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable></arg> + <arg choice="plain">file <replaceable>имя-файла</replaceable></arg> + <arg choice="plain"><replaceable>имя-устройства</replaceable></arg> + </group></arg> + <arg>--uart-type<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">16450</arg> + <arg choice="plain">16550A</arg> + <arg choice="plain">16750</arg> + </group></arg> + <arg>--lpt-mode<replaceable>N</replaceable>=<replaceable>имя-устройства</replaceable></arg> + <arg>--lpt<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-база</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--audio-controller=<group choice="plain"> + <arg choice="plain">ac97</arg> + <arg choice="plain">hda</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audio-codec=<group choice="plain"> + <arg choice="plain">stac9700</arg> + <arg choice="plain">ad1980</arg> + <arg choice="plain">stac9221</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audio-driver=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">default</arg> + <arg choice="plain">null</arg> + <arg choice="plain">dsound</arg> + <arg choice="plain">was</arg> + <arg choice="plain">oss</arg> + <arg choice="plain">alsa</arg> + <arg choice="plain">pulse</arg> + <arg choice="plain">coreaudio</arg> + </group></arg> + <arg>--audio-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--audio-in=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--audio-out=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--clipboard-mode=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> +<!-- There is a currently undocumented option --clipboard-file-transfers. +The implementation is not finished, so postpone documenting until it +actually is ready for users. --> + <arg>--drag-and-drop=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> + <arg>--monitor-count=<replaceable>количество</replaceable></arg> + <arg>--usb-ehci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-ohci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-xhci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usb-rename=<replaceable>старое-имя</replaceable> <replaceable>новое-имя</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-recording"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--recording=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--recording-screens=<group choice="plain"> + <arg choice="plain">all</arg> + <arg choice="plain"><replaceable>ID-экрана</replaceable> [<replaceable>ID-экрана</replaceable>...]</arg> + </group></arg> + <arg>--recording-file=<replaceable>имя-файла</replaceable></arg> + <arg>--recording-max-size=<replaceable>МБ</replaceable></arg> + <arg>--recording-max-time=<replaceable>миллисекунды</replaceable></arg> + <arg>--recording-opts= <arg choice="plain"><replaceable>ключ</replaceable>=<replaceable>значение</replaceable> [,<replaceable>ключ</replaceable>=<replaceable>значение</replaceable>...]</arg></arg> + <arg>--recording-video-fps=<replaceable>кадров-в-сек</replaceable></arg> + <arg>--recording-video-rate=<replaceable>rate</replaceable></arg> + <arg>--recording-video-res=<replaceable>ширина</replaceable> <replaceable>высота</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-vrde"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--vrde=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-property=<replaceable>имя-свойства</replaceable>= <arg><replaceable>значение-свойства</replaceable></arg></arg> + <arg>--vrde-extpack=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> + <arg>--vrde-port=<replaceable>порт</replaceable></arg> + <arg>--vrde-address=<replaceable>IP-хоста</replaceable></arg> + <arg>--vrde-auth-type=<group choice="plain"> + <arg choice="plain">null</arg> + <arg choice="plain">external</arg> + <arg choice="plain">guest</arg> + </group></arg> + <arg>--vrde-auth-library=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>имя</replaceable></arg> + </group></arg> + <arg>--vrde-multi-con=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-reuse-con=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-video-channel=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrde-video-channel-quality=<replaceable>процент</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-teleport"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--teleporter=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--teleporter-port=<replaceable>порт</replaceable></arg> + <arg>--teleporter-address=<group choice="plain"> + <arg choice="plain"><replaceable>адрес</replaceable></arg> + <arg choice="plain">empty</arg> + </group></arg> + <arg>--teleporter-password=<replaceable>пароль</replaceable></arg> + <arg>--teleporter-password-file=<group choice="plain"> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + <arg choice="plain">stdin</arg> + </group></arg> + <arg>--cpuid-portability-level=<replaceable>уровень</replaceable></arg> + <arg>--cpuid-set=<replaceable>лист</replaceable><arg>:<replaceable>подлист</replaceable></arg> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></arg> + <arg>--cpuid-remove=<replaceable>лист</replaceable><arg>:<replaceable>подлист</replaceable></arg></arg> + <arg>--cpuid-remove-all</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-debugging"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--tracing-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--tracing-config=<replaceable>строка</replaceable></arg> + <arg>--tracing-allow-vm-access=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-usbcardreader"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--usb-card-reader=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-autostart"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--autostart-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--autostart-delay=<replaceable>секунды</replaceable></arg> +<!-- There is a currently undocumented option --autostop-type. +Most autostart service implementations either ignore it or rely it is +left unchanged due to otherwise running into timeouts established by the +host OS, defeating the purpose. Not worth spending time on documenting +it unless this changes. --> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-pcipassthrough"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--pci-attach=<replaceable>PCI-адрес-хоста</replaceable><arg>@<replaceable>гостевой-PCI-адрес-шины</replaceable></arg></arg> + <arg>--pci-detach=<replaceable>PCI-адрес-хоста</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-testing"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--testing-enabled=<group choice="plain"><arg choice="plain">on</arg><arg choice="plain">off</arg></group></arg> + <arg>--testing-mmio=<group choice="plain"><arg choice="plain">on</arg><arg choice="plain">off</arg></group></arg> + <arg>--testing-cfg-dword<replaceable>idx</replaceable>=<replaceable>значение</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage modifyvm</command> позволяет изменить + свойства зарегистрированной неработающей на текущий момент + виртуальной машины (ВМ). + </para> + <para> + Большинство этих свойств соответствуют настройкам ВМ отображаемых + в диалоге <emphasis role="bold">Настройки</emphasis> Менеджера + VirtualBox для каждой ВМ. Смотрите <xref linkend="BasicConcepts" />. + Однако, некоторые настройки могут отображаться или управляться + только командой <command>VBoxManage</command>. + </para> + <para> + Можно использовать команду <command>VBoxManage modifyvm</command> + для изменения настроек только если ВМ выключена. ВМ не может быть + в работающем или сохраненном состоянии при использовании этой + команды. + </para> + <para> + Можно использовать команду <command>VBoxManage controlvm</command> + для изменения некоторых настроек ВМ динамически, пока ВМ работает. + Смотрите <xref linkend="vboxmanage-controlvm" />. + </para> + <refsect2 id="vboxmanage-modifyvm-general"> + <title>Общие настройки</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют вам изменить общую информаицю о вашей ВМ. + </para> + <para> + Команда <command>VBoxManage modifyvm</command> поддерживает следующие + опции: + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>имя-ВМ</replaceable></option></term> + <listitem><para> + Изменяет имя ВМ и связанных с ней внутренних файлов. Смотрите + <xref linkend="vboxmanage-createvm"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--groups=<replaceable>группа</replaceable></option></term> + <listitem><para> + Изменяет членство в группе для ВМ. Имена групп всегда + начинаются с символа слэш (<literal>/</literal>) и могут + быть вложены. По умолчанию, ВМ - члены группы + <literal>/</literal>. ВМ может входить в несколько групп, + но ее первичная группа определяет структуру директорий, + где внутренние файлы ВМ располагаются по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Изменяет необязательное описание ВМ. Используйте описание + для записи подробностей о ВМ в осмысленном виде. Графический + интерфейс понимает HTML разметку, тогда как команда + <command>VBoxManage modifyvm</command> позволяет включать + произвольный текст, который может содержать несколько строк. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--os-type=<replaceable>тип-ОС</replaceable></option></term> + <listitem><para> + Задает информацию о гостевой операционной системе (ОС) в ВМ. + Используйте команду <command>VBoxManage list ostypes</command> + для отображения идентификаторов типов ОС. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--icon-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает путь к файлу иконки ВМ в формате PNG в + хост-системе. Иконка отображается в интерфейсе Менеджера + ВМ и когда ВМ запущена в режиме графического интерфейса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--memory=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает количество оперативной памяти хоста, выделенной ВМ. + Размер в МБ. Смотрите <xref linkend="create-vm-wizard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--page-fusion=on | off</option></term> + <listitem><para> + Включает или отключает функцию Page Fusion, которая + по умолчанию отключена. Используйте функцию Page + Fusion для минимизации дублирования памяти между ВМ, + имеющих подобную конфигурацию и работающих на той же + хост-системе. Смотрите <xref linkend="guestadd-pagefusion" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vram=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает количество оперативной памяти, выделенной + графической карте. Смотрите <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--acpi=on | off</option></term> + <listitem><para> + Определяет поддерживает ли ВМ ACPI. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ioapic=on | off</option></term> + <listitem><para> + Определяет поддерживает ли ВМ I/O APIC. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hardware-uuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) + для представления гостевой ВМ в таблицах памяти + (DMI/SMBIOS), в оборудовании и свойствах ВМ. По умолчанию + этот UUID оборудования такой же как UUID ВМ. Клонирование + и функция портирования автоматически сохраняет значение + UUID оборудования. Аналогично для экспорта и импорта + виртуальной конфигурации, но только если обе операции + выполняются &product-name;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpus=<replaceable>число-ЦПУ</replaceable></option></term> + <listitem><para> + Задает количество виртуальных ЦПУ, назначенных ВМ. + Смотрите <xref linkend="settings-processor" />. + </para><para> + Если горячее подключение ЦПУ включено, эта опция задает + максимальное количество виртуальных ЦПУ, которые можно + подключить к ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu-hotplug=on | off</option></term> + <listitem><para> + Включает или выключает горячее подключение ЦПУ. Когда + включено, можно динамически добавлять и удалять виртуальные + ЦПУ в ВМ. Смотрите <xref linkend="cpuhotplug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--plug-cpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Добавляет виртуальный ЦПУ в ВМ. + <replaceable>CPU-ID</replaceable> - это индекс добавляемого + вируального ЦПУ. Допустимое значение индекса - это число + от <literal>0</literal> до максимального количества ЦПУ, + заданных опцией <option>--cpus</option>. + </para><para> + Используйте эту опцию только когда включено горячее подключение ЦПУ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unplug-cpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Удалить виртуальный ЦПУ из ВМ. + <replaceable>CPU-ID</replaceable> - это индекс удаляемого + вируального ЦПУ. Допустимое значение индекса - это число + от <literal>1</literal> до максимального количества ЦПУ, + заданных опцией <option>--cpus</option>. + </para><para> + Используйте эту опцию только когда включено горячее подключение ЦПУ. + </para><para> + Обратите внимание, что нельзя удалить ЦПУ 0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuexectioncap=<replaceable>процент</replaceable></option></term> + <listitem><para> + Указывает, сколько времени ЦПУ может использовать + виртуальный ЦПУ. Допустимые значения от <literal>1</literal> + до <literal>100</literal>. Значение 50 показывает, что + единичные виртуальный ЦПУ может использовать до 50% + единичного ЦПУ хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pae=on | off</option></term> + <listitem><para> + Включает или выключает расширение физических адресов (PAE). + Смотрите <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--long-mode=on | off</option></term> + <listitem><para> + Включает или выключает длинный режим. Смотрите + <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-exit=on | off</option></term> + <listitem><para> + Включает использование барьера предсказателя неявных + ветвлений (IBPB) при каждом выходе из ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-entry=on | off</option></term> + <listitem><para> + Включает использование барьера предсказателя неявных + ветвлений (IBPB) при каждом входе в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--spec-ctrl=on | off</option></term> + <listitem><para> + Включает или выключает отображение интерфейсов управления + спекуляцией для гостевой ВМ. Эти интерфейсы должны + быть доступны в хост-системе. + </para><para> + В зависимости от ЦПУ хоста и нагрузки, включение + управления спекуляцией может значительно уменьшить + производительность. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-sched=on | off</option></term> + <listitem><para> + Включает или отключает сброс кэша данных L1, когда + поток запланирован на исполнение гостевого кода. Смотрите + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-vm-entry=on | off</option></term> + <listitem><para> + Включает или отключает сброс кэша данных L1 при каждом + входе в ВМ. Смотрите <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-sched=on | off</option></term> + <listitem><para> + Включает очистку буфера ЦПУ когда поток запланирован + на выполнение гостевого кода. Смотрите + <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-vm-entry=on | off</option></term> + <listitem><para> + Включает очистку буфера ЦПУ при каждом входе в ВМ. + Смотрите <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386</option></term> + <listitem><para> + Задает профиль, используемый для эмуляции гостевого + ЦПУ. Задайте значение, основанное на ЦПУ хост-системы + (<literal>host</literal>) или одной из следующих более + старых микроархитектурах Intel: <literal>8086</literal>, + <literal>80286</literal> или <literal>80386</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hpet=on | off</option></term> + <listitem><para> + Включает или выключает Таймер Событий Высокого + Разрешения (HPET), заменяющий устаревший системный + тайммер. Эта функция отключена по умолчанию. Заметим, + что HPET поддерживается в Windows начиная с Vista. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hwvirtex=on | off</option></term> + <listitem><para> + Включает или отключает использования расширение + виртуализации оборудования в процессоре хост-системы. + Такими расширениями являются Intel VT-x или AMD-V. + Смотрите <xref linkend="hwvirt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--triple-fault-reset=on | off</option></term> + <listitem><para> + Включает или отключает сброс гостевой ВМ вместо включения + медитации гуру. Некоторые гостевые ВМ вызывают тройной + сбой для сброса ЦПУ, поэтому иногда сброс гостевой ВМ - + это наилучший исход. Эта опция применяется только к + гостевым системам не использующих симметричную + многопроцессорность (SMP). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--apic=on | off</option></term> + <listitem><para> + Включает или выключает APIC. С APIC, ОС может + использовать более 16 запросов на прерывание (IRQ) + избегая совместное использование IRQ для улучшения + надежности. APIC включен по умолчанию. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--x2apic=on | off</option></term> + <listitem><para> + Включает или выключает функцию ЦПУ x2APIC. ЦПУ x2APIC + позволяет ОС работать более эффективно в конфигурациях + с большим количеством ядер и оптимизировать распределение + прерываний в виртуализированном окружении. Эта функция + включена по умолчанию. + </para><para> + Отключите эту функцию если ОС, работающая в хост-системе, + или гостевая ВМ не совместимы с ЦПУ x2APIC. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirt-provider=none | default | legacy | minimal | hyperv | kvm</option></term> + <listitem><para> + Указывает один из следующих интерфейсов + паравиртуализации предоставленный гостевой ОС: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> не предоставляет каких-либо + интерфейсов паравиртуализации. + </para></listitem> + <listitem><para> + <literal>default</literal> выбирает подходящий + интерфейс, основанный на типе гостевой ОС при старте + ВМ. Это значение по умолчанию при создании новой ВМ. + </para></listitem> + <listitem><para> + <literal>legacy</literal> выбирает интерфейс + паравиртуализации для ВМ, созданный более старыми + версиями &product-name;. + </para></listitem> + <listitem><para> + <literal>minimal</literal> требуется для гостевых ВМ + с Mac OS X. + </para></listitem> + <listitem><para> + <literal>kvm</literal> рекомендуется для гостевых ВМ + Linux. Смотрите <xref linkend="gimproviders" />. + </para></listitem> + <listitem><para> + <literal>hyperv</literal> рекомендуется для гостевых + ВМ Windows. Смотрите <xref linkend="gimproviders" />. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirt-debug=<replaceable>свойство</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает отладочные свойства, специфичные для провайдера + паравиртуализации, настроенного для указанной ВМ. + Смотрите <xref linkend="gimdebug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nested-paging=on | off</option></term> + <listitem><para> + Включает или отключает функцию вложенных страниц в + процессоре хост-системы. Эта опция доступна только + если аппаратная виртуализация включена. Смотрите + <xref linkend="hwvirt" /> и + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--large-pages=on | off</option></term> + <listitem><para> + Включает или отключает использование гипервизором + больших страниц, что может увеличить производительность + до 5%. Использование больших страниц уменьшает + использование TLB и накладные расходы. Эта опция + доступна только если включены и аппаратная виртуализация + и вложенные страницы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtx-vpid=on | off</option></term> + <listitem><para> + Включает или отключает использование функцию TLB c метками + (VPID) в процессоре вашей хост-системы. Смотрите + <xref linkend="hwvirt" />. Эта опция доступна только + если аппаратная виртуализация включена на Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtx-ux=on | off</option></term> + <listitem><para> + Включает или отключает использование неограниченного + гостевого режима для выполнения гостевой ВМ. Эта опция + доступна только когда аппаратная виртуализация включена + на Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nested-hw-virt=on | off</option></term> + <listitem><para> + Включает или отключает вложенну виртуализацию. Включение + делает доступной функцию аппаратной виртуализации в ВМ. + Смотрите <xref linkend="nested-virt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--virt-vmsave-vmload=on | off</option></term> + <listitem><para> + Если аппаратная виртуализация включена у хоста с ЦПУ AMD, + эта настройка включает или отключает использование функцию + виртуализированных vmsave/vmload во время исполнения ВМ. + Включена по умолчанию. Рекомендуется оставить включенной, + так как она имеет серьезное влияние на производительность + при выполнении вложенных ВМ при использовании вложенной + аппаратной виртуализации. + <xref linkend="nested-virt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated3d=on | off</option></term> + <listitem><para> + Включает или выключает аппаратное 3D ускорение для + графических адаптеров, поддерживающих это. Эта опция + работает только при установленных Дополнений Гостевой ОС. + Смотрите <xref linkend="guestadd-3d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated2dvideo=on | off</option></term> + <listitem><para> + Включает или отключает 2D видео ускорение для графических + адаптеров, поддерживающих это. Эта опция работает только + при установленных Дополнений Гостевой ОС. Смотрите + <xref linkend="guestadd-2d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--chipset=piix3 | ich9</option></term> + <listitem><para> + Задать чипсет Intel для эмуляции в &product-name;. + Значение по умолчанию - это чипсет Intel PIIX3 + (<literal>piix3</literal>). + </para><para> + Изменяйте это значение только если нужно ослабить + некоторые ограничения чипсета. Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--iommu=none | automatic | amd | intel</option></term> + <listitem><para> + Указывает типа IOMMU для эмуляции в &product-name;. + И Intel и AMD IOMMU требуют в настоящее время использование + чипсета Intel ICH9 (Смотрите опцию <option>--chipset</option>). + </para><para> + Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – IOMMU отсутствует и это + значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>automatic</literal> – IOMMU присутствует, + но его тип выбирается автоматически, соответствуя + поставщику ЦПУ хоста при включении ВМ. + </para></listitem> + <listitem><para> + <literal>amd</literal> – AMD IOMMU присутствует. + </para></listitem> + <listitem><para> + <literal>intel</literal> – Intel IOMMU присутствует. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--tpm-type=none | 1.2 | 2.0 | host | swtpm</option></term> + <listitem><para> + Указывает тип TPM для эмуляции в &product-name;. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – TPM отсутствует и это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>1.2</literal> – TPM, соответствующий спецификации TCG 1.2, присутствует. + </para></listitem> + <listitem><para> + <literal>2.0</literal> – TPM, соответствующий спецификации TCG 2.0, присутствует. + </para></listitem> + <listitem><para> + <literal>host</literal> – TPM хост системы перенаправляется в гостевую систему. + Может быть доступен не на всех поддерживаемых хост платформах. + </para></listitem> + <listitem><para> + <literal>swtpm</literal> – ВМ подключается к эмуляции внешнего TPM, совместимого + с swtpm. Необходиму задать расположение TPM location для подключения (смотрите опцию + <option>--tpm-location</option>). + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-fade-in=on | off</option></term> + <listitem><para> + Указывает, появляется ли логотип BIOS при старте ВМ. По умолчанию + показывается логотип &product-name;. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-fade-out=on | off</option></term> + <listitem><para> + Указывает, исчезает ли логотип BIOS при старте ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-display-time=<replaceable>msec</replaceable></option></term> + <listitem><para> + Задает время отображения логотипа BIOS в миллисекундах. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-logo-image-path=<replaceable>pathname</replaceable></option></term> + <listitem><para> + Заменяет существующий логотип BIOS другим изображением. + Заменяющее изображение должно быть несжатым 16-, 256- или + 16М-цветным файлом bitmap (BMP), не содержащим информацию о + цветовом пространстве (формат Windows 3.0). Также убедитесь + что изображение не больше 640x480 пикселов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-boot-menu=disabled | menuonly | messageandmenu</option></term> + <listitem><para> + Указывает, позволяет ли BIOS выбрать временное + загрузочное устройство. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>disabled</literal> выводит сообщение об + альтернативном загрузочном устройстве и позволяет + выбрать временное загрузочное устройство нажатием F12. + </para></listitem> + <listitem><para> + <literal>menuonly</literal> подавляет вывод сообщения + об альтернативном загрузочном устройстве, но позволяет + выбрать временное загрузочное устройство нажатием F12. + </para></listitem> + <listitem><para> + <literal>messageandmenu</literal> подавляет сообщение + об альтернативном загрузочном устройстве и предотвращает + выбор временного загрузочного устройства нажатием F12. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-apic=x2apic | apic | disabled</option></term> + <listitem><para> + Задает уровень APIC для прошивки. Допустимые значения: + <literal>x2apic</literal>, <literal>apic</literal> + и <literal>disabled</literal>. Когда значение + <literal>disabled</literal>, ни версия <literal>apic</literal> + ни версия <literal>x2apic</literal> не используются. + </para><para> + Заметим, что если указать значение <literal>x2apic</literal> + и x2APIC не поддерживается виртуальным ЦПУ, уровень + APIC снижается до <literal>apic</literal>, если он + поддерживается. Иначе, уровень APIC снижается до + <literal>disabled</literal>. Аналогично, если указать + значение <literal>apic</literal> и APIC не поддерживается + виртуальным ЦПУ, уровень APIC снижается до + <literal>disabled</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-system-time-offset=<replaceable>миллисекунды</replaceable></option></term> + <listitem><para> + Задает смещение времени в миллисекундах для гостевой ВМ + по отношению ко времени в хост-системе. Если значение + положительное, время в гостевой ВМ опережает время + хост-системы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bios-pxe-debug=on | off</option></term> + <listitem><para> + Включает или отключает дополнительный отладочный вывод при + использовании загрузочного ROM Intel PXE. Отладочный вывод + записывается в файл журнала в режиме выпуска. Смотрите + <xref linkend="collect-debug-info" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--system-uuid-le=on | off</option></term> + <listitem><para> + Включает или выключает представление системного UUID в + форме little endian. + Значение по умолчанию <literal>on</literal> для новых ВМ. + Для старых ВМ значение <literal>off</literal> чтобы сохранить + содержиммое таблицы DMI/SMBIOS неизменным, что может быть + важно для активации лицензии Windows. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot<replaceable>N</replaceable>=none | floppy | dvd | disk | net</option></term> + <listitem><para> + Позволяет указать порядок загрузочных устройств для ВМ + через назначение одного из типов устройств на каждый из + четырех слотов загрузочных устройств, представленных + <replaceable>N</replaceable> в имени опции. + </para><para> + Значение 1 для в <replaceable>N</replaceable> представляет + первое загрузочное устройство, и так далее. + </para><para> + Типы устройств - это <literal>floppy</literal> для флоппи + дисков, <literal>dvd</literal> для DVD или CD, + <literal>disk</literal> для жестких дисков и + <literal>net</literal> для сетевых устройств. Значение + <literal>none</literal> показывает, что загрузочное устройство + на указанный слот не назначено. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--rtc-use-utc=on | off</option></term> + <listitem><para> + Указывает, что часы реального времени (RTC) используют + скоординированное универсальное время (UTC). Смотрите + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--graphicscontroller=none | vboxvga | vmsvga | vboxsvga</option></term> + <listitem><para> + Задает используемый тип графического контроллера. + Смотрите <xref linkend="settings-screen" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--snapshot-folder=default | <replaceable>путь</replaceable></option></term> + <listitem><para> + Указывает имя папки для хранения снимков ВМ. + <literal>default</literal> означает + <filename>Snapshots/</filename> в папке машины. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--firmware=bios | efi | efi32 | efi64</option></term> + <listitem><para> + Указывает прошивку, используемую для загрузки ВМ. Допустимые + значения: <literal>bios</literal>, <literal>efi</literal>, + <literal>efi32</literal> или <literal>efi64</literal>. + Используйте значения EFI с осторожностью. + </para><para> + По умолчанию используется прошивка BIOS. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--guest-memory-balloon=<replaceable>размер</replaceable></option></term> + <listitem><para> + Задает размер гостевого memory balloon. Гостевой memory + balloon - это память выделенная Дополнениями Гостевой ОС + из гостевой ОС и возвращенная гипервизору для использования + другими ВМ. Указывайте <replaceable>размер</replaceable> + в мегабайтах. Значение по умолчанию <literal>0</literal> + мегабайт. Смотрите <xref linkend="guestadd-balloon" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--default-frontend=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Указывает фронтенд по умолчанию, используемый при + старте указанной ВМ. Если указать <literal>default</literal>, + ВМ запускается в окне рабочего стола пользователя. + Смотрите <xref linkend="vboxmanage-startvm" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vm-process-priority=default | flat | low | normal | high</option></term> + <listitem><para> + Задает схему приоритета, используемую при старте + и работе указанной ВМ. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>default</literal> – Приоритет процесса + по умолчанию, опрелеляемый ОС. + </para></listitem> + <listitem><para> + <literal>flat</literal> – предполагает политику + планирования, которая устанавливает для процесса + приоритет по умолчанию, при этом, всем потокам процесса + устанавливается один и тот же приоритет. + </para></listitem> + <listitem><para> + <literal>low</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + в основном ниже приоритета по умолчанию ОС хоста. + </para></listitem> + <listitem><para> + <literal>normal</literal> – Предполагает политику + планирования, которая честно разделяет ресурсы ЦПУ с + другими процессами, имеющими приоритет по умолчанию + ОС хоста. + </para></listitem> + <listitem><para> + <literal>high</literal> – Предполагает политику + планирования, которая устанавливает приоритет процесса + выше приоритета по умолчанию ОС хоста. Эта политика + может повлиять на другие процессы, заставляя их ожидать + ресурса ЦПУ больше положенного времени, что может + привести к непредсказуемому поведению. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking"> + <title>Сетевые настройки</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменять сеть в вашей ВМ. Во всех + этих опциях, <replaceable>N</replaceable> - это число больше + нуля, представляющее определенный виртуальный сетевой адаптер, + настраиваемый в данный момент. + </para> + <variablelist> + <varlistentry> + <term><option>--nic<replaceable>N</replaceable>=none | null | nat | natnetwork | bridged | intnet | hostonly | generic</option></term> + <listitem><para> + Настраивает тип сети используемый каждой виртуальной + сетевой картов в ВМ. + </para><para> + Следующие допустимые значения соответствуют режимам, + описанных в<xref linkend="networkingmodes" />: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – Сеть отсутствует + </para></listitem> + <listitem><para> + <literal>null</literal> – Не подключен к хост-системе + </para></listitem> + <listitem><para> + <literal>nat</literal> – Используется преобразование адресов (NAT) + </para></listitem> + <listitem><para> + <literal>natnetwork</literal> – Используется сеть NAT + </para></listitem> + <listitem><para> + <literal>bridged</literal> – Используется сетевой мост + </para></listitem> + <listitem><para> + <literal>intnet</literal> – Используется внутренняя сеть + </para></listitem> + <listitem><para> + <literal>hostonly</literal> – Используется сеть хоста + </para></listitem> + <listitem><para> + <literal>generic</literal> – Доступ к редко используемым подрежимам + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-type<replaceable>N</replaceable>=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio</option></term> + <listitem><para> + Идентифицирует тип сетевого оборудования, которое + &product-name; представляет гостевой ВМ для указанной + виртуальной сетевой карты. Смотрите + <xref linkend="nichardware" />. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>Am79C970A</literal> представляет AMD PCNet + PCI II. + </para></listitem> + <listitem><para> + <literal>Am79C973</literal> представляет AMD PCNet + FAST III, что является значением по умолчанию. + </para></listitem> + <listitem><para> + <literal>82540EM</literal> представляет Intel + PRO/1000 MT Desktop. + </para></listitem> + <listitem><para> + <literal>82543GC</literal> представляет Intel + PRO/1000 T Server. + </para></listitem> + <listitem><para> + <literal>82545EM</literal> представляет Intel + PRO/1000 MT Server. + </para></listitem> + <listitem><para> + <literal>virtio</literal> представляет паравиртуализированный + сетевой адаптер. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--cable-connected<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Временно отсоединяет виртуальный сетевой интерфейс, как + будто вы вытащили сетевой кабель из физического сетевого + интерфейса. Можно использовать эту опцию для сброса + определенных программных компонентов в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-trace<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Включает или выключает трассировку сети для указанной + сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-trace-file<replaceable>N</replaceable>=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к файлу, куда записывать информаицю + журнала трассировки. Используйте эту опцию если включена + трассировка сети. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-property<replaceable>N</replaceable>=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Позволяет задать значения свойств и передать их редко + используемым сетевым бэкендам. Для использования этой + опции, необходимо также использовать опцию + <option>--nic-generic-drv</option>. + </para><para> + Свойства относятся к движку бэкенда и отличаются между + UDP туннелем и драйверами бэкенда VDE. В качестве + примера смотрите + <xref linkend="network_udp_tunnel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-speed<replaceable>N</replaceable>=<replaceable>кбит-в-сек</replaceable></option></term> + <listitem><para> + Указывает пропускную способность в килобит в секунду для + редко используемых сетевых подрежимов, таких как сеть + VDE и UDP туннель. Используйте эту опцию, только если + использована опция <option>--nic</option> для включения + generic сети для указанной виртуальной сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-boot-prio<replaceable>N</replaceable>=<replaceable>приоритет</replaceable></option></term> + <listitem><para> + Назначает приоритет для каждой NIC, что определяет порядок, + в котором соответствующий NIC используется для сетевой + загруки PXE. Значение приоритета - это число в диапазоне + от <literal>0</literal> до <literal>4</literal>. + Приоритет <literal>0</literal>, который является значением + по умолчанию, представляет наименьший приоритет. Приоритет + <literal>1</literal> - это наибольший приоритет, а + приоритеты <literal>3</literal> и <literal>4</literal> - + ниже. + </para><para> + Эта опция работает только когда используется загрузочный + ROM Intel PXE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-promisc<replaceable>N</replaceable>=deny | allow-vms | allow-all</option></term> + <listitem><para> + Позволяет указать разрешен или запрещен неразборчивый + режим указанной виртуальной сетевой карты ВМ. Эта опция + имеет значение только для сетевого моста. + Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>deny</literal> прячет любой траффик, не + предназначенный данной ВМ. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>allow-vms</literal> прячет весь траффик хоста, + но разрешает ВМ просматривать траффик других ВМ. + </para></listitem> + <listitem><para> + <literal>allow-all</literal> разрешает ВМ просматривать + весь траффик. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-bandwidth-group<replaceable>N</replaceable>=none | <replaceable>имя</replaceable></option></term> + <listitem><para> + Добавляет или удаляет назначение группы полосы пропускания + к указанной виртуальной сетевой карте. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> удаляет любое текущее назначение + группы полосы пропускания из указанного виртуального + сетевого интерфейса. + </para></listitem> + <listitem><para> + <replaceable>имя</replaceable> добавляет назначение группы + полосы пропускания к указанному виртуальному сетевому + интерфейсу. + </para></listitem> + </itemizedlist><para> + Смотрите <xref linkend="network_bandwidth_limit" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bridge-adapter<replaceable>N</replaceable>=none | <replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Указывает интерфейс хоста используемого в указанном + виртуальном сетевом интерфейсе. Смотрите + <xref linkend="network_bridged" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения сетевого моста для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--host-only-adapter<replaceable>N</replaceable>=none | <replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Указывает интерфейс сети хоста используемого в указанном + виртуальном сетевом интерфейсе. Смотрите + <xref linkend="network_hostonly" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения сети хоста для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--intnet<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></option></term> + <listitem><para> + Указывает имя внутренней сети. Смотрите + <xref linkend="network_internal" />. Используйте эту опцию + только если использована опция <option>--nic</option> для + включения внутренней сети для указанной виртуальной сетевой + карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-network<replaceable>N</replaceable>=<replaceable>имя-сети</replaceable></option></term> + <listitem><para> + Указывает имя сети NAT, куда подключен адаптер. + Используйте эту опцию только если тип сети + <literal>natnetwork</literal>, а не <literal>nat</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nic-generic-drv<replaceable>N</replaceable>=<replaceable>драйвер-бэкенда</replaceable></option></term> + <listitem><para> + Позволяет получить доступ к редко используемым сетевым + подрежимам, таких как сети VDE и UDP туннель. + Используйте эту опцию, только если использована опция + <option>--nic</option> для включения generic сети для + указанной виртуальной сетевой карты. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mac-address<replaceable>N</replaceable>=auto | <replaceable>MAC-адрес</replaceable></option></term> + <listitem><para> + Указывает MAC адрес указанного сетевого адаптера ВМ. + По умолчанию, &product-name; назначает случайный MAC + адрес на каждый сетевой адаптер при создании ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking-nat"> + <title>Настройкт сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + В следующих опциях, используйте <replaceable>N</replaceable> + для указания определенного виртуального сетевого адаптера, + где нужно произвести изменения. + </para> + <variablelist> + <varlistentry> + <term><option>--nat-net<replaceable>N</replaceable>=default | <replaceable>сеть</replaceable></option></term> + <listitem><para> + Указывает диапазон IP адресов используемый в этой сети. + Смотрите <xref linkend="changenat" />. Используйте эту опцию + только если тип сети <literal>nat</literal>, а не + <literal>natnetwork</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-pf<replaceable>N</replaceable>=[<replaceable>имя</replaceable>],tcp | udp,[<replaceable>IP-хоста</replaceable>],<replaceable>порт-хоста</replaceable>,[<replaceable>IP-гостя</replaceable>],<replaceable>порт-гостя</replaceable></option></term> + <listitem><para> + Указывает используемое правило перенаправления портов NAT. + Смотрите <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-pf<replaceable>N</replaceable>=delete <replaceable>имя</replaceable></option></term> + <listitem><para> + Указывает правило перенаправления портов NAT для удаления. + Смотрите <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-prefix<replaceable>N</replaceable>=<replaceable>префикс</replaceable></option></term> + <listitem><para> + Задает префикс, используемый во встроенном TFTP сервере. + Например, можно использовать префикс, для указания, где + расположен загрузочный файл. Смотрите <xref linkend="nat-tftp" /> + и <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-file<replaceable>N</replaceable>=<replaceable>загрузочный-файл</replaceable></option></term> + <listitem><para> + Задает имя загрузочного файла TFTP. Смотрите + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-tftp-server<replaceable>N</replaceable>=<replaceable>сервер-tftp</replaceable></option></term> + <listitem><para> + Задает адрес сервера TFTP, откуда загружаться. Смотрите + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-bind-ip<replaceable>N</replaceable>=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает альтернативный IP адрес, на который привязывается + движок NAT. Смотрите <xref linkend="nat-adv-settings" />. + По умолчанию, движок NAT &product-name; перенаправляет пакеты TCP/IP + через интерфейс по умолчанию, назначенный TCP/IP стеком хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-pass-domain<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, передает ли встроенный DHCP сервер имя домена + для разрешения сетевого имени. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-proxy<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT - это прокси для всех запросов DNS + из гостевых систем в DNS серверы хост-системы. Смотрите + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-dns-host-resolver<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT использует механизм разрешения + хост-системы для обработки DNS запросов. Смотрите + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-localhostreachable<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Указывает, что движок NAT разрешает траффик из гостя направленный на + 10.0.2.2 передавать в локальную петлю хоста, то есть localhost или 127.0.0.1. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-settings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>отправка-сокет</replaceable>],[<replaceable>прием-сокет</replaceable>],[<replaceable>отправка-tcp</replaceable>],[<replaceable>прием-tcp</replaceable>]</option></term> + <listitem><para> + Задает значения для настройки производительности NAT. + Смотрите <xref linkend="nat-adv-settings" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-alias-mode<replaceable>N</replaceable>=default | [log],[proxyonly],[sameports]</option></term> + <listitem><para> + Задает поведение ядра движка NAT: + </para><itemizedlist> + <listitem><para> + <literal>log</literal> включает журналирование + </para></listitem> + <listitem><para> + <literal>proxyonly</literal> выключает режим + псеводонимов и делает NAT прозрачным + </para></listitem> + <listitem><para> + <literal>sameports</literal> заставляет движок NAT + отправлять пакеты через тот же порт, с которого + они пришли + </para></listitem> + <listitem><para> + <literal>default</literal> выключает все режимы псевдонимов. + </para></listitem> + </itemizedlist><para> + Для более подробной информации смотрите + <xref linkend="nat-adv-alias" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-other-hardware"> + <title>Другие настройки оборудования</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют настроить другое оборудование, такое + как последовательный порт, монитор, аудио устройство, USB порты, + буфер обмена и функционал Drag and Drop. + </para> + <variablelist> + <varlistentry> + <term><option>--mouse=ps2 | usb | usbtablet | usbmultitouch</option></term> + <listitem><para> + Задает режим мыши в ВМ. Допустимые значения: + <literal>ps2</literal>, <literal>usb</literal>, + <literal>usbtablet</literal> и <literal>usbmultitouch</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--keyboard=ps2 | usb</option></term> + <listitem><para> + Задает режим клавиатуры в ВМ. Допустимые значения: + <literal>ps2</literal> и <literal>usb</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart<replaceable>N</replaceable>=off | <replaceable>I/O-база</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Настраивает виртуальные последовательные порты ВМ. + <replaceable>N</replaceable> представляет модифицируемый + последовательный порт. Допустимые значения + <literal>off</literal>, отключающее порт или базу I/O и + IRQ. Для информации по значениям базы I/O и IRQ традиционных + COM портов смотрите <xref linkend="serialports" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart-mode<replaceable>N</replaceable>=<replaceable>режим</replaceable></option></term> + <listitem><para> + Указывает, как &product-name; соединяет указанный + виртуальный последовательный порт к хост-системе, где + работает ВМ. Смотрите <xref linkend="serialports" />. + </para><para> + Убедитесь, что сначала настроили виртуальный последовательный + порт через опцию <option>--uart<replaceable>N</replaceable></option>. + </para><para> + Задайте один из следующих режимов соединения для каждого порта: + </para><itemizedlist> + <listitem><para> + <literal>disconnected</literal> показывает что, даже + если последовательный порт отображается в гостевой ВМ, + он не подключен. Это состояние подобно физическому + COM порту без подключенного кабеля. + </para></listitem> + <listitem><para> + <literal>server</literal> + <replaceable>имя-канала</replaceable> создает + указанный именованный канал или сокет локального + домена в хост системе и присоединяет виртуальное + последовательное устройство к нему. + </para><para> + В хост-системе Windows <replaceable>имя-канала</replaceable> - + это именованный канала с именем в следующем формате: + <literal>\\.\pipe\<replaceable>имя-канала</replaceable></literal>. + </para><para> + В хост-системе Linux, + <replaceable>имя-канала</replaceable> это сокет локального + домена. + </para></listitem> + <listitem><para> + <literal>client</literal> + <replaceable>имя-канала</replaceable> подключает + виртуальное последовательное устройство к указанному + именованному каналу или сокету локального домена. + </para><para> + Заметим, что именованный канал или сокет локального домена + должны уже существовать. + </para></listitem> + <listitem><para> + <literal>tcpserver</literal> + <replaceable>порт</replaceable> создает сокет TCP + с указанным портом TCP в хост-системе и подключает + виртуальное последовательное устройство к нему. + </para><para> + В UNIX-подобных системах используйте порты больше + 1024 для не-root пользователей. + </para></listitem> + <listitem><para> + <literal>tcpclient</literal> + <replaceable>имя-хоста</replaceable>:<replaceable>порт</replaceable> + поключает виртуальное последовательное устройство к + сокету TCP. + </para><para> + Заметим, что TCP сокет должен уже существовать. + </para></listitem> + <listitem><para> + <literal>file</literal> + <replaceable>имя-файла</replaceable> перенаправляет + вывод последовательного порта в указанный файл. + Убедитесь, что <replaceable>имя-файла</replaceable> - + это абсолютный путь к файлу в хост-системе. + </para></listitem> + <listitem><para> + <replaceable>имя-устройства</replaceable> задает имя + устройства физического аппаратного последовательного + порта в указанной хост-системе, куда подсоединяется + виртуальный последовательный порт. + </para><para> + Используйте этот режим для подключения физического + последовательного порта к ВМ. + </para><para> + В хост-системах Windows имя устройства это COM порт + такой как <literal>COM1</literal>. В хост-системах Linux + имя устройства подобно <filename>/dev/ttyS0</filename>. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart-type<replaceable>N</replaceable>=<replaceable>тип-UART</replaceable></option></term> + <listitem><para> + Настраивает тип UART для указанного виртуального последовательного + порта (<replaceable>N</replaceable>). Допустимые значения + <literal>16450</literal>, <literal>16550A</literal> и + <literal>16750</literal>. Значение по умолчанию + <literal>16550A</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lpt-mode<replaceable>N</replaceable>=<replaceable>имя-устройства</replaceable></option></term> + <listitem><para> + Задает имя устройства используемого параллельного порта. + </para><para> + В хост-системах Windows используйте имя устройства как + <command>lpt1</command>. В хост-системах Linux, + используйте имя устройства как <filename>/dev/lp0</filename>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lpt<replaceable>N</replaceable>=<replaceable>I/O-база</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Задает базовый адрес I/O и IRQ параллельного порта. + </para><para> + Можно посмотреть базовый адрес I/O и IRQ, используемый + для параллельного порта, в менеджере устройств. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-controller=<replaceable>тип-контроллера</replaceable></option></term> + <listitem><para> + Задает аудио контроллер, используемый в ВМ. + Допустимые значения: + <literal>ac97</literal>, <literal>hda</literal> и + <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-codec=<replaceable>тип-кодека</replaceable></option></term> + <listitem><para> + Указывает аудио кодек, используемый в ВМ. Допустимые + значения: <literal>stac9700</literal>, + <literal>ad1980</literal>, <literal>stac9221</literal> + и <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-driver=<replaceable>тип</replaceable></option></term> + <listitem><para> + Указывает, что ВМ имеет поддержку аудио определенного типа. + Допустимые значения: + <literal>none</literal>, <literal>default</literal>, + <literal>null</literal>, <literal>dsound</literal>, + <literal>was</literal>, <literal>oss</literal>, + <literal>alsa</literal>, <literal>pulse</literal> и + <literal>coreaudio</literal>. + </para><para> + Заметим, что типы аудио зависят от операционной системы + хоста. Вывод справки по команде <command>VBoxManage + modifyvm</command> поможет определить поддерживаемые + типы аудио для вашей операционной системы. + </para> + <para> + Для обеспечения максимальной совместимости между хостами можно + использовать стандартный аудиодрайвер по + умолчанию. В этом случае, виртуальная машина автоматически выберет + наиболее подходящий аудиодрайвер для текущего доступного хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-enabled=on|off</option></term> + <listitem><para> + Указывает, следует ли включить или отключить звук для виртуальной + машины. + </para> + <para> + Эта опция имеет приоритет над опциями --audio-in и --audio-out, + т.е. отключение звука с помощью этой опции приведет к полному отключению + как входного, так и выходного звука. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-in=on|off</option></term> + <listitem><para> + Указывает, включать или нет аудио захват из хост-системы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio-out=on|off</option></term> + <listitem><para> + Указывает, включать или нет воспроизведение аудио из + гостевой ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--clipboard-mode=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает, как предоставляются данные буфера обмена + между гостевой ВМ и хост-системой. + Допустимые значения: <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и + <literal>bidirectional</literal>. Смотрите + <xref linkend="generalsettings" />. + </para><para> + Функционал буфера обмена доступен только если + Дополнения Гостевой ОС установлены в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--drag-and-drop=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает, как используется функция drag and drop между + хост-системой и ВМ. Допустимые значения: + <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal> и + <literal>bidirectional</literal>. Смотрите + <xref linkend="guestadd-dnd" />. + </para><para> + Функционал drag and drop доступен только если + Дополнения Гостевой ОС установлены в ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--monitor-count=<replaceable>количество</replaceable></option></term> + <listitem><para> + Позволяет настроить несколько мониторов. Смотрите + <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-ohci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 1.1 контроллер ВМ. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-ehci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 2.0 контроллер ВМ. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-xhci=on | off</option></term> + <listitem><para> + Включает или отключает виртуальный USB 3.0 контроллер ВМ. + Это наиболее эффективная опция если ВМ поддерживает его. + Смотрите <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb-rename=<replaceable>старое-имя</replaceable> <replaceable>новое-имя</replaceable></option></term> + <listitem><para> + Переименовывает виртуальный USB контроллер ВМ из + <replaceable>старое-имя</replaceable> в + <replaceable>новое-имя</replaceable>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-recording"> + <title>Настройки записи</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменить настройки записи видео, + записи аудио или обоих. + </para> + <variablelist> + <varlistentry> + <term><option>--recording=on | off</option></term> + <listitem><para> + Включает или отключает запись сессии ВМ в файл WebM или + VP8. Когда установлен в <literal>on</literal>, запись + начинается при старте сессии ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-screens=all | <replaceable>ID-экрана</replaceable></option></term> + <listitem><para> + Позволяет указать записываемый экран ВМ. С каждого экрана + запись ведется в свой файл. Допустимые значения: + <literal>all</literal>, то есть запись со всех экранов + или один или несколько указанных экранов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает имя файла куда сохранять запись. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-max-size=<replaceable>МБ</replaceable></option></term> + <listitem><para> + Задает максимальный размер файла записанного видео в + мегабайтах. Когда файл достигает указанного размера, + запись останавливается. Если указано значение + <literal>0</literal>, запись продолжается пока не будет + остановлена вручную. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-max-time=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает максимальное записываемое время в секундах. + При достижении указанного времени запись останавливается. + Если указано значение <literal>0</literal>, запись + продолжается пока не будет остановлена вручную. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-opts=<replaceable>ключ</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает дополнительные свойства записи видео как + разделенный запятыми список свойств в виде ключ-значение. + Например <literal>foo=bar,a=b</literal>. + </para><para> + Используйте эту опцию, только если вы опытный пользователь. + Информацию о ключах смотрите в <citetitle>Oracle VM + VirtualBox Programming Guide and Reference</citetitle>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-fps=<replaceable>кадров-в-сек</replaceable></option></term> + <listitem><para> + Задает максимальное количество записываемых видеокадров + в секунду (FPS). Запись игнорирует все кадры с более + высокой частотой. Если увеличить FPS, меньше кадров + будет проигнорировано но запись и размер файла с + записью увеличится. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-rate=<replaceable>битрейт</replaceable></option></term> + <listitem><para> + Задает битрейт видео в килобит в секунду. Если увеличить + битрейт, качество записи улучшится но и размер записанного + файла также увеличится. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recording-video-res=<replaceable>ширина</replaceable>x<replaceable>высота</replaceable></option></term> + <listitem><para> + Задает разрешение записанного видео (ширина и высота) + в пикселах. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-vrde"> + <title>Настройки удаленной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют изменить поведение расширения + удаленного рабочего стола VirtualBox (VRDE). + </para> + <variablelist> + <varlistentry> + <term><option>--vrde=on | off</option></term> + <listitem><para> + Включает или отключает сервер VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=TCP/Ports=<replaceable>порт</replaceable></option></term> + <listitem><para> + <replaceable>порт</replaceable> - это порт или диапазон + портов на которые подключается сервер VRDE. Значения + <literal>default</literal> или <literal>0</literal> + используют порт <literal>3389</literal>. Это стандартный + порт RDP. + </para><para> + Также cмотрите описание опции <option>--vrde-port</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=TCP/Address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + <replaceable>IP-адрес</replaceable> - это IP адрес + интерфейса сети хоста, к которому подключается сервер + VRDE. Когда указана, сервер принимает подключения только + на интерфейс сети хоста с этим IP адресом. + </para><para> + Также cмотрите описание опции <option>--vrde-address</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=VideoChannel/Enabled=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает включен ли видеоканал VRDP или нет. + <literal>1</literal> значит <literal>on</literal> и + <literal>0</literal> значит <literal>off</literal>. + Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Quality=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает значение между 10% и 100% включительно. Она + представляет уровень сжатия JPEG в видеоканале сервера + VRDE. Меньшее значение приводит к худшему качеству JPEG + но более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DownscaleProtection=<replaceable>значение</replaceable></option></term> + <listitem><para> + Включает или отключает функцию защиты от уменьшения + масштаба. Допустимые значения <literal>1</literal> + включающая функцию и <literal>0</literal>, отключающую ее. + </para><para> + Когда эта функция включена, &product-name; определяет + отображать ли видео: + </para><itemizedlist> + <listitem><para> + Когда размер видео соответствуют размеру теневого + буфера, видео рассматривается как полноэкранное и + отображается. + </para></listitem> + <listitem><para> + Когда размер видео между полным экраном и порогом + уменьшения масштаба, видео не отображается. Такое + видео может быть окном приложения, нечитаемым при + уменьшении масштаба. + </para></listitem> + </itemizedlist><para> + Когда эта функция отключена, все равно производится попытка + отобразить видео. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableDisplay=1</option></term> + <listitem><para> + Отключает функцию отображения сервера VRDE. + </para><para> + Для повторного включения этой функции, назначьте пустое + значение. Например, для включения функии отображения + укажите команду <command>VBoxManage modifyvm + --vrde-property=Client/DisableDisplay=</command>. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableInput=1</option></term> + <listitem><para> + Отключает функцию ввода сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableAudio=1</option></term> + <listitem><para> + Отключает функцию аудио сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableUSB=1</option></term> + <listitem><para> + Отключает функцию USB сервера VRDE. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableClipboard=1</option></term> + <listitem><para> + Отключает функцию буфера обмена сервера VRDE. Для + включения этой функции, назначьте пустое значение. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=DisableUpstreamAudio=1</option></term> + <listitem><para> + Отключает функцию передачи аудио на сервер VRDE. + Для включения этой функции назначьте пустое значение. + Смотрите <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Client/DisableRDPDR=1</option></term> + <listitem><para> + Отключает функцию RDP перенаправления устройств для + смарт-карт сервера VRDE. Для включения этой функции + назначьте пустое значение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=H3DRedirect/Enabled=1</option></term> + <listitem><para> + Включает функию перенаправления 3D сервера VRDE. Для + включения этой функции назначьте пустое значение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=Security/Method=<replaceable>значение</replaceable></option></term> + <listitem><para> + Указывает следующую информаицю, требуемую для подключения: + </para><itemizedlist> + <listitem><para> + <literal>Negotiate</literal> показывает, что разрешены + подключения, имеющие и расширенную (TLS) и стандартную + безопасность RDP. Метод безопасности согласуется с + клиентом. Это значение по умолчанию. + </para></listitem> + <listitem><para> + <literal>RDP</literal> показывает, что принимается только + подключение, имеющее стандартную безопасность RDP. + </para></listitem> + <listitem><para> + <literal>TLS</literal> показывает, что принимается только + подключение, имеющее расширенную безопасность RDP. Клиент + должен поддерживать TLS. + </para></listitem> + </itemizedlist><para> + Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=ServerCertificate=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к сертификату сервера. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=ServerPrivateKey=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к приватному ключу сервера. Смотрите + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=CACertificate=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к корневому самоподписанному + сертификату. Смотрите <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property Audio/RateCorrectionMode=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает режим подключения аудио или путь к файлу аудио + журнала. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>VRDP_AUDIO_MODE_VOID</literal> - + отсутствие режима. Используйте это значение для + снятия используемого режима. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_RC</literal> - режим + коррекции скорости. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_LPF</literal> - режим + низкочастотного фильтра. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_CS</literal> - режим + синхронизации с клиентом для предотвращения + переполнения или недозаполнености очереди клиента. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-property=LogPath=<replaceable>значение</replaceable></option></term> + <listitem><para> + Задает абсолютный путь к файлу аудио журнала. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-extpack=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Задает библиотеку, используемую для удаленного доступа + к ВМ. Значение <literal>default</literal> использует + код RDP, который является частью пакета расширения + &product-name;. + </para><para> + Для использования модуля VRDE в VNC, укажите + <literal>VNC</literal>. Смотрите + <xref linkend="otherextpacks"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-port=default | <replaceable>порт</replaceable></option></term> + <listitem><para> + <replaceable>порт</replaceable> - это порт или диапазон + портов на которые подключается сервер VRDE. Значение + <literal>default</literal> или <literal>0</literal> + использует порт <literal>3389</literal>, который + является стандартным портом RDP. + </para><para> + Можно указать разделенный запятыми список портов или + диапазонов портов. Используйте дефис между двумя + номерами портов для задания диапазона. Сервер VRDE + подключается только к одному доступному порту из списка. + В один и тот же момент, только одна машина может + использовать данный порт. Например, опция + <option>--vrde-port=5000,5010-5012</option> указывает, + что сервер может подключиться на один из следующих портов: + <literal>5000</literal>, <literal>5010</literal>, + <literal>5011</literal> или <literal>5012</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает IP адрес интерфейса сети хоста, на который + подключается сервер VRDE. Если указать IP адрес, сервер + VRDE принимает подключения только с указанного + интерфейса сети хоста. + </para><para> + Используйте эту опцию для указания, что сервер VRDP + должен принимать IPv4, IPv6 или оба тип соединений: + </para><itemizedlist> + <listitem><para> + <emphasis role="bold">Только IPv4:</emphasis> + Используйте опцию + <option>--vrde-address="0.0.0.0"</option>. + </para></listitem> + <listitem><para> + <emphasis role="bold">Только IPv6:</emphasis> + Используйте опцию + <option>--vrde-address="::"</option>. + </para></listitem> + <listitem><para> + <emphasis role="bold">И IPv6 и IPv4:</emphasis> + Используйте опцию <option>--vrde-address=""</option>. + Это значение по умолчанию. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-auth-type=null | external | guest</option></term> + <listitem><para> + Указывает использовать ли авторизацию и как ее проводить. + Смотрите <xref linkend="vbox-auth" />. Допустимые значения: + </para><itemizedlist> + <listitem><para> + <literal>null</literal> - без аутентификации. + </para></listitem> + <listitem><para> + <literal>external</literal> - внешняя аутентификация + через библиотеку аутентификации. + </para></listitem> + <listitem><para> + <literal>guest</literal> - аутентификация через + гостевые пользовательские учетные записи. Этот + неподдерживаемый метод требует установки Дополнений + Гостевой ОС в ВМ. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-auth-library=default | <replaceable>имя</replaceable></option></term> + <listitem><para> + Задает библиотеку, используемую для аутентификации RDP. + Библиотека по умолчанию для внешней аутентификации + <filename>VBoxAuth</filename>. Смотрите + <xref linkend="vbox-auth" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-multi-con=on | off</option></term> + <listitem><para> + Включает или отключает функцию множественных подключений + к серверу VRDE, если поддерживается. Смотрите + <xref linkend="vrde-multiconnection" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-reuse-con=on | off</option></term> + <listitem><para> + Задает поведение сервера VRDE когда множественные + подключения отключены. Когда значение + <literal>on</literal>, сервер разрешает подключение + нового клиента и разрывает существующее. Когда значение + <literal>off</literal>, новое подключение не принимается + если клиент уже подключен к серверу. Это значение + по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-video-channel=on | off</option></term> + <listitem><para> + Включает перенаправление видео, если поддерживается сервером + VRDE. Смотрите <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrde-video-channel-quality=<replaceable>процент</replaceable></option></term> + <listitem><para> + Задает качество видео при перенаправлении как величина + от 10 до 100 процентов. Процент представляет уровень + сжатия JPEG, где меньшие значения ухудшают качество, + но обеспечивают более высокое сжатие. Смотрите + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-teleport"> + <title>Настройки портирования</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции позволяют настроить машину как цель + портирования. Смотрите <xref linkend="teleporting" />. + </para> + <variablelist> + <varlistentry> + <term><option>--teleporter=on | off</option></term> + <listitem><para> + Включает или выключает портирование. Когда включено, + машина стартует и ждет получения запроса на портирование + из сети вместо нормальной загрузки. + </para><para> + Запросы на портирование принимаются на порт и адрес, + указанный в следующих параметрах: + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-port=<replaceable>порт</replaceable></option></term> + <listitem><para> + Задает порт, который слушает ВМ для получения запросов + на портирование из другой ВМ. + <replaceable>порт</replaceable> - это любой свободный + номер TCP/IP порта, такой как <literal>6000</literal>. + Необходимо также указать опцию <option>--teleporter</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-address=<replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает IP адрес, который слушает ВМ для получения + запросов на портирование из другой ВМ. + <replaceable>IP-адрес</replaceable> - это любой IP + адрес или имя хоста. Он указывает сокет TCP/IP для + подключения. IP адрес по умолчанию + <literal>0.0.0.0</literal>, который представляет + любой IP адрес. Необходимо также указать опцию + <option>--teleporter</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-password=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Задает пароль, используемый для аутентификации. Когда + указан, запрос на портирование успешен только тогда, когда + пароль в исходной машине такой же, как и указанный. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporter-password-file=<replaceable>имя-файла</replaceable></option></term> + <listitem><para> + Задает файл, содержащий пароль для использования в + аутентификации. Когда указан, запрос на портирование + успешен только тогда, когда пароль в исходной машине + такой же, как и в указанном файле. Значение + <literal>stdin</literal> читает пароль из стандартного + потока ввода. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-portability-level=<replaceable>уровень</replaceable></option></term> + <listitem> + <para> + Ограничивает способности виртуального ЦПУ, которые + &product-name; представляет гостевой ОС использую правила + портативности. Более высокие целые значения означают + более ограниченное поведение. Уровень по умолчанию + <literal>0</literal> показывает, что весь поддерживаемый + хостом вируализированный функционал доступен гостевой + системе. Значение <literal>3</literal> подавляет + большинство функций. Значения <literal>1</literal> + и <literal>2</literal> представляют ограничения между + предыдущими уровнями. Поведение может меняться в + зависимости от версии продукта. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-set=<replaceable>лист</replaceable>[:<replaceable>подлист</replaceable>] + <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></option></term> + <listitem> + <para> + Опытные пользователи используют эту настройку перед + операцией портирования (фактически перед запуском ВМ) + для ограничения способностей виртуального ЦПУ, которые + &product-name; предоставляет гостевой операционной + системе. Это должно быть запущено и на исходной и на + целевой машинах, вовлеченных в процесс портирования и + определяет, что гостевая система увидит когда выполняет + машинную инструкцию CPUID. Это может помочь с неправильным + поведением приложений, которые неправильно предполагают, + что присутствуют определенные способности ЦПУ. + Значение параметра зависит от оборудования. Обратитесь + к документации AMD или Intel. + </para><para> + Значения <replaceable>лист</replaceable>, + <replaceable>подлист</replaceable> (необязательно), + <replaceable>eax</replaceable>, <replaceable>ebx</replaceable>, + <replaceable>ecx</replaceable> и <replaceable>edx</replaceable> + - это целые числа данные в шестнадцатиричном формате, то есть + используя основание 16 без какого-либо префикса. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-remove=<replaceable>лист</replaceable>[:<replaceable>подлист</replaceable>]</option></term> + <listitem> + <para> + Удаляет подстройку, установленную через <option>--cpuid-set</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid-remove-all</option></term> + <listitem> + <para> + Удаляет все подстройки, установленные через <option>--cpuid-set</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-debugging"> + <title>Настройки отладки</title> + <remark role="help-copy-synopsis"/> + <para> + Используйте следующие опции только для низкоуровневой + отладки ВМ. Эти опции только для опытных пользователей. + </para> + <variablelist> + <varlistentry> + <term><option>--tracing-enabled=on | off</option></term> + <listitem><para> + Включает или отключает буфер трассировки. Заметим, что + когда указан, буфер трассировки потребляет память и + добавляет накладные расходы. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-config=<replaceable>строка-настроек</replaceable></option></term> + <listitem><para> + Включает конфигурацию трассировки, определяющую группу + включенных точек трассировки. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-allow-vm-access=on | off</option></term> + <listitem><para> + Включает или отключает доступ ВМ к буферу трассировки. + Значение по умолчанию <literal>off</literal>, что + запрещает доступ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-usbcardreader"> + <title>Настройки USB картридера</title> + <remark role="help-copy-synopsis"/> + <para> + Следующие опции задают доступ гостевого окружения к USB картридеру. + USB картридер может получить доступ к данным карт памяти, таких + как CompactFlash (CF), Secure Digital (SD) и MultiMediaCard (MMC). + </para> + <variablelist> + <varlistentry> + <term><option>--usb-card-reader=on | off</option></term> + <listitem><para> + Включает или отключает интерфейс USB картридера. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-autostart"> + <title>Автостарт ВМ в течение загрузки хост-системы</title> + <para> + Следующие опции позволяют настроить функцию автостарта ВМ, + которая автоматически стартует ВМ во время загрузки хост-системы. + Требуется произвести некоторые настройки хост-системы перед + использованием этой функции. Смотрите <xref linkend="autostart" />. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--autostart-enabled=on | off</option></term> + <listitem><para> + Включает или отключает автостарт ВМ во время загрузки + хост-системы для указанного пользователя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--autostart-delay=<replaceable>секунды</replaceable></option></term> + <listitem><para> + Задает количество секунд, по истечении которых после + загрузки хост-системы, ВМ стартует. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-pcipassthrough"> + <title>Настройки сквозного режима PCI</title> + <para> + Следующие опции позволяют настроить функцию сквозного режима PCI, + которая на настоящий момент не доступна в &product-name;. + Планируется вернуть данный функционал в будущем. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--pci-attach=<replaceable>PCI-адрес-хоста</replaceable>[@<replaceable>гостевой-PCI-адрес-шины</replaceable>]</option></term> + <listitem><para> + Подключает указанный сетевой контроллер PCI хоста к гостевой + ВМ. Можно опционально указать шину PCI в гостевой ВМ, куда + подключать контроллер. +<!-- See <xref linkend="pcipassthrough" />. --> + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pci-detach=<replaceable>PCI-адрес-хоста</replaceable></option></term> + <listitem><para> + Отключает указанный сетевой контроллер PCI из + подключенной PCI шины гостевой ВМ. +<!-- See <xref linkend="pcipassthrough" />. --> + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-testing"> + <title>Тестирование (ValidationKit / Bootsector)</title> + <para> + Эти опции для настройки функционала тестирования VMM устройств и + почти экслюзивно используются bootsector тестами в ValidationKit. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--testing-enabled=on | off</option></term> + <listitem><para>Включен функционал тестирования VMMDev. Для подробной информации смотрите VMMDevTesting.h. </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--testing-mmio=on | off</option></term> + <listitem><para>Включена область MMIO для функционала тестирования VMMDev.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--testing-cfg-dword<replaceable>idx</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Это задает один из 10 DWORD значений конфигурации. + <replaceable>idx</replaceable> должен быть в диапазоне от 0 до 9. + <replaceable>значение</replaceable> ограничено 32 битами (DWORD). + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда изменяет описание для ВМ + <filename>ol7</filename>. + </para> +<screen>$ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4"</screen> + <para> + Следующая команда включает поддержку протокола удаленного + рабочего стола VirtualBox (VRDP) для ВМ <filename>ol7</filename>. + </para> +<screen>$ VBoxManage modifyvm ol7 --vrde on</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-showvminfo" />, + <xref linkend="vboxmanage-controlvm" />, + <xref linkend="vboxmanage-createvm" />, + <xref linkend="vboxmanage-startvm" /> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-movevm.xml b/doc/manual/ru_RU/man_VBoxManage-movevm.xml new file mode 100644 index 00000000..889e34ef --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-movevm.xml @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage movevm +--> +<!-- + 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-movevm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage movevm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-movevm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-movevm</refname> + <refpurpose>перемещает виртуальную машину в новое расположение в хост-системе</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-movevm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage movevm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--type=basic</arg> + <arg>--folder=<replaceable>имя-папки</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage movevm</command> перемещает + виртуальную машину (ВМ) в новое расположение в хост-системе. + </para> + <para> + Когда перемещена, все файлы, связанные с ВМ, такие как файлы + настроек и файлы образов дисков, перемещаются в новое расположение. + Конфигурация &product-name; обновляется автоматически. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Указывает Универсальный Уникальный Идентификатор (UUID) + или имя ВМ для перемещения. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--type=basic</option></term> + <listitem><para> + Задает тип операции перемещения. Пока что <literal>basic</literal> + является единственным распознаваемым значением и также + является значением по умолчанию, если не указан. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--folder=<replaceable>имя-папки</replaceable></option></term> + <listitem><para> + Указывает полный или относительный путь к новому + расположению в файловой системе хоста. Позволяется + не указывать эту опцию или указать текущее расположение. + В этом случае производится перемещение образов дисков + и других частей ВМ в это расположение, если они находятся + в других местах. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда перемещает ВМ <filename>ol7</filename> в новое + расположение в хост-системе. + </para> +<screen>$ VBoxManage movevm ol7 --folder "/home/testuser/vms" --type basic +0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% +Машина успешно перемещена в /home/testuser/vms</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-natnetwork.xml b/doc/manual/ru_RU/man_VBoxManage-natnetwork.xml new file mode 100644 index 00000000..850fcb25 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-natnetwork.xml @@ -0,0 +1,367 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage natnetwork +--> +<!-- + 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-natnetwork" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage natnetwork</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-natnetwork</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-natnetwork</refname> + <refpurpose>создает, изменяет или управляет сетью NAT</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-add"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage natnetwork add</command> + <group> + <arg choice="plain">--disable</arg> + <arg choice="plain">--enable</arg> + </group> + <arg choice="req">--netname=<replaceable>имя</replaceable></arg> + <arg choice="req">--network=<replaceable>сеть</replaceable></arg> + <arg>--dhcp=on|off</arg> + <arg>--ipv6=on|off</arg> + <arg>--loopback-4=<replaceable>правило</replaceable></arg> + <arg>--loopback-6=<replaceable>правило</replaceable></arg> + <arg>--port-forward-4=<replaceable>правило</replaceable></arg> + <arg>--port-forward-6=<replaceable>правило</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-list"> + <command>VBoxManage natnetwork list</command> + <arg><replaceable>шаблон-фильтра</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-modify"> + <command>VBoxManage natnetwork modify</command> + <arg>--dhcp=on|off</arg> + <group> + <arg choice="plain">--disable</arg> + <arg choice="plain">--enable</arg> + </group> + <arg choice="req">--netname=<replaceable>имя</replaceable></arg> + <arg choice="req">--network=<replaceable>сеть</replaceable></arg> + <arg>--ipv6=on|off</arg> + <arg>--loopback-4=<replaceable>правило</replaceable></arg> + <arg>--loopback-6=<replaceable>правило</replaceable></arg> + <arg>--port-forward-4=<replaceable>правило</replaceable></arg> + <arg>--port-forward-6=<replaceable>правило</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-remove"> + <command>VBoxManage natnetwork remove</command> + <arg choice="req">--netname=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-start"> + <command>VBoxManage natnetwork start</command> + <arg choice="req">--netname=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-natnetwork-stop"> + <command>VBoxManage natnetwork stop</command> + <arg choice="req">--netname=<replaceable>имя</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage natnetwork</command> позволяет + создавать, изменять и управлять сетью NAT. + </para> + <para> + Сети NAT используют службу преобразования сетевых адресов (NAT). + Служба группирует системы в сеть и предотвращает прямой доступ + внешних систем к системам внутри сети. Служба также позволяет + системам в сети общаться друг с другом и с внешними системами + посредством TCP и UDP через IPv4 и IPv6. + </para> + <para> + Служба NAT подключена к внутренней сети. Чтобы ВМ использовала + службу NAT, необходимо подключить ВМ к внутренней сети. Задайте + имя внутренней сети когда создаете службу NAT. Заметим, что + внутренняя сеть создается если она еще не существует. + </para> + <refsect2 id="vboxmanage-natnetwork-add"> + <title>Добавить службу сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork add</command> создает + новый интерфейс внутренней сети и добавляет службу сети NAT. + Вы должны использовать эту команду перед тем как подключать + ВМ к сети NAT. + </para> + <variablelist> + <varlistentry> + <term><option>--disable</option></term> + <listitem><para> + Отключает службу сети NAT. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option></term> + <listitem><para> + Включает службу сети NAT. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--netname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя нового интерфейса внутренней сети в ОС хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--network</option></term> + <listitem><para> + Указывает статический адрес или сетевой адрес DHCP и + маску интерфейса службы NAT. По умолчанию, это значение + указывает статический сетевой адрес. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dhcp</option></term> + <listitem><para> + Включает или отключает сервер DHCP, который указывается + через опцию <option>--netname</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ipv6</option></term> + <listitem><para> + Включает или отключает IPv6. По умолчанию, IPv6 отключен, + а IPv4 включен. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--loopback-4=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает интерфейс локальной петли IPv4, используя + указанное правило. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--loopback-6=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает интерфейс локальной петли IPv6, используя + указанное правило. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port-forward-4=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает перенаправление портов IPv4 используя правило, + указанное в <replaceable>правило</replaceable>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port-forward-6=<replaceable>rule</replaceable></option></term> + <listitem><para> + Включает перенаправление портов IPv6 используя правило, + указанное в <replaceable>правило</replaceable>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-natnetwork-remove"> + <title>Удалить службу сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork remove</command> + удаляет указанную службу сети NAT. + </para> + <variablelist> + <varlistentry> + <term><option>--netname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя удаляемой службы сети NAT. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-natnetwork-start"> + <title>Запустить службу сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork start</command> + запускает службу сети NAT и любой связанный сервер DHCP. + </para> + <variablelist> + <varlistentry> + <term><option>--netname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя запускаемой службы сети NAT. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-natnetwork-stop"> + <title>Остановить службу сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork stop</command> + останавливает службу сети NAT и любой связанный сервер DHCP. + </para> + <variablelist> + <varlistentry> + <term><option>--netname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя останавливаемой службы сети NAT. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-natnetwork-list"> + <title>Показать все службы сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork list</command> показывает + все службы сети NAT. Можно использовать шаблон для отображения + подмножества служб сетей NAT. + </para> + <variablelist> + <varlistentry> + <term><replaceable>шаблон-фильтра</replaceable></term> + <listitem><para> + Указывает необязательный шаблон фильтра. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-natnetwork-modify"> + <title>Изменить настройки службы сети NAT</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage natnetwork modify</command> + изменяет настройки существующего интерфейса внутренней + сети. + </para> + <variablelist> + <varlistentry> + <term><option>--disable</option></term> + <listitem><para> + Отключает службу сети NAT. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--enable</option></term> + <listitem><para> + Включает службу сети NAT. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--netname=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя нового интерфейса внутренней сети в ОС хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--network</option></term> + <listitem><para> + Указывает статический или DHCP сетевой адрес и маску + интерфейса службы NAT. По умолчанию это значение + указывает статический сетевой адрес. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dhcp</option></term> + <listitem><para> + Включает или отключает сервер DHCP, указанный через + опцию <option>--netname</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ipv6</option></term> + <listitem><para> + Включает или отключает IPv6. По умолчанию IPv6 отключен, а + IPv4 включен. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--loopback-4=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает интерфейс локальной петли IPv4, используя + указанное правило. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--loopback-6=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает интерфейс локальной петли IPv6, используя + указанное правило. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port-forward-4=<replaceable>правило</replaceable></option></term> + <listitem><para> + Включает перенаправление портов IPv4, используя правило, + указанное в <replaceable>правило</replaceable>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port-forward-6=<replaceable>rule</replaceable></option></term> + <listitem><para> + Включает перенаправление портов IPv6, используя правило, + указанное в <replaceable>правило</replaceable>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда показывает как создать сеть NAT для + внутренней сети <literal>natnet1</literal>, использующей + сетевой адрес и маску <literal>192.168.15.0/24</literal> + интерфейса службы NAT. В этой статической конфигурации, + по умолчанию шлюзу назначен IP адрес <literal>192.168.15.1</literal>. + Заметим, что этот IP адрес - это следующий адрес после адреса, + указанного опцией <option>--network</option>. + </para> +<screen>$ VBoxManage natnetwork add --netname natnet1 --network "192.168.15.0/24" --enable</screen> + <para> + Следующая команда показывает как добавить сервер DHCP к + сети NAT <literal>natnet1</literal> после создания: + </para> +<screen>$ VBoxManage natnetwork modify --netname natnet1 --dhcp on</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-registervm.xml b/doc/manual/ru_RU/man_VBoxManage-registervm.xml new file mode 100644 index 00000000..76688b7a --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-registervm.xml @@ -0,0 +1,102 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage registervm +--> +<!-- + 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-registervm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage registervm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-registervm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-registervm</refname> + <refpurpose>регистрирует виртуальную машину</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-registervm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage registervm</command> + <arg choice="req"><replaceable>имя-файла</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage registervm</command> позволяет + создать виртуальную машину (ВМ) путем импорта XML файла + конфигурации машины в &product-name;. У ВМ не может быть + такой же UUID как и у машины, уже зарегистрированной в + &product-name;. Убедитесь перед регистрацией, что XML файл + конфигурации машины находится в папке машины. + </para> + <note> + <para> + При создании ВМ с помощью команды <command>VBoxManage + createvm</command> можно указать опцию <option>--register</option> + для регистрации ВМ после создания. + </para> + </note> + <variablelist> + <varlistentry> + <term><replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает XML файл конфигурации машины. Этот файл + имеет расширение <filename>.vbox</filename>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда регистрирует ВМ, называемую <literal>vm2</literal>. + XMl файл конфигурации машины для этой ВМ расположен в папке машины + по умолчанию. + </para> +<screen>$ VBoxManage registervm "/home/user/VirtualBox VMs/vm2/vm2.vbox"</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-createvm"/>, + <xref linkend="vboxmanage-unregistervm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-setextradata.xml b/doc/manual/ru_RU/man_VBoxManage-setextradata.xml new file mode 100644 index 00000000..bb7e9c0f --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-setextradata.xml @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage setextradata +--> +<!-- + 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-setextradata" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage setextradata</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-setextradata</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-setextradata</refname> + <refpurpose>устанавливает значение ключа связанного с виртуальной машиной или конфигурацией</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-setextradata"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage setextradata</command> + <group choice="req"> + <arg choice="plain">global</arg> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req"><replaceable>ключ</replaceable></arg> + <arg><replaceable>значение</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage setextradata</command> позволяет + задать значение ключа связанного с виртуальной машиной (ВМ) + или с конфигурацией &product-name;. + </para> + <variablelist> + <varlistentry> + <term><literal>global</literal></term> + <listitem><para> + Устанавливает информацию о конфигурации а не ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + имя ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>ключ</replaceable></term> + <listitem><para> + Задает ключ, для которого задается значение. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>значение</replaceable></term> + <listitem><para> + Задает значение ключа. Если не указывается значение, ключ + удаляется. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда устанавливает значение ключа + <literal>installdate</literal> для ВМ <literal>Fedora5</literal> + в <literal>2019.01.01</literal>: + </para> +<screen>$ VBoxManage setextradata Fedora5 installdate 2019.01.01</screen> + <para> + Следующая команда удаляет значение ключа + <literal>installdate</literal> из ВМ + <literal>Fedora5</literal>: + </para> +<screen>$ VBoxManage setextradata Fedora5 installdate</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-getextradata" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-setproperty.xml b/doc/manual/ru_RU/man_VBoxManage-setproperty.xml new file mode 100644 index 00000000..354e5d70 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-setproperty.xml @@ -0,0 +1,232 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage setproperty +--> +<!-- + 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-setproperty" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage setproperty</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-setproperty</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-setproperty</refname> + <refpurpose>изменение глобальных настроек</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-setproperty"> + <command>VBoxManage setproperty</command> + <arg choice="req"><replaceable>имя-свойства</replaceable></arg> + <arg choice="req"><replaceable>значение-свойства</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage setproperty</command> позволяет + изменить глобальные настройки влияющие на всю инсталляцию + &product-name;. Некоторые из этих настроек соответствуют + настройкам в диалоге <emphasis role="bold">Настройки</emphasis> + в Менеджере VirtualBox. + </para> + <para> + Доступны следующие свойства: + </para> + <variablelist> + <varlistentry> + <term><literal>autostartdbpath</literal></term> + <listitem><para> + Задает путь к базе данных автостарта. Допустимые значения + <literal>null</literal>, которое отключает базу данных + автостарта или имя папки, содержащую базу данных. + Смотрите <xref linkend="autostart" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>defaultfrontend</literal></term> + <listitem><para> + Задает глобальный фронтенд ВМ по умолчанию. Допустимые + значения <literal>default</literal>, которое указывает + фронтенд по умолчанию, или имя используемого фронтенда. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>hwvirtexclusive</literal></term> + <listitem><para> + Указывает, использует ли &product-name; эксклюзивно + расширение аппаратной виртуализации Intel VT-x или AMD-V + системного процессора хоста. Смотрите <xref linkend="hwvirt" />. + </para><para> + Допустимы следующие значения: + </para><itemizedlist> + <listitem><para> + <literal>on</literal> позволяет &product-name; + использовать эксклюзивно эти расширения. Это значение + по умолчанию. + </para></listitem> + <listitem><para> + <literal>off</literal> совместно использует эти + расширения с другими гипервизорами, работающими + одновременно. Заметим, что отключение этой + настройки имеет негативное воздействие на + производительность. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><literal>language</literal></term> + <listitem><para> + Указывает язык пользователя для перевода сообщений API. + Допустимые значения <literal>C</literal>, что означает + отсутствие перевода или код языка в форме <literal>ll</literal> + или <literal>ll_CC</literal>, где <literal>ll</literal> - + это двухбуквенный код языка в нижнем регистре и + <literal>CC</literal> - это двухбуквенный код страны в + верхнем регистре. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>logginglevel</literal></term> + <listitem><para> + Задает детали журналирования VBoxSVC в режиме выпуска. + Смотрите <ulink url="http://www.virtualbox.org/wiki/VBoxLogging" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>loghistorycount</literal></term> + <listitem><para> + Указывает количество оставляемых циклических журналов ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>machinefolder</literal></term> + <listitem><para> + Задает папку по умолчанию куда сохраняются определения + виртуальных машин (ВМ). Допустимые значения + <literal>default</literal>, который указывает папку + хранилища по умолчанию или имя используемой папки. + Смотрите <xref linkend="vboxconfigdata" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>proxymode</literal></term> + <listitem><para> + Настраивает режим сервера прокси HTTP. Допустимые значения: + </para><variablelist> + <varlistentry> + <term><literal>manual</literal></term> + <listitem><para> + Настраивает вручную URL сервера прокси HTTP, + с помощью значения свойства <literal>proxyurl</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>noproxy</literal></term> + <listitem><para> + Не использовать сервер прокси HTTP. Используется + прямое соединение к интернету. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>system</literal></term> + <listitem><para> + Автоматически определить настройки прокси для сети + хоста. Это значение по умолчанию. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + <varlistentry> + <term><literal>proxyurl</literal></term> + <listitem><para> + Задает URL для сервера прокси HTTP при использовании + ручной настройки через установку свойства + <literal>proxymode</literal> в <literal>manual</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>vrdeauthlibrary</literal></term> + <listitem><para> + Указывает используемую библиотеку если настроена + внешняя аутентификация для определенной ВМ. Допустимые + значения <literal>default</literal>, которая задает + библиотеку по умолчанию или имя используемой библиотеки. + Смотрите <xref linkend="vbox-auth" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>vrdeextpack</literal></term> + <listitem><para> + Задает библиотеку, реализующую расширение удаленного + рабочего стола VirtualBox (RDE). Допустимые значения + <literal>null</literal>, которое отключает RDE или имя + используемой библиотеки. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>websrvauthlibrary</literal></term> + <listitem><para> + Указывает, библиотеку, используемую веб службой для + аутентификации пользователей. Допустимые значения + <literal>default</literal>, которое задает библиотеку + по умолчанию, <literal>null</literal>, которое отключает + аутентификацию или имя используемой библиотеки. Для + дополнительной информации о веб службе &product-name; + Смотрите <xref linkend="VirtualBoxAPI" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда настраивает &product-name; для использования + указанного сервера прокси HTTP. + </para> +<screen>$ VBoxManage setproperty proxymode manual +$ VBoxManage setproperty proxyurl "http://myproxy.com:8080"</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-startvm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-sharedfolder.xml b/doc/manual/ru_RU/man_VBoxManage-sharedfolder.xml new file mode 100644 index 00000000..a3d4d88d --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-sharedfolder.xml @@ -0,0 +1,214 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage sharedfolder +--> +<!-- + 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-sharedfolder" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage sharedfolder</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-sharedfolder</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-sharedfolder</refname> + <refpurpose>добавление или удаление общих папок</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-add"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage sharedfolder add</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req">--name=<replaceable>имя</replaceable></arg> + <arg choice="req">--hostpath=<replaceable>путь-в-хост-системе</replaceable></arg> + <arg>--readonly</arg> + <arg>--transient</arg> + <arg>--automount</arg> + <arg>--auto-mount-point=<replaceable>путь</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-remove"> + <command>VBoxManage sharedfolder remove</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req">--name=<replaceable>имя</replaceable></arg> + <arg>--transient</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Общие папки позволяют предоставить совместный доступ к данным + между хост-системой и гостевыми системами. Для использования + общих папок, сначала надо установить Дополнения Гостевой ОС + &product-name; в гостевой ОС. + </para> + <para> + Общая папка связана с именем разделяемого ресурса и полным + путем к папке или директории в хост-системе. Имя разделяемого + ресурса - это уникальное имя в пространстве имен ОС хоста. + </para> + <refsect2 id="vboxmanage-sharedfolder-add"> + <title>Добавить общую папку</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage sharedfolder add</command> создает + общую папку. Папка указывается в хост-системе. Когда папка + настроена, к содержимому папки в хост-системе может быть + предоставлен совместный доступ в гостевых ОС. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает имя или UUID гостевой ВМ, которая разделяет папку + с хост-системой. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--name=<replaceable>имя</replaceable></term> + <listitem><para> + Задает имя разделяемого ресурса, который имеет + уникальное имя в пространстве имен ОС хоста. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--hostpath=<replaceable>путь-в-хост-системе</replaceable></term> + <listitem><para> + Задает абсолютный путь к папке или директории в ОС хоста + для предоставления доступа гостевым ОС. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--readonly</term> + <listitem><para> + Указывает, что разделяемый ресурс имеет доступ только + для чтения к файлам хоста. + </para><para> + По умолчанию, общие папки имеют доступ на чтение и на + запись к файлам хоста. Однако, в дистрибутивах Linux, + общие папки монтируются с файловыми разрешениями 770, + пользователем <literal>root</literal> и группой + <literal>vboxsf</literal>. Эта опция устанавливает + файловые разрешения в 700. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--transient</term> + <listitem><para> + Задает что разделяемый ресурс временный, что означает, что + он может быть добавлен и удален в время выполнения и не + сохраняется после выключения ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--automount</term> + <listitem><para> + Указывает, что разделяемый ресурс монтируется автоматически. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--auto-mount-point=<replaceable>путь</replaceable></term> + <listitem><para> + Задает точку монтирования разделяемого ресурса. Зависит от гостевой ОС. + </para><para> + Для гостевых систем Windows и OS/2 она должна быть неиспользуемой + буквой диска. Если оставить пустым (или указать используемую + букву диска), будет использована последняя неиспользуемая буква + диска вместо указанной (то есть ищется буква с <literal>Z:</literal> + по <literal>A:</literal>). + </para><para> + Для Linux, Solaris и других гостевых систем UNIX, он должен быть + абсолютным путем, например <filename>/mnt/mysharedfolder</filename>. + Если оставить пустым, расположение по умолчанию будет + <filename>/media/sf_<replaceable>имя-общей-папки</replaceable></filename>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-sharedfolder-remove"> + <title>Удалить общую папку</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage sharedfolder remove</command> + удаляет общую папку. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает имя или UUID гостевой ВМ, которая разделяет папку + с хост-системой. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--name=<replaceable>имя</replaceable></term> + <listitem><para> + Задает имя удаляемого разделяемого ресурса. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--transient</term> + <listitem><para> + Указывает, что папка временная, что означает что она + может быть добавлена и удалена во время выполнения и не + сохраняется после выключения ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает общую папку, называемую + <filename>o7share</filename> для ВМ <filename>ol7</filename>. + Папка монтируется автоматически при старте ВМ. + </para> +<screen>$ VBoxManage sharedfolder add ol7 --name ol7share --hostpath "/home/user/ol7share" --automount</screen> + <para> + Следующая команда удаляет общую папку, называемую + <filename>o7share</filename> из ВМ <filename>ol7</filename>. + </para> +<screen>$ VBoxManage sharedfolder remove ol7 --name ol7share</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-showmediuminfo.xml b/doc/manual/ru_RU/man_VBoxManage-showmediuminfo.xml new file mode 100644 index 00000000..57efa575 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-showmediuminfo.xml @@ -0,0 +1,142 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage showmediuminfo +--> +<!-- + 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-showmediuminfo" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage showmediuminfo</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-showmediuminfo</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-showmediuminfo</refname> + <refpurpose>отображение информации о носителе</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-showmediuminfo"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage showmediuminfo</command> + <group> + <arg choice="plain">disk</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">floppy</arg> + </group> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage showmediuminfo</command> показывает + следующую информацию о носителе: + </para> + <itemizedlist> + <listitem><para> + Размер + </para></listitem> + <listitem><para> + Размер на диске + </para></listitem> + <listitem><para> + Тип + </para></listitem> + <listitem><para> + Используется виртуальными машинами (ВМ) + </para></listitem> + </itemizedlist> + <para> + Носитель должен быть указан или через UUID, если носитель + зарегистрирован или через имя файла. Зарегистрированные носители + можно увидеть через <command>VBoxManage list hdds</command>, + <command>VBoxManage list dvds</command> или <command>VBoxManage list + floppies</command> соответственно. + </para> + <para> + Для обратной совместимости, можно также использовать команду + <command>showvdiinfo</command> для получения информации о + носителе. + </para> + <variablelist> + <varlistentry> + <term><literal>disk</literal> | <literal>dvd</literal> | <literal>floppy</literal></term> + <listitem><para> + Указывает тип носителя. Допустимые значения + <literal>disk</literal> (жесткий диск), + <literal>dvd</literal> или <literal>floppy</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) + или абсолютный путь к носителю или образу. + </para><para> + Если носитель зарегистрирован, можно указывать UUID. Можно + также просмотреть зарегистрированные образы через команды + <command>VBoxManage list hdds</command>, <command>VBoxManage + list dvds</command> или <command>VBoxManage list + floppies</command>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда показывает информацию об образе + диска <filename>disk01.vdi</filename>: + </para> +<screen>$ VBoxManage showmediuminfo disk01.vdi</screen> + <para> + Следующая команда показывает информацию об образе + флоппи диска <filename>floppy01.img</filename>. + </para> +<screen>$ VBoxManage showmediuminfo floppy floppy01.img</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-showvminfo.xml b/doc/manual/ru_RU/man_VBoxManage-showvminfo.xml new file mode 100644 index 00000000..ade50a1d --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-showvminfo.xml @@ -0,0 +1,186 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage showvminfo +--> +<!-- + 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-showvminfo" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-18 00:40:56 +0100 (Wed, 18 Jan 2023) $</pubdate> + <title>VBoxManage showvminfo</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-showvminfo</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-showvminfo</refname> + <refpurpose>отображает информацию о конфигурации или содержимое файла журнала виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-showvminfo-default"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage showvminfo</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--details</arg> + <arg>--machinereadable</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-showvminfo-log"> + <command>VBoxManage showvminfo</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req">--log=<replaceable>индекс</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage showvminfo</command> выводит + информацию о конфигурации или содержимое файла журнала для + указанной виртуальной машины (ВМ). + </para> + <refsect2 id="vboxmanage-showvminfo-default"> + <title>Просмотр информации о виртуальной машине</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage showvminfo</command> выводит + информацию об указанной ВМ в подробном формате или в + машино-читаемом формате. + </para> + <para> + Команда <command>VBoxManage showvminfo</command> показывает + ту же самую информацию для указанной ВМ в том же формате, что + и команда <command>VBoxManage list vms --long</command>. + </para> + <variablelist> + <varlistentry> + <term><option>--details</option></term> + <listitem><para> + Включает подробную информацию о ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--machinereadable</option></term> + <listitem><para> + Указывает, что информация о ВМ должна быть в + машино-читаемом формате. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-showvminfo-log"> + <title>Просмотр содержимого журнала виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage showvminfo --log</command> выводит + содержимое одного из указанных файлов журналов ВМ. + </para> + <variablelist> + <varlistentry> + <term><option>--log=<replaceable>индекс</replaceable></option></term> + <listitem><para> + Задает численный индекс, идентифицирующий файл журнала. + </para><para> + Значение индекса начинается <literal>0</literal>, которая + указывает файл <filename>VBox.log</filename>. Значение + индекса <literal>1</literal> указывает файл + <filename>VBoxHardening.log</filename>. Значение индекса + начиная с <literal>2</literal> указывают другие файлы + журнала, такие как файл <filename>VBox.log.1</filename>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующий пример показывает типичный вывод этой команды: + </para> +<screen>$ VBoxManage showvminfo "Windows 10" +VirtualBox Command Line Management Interface Version <replaceable>номер-версии</replaceable> +Copyright (C) 2005-2023 Oracle and/or its affiliates + +Имя: Windows 10 +Группы: / +Гостевая ОС: Windows 10 (64-bit) +UUID: 1bf3464d-57c6-4d49-92a9-a5cc3816b7e7 +Файл настроек: /home/username/VirtualBox VMs/Windows 10/Windows 10.vbox +Папка снимков: /home/username/VirtualBox VMs/Windows 10/Snapshots +Папка журнала: /home/username/VirtualBox VMs/Windows 10/Logs +UUID оборудования: 1bf3464d-57c6-4d49-92a9-a5cc3816b7e7 +Размер памяти: 2048MB +Page Fusion: off +Размер VRAM: 12MB +Время выполнения ЦПУ: 100% +...</screen> + <para> + Следующий пример показывает вывод информации в + машино-читаемом формате, которая отображает элементы + как строку + <replaceable>свойство</replaceable>=<replaceable>значение</replaceable>: + </para> +<screen>$ VBoxManage showvminfo "Windows 10" --machinereadable +... +groups="/" +ostype="Windows 10 (64-bit)" +UUID="1bf3464d-57c6-4d49-92a9-a5cc3816b7e7" +...</screen> + <para> + Следующий пример показывает содержимое файла + журнала <filename>VBox.log</filename>: + </para> +<screen>$ VBoxManage showvminfo "Windows 10" --log 0 +00:00:02.895106 VirtualBox VM 6.0.0_RC1 r127378 linux.amd64 (Dec 10 2018 17:16:06) release log +00:00:02.895109 Log opened 2018-12-14T14:31:44.088259000Z +00:00:02.895111 Build Type: release +00:00:02.895115 OS Product: Linux +00:00:02.895117 OS Release: 4.1.12-61.1.22.el7uek.x86_64 +00:00:02.895119 OS Version: #2 SMP Fri Dec 2 09:28:44 PST 2016 +...</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-signova.xml b/doc/manual/ru_RU/man_VBoxManage-signova.xml new file mode 100644 index 00000000..06aa389f --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-signova.xml @@ -0,0 +1,145 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage signova +--> +<!-- + 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-signova" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage signova</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-signova</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-signova</refname> + <refpurpose>цифровая подпись OVA</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-signova"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage signova</command> + <arg choice="req"><replaceable>ova</replaceable></arg> + <arg choice="req">--certificate=<replaceable>файл</replaceable></arg> + <arg choice="req">--private-key=<replaceable>файл</replaceable></arg> + <group> + <arg choice="plain">--private-key-password-file=<replaceable>файл-с-паролем</replaceable></arg> + <arg choice="plain">--private-key-password=<replaceable>файл-с-паролем</replaceable></arg> + </group> + <arg>--digest-type=<replaceable>тип</replaceable></arg> + <group> + <arg choice="plain">--pkcs7</arg> + <arg choice="plain">--no-pkcs7</arg> + </group> + <arg>--intermediate-cert=<replaceable>файл</replaceable></arg> + <arg>--force</arg> + <arg>--verbose</arg> + <arg>--quiet</arg> + <arg>--dry-run</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage signova</command> добавляет цифровую + подпись к OVA файлу. + </para> + <!-- Add more description here --> + <variablelist> + <varlistentry> + <term><replaceable>ova</replaceable></term> + <listitem><para>подписываемый файл OVA.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--certificate=<replaceable>файл</replaceable></option></term> + <listitem><para> Файл, содержащий сертификат для подписи OVA. Он может + быть или в формате PEM (base64) или DER (бинарный). Команда определит, + какой из них.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--private-key=<replaceable>файл</replaceable></option></term> + <listitem><para>Файл, содержащий приватный ключ. Он может быть или в + формате PEM (base64) или DER (бинарный). Команда определит, + какой из них.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--private-key-password-file=<replaceable>файл-с-паролем</replaceable></option></term> + <listitem><para>Файл, содержащий пароль к приватному ключу.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--private-key-password=<replaceable>пароль</replaceable></option></term> + <listitem><para>Пароль к приватному ключу. <!-- add warning about visibility --> </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--digest-type=<replaceable>тип</replaceable></option></term> + <listitem> + <para>Выбирает алгоритм криптографического дайджеста, используемый + в подписи. Возможные значения: SHA-256 (по умолчанию), SHA-512 и SHA-1.</para> + <para>Некоторые старые версии OVFTool и другие продукты VMWare могут + требовать <option>--digest-type=sha-1</option> для принятия OVA.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--pkcs7</option>, <option>--no-pkcs7</option></term> + <listitem><para>Включает или отключает создание дополнительной подписи + PKCS#7/CMS. Включено по умолчанию.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--intermediate-cert=<replaceable>файл</replaceable></option></term> + <listitem><para>Файл содержащий промежуточный сертификат, который должен быть + включен в необязательную подпись PKCS#7/CMS. Как и другие, файл может быть + в форматах PEM или DER. Эта опция может повторяться для добавления нескольких + промежуточных сертификатов. Эта опция подразумевает опцию + <option>--pkcs7</option>.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--force</option></term> + <listitem><para>Переписывает существующую сигнатуру если присутствует. Поведение + по умолчанию - завершиться неудачей если OVA уже подписан.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dry-run</option></term> + <listitem><para>Не изменять OVA на самом деле, просто протестировать операцию подписи.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>-v</option>, <option>--verbose</option>, <option>-q</option>, <option>--quiet</option></term> + <listitem><para>Управляет степенью подробности вывода при выполнении команды. Опцию + <option>--verbose</option> можно указывать несколько раз для получения более + подробного вывода. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-snapshot.xml b/doc/manual/ru_RU/man_VBoxManage-snapshot.xml new file mode 100644 index 00000000..dce74106 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-snapshot.xml @@ -0,0 +1,395 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage snapshot +--> +<!-- + 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-snapshot" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage snapshot</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-snapshot</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-snapshot</refname> + <refpurpose>управляет снимками виртуальной машины &product-name;</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-snapshot"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-take"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">take</arg> + + <arg choice="req"><replaceable>имя-снимка</replaceable></arg> + + <arg>--description=<replaceable>описание</replaceable></arg> + + <arg>--live</arg> + + <arg>--uniquename Number,Timestamp,Space,Force</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-delete"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">delete</arg> + + <arg choice="req"><replaceable>имя-снимка</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-restore"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">restore</arg> + + <arg choice="req"><replaceable>имя-снимка</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-restorecurrent"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">restorecurrent</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-edit"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">edit</arg> + + <group choice="req"> + <arg choice="plain"><replaceable>имя-снимка</replaceable></arg> + <arg choice="plain">--current</arg> + </group> + + <arg>--description=<replaceable>описание</replaceable></arg> + + <arg>--name=<replaceable>новое-имя</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-list"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">list</arg> + + <group><arg>--details</arg><arg>--machinereadable</arg></group> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-snapshot-showvminfo"> + <command>VBoxManage snapshot</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + + <arg choice="plain">showvminfo</arg> + + <arg choice="req"><replaceable>имя-снимка</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage snapshot</command> управляет снимками. + </para> + <para> + &product-name; использует снимки для фиксации состояния виртуальной + машины (ВМ). Можно позднее использовать снимок для возврата к + состоянию, описываемому снимком. + </para> + <para> + Снимок - это полная копия настроек ВМ. Если снимок создается + во время работы ВМ, снимок также включает файл состояния ВМ. + </para> + <para> + После создания снимка, &product-name; создает + <emphasis>разностный жесткий диск</emphasis> для каждого обычного + диска связанного с хост-машиной. При восстановлении снимка, + &product-name; использует эти разностные файлы для быстрого + сброса содержимого виртуальных жестких дисков ВМ. + </para> + <para> + Для каждой команды <command>VBoxManage snapshot</command>, + необходимо указать имя или универсальный уникальный идентификатор + (UUID) ВМ для которого нужно сделать снимок. + </para> + <refsect2> + <title>Общие операнды команды</title> + <variablelist> + <varlistentry> + <term><replaceable>uuid|имя-ВМ</replaceable></term> + <listitem><para> + Задает UUID или имя ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-take"> + <title>Сделать снимок виртуальной машины</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot take</command> делает + снимок текущего состояния ВМ. Необходимо указать имя снимка + и, необязательно, описание. Новый снимок вставляется в дерево + снимков как потомок текущего снимка и становится новым текущим + снимком. + </para> + <variablelist> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Задает описание снимка. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--live</option></term> + <listitem><para> + Указывает, что ВМ не останавливается во время создания + снимка. Операция известна как живое создание снимка. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uniquename Number,Timestamp,Space,Force</option></term> + <listitem><para> + Будет описано позже. + </para><remark> + Что эта опция делает и как ее использовать? + </remark></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-снимка</replaceable></term> + <listitem><para> + Задает имя создаваемого снимка. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-delete"> + <title>Удалить снимок</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot delete</command> + удаляет указанный снимок. + </para> + <para> + Операция удаления может занять некоторое время из-за + того что разностные образы связанные со снимком могут быть + объединены с их дочерними разностными образами. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-снимка</replaceable></term> + <listitem><para> + Задает UUID или имя снимка. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-restore"> + <title>Восстановить снимок</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot restore</command> + восстанавливает указанный снимок. Эта операция сбрасывает + настройки и текущее состояние к указанному снимку. Состояние + ВМ, на котором восстанавливается снимок, теряется. По + завершении восстановления, указанный снимок становится новым + текущим снимком, а последующие снимки - дочерними к нему. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-снимка</replaceable></term> + <listitem><para> + Задает UUID или имя снимка. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-restorecurrent"> + <title>Восстановить текущий снимок</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot restorecurrent</command> + восстанавливает текущий снимок. Текущий снимок - это снимок, + от которого получено текущее состояние. Эта команда + эквивалентна команде <command>VBoxManage snapshot + restore</command> с указанием имени или UUID текущего снимка. + </para> + </refsect2> + <refsect2 id="vboxmanage-snapshot-edit"> + <title>Изменить имя или описание существующего снимка</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot edit</command> позволяет + изменить имя или описание указанного снимка. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-снимка</replaceable></term> + <listitem><para> + Задает UUID или имя редактируемого снимка. + </para><para> + Эта опция взаимоисключающая с опцией + <option>--current</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--current</option></term> + <listitem><para> + Указывает, что нужно обновить текущую версию снимка. + </para><para> + Эта опция взаимоисключающая с указанием имени снимка + или его UUID. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>описание</replaceable></option></term> + <listitem><para> + Задает новое описание для указанного снимка. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--name=<replaceable>новое-имя</replaceable></option></term> + <listitem><para> + Задает новое имя снимка. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-list"> + <title>Показать список снимков</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot list</command> показывает + все снимки ВМ. + </para> + <variablelist> + <varlistentry> + <term><option>--details</option></term> + <listitem><para> + Указывает, что вывод показывает подробную информацию о снимке. + </para><para> + Эта опция взаимоисключающая с опцией + <option>--machinereadable</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--machinereadable</option></term> + <listitem><para> + Указывает, что вывод производится в машино-читаемом + формате. + </para><para> + Эта опция взаимоисключающая с опцией + <option>--details</option>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-snapshot-showvminfo"> + <title>Показать информацию о настройках снимка</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage snapshot showvminfo</command> позволяет + просмотреть настройки ВМ, являющихся частью существующего снимка. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-снимка</replaceable></term> + <listitem><para> + Задает UUID или имя снимка. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL"/> + <para> + Следующая команда создает снимок ВМ + <computeroutput>ol7u4</computeroutput>. Снимок называется + <computeroutput>ol7u4-snap-001</computeroutput>. Команда использует + опцию <option>--description</option> для передачи описания + содержимого снимка. + </para> +<screen> +$ VBoxManage snapshot ol7u4 take ol7u4-snap-001 \ +--description="Oracle Linux 7.4" +</screen> + <para> + Следующая команда показывает снимки ВМ + <computeroutput>ol7u4</computeroutput>. + </para> +<screen> +$ VBoxManage snapshot ol7u4 list +</screen> + <para> + Следующая команда изменяет описание снимка + <computeroutput>ol7u4-snap-001</computeroutput> ВМ + <computeroutput>ol7u4</computeroutput>. + </para> +<screen> +$ VBoxManage snapshot ol7u4 edit ol7u4-snap-001 \ +--description="Oracle Linux 7.4 with UEK4 kernel" +</screen> + <para> + Следующая команда показывает настройки ВМ снимка + <computeroutput>ol7u1-snap-001</computeroutput> ВМ + <computeroutput>ol7u4</computeroutput>. + </para> +<screen> +$ VBoxManage snapshot ol7u4 showvminfo ol7u4-snap-001 +Имя: ol7u4 +Группы: / +Гостевая ОС: Oracle (64-bit) +UUID: 43349d78-2ab3-4cb8-978f-0e755cd98090 +Файл настроек: C:\Users\user1\VirtualBox VMs\ol7u4\ol7u4.vbox +... +Снимки: + + Имя: ol7u4-snap-001 (UUID: 1cffc37d-5c37-4b86-b9c5-a0f157a55f43) + Описание: Oracle Linux 7.4 with UEK4 kernel +</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-startvm.xml b/doc/manual/ru_RU/man_VBoxManage-startvm.xml new file mode 100644 index 00000000..2ade9374 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-startvm.xml @@ -0,0 +1,174 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage startvm +--> +<!-- + 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-startvm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage startvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-startvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-startvm</refname> + <refpurpose>запуск виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-startvm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage startvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--putenv=<replaceable>имя</replaceable>[=<replaceable>значение</replaceable>]</arg> + <arg>--type=<group> + <arg choice="plain">gui</arg> + <arg choice="plain">headless</arg> + <arg choice="plain">sdl</arg> + <arg choice="plain">separate</arg> + </group></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage startvm</command> запускает + виртуальную машину &product-name; (ВМ), которая в состоянии + "Выключено" или "Состояние сохранено". + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает имя или Универсальный Уникальный Идентификатор + (UUID) ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--putenv=<replaceable>имя</replaceable>=<replaceable>значение</replaceable></option></term> + <listitem><para> + Назначает значение переменной окружения в виде пары + имя-значение. Например VBOX_DISABLE_HOST_DISK_CACHE=1. + </para><para> + Кратка форма этой опции <option>-E</option>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--type=gui | headless | sdl | separate</option></term> + <listitem><para> + Указывает фронтенд запускаемой ВМ. + </para><para> + Можно использовать команду <command>VBoxManage setproperty</command> + для установки фронтенда по умолчанию как глобального + значения. Альтернативно, можно использовать команду + <command>VBoxManage modifyvm</command> для указания + фронтенда по умолчанию для определенной ВМ. Если не + установлено значение по умолчанию ни глобально, ни + для указанной ВМ и не указана опция <option>--type</option>, + ВМ открывается в окне рабочего стола хоста. + </para><para> + Опция <option>--type</option> принимает следующие + значения: + </para><variablelist> + <varlistentry> + <term><literal>gui</literal></term> + <listitem><para> + Запускает ВМ в окне графического интерфейса + пользователя. Это значение по умолчанию. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>headless</literal></term> + <listitem><para> + Фоновый режим. Запускает ВМ только для + удаленного дисплея. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>sdl</literal></term> + <listitem><para> + Запускает ВМ, используя фронтенд VBoxSDL. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>separate</literal></term> + <listitem><para> + Запускает ВМ с отделяемым интерфейсом пользователя, + что означает что ВМ запущена в фоновом режиме с + интерфейсом пользователя в отдельном процессе. + </para><para> + Это экспериментальная функция, у которой отсутствует + некоторый функционал, например ускорение 3D. + </para></listitem> + </varlistentry> + </variablelist></listitem> + </varlistentry> + </variablelist> + <note> + <para> + Если ВМ не удается запуститься с определенным фронтендом и + информация об ошибке неубедительна, рассмотрите запуск ВМ + напрямую, путем запуска фронтенда. Этот обходной путь может + выдать дополнительную информацию об ошибке. + </para> + </note> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда запускает ВМ <literal>ol7u6</literal>: + </para> +<screen>$ VBoxManage startvm ol7u6</screen> + <para> + Следующая команда запускает ВМ <literal>ol7u6-mininstall</literal> + в фоновом режиме. + </para> +<screen>$ VBoxManage startvm ol7u6-mininstall --type headless</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> +<!--<xref linkend="vboxmanage-vboxheadless" />--> + <xref linkend="vboxheadless" />, + <xref linkend="vboxmanage-setproperty" />, + <xref linkend="vboxmanage-modifyvm" />. + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-storageattach.xml b/doc/manual/ru_RU/man_VBoxManage-storageattach.xml new file mode 100644 index 00000000..10a9444d --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-storageattach.xml @@ -0,0 +1,549 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage storageattach +--> +<!-- + 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-storageattach" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage storageattach</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-storageattach</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-storageattach</refname> + <refpurpose>подключение, удаление и изменение носителей, используемых виртуальной машиной</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-storageattach"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage storageattach</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req">--storagectl=<replaceable>имя</replaceable></arg> + <arg>--bandwidthgroup=<group choice="plain"> + <arg choice="plain">name</arg> + <arg choice="plain">none</arg> + </group></arg> + <arg>--comment=<replaceable>текст</replaceable></arg> + <arg>--device=<replaceable>номер</replaceable></arg> + <arg>--discard=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--encodedlun=<replaceable>lun</replaceable></arg> + <arg>--forceunmount</arg> + <arg>--hotpluggable=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--initiator=<replaceable>инициатор</replaceable></arg> + <arg>--intnet</arg> + <arg>--lun=<replaceable>lun</replaceable></arg> + <arg>--medium=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">emptydrive</arg> + <arg choice="plain">additions</arg> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-файла</replaceable></arg> + <arg choice="plain">host:<replaceable>диск</replaceable></arg> + <arg choice="plain">iscsi</arg> + </group></arg> + <arg>--mtype=<group choice="plain"> + <arg choice="plain">normal</arg> + <arg choice="plain">writethrough</arg> + <arg choice="plain">immutable</arg> + <arg choice="plain">shareable</arg> + <arg choice="plain">readonly</arg> + <arg choice="plain">multiattach</arg> + </group></arg> + <arg>--nonrotational=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--passthrough=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--passwordfile=<replaceable>файл</replaceable></arg> + <arg>--password=<replaceable>пароль</replaceable></arg> + <arg>--port=<replaceable>номер</replaceable></arg> + <arg>--server=<group choice="plain"> + <arg choice="plain"><replaceable>имя</replaceable></arg> + <arg choice="plain"><replaceable>ip</replaceable></arg> + </group></arg> + <arg>--setparentuuid=<replaceable>uuid</replaceable></arg> + <arg>--setuuid=<replaceable>uuid</replaceable></arg> + <arg>--target=<replaceable>цель</replaceable></arg> + <arg>--tempeject=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--tport=<replaceable>порт</replaceable></arg> + <arg>--type=<group choice="plain"> + <arg choice="plain">dvddrive</arg> + <arg choice="plain">fdd</arg> + <arg choice="plain">hdd</arg> + </group></arg> + <arg>--username=<replaceable>имя-пользователя</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage storageattach</command> позволяет + управлять носителями, подключенными к контроллеру через команду + <command>VBoxManage storagectl</command>. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + имя виртуальной машины (ВМ). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--storagectl=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает имя контроллера. Используйте команду + <command>VBoxManage showvminfo</command> для просмотра + подключенных к ВМ контроллеров. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port=<replaceable>номер</replaceable></option></term> + <listitem><para> + Задает номер порта изменяемого контроллера. Необходимо + использовать эту опцию если у контроллера несколько портов. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--device=<replaceable>номер</replaceable></option></term> + <listitem><para> + Задает номер устройства изменяемого порта. Необходимо + использовать эту опцию если у контроллера несколько + устройств на порт. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--type=dvddrive | fdd | hdd</option></term> + <listitem><para> + Указывает тип диска, с которым связан носитель. + Опустить данный параметр можно только если тип носителя + может быть определен через опцию <option>--medium</option> + или через информацию, переданную более ранней командой + подключения носителя. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--medium=none | emptydrive | additions | <replaceable>uuid</replaceable> | <replaceable>имя-файла</replaceable> | host:<replaceable>диск</replaceable> | iscsi</option></term> + <listitem><para> + Задает одно из следующих значений: + </para><variablelist> + <varlistentry> + <term><literal>none</literal></term> + <listitem><para> + Удаляет любой существующее устройство из указанного слота. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>emptydrive</literal></term> + <listitem><para> + Только для виртуальных DVD или флоппи дисков. + </para><para> + Заставляет слот устройства вести себя как съемный + диск, в который не вставлен носитель. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>additions</literal></term> + <listitem><para> + Только для виртуальных DVD дисков. + </para><para> + Подключает образ Дополнений Гостевой ОС VirtualBox + в указанный слот устройств. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>uuid</replaceable></term> + <listitem><para> + Задает UUID носителя для подключения в указанный слот + устройства. Носитель должен быть уже известен + &product-name;, например носитель, подключенный к + другой ВМ. Используйте команду + <command>VBoxManage list</command> для просмотра + носителей. + </para></listitem> + </varlistentry> + <varlistentry> + <term><replaceable>имя-файла</replaceable></term> + <listitem><para> + Задает полный путь к существующему образу диска + для подключения к указанному слоту устройства. + Образ диска может быть ISO, RAW, VDI, VMDK или + другого формата. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>host:<replaceable>диск</replaceable></literal></term> + <listitem><para> + Только для виртуальных DVD или флоппи дисков. + </para><para> + Соединяет указанный слот устройства к указанному + DVD или флоппи диску хост-компьютера. + </para></listitem> + </varlistentry> + <varlistentry> + <term><literal>iscsi</literal></term> + <listitem><para> + Только для виртуальных жестких дисков. + </para><para> + Задает цель iSCSI, для которой необходимо указать + дополнительную информацию. Смотрите + <xref linkend="storage-iscsi" />. + </para></listitem> + </varlistentry> + </variablelist><para> + Для съемных дисков, таких как флоппи и DVD, можно менять + настройки во время выполнения ВМ. Изменения устройств или + слотов устройств жестких дисков требуют, чтобы ВМ была + выключена. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mtype=normal | writethrough | immutable | shareable | readonly | multiattach</option></term> + <listitem><para> + Указывает, как носитель ведет себя по отношению к снимкам + и операциям записи. Смотрите <xref linkend="hdimagewrites" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--comment=<replaceable>текст</replaceable></option></term> + <listitem><para> + Задает необязательное описание, сохраняемое с носителем. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--setuuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Изменяет UUID носителя перед подключением к ВМ. + </para><para> + Это экспертная опция. Неподходящие значения могут привести + к невозможности использовать носитель или к поломке + настроек ВМ если другая ВМ уже ссылается на такой же носитель. + </para><para> + Опция <option>--setuuid=""</option> назначает + новый случайный UUID образу, что может убрать ошибку + дублированного UUID, если была использована утилита + файлового копирования для дублирования образа. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--setparentuuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Изменяет родительский UUID носителя перед подключением к ВМ. + </para><para> + Это экспертная опция. Неподходящие значения могут привести + к невозможности использовать носитель или к поломке + настроек ВМ если другая ВМ уже ссылается на такой же носитель. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--passthrough=on | off</option></term> + <listitem><para> + Только для виртуальных DVD дисков. + </para><para> + Включает запись на DVD. Эта функция экспериментальная. + Смотрите <xref linkend="storage-cds" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tempeject=on | off</option></term> + <listitem><para> + Только для виртуальных DVD дисков. + </para><para> + Указывает, разрешать ли операцию временного извлечения + носителя по запросу гостевой системы. Если установлено + в <literal>on</literal>, носитель может быть извлечен. + Возможность операции извлечения по запросу гостевой + системы, не сохраняется, если ВМ выключена и + перезапущена. Таким образом, когда опция установлена + в <literal>on</literal> и ВМ перезапущена, первоначально + настроенный носитель все еще в дисководе. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nonrotational=on | off</option></term> + <listitem><para> + Позволяет указать, что виртуальный жесткий диск + не вращается. Некоторые гостевые ОС, например Windows 7 + и более поздние, считают такие диски твердотельными (SSD) + и не производят фрагментацию диска на них. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--discard=on | off</option></term> + <listitem><para> + Указывает, включать ли функцию автоудаления для виртуального + жесткого диска. Когда установлена в <literal>on</literal>, + образ VDI уменьшается в ответ на команду <command>trim</command> + гостевой ОС. + </para><para> + Виртуальный жесткий диск должен удовлетворять следующим + требованиям: + </para><itemizedlist> + <listitem><para> + Формат диска должен быть VDI. + </para></listitem> + <listitem><para> + Размер очищаемой области диска должен быть не менее 1 МБ. + </para></listitem> + <listitem><para> + Убедитесь, что обрезаемое пространство представляет + собой непрерывный блок размером не менее 1 МБ на + границе 1 МБ. + </para></listitem> + </itemizedlist><para> + Рассмотрите запуск команд дефрагментации в фоновом режиме + через cron для сохранения пространства. В Windows + запускайте команду <command>defrag.exe /D</command>. В + Linux запускайте команду <command>btrfs filesystem + defrag</command>. + </para><note> + <para> + При настройке гостевой ОС для выдачи команды + <command>trim</command>, гостевая ОС обычно рассматривает + диск как SSD. + </para> + <para> + Ext4 поддерживает опцию монтирования + <option>-o discard</option>. В Mac OS X может + потребоваться дополнительная настройка. Windows 7, 8 + и 10 автоматически определяет и поддерживает SSD. + Драйвер Linux <command>exFAT</command> от Samsung + поддерживает команду <command>trim</command>. + </para> + </note><para> + Реализация exFAT от Microsoft может не поддерживать эту + функцию. + </para><para> + Можно использовать другие способы для выдачи команд trim. + Команда Linux <command>fstrim</command> является частью + пакета <filename>util-linux</filename>. Ранние решения + требовали обнулить неиспользуемые области через команду + <command>zerofree</command> или подобную, затем уплотнить + диск. Можно производит данные шаги только при выключенной + ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bandwidthgroup=<replaceable>имя</replaceable></option></term> + <listitem><para> + Задает группу полосы пропускания, используемую в устройстве. + Смотрите <xref linkend="storage-bandwidth-limit" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--forceunmount</option></term> + <listitem><para> + Только для виртуальных DVD или флоппи дисков. + </para><para> + Принудительно размонтирует DVD, CD, или флоппи или + монтирует новый DVD, CD, или флоппи даже если предыдущий + съемный носитель заблокирован гостем на чтение. Смотрите + <xref linkend="storage-cds" />. + </para></listitem> + </varlistentry> + </variablelist> + <para> + Следующие опции применимы когда указана опция + <option>--medium=iscsi</option>: + </para> + <variablelist> + <varlistentry> + <term><option>--server=<replaceable>имя-хоста</replaceable> | <replaceable>IP-адрес</replaceable></option></term> + <listitem><para> + Задает имя хоста или IP адрес цели iSCSI. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--target=<replaceable>цель</replaceable></option></term> + <listitem><para> + Задает строку имени цели, определяемую целью + iSCSI и используется для идентификации ресурса хранилища. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tport=<replaceable>порт</replaceable></option></term> + <listitem><para> + Задает номер порта TCP/IP службы iSCSI цели. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lun=<replaceable>LUN</replaceable></option></term> + <listitem><para> + Задает номер логической единицы ресурса цели. + Для единственного дисковода значение равно нулю. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--encodedlun=<replaceable>LUN</replaceable></option></term> + <listitem><para> + Задает LUN ресурса цели в виде закодированную в + шестнадцатеричном виде. Для единственного дисковода + значение равно нулю. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--username=<replaceable>имя-пользователя</replaceable></option></term> + <listitem><para> + Задает имя пользователя для аутентификации цели. + </para><note> + <para> + Если не установлен пароль на настройки, имя пользователя + сохраняется в виде простого текста в XML файле настроек + машины. + </para> + </note></listitem> + </varlistentry> + <varlistentry> + <term><option>--password=<replaceable>пароль</replaceable></option></term> + <listitem><para> + Задает пароль для аутентификации цели. + </para><note> + <para> + Если не установлен пароль на настройки, этот пароль + сохраняется в виде простого текста в XML файле + конфигурации машины. Когда пароль на настройки + установлен, пароль аутентификации цели сохраняется + в шифрованном виде. + </para> + </note><remark> + Этот дизайн не соответствует рекомендациям по безопасности + Oracle. У Вас не должно быть возможности указать пароль + в командной строке, так как пароль может быть увиден + в списке процессов. + </remark></listitem> + </varlistentry> + <varlistentry> + <term><option>--passwordfile=<replaceable>файл-с-паролем</replaceable></option></term> + <listitem><para> + Задает файл, содержащий пароль аутентификации цели + в виде простого текста. + </para><note> + <para> + Используйте настройки разрешений и владения, чтобы + убедиться, что содержимое этого файла не могут прочитать + неавторизованные пользователи. + </para> + </note></listitem> + </varlistentry> + <varlistentry> + <term><option>--initiator=<replaceable>инициатор</replaceable></option></term> + <listitem><para> + Задает инициатор iSCSI. + </para><para> + iSCSI инициатор от Microsoft - это система, например сервер, + которая подключается к IP сети и инициирует запросы и + получает ответы от iSCSI целей. SAN компоненты в + инициаторе iSCSI во многом аналогичны SAN компонентам Fibre + Channel и включают следующие: + </para><itemizedlist> + <listitem><para> + <emphasis role="bold">Драйвер iSCSI.</emphasis> + Траспортирует блоки команд iSCSI через сеть IP. Этот + драйвер iSCSI устанавливается в хост iSCSI и входит + в состав инициатор iSCSI от Microsoft. + </para></listitem> + <listitem><para> + <emphasis role="bold">Адаптер Gigabit Ethernet.</emphasis> + Подключается к цели iSCSI. Используйте адаптер + Ethernet, который может передавать 1000 мегабит в + секунду (Мб/с). Как и стандартные 10/100 адаптеры, + большинство гигабитных адаптеров используют + существующие кабели категории 5 или 6Е. Каждый порт + адаптера идентифицируется уникальным IP адресом. + </para></listitem> + <listitem><para> + <emphasis role="bold">Цель iSCSI.</emphasis> Это любое + устройство, которое получает команды iSCSI. Устройством + может быть как конечный узел, например устройство хранения, + так и промежуточное устройство, например сетевой мост + между устройствами IP и Fibre Channel. Каждый порт + контроллера массива хранилищ или сетевого моста + идентифицируется одним или несколькими IP адресами. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--intnet</option></term> + <listitem><para> + Указывает, подключаться ли к цели iSCSI, использующую + внутреннюю сеть. Эта настройка требует дальнейшую + настройку. Смотрите <xref linkend="iscsi-intnet" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда подключает образ диска <filename>o7.vdi</filename> + к указанному контроллеру SATA в ВМ <filename>ol7</filename>. + </para> +<screen>$ storageattach ol7 --storagectl "SATA Controller" --port 0 --device 0 \ +--type hdd --medium /VirtualBox/ol7/ol7.vdi</screen> + <para> + Следующая команда подключает образ DVD <filename>o7-r6-dvd.iso</filename> + к указанному контроллеру IDE в ВМ <filename>ol7</filename>. + </para> +<screen>$ VBoxManage storageattach ol7 --storagectl "IDE Controller" --port 0 --device 0 \ +--type dvddrive --medium ol7-r6-dvd.iso</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-showvminfo" />, + <xref linkend="vboxmanage-storagectl" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-storagectl.xml b/doc/manual/ru_RU/man_VBoxManage-storagectl.xml new file mode 100644 index 00000000..25f39d75 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-storagectl.xml @@ -0,0 +1,203 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage storagectl +--> +<!-- + 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-storagectl" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage storagectl</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-storagectl</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-storagectl</refname> + <refpurpose>управляет контроллером хранения</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-storagectl"> + <command>VBoxManage storagectl</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg choice="req">--name=<replaceable>имя-контроллера</replaceable></arg> + <arg>--add=<group choice="plain"> + <arg choice="plain">floppy</arg> + <arg choice="plain">ide</arg> + <arg choice="plain">pcie</arg> + <arg choice="plain">sas</arg> + <arg choice="plain">sata</arg> + <arg choice="plain">scsi</arg> + <arg choice="plain">usb</arg> + </group></arg> + <arg>--controller=<group choice="plain"> + <arg choice="plain">BusLogic</arg> + <arg choice="plain">I82078</arg> + <arg choice="plain">ICH6</arg> + <arg choice="plain">IntelAhci</arg> + <arg choice="plain">LSILogic</arg> + <arg choice="plain">LSILogicSAS</arg> + <arg choice="plain">NVMe</arg> + <arg choice="plain">PIIX3</arg> + <arg choice="plain">PIIX4</arg> + <arg choice="plain">USB</arg> + <arg choice="plain">VirtIO</arg> + </group></arg> + <arg>--bootable=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hostiocache=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--portcount=<replaceable>количество</replaceable></arg> + <arg>--remove</arg> + <arg>--rename=<replaceable>новое-имя-контроллера</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage storagectl</command> позволяет + подключить, изменить или удалить контроллер хранилища. После + настройки контроллера, можно использовать команду + <command>VBoxManage storageattach</command> для подключения + виртуального носителя к контроллеру. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает Универсальный Уникальный Идентификатор (UUID) или + имя виртуальной машины (ВМ). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--name=<replaceable>имя-контроллера</replaceable></option></term> + <listitem><para> + Задает имя контроллера хранения. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--add=<replaceable>тип-системной-шины</replaceable></option></term> + <listitem><para> + Задает тип системной шины, куда подключать контроллер + хранилища. Допустимые значения + <literal>floppy</literal>, <literal>ide</literal>, + <literal>pcie</literal>, <literal>sas</literal>, + <literal>sata</literal>, <literal>scsi</literal> и + <literal>usb</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--controller=<replaceable>тип-чипсета</replaceable></option></term> + <listitem><para> + Задает тип эмулируемого чипсета для указанного + контроллера хранилища. Допустимые значения + <literal>BusLogic</literal>, <literal>I82078</literal>, + <literal>ICH6</literal>, <literal>IntelAHCI</literal>, + <literal>LSILogic</literal>, <literal>LSILogicSAS</literal>, + <literal>NVMe</literal>, <literal>PIIX3</literal>, + <literal>PIIX4</literal> и <literal>USB</literal>. + </para><para> + Значение по умолчание изменяется, в соответствии с типом + контроллера хранилища. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--portcount=<replaceable>количество</replaceable></option></term> + <listitem><para> + Задает количество портов, поддерживаемых контроллером. + Допустимые значения зависят от контроллера. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hostiocache=on|off</option></term> + <listitem><para> + Указывает, использовать ли I/O кэш хоста для всех образов + дисков, подключенных к контроллеру. Допустимые значения + <literal>on</literal> и <literal>off</literal>. Смотрите + <xref linkend="iocaching" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bootable=on|off</option></term> + <listitem><para> + Указывает, что контроллер загрузочный. Допустимые значения + <literal>on</literal> и <literal>off</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--rename=<replaceable>новое-имя-контроллера</replaceable></option></term> + <listitem><para> + Задает новое имя для контроллера хранилища. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--remove</option></term> + <listitem><para> + Удаляет контроллер хранилища из конфигурации ВМ. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда создает контроллер SATA, называемый + <literal>sata01</literal> и добавляет его в ВМ + <literal>ol7</literal>. Контроллер эмулирует чипсет IntelAHCI. + </para> +<screen>$ VBoxManage storagectl ol7 --name "sata01" --add sata --controller IntelAHCI</screen> + <para> + Следующая команда создает контроллер IDE называемый + <literal>ide01</literal> и добавляет его в ВМ <literal>ol7</literal> + VM. + </para> +<screen>$ VBoxManage storagectl ol7 --name "ide01" --add ide</screen> + </refsect1> + + <refsect1> + <title>Смотрите также</title> + <para> + <xref linkend="vboxmanage-storageattach" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-unattended.xml b/doc/manual/ru_RU/man_VBoxManage-unattended.xml new file mode 100644 index 00000000..40166cc6 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-unattended.xml @@ -0,0 +1,256 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage unattended +--> +<!-- + 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-unattended" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage unattended</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-unattended</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-unattended</refname> + <refpurpose>unattended установка гостевой ОС</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-unattended-detect"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage unattended detect</command> + <arg choice="req">--iso=<replaceable>iso-установщика</replaceable></arg> + <arg>--machine-readable</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-unattended-install"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage unattended install</command> + <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg> + <arg choice="req">--iso=<replaceable>iso-инсталляции</replaceable></arg> + <arg>--user=<replaceable>логин</replaceable></arg> + <arg>--password=<replaceable>пароль</replaceable></arg> + <arg>--password-file=<replaceable>файл</replaceable></arg> + <arg>--full-user-name=<replaceable>имя</replaceable></arg> + <arg>--key=<replaceable>ключ-продукта</replaceable></arg> + <arg>--install-additions</arg> + <arg>--no-install-additions</arg> + <arg>--additions-iso=<replaceable>iso-дополнений</replaceable></arg> + <arg>--install-txs</arg> + <arg>--no-install-txs</arg> + <arg>--validation-kit-iso=<replaceable>iso-тестирования</replaceable></arg> + <arg>--locale=<replaceable>ll_CC</replaceable></arg> + <arg>--country=<replaceable>CC</replaceable></arg> + <arg>--time-zone=<replaceable>tz</replaceable></arg> + <arg>--hostname=<replaceable>имя-хоста</replaceable></arg> + <arg>--package-selection-adjustment=<replaceable>ключ</replaceable></arg> + <arg>--dry-run</arg> + <arg>--auxiliary-base-path=<replaceable>путь</replaceable></arg> + <arg>--image-index=<replaceable>номер</replaceable></arg> + <arg>--script-template=<replaceable>файл</replaceable></arg> + <arg>--post-install-template=<replaceable>файл</replaceable></arg> + <arg>--post-install-command=<replaceable>команда</replaceable></arg> + <arg>--extra-install-kernel-parameters=<replaceable>параметры</replaceable></arg> + <arg>--language=<replaceable>язык</replaceable></arg> + <arg>--start-vm=<replaceable>тип-сессии</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <refsect2 id="vboxmanage-unattended-detect"> + <title>unattended detect</title> + <remark role="help-copy-synopsis"/> + <para> + Определяет гостевую операционную систему (ОС) на указанном инсталляционном + ISO и отображает результат. Это может быть использовано как входные данные + при создании ВМ для устанавливаемого ISO. + </para> + <variablelist> + <varlistentry> + <term><option>--iso=<replaceable>iso-инсталляции</replaceable></option></term> + <listitem><para>Определяемый инсталляционный ISO.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--machine-readable</option></term> + <listitem><para>Производит вывод, который проще для разбора из скрипта.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-unattended-install"> + <title>unattended install</title> + <remark role="help-copy-synopsis"/> + <para> + Перенастраивает указанную ВМ для установки и опционально запуска ОС. + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid|имя-ВМ</replaceable></term> + <listitem><para>Или UUID или имя (чувствительно к регистру) ВМ.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--iso=<replaceable>iso-инсталляции</replaceable></option></term> + <listitem><para>Инсталляционный ISO для запуска определения.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--user=<replaceable>логин</replaceable></option></term> + <listitem><para>Имя пользователя. (По умолчанию: vboxuser)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--password=<replaceable>пароль</replaceable></option></term> + <listitem> + <para>Пароль пользователя. Он используется как для пользователя указанного через <option>--user</option>, так и для + пользователя root/administrator. (по умолчанию: changeme)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--password-file=<replaceable>файл</replaceable></option></term> + <listitem> + <para>Альтернатива <option>--password</option> для передачи пароля. Специальное имя файла + <computeroutput>stdin</computeroutput> может использоваться для чтения пароля с стандартного потока ввода.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--full-user-name=<replaceable>имя</replaceable></option></term> + <listitem><para>Полное имя пользователя. (по умолчанию: --user)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--key=<replaceable>ключ-продукта</replaceable></option></term> + <listitem><para>Ключ продукта гостевой ОС. Не всем гостевым ОС требуется это.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--install-additions</option>, <option>--no-install-additions</option></term> + <listitem><para>Устанавливать ли Дополнения Гостевой ОС VirtualBox. (по умолчанию: --no-install-addations)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--additions-iso=<replaceable>iso-дополнений</replaceable></option></term> + <listitem> + <para>Путь к ISO Дополнений Гостевой ОС. (по умолчанию: installed/downloaded GAs)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--install-txs</option>, <option>--no-install-txs</option></term> + <listitem> + <para>Инсталлировать ли службу выполнения тестов (TXS) из VirtualBox ValidationKit. + Это полезно при подготовке ВМ к тестированию или подобной работы. (по умолчанию: --no-install-txs)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--validation-kit-iso=<replaceable>iso-тестирования</replaceable></option></term> + <listitem> + <para>Путь к VirtualBox ValidationKit ISO. Опция необходима если указана <option>--install-txs</option> + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--locale=<replaceable>ll_CC</replaceable></option></term> + <listitem> + <para>Спецификация базовая локали для гостевой системы, например en_US, de_CH, или nn_NO. (по умолчанию: host или en_US)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--country=<replaceable>CC</replaceable></option></term> + <listitem><para>Двухбуквенный кода страны если отличается от указанной в <option>--location</option>.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--time-zone=<replaceable>tz</replaceable></option></term> + <listitem><para>Часовая зона для установки в гостевой ОС. (по умолчанию: часовая зона хоста или UTC)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hostname=<replaceable>имя-хоста</replaceable></option></term> + <listitem> + <para> Полное доменное имя гостевой машины. (по умолчанию: <replaceable>имя-ВМ</replaceable>.myguest.virtualbox.org)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--package-selection-adjustment=<replaceable>ключ</replaceable></option></term> + <listitem> + <para> Корректировка выбора пакетов/компонентов гостевой ОС. Может быть указана более одного раза. В настоящее + время единственным распознаваемым ключевым словом является <computeroutput>minimal</computeroutput>, которое + запускает минимальную установку для некоторых гостевых ОС.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--dry-run</option></term> + <listitem><para>Не создавать каких-либо файлов или делать изменения в конфигурации ВМ.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--start-vm=<replaceable>тип-сессии</replaceable></option></term> + <listitem> + <para>Запуск ВМ с помощью фронтенда, указанного в <replaceable>session-type</replaceable>. Это то же самое что + и опция <option>--type</option> для команды <computeroutput>startvm</computeroutput>, Но нам пришлось добавить + <computeroutput>none</computeroutput> для указания того, что ВМ не надо запускать. + (по умолчанию: <computeroutput>none</computeroutput>)</para></listitem> + </varlistentry> + </variablelist> + + <para>Дополнительные опции:</para> + <variablelist> + <varlistentry> + <term><option>--auxiliary-base-path=<replaceable>путь</replaceable></option></term> + <listitem> + <para>Префикс пути к файлам относящимся к носителю, созданные для установки. + (по умолчанию: <replaceable>папка-настроек-ВМ</replaceable>/Unattended-<replaceable>uuid-ВМ</replaceable>-)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--image-index=<replaceable>номер</replaceable></option></term> + <listitem><para>Индекс образа инсталляции Windows. (по умолчанию: 1)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--script-template=<replaceable>файл</replaceable></option></term> + <listitem><para>Шаблон скрипта unattended инсталляции. (по умолчанию: зависит от IMachine::OSTypeId)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--post-install-template=<replaceable>файл</replaceable></option></term> + <listitem><para>Шаблон скрипта после инсталляции. (по умолчанию: зависит от IMachine::OSTypeId)</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--post-install-command=<replaceable>команда</replaceable></option></term> + <listitem> + <para>Единичная команда, запускаемая после завершения установки. Точный формат и точный момент, + когда будет запущена команда, зависит от установщика гостевой ОС.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--extra-install-kernel-parameters=<replaceable>параметры</replaceable></option></term> + <listitem> + <para> + Список дополнительных параметров ядра Linux в течение установки. (по умолчанию: зависит от IMachine::OSTypeId) + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--language=<replaceable>язык</replaceable></option></term> + <listitem> + <para> + Задает язык пользовательского интерфейса для Windows инсталляции. <replaceable>язык</replaceable> обычно + в виде {ll}-{CC}. Смотрите результаты detectedOSLanguages из <command>VBoxManage unattended detect</command>. + (по умолчанию: detectedOSLanguages[0])</para></listitem> + </varlistentry> + + </variablelist> + </refsect2> + + </refsect1> +</refentry> + diff --git a/doc/manual/ru_RU/man_VBoxManage-unregistervm.xml b/doc/manual/ru_RU/man_VBoxManage-unregistervm.xml new file mode 100644 index 00000000..e8e7ce06 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-unregistervm.xml @@ -0,0 +1,121 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage unregistervm +--> +<!-- + 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-unregistervm" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage unregistervm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-unregistervm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-unregistervm</refname> + <refpurpose>отмена регистрации виртуальной машины</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-unregistervm"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage unregistervm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + </group> + <arg>--delete</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage unregistervm</command> отменяет + регистрацию виртуальной машины (ВМ). + </para> + <variablelist> + <varlistentry> + <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term> + <listitem><para> + Задает имя или Универсальный Уникальный Идентификатор (UUID) ВМ. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--delete</option></term> + <listitem><para> + Удаляет следующие файлы, относящиеся к ВМ автоматически: + </para><itemizedlist> + <listitem><para> + Все файл образов жестких дисков, включая разностные файлы. + </para></listitem> + <listitem><para> + Все файлы сохраненного состояния, созданные машиной, + включая файлы для каждого снимка. + </para></listitem> + <listitem><para> + XML файл определения ВМ и его резервные копии. + </para></listitem> + <listitem><para> + Файлы журналов ВМ. + </para></listitem> + <listitem><para> + Пустую директорию, связанную с незарегистрированной ВМ. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда отменяет регистрацию ВМ, называемую + <literal>vm2</literal>. + </para> +<screen>$ VBoxManage unregistervm vm2</screen> + <para> + Следующая команда отменяет регистрацию ВМ, называемую + <literal>vm3</literal>. Все файлы, относящиеся к ВМ удаляются. + </para> +<screen>$ VBoxManage unregistervm vm3 --delete +%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%</screen> + </refsect1> + + <refsect1> + <title>Смотри также</title> + <para> + <xref linkend="vboxmanage-registervm" /> + </para> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-updatecheck.xml b/doc/manual/ru_RU/man_VBoxManage-updatecheck.xml new file mode 100644 index 00000000..8339cc6c --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-updatecheck.xml @@ -0,0 +1,143 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage updatecheck +--> +<!-- + Copyright (C) 2020-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-updatecheck" lang="en"> + + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage updatecheck</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-updatecheck</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-updatecheck</refname> + <refpurpose>проверка на наличие новой версии VirtualBox</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-updatecheck-perform"> <!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage updatecheck perform</command> + <arg>--machine-readable</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-updatecheck-list"> + <command>VBoxManage updatecheck list</command> + <arg>--machine-readable</arg> + </cmdsynopsis> + <cmdsynopsis id="synopsis-vboxmanage-updatecheck-modify"> + <command>VBoxManage updatecheck modify</command> + <group> + <arg choice="plain">--disable</arg> + <arg choice="plain">--enable</arg> + </group> + <arg>--channel=<replaceable>stable | withbetas | all</replaceable></arg> + <arg>--frequency=<replaceable>дни</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + + <para>Подкоманда <command>updatecheck</command> используется для проверки доступности новой версии + VirtualBox. Две опции подкоманды <command>updatecheck</command> используются для изменения + или просмотра настроек, относящихся к проверке новой версии VirtualBox.</para> + + <refsect2 id="vboxmanage-updatecheck-perform"> + <title>updatecheck perform</title> + <remark role="help-copy-synopsis"/> + <para> + Проверяет доступность новой версии VirtualBox. + </para> + <variablelist> + <varlistentry> + <term><option>--machine-readable</option></term><listitem><para>Машино-читаемый вывод.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-updatecheck-list"> + <title>updatecheck list</title> + <remark role="help-copy-synopsis"/> + <para> + Отображает текущие настройки, используемый при проверке новой версии VirtualBox. + </para> + <variablelist> + <varlistentry> + <term><option>--machine-readable</option></term><listitem><para>Машино-читаемый вывод.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + <refsect2 id="vboxmanage-updatecheck-modify"> + <title>updatecheck modify</title> + <remark role="help-copy-synopsis"/> + <para> + Изменяет настройки, используемые при проверке новой версии VirtualBox. + </para> + <variablelist> + <varlistentry> + <term><option>--enable</option></term><listitem><para>Включает службу проверки обновлений.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--disable</option></term><listitem><para>Отключает службу проверки обновлений.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>--channel=stable | withbetas | all</option></term> + <listitem><para>Предпочитаемый тип выпуска, используемый при определении доступности новой версии VirtualBox. По умолчанию 'stable'.</para> + <variablelist> + <varlistentry> + <term><option>stable</option></term> + <listitem><para>Проверяет на новые стабильные выпуски (корректирующие и минорные выпуски внутри того же самого мажорного выпуска) VirtualBox.</para> </listitem> + </varlistentry> + <varlistentry> + <term><option>all</option></term> + <listitem><para>Проверяет на новые стабильные выпуски (корректирующие и минорные выпуски внутри того же самого мажорного выпуска), а также мажорные выпуски VirtualBox.</para></listitem> + </varlistentry> + <varlistentry> + <term><option>withbetas</option></term> + <listitem><para>Проверяет на новые стабильные выпуски (корректирующие и минорные выпуски внутри того же самого мажорного выпуска), мажорные и бета выпуски VirtualBox.</para></listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--frequency=дни</option></term> + <listitem><para>Указывает, как часто в днях проверять на новые версии VirtualBox.</para></listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-usbdevsource.xml b/doc/manual/ru_RU/man_VBoxManage-usbdevsource.xml new file mode 100644 index 00000000..5d62a708 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-usbdevsource.xml @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage usbdevsource +--> +<!-- + 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-usbdevsource" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage usbdevsource</title> + </refentryinfo> + + <refmeta> + <refentrytitle>vboxmanage-usbdevsource</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>vboxmanage-usbdevsource</refname> + <refpurpose>добавление и удаление источников USB устройств</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-usbdevsource-add"> + <command>VBoxManage usbdevsource add</command> + <arg choice="req"><replaceable>имя-источника</replaceable></arg> + <arg choice="req">--backend=<replaceable>бэкенд</replaceable></arg> + <arg choice="req">--address=<replaceable>адрес</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-usbdevsource-remove"> + <command>VBoxManage usbdevsource remove</command> + <arg choice="req"><replaceable>имя-источника</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage usbdevsource</command> добавляет + источник USB устройства и делает его доступным гостевым системам + в хосте. Можно также использовать эту команду для удаления + источника USB устройства. + </para> + <refsect2 id="vboxmanage-usbdevsource-add"> + <title>Добавить источник USB устройства</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage usbdevsource add</command> добавляет + источник USB устройства, и он становится доступен все гостевым + системам в хост-системе. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-источника</replaceable></term> + <listitem><para> + Задает уникальное имя для источника USB устройства. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--address=<replaceable>адрес</replaceable></term> + <listitem><para> + Задает адрес USB бэкенда. + </para></listitem> + </varlistentry> + <varlistentry> + <term>--backend=<replaceable>бэкенд</replaceable></term> + <listitem><para> + Задает используемый бэкенд службы USB прокси. + </para><remark> + Что такое служба USB прокси? Как определяется + используемый бэкенд? + </remark></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-usbdevsource-remove"> + <title>Удалить USB устройство</title> + <remark role="help-copy-synopsis"/> + <para> + Команда <command>VBoxManage usbdevsource remove</command> + удаляет USB устройство. + </para> + <variablelist> + <varlistentry> + <term><replaceable>имя-источника</replaceable></term> + <listitem><para> + Задает имя удаляемого источника USB устройства. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда добавляет сервер USB устройства называемый + <filename>hostusb01</filename>. + </para> +<screen>$ VBoxManage usbdevsource add hostusb01 --backend USBIP --address 10.0.1.16</screen> + </refsect1> +</refentry> diff --git a/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml b/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml new file mode 100644 index 00000000..e5e30510 --- /dev/null +++ b/doc/manual/ru_RU/man_VBoxManage-usbfilter.xml @@ -0,0 +1,322 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage usbfilter +--> +<!-- + 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-usbfilter" lang="en"> + <refentryinfo> + <pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate> + <title>VBoxManage usbfilter</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-usbfilter</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-usbfilter</refname> + <refpurpose>управление USB фильтрами</refpurpose> + <refclass>&product-name;</refclass> + </refnamediv> + + <refsynopsisdiv> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <cmdsynopsis id="synopsis-vboxmanage-usbfilter-add"> + <command>VBoxManage usbfilter add</command> + <arg choice="req"><replaceable>индекс</replaceable>,0-<replaceable>N</replaceable></arg> + <arg choice="req">--target=<group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + <arg choice="plain">global</arg> + </group></arg> + <arg choice="req">--name=<replaceable>строка</replaceable></arg> + <arg choice="req">--action=ignore | hold</arg> + <arg>--active=yes | no</arg> + <arg>--vendorid=<replaceable>XXXX</replaceable></arg> + <arg>--productid=<replaceable>XXXX</replaceable></arg> + <arg>--revision=<replaceable>IIFF</replaceable></arg> + <arg>--manufacturer=<replaceable>строка</replaceable></arg> + <arg>--product=<replaceable>строка</replaceable></arg> + <arg>--port=<replaceable>hex</replaceable></arg> + <arg>--remote=yes | no</arg> + <arg>--serialnumber=<replaceable>строка</replaceable></arg> + <arg>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-usbfilter-modify"> + <command>VBoxManage usbfilter modify</command> + <arg choice="req"><replaceable>индекс</replaceable>,0-<replaceable>N</replaceable></arg> + <arg choice="req">--target=<group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + <arg choice="plain">global</arg> + </group></arg> + <arg>--name=<replaceable>строка</replaceable></arg> + <arg>--action=ignore | hold</arg> + <arg>--active=yes | no</arg> + <arg>--vendorid=<replaceable>XXXX</replaceable> | ""</arg> + <arg>--productid=<replaceable>XXXX</replaceable> | ""</arg> + <arg>--revision=<replaceable>IIFF</replaceable> | ""</arg> + <arg>--manufacturer=<replaceable>строка</replaceable> | ""</arg> + <arg>--product=<replaceable>строка</replaceable> | ""</arg> + <arg>--port=<replaceable>hex</replaceable></arg> + <arg>--remote=yes | no</arg> + <arg>--serialnumber=<replaceable>строка</replaceable> | ""</arg> + <arg>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-usbfilter-remove"> + <command>VBoxManage usbfilter remove</command> + <arg choice="req"><replaceable>индекс</replaceable>,0-<replaceable>N</replaceable></arg> + <arg choice="req">--target=<group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg> + <arg choice="plain">global</arg> + </group></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Описание</title> + <para> + Команда <command>VBoxManage usbfilter</command> позволяет управлять + USB фильтрами для указанной виртуальной машиной (ВМ) или глобальными + USB фильтрами, влияющими на всю конфигурацию &product-name;. + </para> + <para> + Глобальные фильтры применяются перед фильтрами определенной ВМ. + Это означает, что можно использовать глобальный фильтр для + предотвращения захвата устройств какой-либо ВМ. + </para> + <para> + Глобальные фильтры применяются в определенном порядке. Применяется + только первый походящий данному устройству фильтр. Например, + первый глобальный фильтр делает доступным определенный + флеш-накопитель Kingston, тогда как второй фильтр игнорирует все + устройства Kingston. В результате применения этих фильтров, + определенный флеш-накопитель Kingston будет доступен любой машине, + имеющей соответствующий фильтр, но остальные устройства Kingston + доступны не будут. + </para> + <refsect2> + <title>Общие операнды и опции</title> + <variablelist> + <varlistentry> + <term>index,0-<replaceable>N</replaceable></term> + <listitem><para> + Задает единственное число, указывающее позицию фильтра + в списке. Ноль (<literal>0</literal>) представляет + первую позицию в списке. Если в данной позиции уже + существует фильтр, то этот фильтр, а также + следующие за ним передвигаются ниже по списку. + В противном случае, новый фильтр добавляется в + список. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--action=ignore | hold</option></term> + <listitem><para> + Указывает, разрешать ли доступ ВМ к устройствам, + подходящим к описанию фильтра (<literal>hold</literal>) + или запрещать (<literal>ignore</literal>). Эта опция + применяется только к глобальным фильтрам. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--active=yes | no</option></term> + <listitem><para> + Указывает, активен ли USB фильтр или временно отключен. + Допустимые значения <literal>yes</literal>, активирующая + фильтр и <literal>no</literal>, отключающая его. Значение + по умолчанию <literal>yes</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--manufacturer=<replaceable>строка</replaceable></option></term> + <listitem><para> + Задает фильтр по ID производителя как строку. Значение + по умолчанию пустое (<literal>""</literal>). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></option></term> + <listitem><para> + Указывает фильтр маскированного интерфейса, который + используется для скрытия одного или нескольких USB + интерфейсов от гостевой системы. Значение - это битовая + маска, где набор битов соответствует скрываемому USB + интерфейсу или снятие маски. Эта функция поддерживается + только только в хост-системах Linux. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--name=<replaceable>имя-фильтра</replaceable></option></term> + <listitem><para> + Задает имя фильтра. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--port=<replaceable>hex</replaceable></option></term> + <listitem><para> + Задает фильтр по номеру USB порта (hub port number). Значение по + умолчанию - пустая строка (<literal>""</literal>). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--product=<replaceable>строка</replaceable></option></term> + <listitem><para> + Задает фильтр по ID продукта как строку. Значение по + умолчанию пустое (<literal>""</literal>). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--productid=<replaceable>XXXX</replaceable></option></term> + <listitem><para> + Задает фильтр по ID продукта. Строковое представление + для точного соответствия имеет вид + <replaceable>XXXX</replaceable>, где + <replaceable>X</replaceable> - это шестнадцатеричная + цифра включающая лидирующие нули. Значение по умолчанию + пустое (<literal>""</literal>). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--remote=yes | no</option></term> + <listitem><para> + Задает удаленный фильтр, показывающий подключено ли + физически устройство к удаленному клиенту VRDE или + или к локальной системе. Эта опцию применяется только + к фильтрам ВМ. Значение по умолчанию пустое + (<literal>""</literal>). + </para><remark> + Почему значение по умолчанию пустое когда допустимые + значения <literal>yes</literal> или <literal>no</literal>? + </remark></listitem> + </varlistentry> + <varlistentry> + <term><option>--revision=<replaceable>IIFF</replaceable></option></term> + <listitem><para> + Задает фильтр по ID ревизии. Строковое представление + для точного соответствия имеет вид <replaceable>IIFF</replaceable>. + <replaceable>I</replaceable> - это десятичная цифра + целой части ревизии. <replaceable>F</replaceable> - + это десятичная цифра ее дробной части включающая + лидирующие и замыкающие нули. Значение по умолчанию + пустое (<literal>""</literal>). + </para><para> + Для того, чтобы указать диапазон ревизий ID, убедитесь + что используется шестнадцатеричная форма, то есть в виде + 16 битного упакованного двоично-десятичного значения. + Например, выражение <literal>int:0x0100-0x0199</literal> + соответствует любой ревизии с 1.0 по 1.99 включительно. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--serialnumber=<replaceable>строка</replaceable></option></term> + <listitem><para> + Задает фильтр серийного номера как строку. Значение по + умолчанию пустое(<literal>""</literal>). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--target=<replaceable>uuid</replaceable> | <replaceable>имя-ВМ</replaceable> | global</option></term> + <listitem><para> + Указывает ВМ, к которой подключается фильтр. Можно + указать Универсальный Уникальный Идентификатор (UUID) + или имя ВМ. Для применения описания фильтра ко всем ВМ, + укажите <literal>global</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vendorid=<replaceable>XXXX</replaceable></option></term> + <listitem><para> + Задает фильтр по ID поставщика, который представляется + строкой шестнадцатеричного номера, состоящего из + четырех цифр включая лидирующие нули. Значение по + умолчанию пустое (<literal>""</literal>). + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-usbfilter-add"> + <title>Добавить USB фильтр или глобальный фильтр</title> + <remark role="help-copy-synopsis"/> + <para> + Используйте команду <command>VBoxManage usbfilter add</command> + для создания нового USB фильтра. + </para> + <para> + Дополнительно укажите параметры для фильтрации. Можно использовать + команду <command>VBoxManage list usbhost</command> для просмотра + параметров устройств, подключенных к вашей системе. + </para> + </refsect2> + <refsect2 id="vboxmanage-usbfilter-modify"> + <title>Изменить USB фильтр или глобальный фильтр</title> + <remark role="help-copy-synopsis"/> + <para> + Используйте команду <command>VBoxManage usbfilter modify</command> + для изменения USB фильтра. Можно использовать команду + <command>VBoxManage list usbfilters</command> для отображения + индексов глобальных фильтров и команду + <command>VBoxManage showvminfo</command> для отображения + индексов по определенной машине. + </para> + </refsect2> + <refsect2 id="vboxmanage-usbfilter-remove"> + <title>Удалить USB фильтр или глобальный фильтр</title> + <remark role="help-copy-synopsis"/> + <para> + Используйте команду <command>VBoxManage usbfilter remove</command> + для удаления USB фильтра. + </para> + </refsect2> + </refsect1> + + <refsect1> + <title>Примеры</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + Следующая команда отображает доступные USB устройства в хост-системе. + </para> +<screen>$ VBoxManage list usbhost</screen> + <para> + Следующая команда добавляет USB фильтр, называемый + <filename>filter01</filename> к ВМ <filename>ol7</filename>. + Фильтр определяет флеш-накопитель Kingston DataTraveler и + помещается первым в списке USB фильтров ВМ. + </para> +<screen>$ VBoxManage usbfilter add 0 --target ol7 --name filter01 --vendorid 0x0930 --productid 0x6545</screen> + <para> + Следующая команда удаляет USB фильтр, который второй в списке + ВМ <filename>ol7</filename> VM. + </para> +<screen>$ VBoxManage usbfilter remove 1 --target ol7</screen> + </refsect1> +</refentry> |