man_VBoxManage-import.xml@ 94219

Last change on this file since 94219 was 94219, checked in by vboxsync, 3 years ago
doc/manual: Some cleanups in the ru_RU VBoxManage refentry documentation, bugref:9186
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 25.0 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-03-14 09:39:06 +0000 (Mon, 14 Mar 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>&product-name;</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>--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...
364	OK.
365	Виртуальная система 0:
366	0: Предложенный тип ОС: "Windows10_64"
367	(изменить через "--vsys 0 --ostype <тип>"; используйте "list ostypes" для просмотра всех возможных значений)
368	1: Предложенное имя ВМ "win10-appliance"
369	(изменить через "--vsys 0 --vmname <имя>")
370	2: Предложенная группа ВМ "/"
371	(изменить через "--vsys 0 --group <группа>")
372	3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
373	(изменить через "--vsys 0 --settingsfile <имя файла>")
374	4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs"
375	(изменить через "--vsys 0 --basefolder <путь>")
376	5: Лицензионное соглашение
377	(показать через "--vsys 0 --eula show";
378	принять через "--vsys 0 --eula accept")
379	6: Число ЦПУ: 1
380	(изменить через "--vsys 0 --cpus <n>")
381	7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory <MB>")
382	8: Аудио карта (конфигурация ожидает "ensoniq1371", может быть изменена при импорте)
383	(отключить через "--vsys 0 --unit 5 --ignore")
384	9: USB контроллер
385	(отключить через "--vsys 0 --unit 6 --ignore")
386	10: Сетевой адаптер: ориг. сетевой мост, конфиг. 2, экстра тип=сетевой мост
387	11: Флоппи
388	(отключить через "--vsys 0 --unit 8 --ignore")
389	12: SCSI контроллер, тип BusLogic
390	(изменить через "--vsys 0 --unit 9 --scsitype {BusLogic\|LsiLogic}";
391	отключить через "--vsys 0 --unit 9 --ignore")
392	13: IDE контроллер, тип PIIX4
393	(отключить через "--vsys 0 --unit 10 --ignore")
394	14: Образ жесткого диска: образ источника=Windows10.vmdk,
395	путь назначения=/home/user1/disks/Windows10.vmdk, контроллер=9;канал=0
396	(изменить путь назначения через "--vsys 0 --unit 11 --disk <путь>";
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.

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

Download in other formats: