VirtualBox

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

Last change on this file since 94171 was 93478, checked in by vboxsync, 3 years ago

Doc/manual: bugref:1909: Added Russian translation of VBoxManage manuals

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