1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
manpage, user manual, usage: VBoxManage unattended
-->
<!--
Copyright (C) 2006-2023 Oracle and/or its affiliates.
This file is part of VirtualBox base platform packages, as
available from https://www.virtualbox.org.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation, in version 3 of the
License.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, see <https://www.gnu.org/licenses>.
SPDX-License-Identifier: GPL-3.0-only
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
<!ENTITY % all.entities SYSTEM "all-entities.ent">
%all.entities;
]>
<refentry id="vboxmanage-unattended" lang="en">
<refentryinfo>
<pubdate>$Date: 2023-01-17 15:15:46 +0100 (Tue, 17 Jan 2023) $</pubdate>
<title>VBoxManage unattended</title>
</refentryinfo>
<refmeta>
<refentrytitle>VBoxManage-unattended</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname>VBoxManage-unattended</refname>
<refpurpose>unattended установка гостевой ОС</refpurpose>
<refclass>&product-name;</refclass>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis id="synopsis-vboxmanage-unattended-detect"> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
<command>VBoxManage unattended detect</command>
<arg choice="req">--iso=<replaceable>iso-установщика</replaceable></arg>
<arg>--machine-readable</arg>
</cmdsynopsis>
<cmdsynopsis id="synopsis-vboxmanage-unattended-install"> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
<command>VBoxManage unattended install</command>
<arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
<arg choice="req">--iso=<replaceable>iso-инсталляции</replaceable></arg>
<arg>--user=<replaceable>логин</replaceable></arg>
<arg>--password=<replaceable>пароль</replaceable></arg>
<arg>--password-file=<replaceable>файл</replaceable></arg>
<arg>--full-user-name=<replaceable>имя</replaceable></arg>
<arg>--key=<replaceable>ключ-продукта</replaceable></arg>
<arg>--install-additions</arg>
<arg>--no-install-additions</arg>
<arg>--additions-iso=<replaceable>iso-дополнений</replaceable></arg>
<arg>--install-txs</arg>
<arg>--no-install-txs</arg>
<arg>--validation-kit-iso=<replaceable>iso-тестирования</replaceable></arg>
<arg>--locale=<replaceable>ll_CC</replaceable></arg>
<arg>--country=<replaceable>CC</replaceable></arg>
<arg>--time-zone=<replaceable>tz</replaceable></arg>
<arg>--hostname=<replaceable>имя-хоста</replaceable></arg>
<arg>--package-selection-adjustment=<replaceable>ключ</replaceable></arg>
<arg>--dry-run</arg>
<arg>--auxiliary-base-path=<replaceable>путь</replaceable></arg>
<arg>--image-index=<replaceable>номер</replaceable></arg>
<arg>--script-template=<replaceable>файл</replaceable></arg>
<arg>--post-install-template=<replaceable>файл</replaceable></arg>
<arg>--post-install-command=<replaceable>команда</replaceable></arg>
<arg>--extra-install-kernel-parameters=<replaceable>параметры</replaceable></arg>
<arg>--language=<replaceable>язык</replaceable></arg>
<arg>--start-vm=<replaceable>тип-сессии</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Описание</title>
<refsect2 id="vboxmanage-unattended-detect">
<title>unattended detect</title>
<remark role="help-copy-synopsis"/>
<para>
Определяет гостевую операционную систему (ОС) на указанном инсталляционном
ISO и отображает результат. Это может быть использовано как входные данные
при создании ВМ для устанавливаемого ISO.
</para>
<variablelist>
<varlistentry>
<term><option>--iso=<replaceable>iso-инсталляции</replaceable></option></term>
<listitem><para>Определяемый инсталляционный ISO.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--machine-readable</option></term>
<listitem><para>Производит вывод, который проще для разбора из скрипта.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2 id="vboxmanage-unattended-install">
<title>unattended install</title>
<remark role="help-copy-synopsis"/>
<para>
Перенастраивает указанную ВМ для установки и опционально запуска ОС.
</para>
<variablelist>
<varlistentry>
<term><replaceable>uuid|имя-ВМ</replaceable></term>
<listitem><para>Или UUID или имя (чувствительно к регистру) ВМ.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--iso=<replaceable>iso-инсталляции</replaceable></option></term>
<listitem><para>Инсталляционный ISO для запуска определения.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--user=<replaceable>логин</replaceable></option></term>
<listitem><para>Имя пользователя. (По умолчанию: vboxuser)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--password=<replaceable>пароль</replaceable></option></term>
<listitem>
<para>Пароль пользователя. Он используется как для пользователя указанного через <option>--user</option>, так и для
пользователя root/administrator. (по умолчанию: changeme)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--password-file=<replaceable>файл</replaceable></option></term>
<listitem>
<para>Альтернатива <option>--password</option> для передачи пароля. Специальное имя файла
<computeroutput>stdin</computeroutput> может использоваться для чтения пароля с стандартного потока ввода.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--full-user-name=<replaceable>имя</replaceable></option></term>
<listitem><para>Полное имя пользователя. (по умолчанию: --user)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--key=<replaceable>ключ-продукта</replaceable></option></term>
<listitem><para>Ключ продукта гостевой ОС. Не всем гостевым ОС требуется это.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--install-additions</option>, <option>--no-install-additions</option></term>
<listitem><para>Устанавливать ли Дополнения Гостевой ОС VirtualBox. (по умолчанию: --no-install-addations)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--additions-iso=<replaceable>iso-дополнений</replaceable></option></term>
<listitem>
<para>Путь к ISO Дополнений Гостевой ОС. (по умолчанию: installed/downloaded GAs)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--install-txs</option>, <option>--no-install-txs</option></term>
<listitem>
<para>Инсталлировать ли службу выполнения тестов (TXS) из VirtualBox ValidationKit.
Это полезно при подготовке ВМ к тестированию или подобной работы. (по умолчанию: --no-install-txs)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--validation-kit-iso=<replaceable>iso-тестирования</replaceable></option></term>
<listitem>
<para>Путь к VirtualBox ValidationKit ISO. Опция необходима если указана <option>--install-txs</option>
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--locale=<replaceable>ll_CC</replaceable></option></term>
<listitem>
<para>Спецификация базовая локали для гостевой системы, например en_US, de_CH, или nn_NO. (по умолчанию: host или en_US)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--country=<replaceable>CC</replaceable></option></term>
<listitem><para>Двухбуквенный кода страны если отличается от указанной в <option>--location</option>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--time-zone=<replaceable>tz</replaceable></option></term>
<listitem><para>Часовая зона для установки в гостевой ОС. (по умолчанию: часовая зона хоста или UTC)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--hostname=<replaceable>имя-хоста</replaceable></option></term>
<listitem>
<para> Полное доменное имя гостевой машины. (по умолчанию: <replaceable>имя-ВМ</replaceable>.myguest.virtualbox.org)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--package-selection-adjustment=<replaceable>ключ</replaceable></option></term>
<listitem>
<para> Корректировка выбора пакетов/компонентов гостевой ОС. Может быть указана более одного раза. В настоящее
время единственным распознаваемым ключевым словом является <computeroutput>minimal</computeroutput>, которое
запускает минимальную установку для некоторых гостевых ОС.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--dry-run</option></term>
<listitem><para>Не создавать каких-либо файлов или делать изменения в конфигурации ВМ.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--start-vm=<replaceable>тип-сессии</replaceable></option></term>
<listitem>
<para>Запуск ВМ с помощью фронтенда, указанного в <replaceable>session-type</replaceable>. Это то же самое что
и опция <option>--type</option> для команды <computeroutput>startvm</computeroutput>, Но нам пришлось добавить
<computeroutput>none</computeroutput> для указания того, что ВМ не надо запускать.
(по умолчанию: <computeroutput>none</computeroutput>)</para></listitem>
</varlistentry>
</variablelist>
<para>Дополнительные опции:</para>
<variablelist>
<varlistentry>
<term><option>--auxiliary-base-path=<replaceable>путь</replaceable></option></term>
<listitem>
<para>Префикс пути к файлам относящимся к носителю, созданные для установки.
(по умолчанию: <replaceable>папка-настроек-ВМ</replaceable>/Unattended-<replaceable>uuid-ВМ</replaceable>-)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--image-index=<replaceable>номер</replaceable></option></term>
<listitem><para>Индекс образа инсталляции Windows. (по умолчанию: 1)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--script-template=<replaceable>файл</replaceable></option></term>
<listitem><para>Шаблон скрипта unattended инсталляции. (по умолчанию: зависит от IMachine::OSTypeId)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--post-install-template=<replaceable>файл</replaceable></option></term>
<listitem><para>Шаблон скрипта после инсталляции. (по умолчанию: зависит от IMachine::OSTypeId)</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--post-install-command=<replaceable>команда</replaceable></option></term>
<listitem>
<para>Единичная команда, запускаемая после завершения установки. Точный формат и точный момент,
когда будет запущена команда, зависит от установщика гостевой ОС.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--extra-install-kernel-parameters=<replaceable>параметры</replaceable></option></term>
<listitem>
<para>
Список дополнительных параметров ядра Linux в течение установки. (по умолчанию: зависит от IMachine::OSTypeId)
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--language=<replaceable>язык</replaceable></option></term>
<listitem>
<para>
Задает язык пользовательского интерфейса для Windows инсталляции. <replaceable>язык</replaceable> обычно
в виде {ll}-{CC}. Смотрите результаты detectedOSLanguages из <command>VBoxManage unattended detect</command>.
(по умолчанию: detectedOSLanguages[0])</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
</refentry>
|
