diff options
Diffstat (limited to 'doc/manual/ru_RU/man_VBoxManage-import.xml')
| -rw-r--r-- | doc/manual/ru_RU/man_VBoxManage-import.xml | 456 |
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>--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> |