VirtualBox

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

最後變更 在這個檔案從96388是 96300,由 vboxsync 提交於 3 年 前

doc: comment fixing

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

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