man_VBoxManage-import.xml@ 103620

Last change on this file since 103620 was 103620, checked in by vboxsync, 9 months ago
doc/man_VBoxManage: Adapt Russian translation files: Require all refsect1 and refsect2 elements to have @id attributes in manpages. bugref:10302
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 25.4 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: 2024-02-29 20:47:25 +0000 (Thu, 29 Feb 2024) $</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>--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 id="vboxmanage-import-description">
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 id="vboxmanage-import-common-options">
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 id="vboxmanage-import-examples">
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...
375	OK.
376	Виртуальная система 0:
377	0: Предложенный тип ОС: "Windows10_64"
378	(изменить через "--vsys 0 --ostype <тип>"; используйте "list ostypes" для просмотра всех возможных значений)
379	1: Предложенное имя ВМ "win10-appliance"
380	(изменить через "--vsys 0 --vmname <имя>")
381	2: Предложенная группа ВМ "/"
382	(изменить через "--vsys 0 --group <группа>")
383	3: Предложенное имя файла настроек ВМ "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
384	(изменить через "--vsys 0 --settingsfile <имя файла>")
385	4: Предложенная основная папка ВМ "/home/user1/VirtualBox VMs"
386	(изменить через "--vsys 0 --basefolder <путь>")
387	5: Лицензионное соглашение
388	(показать через "--vsys 0 --eula show";
389	принять через "--vsys 0 --eula accept")
390	6: Число ЦПУ: 1
391	(изменить через "--vsys 0 --cpus <n>")
392	7: Размер памяти гостевой системы: 2048 MB (изменить через "--vsys 0 --memory <MB>")
393	8: Аудио карта (конфигурация ожидает "ensoniq1371", может быть изменена при импорте)
394	(отключить через "--vsys 0 --unit 5 --ignore")
395	9: USB контроллер
396	(отключить через "--vsys 0 --unit 6 --ignore")
397	10: Сетевой адаптер: ориг. сетевой мост, конфиг. 2, экстра тип=сетевой мост
398	11: Флоппи
399	(отключить через "--vsys 0 --unit 8 --ignore")
400	12: SCSI контроллер, тип BusLogic
401	(изменить через "--vsys 0 --unit 9 --scsitype {BusLogic\|LsiLogic}";
402	отключить через "--vsys 0 --unit 9 --ignore")
403	13: IDE контроллер, тип PIIX4
404	(отключить через "--vsys 0 --unit 10 --ignore")
405	14: Образ жесткого диска: образ источника=Windows10.vmdk,
406	путь назначения=/home/user1/disks/Windows10.vmdk, контроллер=9;канал=0
407	(изменить путь назначения через "--vsys 0 --unit 11 --disk <путь>";
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.

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

Download in other formats: