VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-import.xml@ 103131

Last change on this file since 103131 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 25.3 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage import
4-->
5<!--
6 Copyright (C) 2006-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-import" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage import</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-import</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-import</refname>
44 <refpurpose>импорт виртуальной конфигурации в формате OVF или из облачной службы и создание виртуальной машины</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-import-ovf">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage import</command>
52 <group choice="req">
53 <arg choice="plain"><replaceable>имя-ovf</replaceable></arg>
54 <arg choice="plain"><replaceable>имя-ova</replaceable></arg>
55 </group>
56 <arg>--dry-run</arg>
57 <arg>--options=<group choice="plain">
58 <arg choice="plain">keepallmacs</arg>
59 <arg choice="plain">keepnatmacs</arg>
60 <arg choice="plain">importtovdi</arg>
61 </group></arg>
62 <arg>--vsys=<replaceable>n</replaceable></arg>
63 <arg>--ostype=<replaceable>тип-ос</replaceable></arg>
64 <arg>--vmname=<replaceable>имя</replaceable></arg>
65 <arg>--settingsfile=<replaceable>файл</replaceable></arg>
66 <arg>--basefolder=<replaceable>папка</replaceable></arg>
67 <arg>--group=<replaceable>группа</replaceable></arg>
68 <arg>--memory=<replaceable>МБ</replaceable></arg>
69 <arg>--cpus=<replaceable>n</replaceable></arg>
70 <arg>--description=<replaceable>текст</replaceable></arg>
71 <arg>--eula=<group choice="plain">
72 <arg choice="plain">show</arg>
73 <arg choice="plain">accept</arg>
74 </group></arg>
75 <arg>--unit=<replaceable>n</replaceable></arg>
76 <arg>--ignore</arg>
77 <arg>--scsitype=<group choice="plain">
78 <arg choice="plain">BusLogic</arg>
79 <arg choice="plain">LsiLogic</arg>
80 </group></arg>
81 <!-- <arg>&#45;&#45;controller=<replaceable>n</replaceable></arg> -->
82 <arg>--disk=<replaceable>путь</replaceable></arg>
83 </cmdsynopsis>
84
85 <cmdsynopsis id="synopsis-vboxmanage-import-cloud">
86<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
87 <command>VBoxManage import</command>
88 <arg choice="plain">OCI://</arg>
89 <arg choice="plain">--cloud</arg>
90 <arg>--ostype=<replaceable>тип-ос</replaceable></arg>
91 <arg>--vmname=<replaceable>имя</replaceable></arg>
92 <arg>--basefolder=<replaceable>папка</replaceable></arg>
93 <arg>--memory=<replaceable>МБ</replaceable></arg>
94 <arg>--cpus=<replaceable>n</replaceable></arg>
95 <arg>--description=<replaceable>текст</replaceable></arg>
96 <arg choice="req">--cloudprofile=<replaceable>профиль</replaceable></arg>
97 <arg choice="req">--cloudinstanceid=<replaceable>id</replaceable></arg>
98 <arg>--cloudbucket=<replaceable>корзина</replaceable></arg>
99 </cmdsynopsis>
100 </refsynopsisdiv>
101
102 <refsect1>
103 <title>Описание</title>
104 <para>
105 Команда <command>VBoxManage import</command> импортирует виртуальную
106 конфигурацию из формата OVF или из облачной службы, например &oci;.
107 Импорт производится путем копирования образов виртуальных дисков
108 (по умолчанию в формает VMDK образа) и создания виртуальных машин (ВМ)
109 в &product-name;. Смотрите <xref linkend="ovf" />.
110 </para>
111 <para>
112 Необходимо указать путь к OVF файлу или OVA архиву в качестве входных
113 данных или заполнитель для облачного варианта. В случае OVF конфигураций,
114 убедитесь, что все образы дисков в той же директории, что и OVF файл.
115 </para>
116 <para>
117 Обратите внимание, что любые опции, указываемые для управления
118 импортированной виртуальной конфигурацией или для изменения
119 параметров импорта зависят от содержимого файла OVF или от
120 информации из облачной службы.
121 </para>
122 <para>
123 Перед использованием операции импорта для создания ВМ, произведите
124 пробный запуск для проверки корректности вашей конфигурации. Это
125 полезно с конфигурациями OVF и OVA, потому что в случае с облачной
126 службой, даже при пробном запуске необходимо произвести достаточно
127 много действий, занимающих ощутимое время.
128 </para>
129 <para>
130 Импорт из облачной службы загружает временный файл, содержащий и
131 загрузочный образ и некоторые метаданные, описывающие детали
132 экземпляра ВМ. Временный файл удаляется после успешного импорта.
133 </para>
134 <refsect2>
135 <title>Общие параметры</title>
136 <variablelist>
137 <varlistentry>
138 <term><replaceable>имя-ovf</replaceable> | <replaceable>имя-ova</replaceable></term>
139 <listitem><para>
140 Задает имя файла OVF или архив OVA, описывающий конфигурацию.
141 В случае облака, это обычно фиксированная строка, такая как
142 <literal>OCI://</literal>.
143 </para></listitem>
144 </varlistentry>
145 <varlistentry>
146 <term><option>--dry-run</option></term>
147 <!-- Does this option really work for cloud import? -->
148 <listitem><para>
149 Производит пробный запуск команды <command>VBoxManage
150 import</command> перед проведением реальной операции
151 импорта. Операция пробного запуска делает следующее:
152 </para><itemizedlist>
153 <listitem><para>
154 Выводит описание содержимого конфигурации, основанное
155 на указанном OVF или OVA файле.
156 </para></listitem>
157 <listitem><para>
158 Показывает, как конфигурация могла быть импортирована
159 в &product-name;. В дополнение, вывод показывает все
160 опции, которые можно использовать для изменения
161 поведения импорта.
162 </para></listitem>
163 </itemizedlist><para>
164 Краткая форма этой опции <option>-n</option>.
165 </para></listitem>
166 </varlistentry>
167 <varlistentry>
168 <term><option>--options=keepallmacs | keepnatmacs | importtovdi</option></term>
169 <!-- Does this option really work for cloud import? -->
170 <listitem><para>
171 Позволяет подстроить операцию импорта.
172 </para><para>
173 Допустимые аргументы нижеследующие:
174 </para><itemizedlist>
175 <listitem><para>
176 <literal>keepallmacs</literal>: Указывает, что
177 MAC адреса каждой виртуальной сетевой карты
178 остаются неизменными.
179 </para></listitem>
180 <listitem><para>
181 <literal>keepnatmacs</literal>: Указывает, что
182 MAC адреса каждой виртуальной сетевой карты
183 остаются неизменными если тип сети - NAT.
184 </para></listitem>
185 <listitem><para>
186 <literal>importtovdi</literal>: Указывает, что
187 все новые образы дисков в формате файла VDI.
188 </para></listitem>
189 </itemizedlist></listitem>
190 </varlistentry>
191 <varlistentry>
192 <term><option>--ostype=<replaceable>тип-ос</replaceable></option></term>
193 <listitem><para>
194 Задает информацию о гостевой операционной системе (ОС) для
195 ВМ. Используйте команду <command>VBoxManage list ostypes</command>
196 для отображения идентификаторов типов ОС.
197 </para></listitem>
198 </varlistentry>
199 <varlistentry>
200 <term><option>--vmname=<replaceable>имя</replaceable></option></term>
201 <listitem><para>
202 Задает имя ВМ в &product-name;.
203 </para></listitem>
204 </varlistentry>
205 <varlistentry>
206 <term><option>--basefolder=<replaceable>папка</replaceable></option></term>
207 <!-- Does this option really work for cloud import? -->
208 <listitem><para>
209 Задает папку, где сохраняются файлы импортированной ВМ.
210 </para></listitem>
211 </varlistentry>
212 <varlistentry>
213 <term><option>--memory=<replaceable>МБ</replaceable></option></term>
214 <listitem><para>
215 Задает размер памяти в мегабайтах в импортированной ВМ.
216 </para></listitem>
217 </varlistentry>
218 <varlistentry>
219 <term><option>--cpus=<replaceable>n</replaceable></option></term>
220 <listitem><para>
221 Задает количество ЦПУ в импортированной ВМ.
222 </para></listitem>
223 </varlistentry>
224 <varlistentry>
225 <term><option>--description=<replaceable>текст</replaceable></option></term>
226 <listitem><para>
227 Задает текст описания, видимый в графическом и командном
228 интерфейсе при проверке деталей ВМ.
229 </para></listitem>
230 </varlistentry>
231 </variablelist>
232 </refsect2>
233
234 <refsect2 id="vboxmanage-import-ovf">
235 <title>Опции импорта OVF / OVA</title>
236 <para>
237 Следующие опции предназначены для импорта виртуальной конфигурации
238 в форматах OVF или OVA. Такие конфигурации могут содержать один или
239 несколько ВМ. Поэтому требуется указать, какую конфигурацию ВМ надо
240 подстроить если вы хотите изменить ее. Смотрите
241 <xref linkend="ovf-import-appliance" />.
242 </para>
243 <remark role="help-copy-synopsis"/>
244 <variablelist>
245 <varlistentry>
246 <term><option>--vsys=<replaceable>n</replaceable></option></term>
247 <listitem><para>
248 Задает индекс конкретной ВМ внутри конфигурации. Влияет
249 на нижеследующие опции.
250 </para></listitem>
251 </varlistentry>
252 <varlistentry>
253 <term><option>--unit=<replaceable>n</replaceable></option></term>
254 <listitem><para>
255 Задает индекс конкретного элемента ВМ внутри конфигурации.
256 Влияет на нижеследующие опции.
257 </para></listitem>
258 </varlistentry>
259 <varlistentry>
260 <term><option>--settingsfile=<replaceable>файл</replaceable></option></term>
261 <listitem><para>
262 Задает имя файла настроек ВМ (с указанием пути или без),
263 который будет создан как часть импорта. Обычно, более
264 предпочтительный способ это переопределение имени ВМ через
265 <option>--vmname</option> и, если нужно, указание папки,
266 где надо создать ВМ, через <option>--basefolder</option>.
267 </para></listitem>
268 </varlistentry>
269 <varlistentry>
270 <term><option>--group=<replaceable>группа</replaceable></option></term>
271 <listitem><para>
272 Задает первичную группу импортированной ВМ.
273 </para></listitem>
274 </varlistentry>
275 <varlistentry>
276 <term><option>--eula=show | accept</option></term>
277 <listitem><para>
278 Позволяет вам отобразить или принять условия лицензии ВМ
279 внутри конфигурации.
280 </para><para>
281 Допустимы следующие аргументы:
282 </para><itemizedlist>
283 <listitem><para>
284 <literal>show</literal>: Показывает лицензионное соглашение ВМ.
285 </para></listitem>
286 <listitem><para>
287 <literal>accepts</literal>: Принимает лицензионное соглашение ВМ.
288 Все ВМ в конфигурации, имеющие лицензию, требуют ее принятия,
289 иначе импорт закончится неудачей.
290 </para></listitem>
291 </itemizedlist></listitem>
292 </varlistentry>
293 <varlistentry>
294 <term><option>--ignore</option></term>
295 <listitem><para>
296 Игнорирует текущий элемент импортируемой ВМ, эффективно
297 удаляя связанное аппаратное обеспечение.
298 </para></listitem>
299 </varlistentry>
300 <varlistentry>
301 <term><option>--scsitype=BusLogic | LsiLogic</option></term>
302 <listitem><para>
303 Позволяет выбрать тип SCSI контроллера текущего элемента
304 импортированной ВМ.
305 </para><para>
306 Допустимы следующие аргументы:
307 </para><itemizedlist>
308 <listitem><para>
309 <literal>BusLogic</literal>: Использует SCSI контроллер
310 типа BusLogic (очень старый).
311 </para></listitem>
312 <listitem><para>
313 <literal>LsiLogic</literal>: Использует SCSI контроллер
314 типа LsiLogic (более современный).
315 </para></listitem>
316 </itemizedlist></listitem>
317 </varlistentry>
318 </variablelist>
319 </refsect2>
320
321 <refsect2 id="vboxmanage-import-cloud">
322 <title>Опции импорта из облака</title>
323 <para>
324 Следующие опции предназначены для импорта экземпляра ВМ из
325 провайдера облачной службы. Они всегда имеют дело только
326 с одной ВМ. Смотрите <xref linkend="cloud-import-oci" />.
327 </para>
328 <remark role="help-copy-synopsis"/>
329 <variablelist>
330 <varlistentry>
331 <term><option>--cloud</option></term>
332 <listitem><para>
333 Указывает, что импорт должен быть из облака.
334 </para></listitem>
335 </varlistentry>
336 <varlistentry>
337 <term><option>--cloudprofile=<replaceable>профиль</replaceable></option></term>
338 <listitem><para>
339 Задает облачный профиль используемый для соединения с
340 провайдером облачной службы. Облачный профиль содержит
341 детали вашей учетной записи &oci;, такие как ваш OCID
342 пользователя и отпечаток вашего публичного ключа. У вас
343 должны быть требуемые права в &oci;, чтобы использовать
344 облачный профиль.
345 </para></listitem>
346 </varlistentry>
347 <varlistentry>
348 <term><option>--cloudinstanceid=<replaceable>id</replaceable></option></term>
349 <listitem><para>
350 Задает ID существующего экземпляра в облаке.
351 </para></listitem>
352 </varlistentry>
353 <varlistentry>
354 <term><option>--cloudbucket=<replaceable>корзина</replaceable></option></term>
355 <listitem><para>
356 Задает имя корзины, куда сохранять объекты, созданные из
357 экземпляра. В &oci;, корзина - это логический контейнер для
358 сохранения объектов. По умолчанию, используется первая
359 доступная корзина в облачном профиле.
360 </para></listitem>
361 </varlistentry>
362 </variablelist>
363 </refsect2>
364 </refsect1>
365
366 <refsect1>
367 <title>Примеры</title>
368 <remark role="help-scope" condition="GLOBAL"/>
369 <para>
370 Следующий пример производит пробный запуск операции OVF импорта
371 примерной конфигурации, содержащей гостевую систему Windows 10:
372 </para>
373<screen>$ VBoxManage import Windows10.ovf --dry-run
374Интерпретация Windows10.ovf...
375OK.
376Виртуальная система 0:
377 0: Предложенный тип ОС: "Windows10_64"
378 (изменить через "--vsys 0 --ostype &lt;тип&gt;"; используйте "list ostypes" для просмотра всех возможных значений)
379 1: Предложенное имя ВМ "win10-appliance"
380 (изменить через "--vsys 0 --vmname &lt;имя&gt;")
381 2: Предложенная группа ВМ "/"
382 (изменить через "--vsys 0 --group &lt;группа&gt;")
383 3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
384 (изменить через "--vsys 0 --settingsfile &lt;имя файла&gt;")
385 4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs"
386 (изменить через "--vsys 0 --basefolder &lt;путь&gt;")
387 5: Лицензионное соглашение
388 (показать через "--vsys 0 --eula show";
389 принять через "--vsys 0 --eula accept")
390 6: Число ЦПУ: 1
391 (изменить через "--vsys 0 --cpus &lt;n&gt;")
392 7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory &lt;MB&gt;")
393 8: Аудио карта (конфигурация ожидает "ensoniq1371", может быть изменена при импорте)
394 (отключить через "--vsys 0 --unit 5 --ignore")
395 9: USB контроллер
396 (отключить через "--vsys 0 --unit 6 --ignore")
39710: Сетевой адаптер: ориг. сетевой мост, конфиг. 2, экстра тип=сетевой мост
39811: Флоппи
399 (отключить через "--vsys 0 --unit 8 --ignore")
40012: SCSI контроллер, тип BusLogic
401 (изменить через "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
402 отключить через "--vsys 0 --unit 9 --ignore")
40313: IDE контроллер, тип PIIX4
404 (отключить через "--vsys 0 --unit 10 --ignore")
40514: Образ жесткого диска: образ источника=Windows10.vmdk,
406 путь назначения=/home/user1/disks/Windows10.vmdk, контроллер=9;канал=0
407 (изменить путь назначения через "--vsys 0 --unit 11 --disk &lt;путь&gt;";
408 отключить через "--vsys 0 --unit 11 --ignore")</screen>
409 <para>
410 Вывод пробного запуска показывает и нумерует индивидуальные
411 элементы настройки описанные в файле
412 <filename>Windows10.ovf</filename>. Некоторые из них включают
413 информацию о том, как отключить или изменить настройку элемента.
414 </para>
415 <para>
416 Можно отключить многие элементы, используя опции <option>--vsys
417 <replaceable>X</replaceable> --unit <replaceable>Y</replaceable>
418 --ignore</option>. <replaceable>X</replaceable> - это номер
419 виртуальной системы. Значение равно <literal>0</literal> если
420 конфигурация содержит только одно описание виртуальной системы.
421 <replaceable>Y</replaceable> - это номер элемента конфигурации.
422 </para>
423 <para>
424 Элемент 1 в выводе команды примера указывает имя целевой машины.
425 Элементы 12 и 13 указывают контроллеры IDE и SCSI жестких дисков
426 соответственно.
427 </para>
428 <para>
429 Элемент 14 показывает образ жесткого диска и опцию
430 <option>--disk</option>, задающую путь назначения, где сохранять
431 образ. Значение по умолчанию задается в файле OVF.
432 </para>
433 <para>
434 Можно комбинировать несколько элементов для той же самой
435 виртуальной системы, путем указания того же самого значения
436 для опции <option>--vsys</option>. Например, используйте
437 следующую команду для импорта машины как описано в OVF,
438 кроме аудио карты и USB контроллера, и образ диска должен
439 сохраняться с другим именем.
440 </para>
441<screen>$ VBoxManage import Windows10.ovf --vsys 0 --unit 8 --ignore \
442 --unit 9 --ignore --unit 14 --disk Windows10_disk0.vmdk</screen>
443 <para>
444 Следующий пример иллюстрирует как импортировать ВМ из &oci;. Для поиска
445 экземпляров ВМ в &oci;, а также их ID, можно вывести список всех доступных
446 экземпляров через:
447 </para>
448<screen>$ VBoxManage cloud --provider=OCI --profile=<replaceable>имя-облачного-профиля</replaceable> list instances</screen>
449 <para>
450 Когда ID известно, следующая команда импортирует экземпляр из &oci;:
451 </para>
452<screen>$ VBoxManage import OCI:// --cloud --vmname OCI_FreeBSD_VM --memory 4000 \
453 --cpus 3 --ostype FreeBSD_64 --cloudprofile "standard user" \
454 --cloudinstanceid ocid1.instance.oc1.iad.abuwc... --cloudbucket myBucket</screen>
455 </refsect1>
456</refentry>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette