summaryrefslogtreecommitdiffstats
path: root/doc/manual/ru_RU/man_VBoxManage-import.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/manual/ru_RU/man_VBoxManage-import.xml')
-rw-r--r--doc/manual/ru_RU/man_VBoxManage-import.xml456
1 files changed, 456 insertions, 0 deletions
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>&#45;&#45;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 &lt;тип&gt;"; используйте "list ostypes" для просмотра всех возможных значений)
+ 1: Предложенное имя ВМ "win10-appliance"
+ (изменить через "--vsys 0 --vmname &lt;имя&gt;")
+ 2: Предложенная группа ВМ "/"
+ (изменить через "--vsys 0 --group &lt;группа&gt;")
+ 3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
+ (изменить через "--vsys 0 --settingsfile &lt;имя файла&gt;")
+ 4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs"
+ (изменить через "--vsys 0 --basefolder &lt;путь&gt;")
+ 5: Лицензионное соглашение
+ (показать через "--vsys 0 --eula show";
+ принять через "--vsys 0 --eula accept")
+ 6: Число ЦПУ: 1
+ (изменить через "--vsys 0 --cpus &lt;n&gt;")
+ 7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory &lt;MB&gt;")
+ 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 &lt;путь&gt;";
+ отключить через "--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>