VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-guestcontrol.xml@ 103131

Last change on this file since 103131 was 98103, checked in by vboxsync, 22 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 68.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage guestcontrol
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-guestcontrol" lang="en">
32 <refentryinfo>
33 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
34 <title>VBoxManage guestcontrol</title>
35 </refentryinfo>
36
37 <refmeta>
38 <refentrytitle>VBoxManage-guestcontrol</refentrytitle>
39 <manvolnum>1</manvolnum>
40 </refmeta>
41
42 <refnamediv>
43 <refname>VBoxManage-guestcontrol</refname>
44 <refpurpose>управляет виртуальной машиной из хост-системы</refpurpose>
45 <refclass>&product-name;</refclass>
46 </refnamediv>
47
48 <refsynopsisdiv>
49 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-run">
50<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
51 <command>VBoxManage guestcontrol</command>
52 <group choice="req">
53 <arg choice="plain"><replaceable>uuid</replaceable></arg>
54 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
55 </group>
56 <arg choice="plain">run</arg>
57 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
58 <arg>--dos2unix</arg>
59 <arg>--exe=<replaceable>имя-файла</replaceable></arg>
60 <arg>--ignore-orphaned-processes</arg>
61 <group>
62 <arg choice="plain">--no-wait-stderr</arg>
63 <arg choice="plain">--wait-stderr</arg>
64 </group>
65 <group>
66 <arg choice="plain">--no-wait-stdout</arg>
67 <arg choice="plain">--wait-stdout</arg>
68 </group>
69 <group>
70 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
71 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
72 </group>
73 <arg>--profile</arg>
74 <arg>--putenv=<replaceable>имя-переменной</replaceable>=[<replaceable>значение</replaceable>]</arg>
75 <arg>--quiet</arg>
76 <arg>--timeout=<replaceable>миллисекунды</replaceable></arg>
77 <arg>--unix2dos</arg>
78 <arg>--unquoted-args</arg>
79 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
80 <arg>--verbose</arg>
81 <arg choice="req">-- <replaceable>программа/аргумент0</replaceable> <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
82 </cmdsynopsis>
83
84 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-start">
85 <command>VBoxManage guestcontrol</command>
86 <group choice="req">
87 <arg choice="plain"><replaceable>uuid</replaceable></arg>
88 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
89 </group>
90 <arg choice="plain">start</arg>
91 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
92 <arg>--exe=<replaceable>имя-файла</replaceable></arg>
93 <arg>--ignore-orphaned-processes</arg>
94 <group>
95 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
96 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
97 </group>
98 <arg>--profile</arg>
99 <arg>--putenv=<replaceable>имя-переменной</replaceable>=[<replaceable>значение</replaceable>]</arg>
100 <arg>--quiet</arg>
101 <arg>--timeout=<replaceable>миллисекунды</replaceable></arg>
102 <arg>--unquoted-args</arg>
103 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
104 <arg>--verbose</arg>
105 <arg choice="req">-- <replaceable>программа/аргумент0</replaceable> <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
106 </cmdsynopsis>
107
108 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyfrom">
109 <command>VBoxManage guestcontrol</command>
110 <group choice="req">
111 <arg choice="plain"><replaceable>uuid</replaceable></arg>
112 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
113 </group>
114 <arg choice="plain">copyfrom</arg>
115 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
116 <arg>--follow</arg>
117 <group>
118 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
119 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
120 </group>
121 <arg>--quiet</arg>
122 <arg>--no-replace</arg>
123 <arg>--recursive</arg>
124 <arg>--target-directory=<replaceable>хост-директория-назначения</replaceable></arg>
125 <arg>--update</arg>
126 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
127 <arg>--verbose</arg>
128 <arg choice="req"><replaceable>гостевой-источник0</replaceable></arg>
129 <arg choice="plain"><replaceable>гостевой-источник1</replaceable> [...]</arg>
130 </cmdsynopsis>
131
132 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyto">
133 <command>VBoxManage guestcontrol</command>
134 <group choice="req">
135 <arg choice="plain"><replaceable>uuid</replaceable></arg>
136 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
137 </group>
138 <arg choice="plain">copyto</arg>
139 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
140 <arg>--follow</arg>
141 <group>
142 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
143 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
144 </group>
145 <arg>--quiet</arg>
146 <arg>--no-replace</arg>
147 <arg>--recursive</arg>
148 <arg>--target-directory=<replaceable>гостевая-директория-назначения</replaceable></arg>
149 <arg>--update</arg>
150 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
151 <arg>--verbose</arg>
152 <arg choice="req"><replaceable>хост-источник0</replaceable></arg>
153 <arg choice="plain"><replaceable>хост-источник1</replaceable> [...]</arg>
154 </cmdsynopsis>
155
156 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mkdir">
157 <command>VBoxManage guestcontrol</command>
158 <group choice="req">
159 <arg choice="plain"><replaceable>uuid</replaceable></arg>
160 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
161 </group>
162 <arg choice="plain">mkdir</arg>
163 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
164 <arg>--mode=<replaceable>режим</replaceable></arg>
165 <arg>--parents</arg>
166 <group>
167 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
168 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
169 </group>
170 <arg>--quiet</arg>
171 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
172 <arg>--verbose</arg>
173 <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
174 </cmdsynopsis>
175
176 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rmdir">
177 <command>VBoxManage guestcontrol</command>
178 <group choice="req">
179 <arg choice="plain"><replaceable>uuid</replaceable></arg>
180 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
181 </group>
182 <arg choice="plain">rmdir</arg>
183 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
184 <group>
185 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
186 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
187 </group>
188 <arg>--quiet</arg>
189 <arg>--recursive</arg>
190 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
191 <arg>--verbose</arg>
192 <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
193 </cmdsynopsis>
194
195 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rm">
196 <command>VBoxManage guestcontrol</command>
197 <group choice="req">
198 <arg choice="plain"><replaceable>uuid</replaceable></arg>
199 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
200 </group>
201 <arg choice="plain">rm</arg>
202 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
203 <arg>--force</arg>
204 <group>
205 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
206 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
207 </group>
208 <arg>--quiet</arg>
209 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
210 <arg>--verbose</arg>
211 <arg choice="req" rep="repeat"><replaceable>гостевая-директория</replaceable></arg>
212 </cmdsynopsis>
213
214 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mv">
215 <command>VBoxManage guestcontrol</command>
216 <group choice="req">
217 <arg choice="plain"><replaceable>uuid</replaceable></arg>
218 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
219 </group>
220 <arg choice="plain">mv</arg>
221 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
222 <group>
223 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
224 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
225 </group>
226 <arg>--quiet</arg>
227 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
228 <arg>--verbose</arg>
229 <arg choice="req" rep="repeat"><replaceable>источник</replaceable></arg>
230 <arg choice="req"><replaceable>директория-назначения</replaceable></arg>
231 </cmdsynopsis>
232
233 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mktemp">
234 <command>VBoxManage guestcontrol</command>
235 <group choice="req">
236 <arg choice="plain"><replaceable>uuid</replaceable></arg>
237 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
238 </group>
239 <arg choice="plain">mktemp</arg>
240 <arg>--directory</arg>
241 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
242 <arg>--mode=<replaceable>режим</replaceable></arg>
243 <group>
244 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
245 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
246 </group>
247 <arg>--quiet</arg>
248 <arg>--secure</arg>
249 <arg>--tmpdir=<replaceable>имя-директории</replaceable></arg>
250 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
251 <arg>--verbose</arg>
252 <arg choice="req"><replaceable>имя-шаблона</replaceable></arg>
253 </cmdsynopsis>
254
255 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-stat">
256 <command>VBoxManage guestcontrol</command>
257 <group choice="req">
258 <arg choice="plain"><replaceable>uuid</replaceable></arg>
259 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
260 </group>
261 <arg choice="plain">stat</arg>
262 <arg>--domain=<replaceable>имя-домена</replaceable></arg>
263 <group>
264 <arg choice="plain">--passwordfile=<replaceable>файл-с-паролем</replaceable></arg>
265 <arg choice="plain">--password=<replaceable>пароль</replaceable></arg>
266 </group>
267 <arg>--quiet</arg>
268 <arg>--username=<replaceable>имя-пользователя</replaceable></arg>
269 <arg>--verbose</arg>
270 <arg choice="req"><replaceable>имя-файла</replaceable></arg>
271 </cmdsynopsis>
272
273 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-list">
274 <command>VBoxManage guestcontrol</command>
275 <group choice="req">
276 <arg choice="plain"><replaceable>uuid</replaceable></arg>
277 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
278 </group>
279 <arg choice="plain">list</arg>
280 <group choice="req">
281 <arg choice="plain">all</arg>
282 <arg choice="plain">files</arg>
283 <arg choice="plain">processes</arg>
284 <arg choice="plain">sessions</arg>
285 </group>
286 <arg>--quiet</arg>
287 <arg>--verbose</arg>
288 </cmdsynopsis>
289
290 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closeprocess">
291 <command>VBoxManage guestcontrol</command>
292 <group choice="req">
293 <arg choice="plain"><replaceable>uuid</replaceable></arg>
294 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
295 </group>
296 <arg choice="plain">closeprocess</arg>
297 <group>
298 <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
299 <arg choice="plain">--session-name=<replaceable>имя-или-шаблон</replaceable></arg>
300 </group>
301 <arg>--quiet</arg>
302 <arg>--verbose</arg>
303 <arg choice="req" rep="repeat"><replaceable>PID</replaceable></arg>
304 </cmdsynopsis>
305
306 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closesession">
307 <command>VBoxManage guestcontrol</command>
308 <group choice="req">
309 <arg choice="plain"><replaceable>uuid</replaceable></arg>
310 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
311 </group>
312 <arg choice="plain">closesession</arg>
313 <group>
314 <arg choice="plain">--all</arg>
315 <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
316 <arg choice="plain">--session-name=<replaceable>имя-или-шаблон</replaceable></arg>
317 </group>
318 <arg>--quiet</arg>
319 <arg>--verbose</arg>
320 </cmdsynopsis>
321
322 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-updatega">
323 <command>VBoxManage guestcontrol</command>
324 <group choice="req">
325 <arg choice="plain"><replaceable>uuid</replaceable></arg>
326 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
327 </group>
328 <arg choice="plain">updatega</arg>
329 <arg>--quiet</arg>
330 <arg>--verbose</arg>
331 <arg>--source=<replaceable>дополнения_гостевой_ос.ISO</replaceable></arg>
332 <arg>--wait-start</arg>
333 <arg>-- <arg rep="repeat"><replaceable>аргумент</replaceable></arg></arg>
334 </cmdsynopsis>
335
336 <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-watch">
337 <command>VBoxManage guestcontrol</command>
338 <group choice="req">
339 <arg choice="plain"><replaceable>uuid</replaceable></arg>
340 <arg choice="plain"><replaceable>имя-ВМ</replaceable></arg>
341 </group>
342 <arg choice="plain">watch</arg>
343 <arg>--quiet</arg>
344 <arg>--verbose</arg>
345 </cmdsynopsis>
346 </refsynopsisdiv>
347
348 <refsect1>
349 <title>Описание</title>
350 <para>
351 Команда <command>VBoxManage guestcontrol</command> позволяет
352 управлять гостевой виртуальной машиной (ВМ) из хост-системы.
353 Смотрите <xref linkend="guestadd-guestcontrol" />.
354 </para>
355 <refsect2>
356 <title>Общие опции и операнды</title>
357 <para>
358 Следующие опции могут быть использованы с любой подкомандой
359 <command>VBoxManage guestcontrol</command>:
360 </para>
361 <variablelist>
362 <varlistentry>
363 <term><replaceable>uuid</replaceable>|<replaceable>имя-ВМ</replaceable></term>
364 <listitem><para>
365 Задает Универсальный Уникальный Идентификатор (UUID) или
366 имя ВМ.
367 </para></listitem>
368 </varlistentry>
369 <varlistentry>
370 <term><option>--quiet</option></term>
371 <listitem><para>
372 Указывает, что команда производит более тихий вывод.
373 </para><para>
374 Краткая форма этой опции <option>-q</option>.
375 </para></listitem>
376 </varlistentry>
377 <varlistentry>
378 <term><option>--verbose</option></term>
379 <listitem><para>
380 Указывает, что команда производит более подробный вывод.
381 </para><para>
382 Краткая форма этой опции <option>-v</option>.
383 </para></listitem>
384 </varlistentry>
385 </variablelist>
386 <para>
387 Некоторые подкоманды <command>VBoxManage guestcontrol</command>
388 требуют, чтобы предоставили гостевые учетные данные для
389 идентификации. Эти подкоманды:
390 <command>copyfrom</command>, <command>copyto</command>,
391 <command>mkdir</command>, <command>mktemp</command>,
392 <command>mv</command>, <command>rmdir</command>,
393 <command>rm</command>, <command>run</command>,
394 <command>start</command> и <command>stat</command>.
395 </para>
396 <para>
397 Хотя вы не можете выполнять анонимные операции, пароль учетной
398 записи пользователя не является обязательным и зависит от
399 политики безопасности гостевой ОС. Если у пользователя
400 пароль не установлен, укажите пустой пароль. В ОС, таких как
401 Windows, возможно необходимо подстроить политику безопасности,
402 чтобы разрешить пользовательские учетные записи с пустым паролем.
403 В дополнение, могут применяться глобальные правила домена, и
404 поэтому они не могут быть изменены.
405 </para>
406 <para>
407 Следующие опции используются для аутентификации в гостевой ВМ:
408 </para>
409 <variablelist>
410 <varlistentry>
411 <term><option>--domain=<replaceable>имя-домена</replaceable></option></term>
412 <listitem><para>
413 Задает имя домена для гостевых Windows ВМ.
414 </para></listitem>
415 </varlistentry>
416 <varlistentry>
417 <term><option>--password=<replaceable>пароль</replaceable></option></term>
418 <listitem><para>
419 Задает пароль указанного пользователя. Если пароль не
420 указан в командной строке или файл с паролем пуст,
421 считается что у пользователя пустой пароль.
422 </para></listitem>
423 </varlistentry>
424 <varlistentry>
425 <term><option>--passwordfile=<replaceable>имя-файла</replaceable></option></term>
426 <listitem><para>
427 Задает абсолютный путь к файлу в гостевой ОС, содержащему
428 пароль для указанного пользователя. Если файл с паролем
429 пуст или не указан пароль в командной строке, считается
430 что у пользователя пустой пароль.
431 </para></listitem>
432 </varlistentry>
433 <varlistentry>
434 <term><option>--username=<replaceable>имя-пользователя</replaceable></option></term>
435 <listitem><para>
436 Задает существующего пользователя в гостевой ОС, от имени
437 которого запускается процесс. Если не указан, процесс
438 запускается от имени пользователя хоста.
439 </para></listitem>
440 </varlistentry>
441 </variablelist>
442 </refsect2>
443 <refsect2>
444 <title>Ограничения на гостевой процесс</title>
445 <para>
446 По умолчанию, можно запустить до пяти гостевых процессов
447 одновременно. Если запускается новый гостевой процесс, который
448 превысил этот лимит, старый не выполняющийся процесс удаляется
449 для запуска нового. Вы не сможете получить вывод из удаленного
450 гостевого процесса. Если все пять гостевых процессов активны и
451 выполняются, попытка запустить новый гостевой процесс будет
452 неудачна.
453 </para>
454 <para>
455 Можно модифицировать ограничения на выполнение гостевого процесса
456 двумя способами:
457 </para>
458 <itemizedlist>
459 <listitem><para>
460 Используя команду <command>VBoxManage setproperty</command>
461 для обновления значения гостевого свойства
462 <literal>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</literal>.
463 </para></listitem>
464 <listitem><para>
465 Используя команду <command>VBoxService</command> и указывая
466 опцию <option>--control-procs-max-kept=<replaceable>value</replaceable></option>.
467 </para></listitem>
468 </itemizedlist>
469 <para>
470 Необходимо перезагрузить гостевую ОС после изменения ограничения.
471 </para>
472 <para>
473 Можно обслуживать неограниченное количество гостевых процессов
474 путем указания значения <literal>0</literal>, однако, это не
475 рекомендуется.
476 </para>
477 </refsect2>
478 <refsect2 id="vboxmanage-guestcontrol-run">
479 <title>Запуск команды в гостевой виртуальной машине</title>
480 <remark role="help-copy-synopsis"/>
481 <para>
482 Команда <command>VBoxManage guestcontrol
483 <replaceable>имя-ВМ</replaceable> run</command> позволяет
484 исполнять программу в гостевой ВМ. Стандартные потоки ввода,
485 вывода и ошибок перенаправляются из ВМ в хост-систему до
486 завершения программы.
487 </para>
488 <note>
489 <para>
490 ОС Windows навязывает определенные ограничения на графические
491 приложения. Смотрите <xref linkend="KnownIssues" />.
492 </para>
493 </note>
494 <variablelist>
495 <varlistentry>
496 <term><option>--exe=<replaceable>путь-до-исполняемого-файла</replaceable></option></term>
497 <listitem><para>
498 Указывает абсолютный путь к исполняемому файлу для запуска
499 в гостевой ВМ. Например <filename>C:\Windows\System32\calc.exe</filename>.
500 </para></listitem>
501 </varlistentry>
502 <varlistentry>
503 <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
504 <listitem><para>
505 Указывает максимальное время в миллисекундах,
506 выделенное для работы программы. Во время работы
507 программы <command>VBoxManage</command> получает ее
508 вывод.
509 </para><para>
510 Если не указывается величина ожидания, <command>VBoxManage</command>
511 ждет до бесконечности окончания программы или возникновения ошибки.
512 </para></listitem>
513 </varlistentry>
514 <varlistentry>
515 <term><option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</option></term>
516 <listitem><para>
517 Устанавливает, изменяет или удаляет переменные окружения
518 в окружении гостевой ВМ.
519 </para><para>
520 Когда создается гостевой процесс, он работает в
521 стандартной среде гостевой ОС задаваемой по умолчанию.
522 Используйте эту опцию, чтобы изменить переменные окружения
523 в среде по умолчанию.
524 </para><para>
525 Используйте опцию
526 <option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значение</replaceable>]</option>
527 для установки или изменения переменной окружения указываемой через <replaceable>имя</replaceable>.
528 </para><para>
529 Используйте опцию
530 <option>--putenv=<replaceable>имя</replaceable>=[<replaceable>значения</replaceable>]</option>
531 для удаления переменной окружения указанной через <replaceable>имя</replaceable>.
532 </para><para>
533 Убедитесь, что переменная или значение, содержащие
534 пробелы должны быть заключены в кавычки.
535 </para><para>
536 Необходимо указать опцию <option>--putenv</option>
537 для каждой модифицируемой переменной окружения.
538 </para><para>
539 Краткая форма этой опции <option>-E</option>.
540 </para></listitem>
541 </varlistentry>
542 <varlistentry>
543 <term><option>--unquoted-args</option></term>
544 <listitem><para>
545 Отключает экранированные двойные кавычки аргументов,
546 передаваемые программе. Например <literal>\"fred\"</literal>.
547 </para></listitem>
548 </varlistentry>
549 <varlistentry>
550 <term><option>--ignore-orphaned-processes</option></term>
551 <listitem><para>
552 Игнорирует процессы-сироты. Еще не реализовано.
553 </para></listitem>
554 </varlistentry>
555 <varlistentry>
556 <term><option>--profile</option></term>
557 <listitem><para>
558 Использует профиль оболочки, чтобы указать используемое
559 окружение. Еще не реализовано.
560 </para></listitem>
561 </varlistentry>
562 <varlistentry>
563 <term><option>--no-wait-stdout</option></term>
564 <listitem><para>
565 Не ждет завершения гостевого процесса или получения его
566 кода завершения и каких-либо объяснений сбоя.
567 </para></listitem>
568 </varlistentry>
569 <varlistentry>
570 <term><option>--wait-stdout</option></term>
571 <listitem><para>
572 Ждет завершения процесса, чтобы получить его код
573 завершения и любые объяснения сбоя. Команда
574 <command>VBoxManage</command> принимает данные со
575 стандартного потока вывода гостевого процесса во
576 время выполнения процесса.
577 </para></listitem>
578 </varlistentry>
579 <varlistentry>
580 <term><option>--no-wait-stderr</option></term>
581 <listitem><para>
582 Не ждет завершения гостевого процесса, чтобы
583 получить его код завершения, сообщения об
584 ошибках и флаги.
585 </para></listitem>
586 </varlistentry>
587 <varlistentry>
588 <term><option>--wait-stderr</option></term>
589 <listitem><para>
590 Ждет завершения гостевого процесса для получения
591 его кода завершения, сообщений об ошибках и флаги.
592 Команда <command>VBoxManage</command> принимает данные
593 со стандартного потока ошибок гостевого процесса во
594 время выполнения процесса.
595 </para></listitem>
596 </varlistentry>
597 <varlistentry>
598 <term><option>--dos2unix</option></term>
599 <listitem><para>
600 Преобразует гостевой DOS или Windows вывод в UNIX или
601 Linux вывод. Это преобразование изменяет завершения строк
602 с CR + LF на LF. Еще не реализовано.
603 </para></listitem>
604 </varlistentry>
605 <varlistentry>
606 <term><option>--unix2dos</option></term>
607 <listitem><para>
608 Преобразует гостевой UNIX или Linux вывод в DOS или
609 Windows вывод. Это преобразование изменяет завершения строк
610 с LF на CR + LF.
611 </para></listitem>
612 </varlistentry>
613 <varlistentry>
614 <term><option>-- <replaceable>программа/аргумент0</replaceable> [<replaceable>аргумент</replaceable>...]</option></term>
615 <listitem><para>
616 Задает имя программы и любые аргументы, передаваемые
617 программе.
618 </para><para>
619 Убедитесь, что все аргументы команды, содержащие пробелы,
620 заключены в кавычки.
621 </para></listitem>
622 </varlistentry>
623 </variablelist>
624 </refsect2>
625 <refsect2 id="vboxmanage-guestcontrol-start">
626 <title>Запуск команды в гостевой виртуальной машине</title>
627 <remark role="help-copy-synopsis"/>
628 <para>
629 Команда <command>VBoxManage guestcontrol
630 <replaceable>имя-ВМ</replaceable> start</command> позволяет
631 выполнить гостевую программу до ее завершения.
632 </para>
633 <note>
634 <para>
635 ОС Windows навязывает определенные ограничения на графические
636 приложения. Смотрите <xref linkend="KnownIssues" />.
637 </para>
638 </note>
639 </refsect2>
640 <refsect2 id="vboxmanage-guestcontrol-copyfrom">
641 <title>Копирование файла из гостевой виртуальной машины в директорию в хост-системы</title>
642 <remark role="help-copy-synopsis"/>
643 <para>
644 Команда <command>VBoxManage guestcontrol
645 <replaceable>имя-ВМ</replaceable> copyfrom</command> позволяет
646 скопировать файл из гостевой ВМ в хост-систему.
647 </para>
648 <variablelist>
649 <varlistentry>
650 <term><option>--dereference</option></term>
651 <listitem><para>
652 Включает следование по символическим ссылкам в гостевой
653 файловой системе.
654 </para></listitem>
655 </varlistentry>
656 <varlistentry>
657 <term><option>--no-replace</option></term>
658 <listitem><para>
659 Only copies a file if it does not exist on the host yet.
660 </para><para>
661 The short form of this option is <option>-n</option>.
662 </para></listitem>
663 </varlistentry>
664 <varlistentry>
665 <term><option>--recursive</option></term>
666 <listitem><para>
667 Рекурсивно копирует файлы и директории из указанной
668 директории в гостевой ВМ.
669 </para><para>
670 Краткая форма этой опции <option>-R</option>.
671 </para></listitem>
672 </varlistentry>
673 <varlistentry>
674 <term><option>--target-directory=<replaceable>хост-директория-назначения</replaceable></option></term>
675 <listitem><para>
676 Задает абсолютный путь к директории назначения в
677 хост-системе. Например <filename>C:\Temp</filename>.
678 </para></listitem>
679 </varlistentry>
680 <varlistentry>
681 <term><option>--update</option></term>
682 <listitem><para>
683 Only copies a file if the guest file is newer than on the host.
684 </para><para>
685 The short form of this option is <option>-u</option>.
686 </para></listitem>
687 </varlistentry>
688 <varlistentry>
689 <term><literal><replaceable>гостевой-источник0</replaceable> [<replaceable>гостевой-источник1</replaceable> [...]]</literal></term>
690 <listitem><para>
691 Задает абсолютный путь одного или нескольких файлов
692 для копирования из гостевой ВМ. Например
693 <filename>C:\Windows\System32\calc.exe</filename>. Можно
694 использовать подстановочные знаки. Например
695 <filename>C:\Windows\System*\*.dll</filename>.
696 </para></listitem>
697 </varlistentry>
698 </variablelist>
699 </refsect2>
700 <refsect2 id="vboxmanage-guestcontrol-copyto">
701 <title>Копирует файл в директорию на гостевой виртуальной машине из хост-системы</title>
702 <remark role="help-copy-synopsis"/>
703 <para>
704 Команда <command>VBoxManage guestcontrol
705 <replaceable>имя-ВМ</replaceable> copyto</command> позволяет
706 скопировать файл из хост-системы в гостевую ВМ.
707 </para>
708 <variablelist>
709 <varlistentry>
710 <term><option>--dereference</option></term>
711 <listitem><para>
712 Включает следование по символическим ссылкам в хост-системе.
713 </para></listitem>
714 </varlistentry>
715 <varlistentry>
716 <term><option>--no-replace</option></term>
717 <listitem><para>
718 Only copies a file if it does not exist on the guest yet.
719 </para><para>
720 The short form of this option is <option>-n</option>.
721 </para></listitem>
722 </varlistentry>
723 <varlistentry>
724 <term><option>--recursive</option></term>
725 <listitem><para>
726 Рекурсивно копирует файлы и директории из указанной
727 директории в хост-системе.
728 </para><para>
729 Краткая форма этой опции <option>-R</option>.
730 </para></listitem>
731 </varlistentry>
732 <varlistentry>
733 <term><option>--target-directory=<replaceable>гостевая-директория-назначения</replaceable></option></term>
734 <listitem><para>
735 Задает абсолютный путь директории назначения в гостевой
736 ВМ. Например <filename>C:\Temp</filename>.
737 </para></listitem>
738 </varlistentry>
739 <varlistentry>
740 <term><option>--update</option></term>
741 <listitem><para>
742 Only copies a file if the host file is newer than on the guest.
743 </para><para>
744 The short form of this option is <option>-u</option>.
745 </para></listitem>
746 </varlistentry>
747 <varlistentry>
748 <term><literal><replaceable>хост-источник0</replaceable> [<replaceable>хост-источник1</replaceable> [...]]</literal></term>
749 <listitem><para>
750 Задает абсолютный путь одного или нескольких файлов для
751 копирования из хост-системы. Например
752 <filename>C:\Windows\System32\calc.exe</filename>. Можно
753 использовать подстановочные знаки для указания нескольких
754 файлов. Например <filename>C:\Windows\System*\*.dll</filename>.
755 </para></listitem>
756 </varlistentry>
757 </variablelist>
758 </refsect2>
759 <refsect2 id="vboxmanage-guestcontrol-mkdir">
760 <title>Создает директорию в гостевой виртуальной машине</title>
761 <remark role="help-copy-synopsis"/>
762 <para>
763 Команда <command>VBoxManage guestcontrol
764 <replaceable>имя-ВМ</replaceable> mkdir</command> позволяет
765 создать один или несколько директорий в гостевой ВМ.
766 </para>
767 <para>
768 Альтернативные формы этой подкоманды: <command>md</command>,
769 <command>createdir</command> и <command>createdirectory</command>.
770 </para>
771 <variablelist>
772 <varlistentry>
773 <term><option>--parents</option></term>
774 <listitem><para>
775 Создает все отсутствующие родительские директории по
776 отношению к указанной.
777 </para><para>
778 Например, если попытаться создать директорию
779 <filename>D:\Foo\Bar</filename> и директория
780 <filename>D:\Foo</filename> не существует, использование
781 <option>--parents</option> создаст отсутствующую
782 директорию <filename>D:\Foo</filename>. Однако, если
783 попытаться создать <filename>D:\Foo\Bar</filename> и
784 не указать опцию <option>--parents</option>, команда
785 завершится неудачей.
786 </para></listitem>
787 </varlistentry>
788 <varlistentry>
789 <term><option>--mode=<replaceable>режим</replaceable></option></term>
790 <listitem><para>
791 Задает режим разрешений для указанной директории.
792 Если также используется опция <option>--parents</option>,
793 этот режим задается также для всех ее родительских
794 директорий. <replaceable>режим</replaceable> - это
795 четыре восьмеричные цифры, например <literal>0755</literal>.
796 </para></listitem>
797 </varlistentry>
798 <varlistentry>
799 <term><literal><replaceable>гостевая-директория</replaceable> [<replaceable>гостевая-директория</replaceable>...]</literal></term>
800 <listitem><para>
801 Задает абсолютный путь к одной или нескольким директориям
802 для создания в гостевой ВМ. Например <filename>D:\Foo\Bar</filename>.
803 </para><para>
804 Если все относящиеся к указанной родительские директории
805 не существуют в гостевой ВМ, необходимо использовать
806 опцию <option>--parents</option>.
807 </para><para>
808 У вас должно быть достаточно прав в гостевой ВМ, чтобы
809 создать указанную и ее родительские директории.
810 </para></listitem>
811 </varlistentry>
812 </variablelist>
813 </refsect2>
814 <refsect2 id="vboxmanage-guestcontrol-rmdir">
815 <title>Удалить директорию из гостевой виртуальной машины</title>
816 <remark role="help-copy-synopsis"/>
817 <para>
818 Команда <command>VBoxManage guestcontrol
819 <replaceable>имя-ВМ</replaceable> rmdir</command> позволяет
820 удалить указанную директорию из гостевой ВМ.
821 </para>
822 <para>
823 Альтернативные формы этой подкоманды <command>removedir</command>
824 и <command>removedirectory</command>.
825 </para>
826 <variablelist>
827 <varlistentry>
828 <term><option>--recursive</option></term>
829 <listitem><para>
830 Рекурсивно удаляет директории из указанной в гостевой ВМ.
831 </para><para>
832 Краткая форма этой опции <option>-R</option>.
833 </para></listitem>
834 </varlistentry>
835 <varlistentry>
836 <term><literal><replaceable>гостевая-директория</replaceable> [<replaceable>гостевая-директория</replaceable>...]</literal></term>
837 <listitem><para>
838 Задает абсолютный путь к одной или нескольким директориям
839 для удаления в гостевой ВМ. Можно использовать
840 подстановочные знаки в именах директорий. Например
841 <filename>D:\Foo\*Bar</filename>.
842 </para><para>
843 У вас должно быть достаточно прав в гостевой ВМ, чтобы
844 удалить указанную и ее родительские директории.
845 </para></listitem>
846 </varlistentry>
847 </variablelist>
848 </refsect2>
849 <refsect2 id="vboxmanage-guestcontrol-rm">
850 <title>Удалить файл из гостевой виртуальной машины</title>
851 <remark role="help-copy-synopsis"/>
852 <para>
853 Команда <command>VBoxManage guestcontrol
854 <replaceable>имя-ВМ</replaceable> rm</command> позволяет
855 удалить указанный файл из гостевой ВМ.
856 </para>
857 <para>
858 Альтернативная форма этой подкоманды <command>removefile</command>.
859 </para>
860 <variablelist>
861 <varlistentry>
862 <term><option>--force</option></term>
863 <listitem><para>
864 Принудительно выполняет операцию и отменяет любые
865 запросы подтверждения.
866 </para><para>
867 Краткая форма этой опции <option>-f</option>.
868 </para></listitem>
869 </varlistentry>
870 <varlistentry>
871 <term><literal><replaceable>гостевой-файл</replaceable> [<replaceable>гостевой-файл</replaceable>...]</literal></term>
872 <listitem><para>
873 Задает абсолютный путь одного или нескольких файлов для
874 удаления из гостевой ВМ. Можно использовать
875 подстановочные знаки в именах файлов. Например
876 <filename>D:\Foo\Bar\text*.txt</filename>.
877 </para><para>
878 У вас должно быть достаточно прав в гостевой ВМ, чтобы
879 удалить указанный файл.
880 </para></listitem>
881 </varlistentry>
882 </variablelist>
883 </refsect2>
884 <refsect2 id="vboxmanage-guestcontrol-mv">
885 <title>Переименовать файл или директорию в гостевой виртуальной машине</title>
886 <remark role="help-copy-synopsis"/>
887 <para>
888 Команда <command>VBoxManage guestcontrol
889 <replaceable>имя-ВМ</replaceable> mv</command> позволяет
890 переименовать файлы и директории в гостевой ВМ.
891 </para>
892 <para>
893 Альтернативная форма этой подкоманды <command>move</command>,
894 <command>ren</command> и <command>rename</command>.
895 </para>
896 <variablelist>
897 <varlistentry>
898 <term><literal><replaceable>гостевой-источник</replaceable> [<replaceable>гостевой-источник</replaceable>...]</literal></term>
899 <listitem><para>
900 Задает абсолютный путь к файлу или единичной директории
901 для перемещения или переименования в гостевой ВМ. Можно
902 использовать подстановочные знаки в именах файлов.
903 </para><para>
904 У вас должно быть достаточно прав в гостевой ВМ для
905 доступа к указанному файлу или директории.
906 </para></listitem>
907 </varlistentry>
908 <varlistentry>
909 <term><replaceable>назначение</replaceable></term>
910 <listitem><para>
911 Задает абсолютный путь к переименовываемым файлу или
912 директории, или директории назначения, куда
913 перемещать файлы. Если перемещается только один
914 файл, <replaceable>назначение</replaceable> может
915 быть как файлом так и директорией, иначе
916 <replaceable>назначение</replaceable> должно быть
917 директорией.
918 </para><para>
919 У вас должно быть достаточно прав в гостевой ВМ для
920 доступа к файлу или директории назначения.
921 </para></listitem>
922 </varlistentry>
923 </variablelist>
924 </refsect2>
925 <refsect2 id="vboxmanage-guestcontrol-mktemp">
926 <title>Создать временный файл или директорию в гостевой виртуальной машине</title>
927 <remark role="help-copy-synopsis"/>
928 <para>
929 Команда <command>VBoxManage guestcontrol
930 <replaceable>имя-ВМ</replaceable> mktemp</command> позволяет
931 создать временный файл или директорию в гостевой ВМ. Можно
932 использовать эту команду для помощи с последующим копированием
933 файлов из хост-системы в гостевую ВМ. По умолчанию, эта команда
934 создает файл или директорию в платформо-зависимой директории
935 <filename>temp</filename> гостевой ВМ.
936 </para>
937 <para>
938 Альтернативные формы этой подкоманды <command>createtemp</command>
939 и <command>createtemporary</command>.
940 </para>
941 <variablelist>
942 <varlistentry>
943 <term><option>--directory</option></term>
944 <listitem><para>
945 Создает временную директорию указанную в операнде
946 <replaceable>шаблон</replaceable>.
947 </para></listitem>
948 </varlistentry>
949 <varlistentry>
950 <term><option>--secure</option></term>
951 <listitem><para>
952 Обеспечивает безопасное создание файлов и каталогов,
953 устанавливая режим разрешений <literal>0755</literal>.
954 Любая операция, которая не может быть произведена
955 безопасно приведет к неудаче.
956 </para></listitem>
957 </varlistentry>
958 <varlistentry>
959 <term><option>--mode=<replaceable>режим</replaceable></option></term>
960 <listitem><para>
961 Задает режим разрешений, используемый указанной директорией.
962 <replaceable>режим</replaceable> - это четыре восьмеричные
963 цифры, например <literal>0755</literal>.
964 </para></listitem>
965 </varlistentry>
966 <varlistentry>
967 <term><option>--tmpdir=<replaceable>директория</replaceable></option></term>
968 <listitem><para>
969 Задает абсолютный путь к директории в гостевой ВМ, где
970 создавать указанный файл или директорию. Если не указан,
971 <replaceable>директория</replaceable> - это
972 платформо-зависимая директория <filename>temp</filename>.
973 </para></listitem>
974 </varlistentry>
975 <varlistentry>
976 <term><replaceable>шаблон</replaceable></term>
977 <listitem><para>
978 Задает шаблон имени для временного файла без пути к
979 директории. Шаблон имени файла должен содержать как
980 минимум одну последовательности трех последовательных
981 символов X или должен заканчиваться ими.
982 </para></listitem>
983 </varlistentry>
984 </variablelist>
985 </refsect2>
986 <refsect2 id="vboxmanage-guestcontrol-stat">
987 <title>Показать статус файла или файловой системы в гостевой виртуальной машине.</title>
988 <remark role="help-copy-synopsis"/>
989 <para>
990 Команда <command>VBoxManage guestcontrol
991 <replaceable>имя-ВМ</replaceable> stat</command> позволяет
992 отобразить статус файлов или или файловых систем в гостевой
993 ВМ.
994 </para>
995 <variablelist>
996 <varlistentry>
997 <term><literal><replaceable>файл</replaceable> [<replaceable>файл</replaceable> ...]</literal></term>
998 <listitem><para>
999 Задает абсолютный путь к файлу или файловой системе в
1000 гостевой ВМ. Например <filename>/home/foo/a.out</filename>.
1001 </para><para>
1002 У вас должно быть достаточно прав в гостевой ВМ для
1003 доступа к указанным файлам или файловым системам.
1004 </para></listitem>
1005 </varlistentry>
1006 </variablelist>
1007 </refsect2>
1008 <refsect2 id="vboxmanage-guestcontrol-list">
1009 <title>Показать настройки и информацию о статусе гостевой виртуальной машины</title>
1010 <remark role="help-copy-synopsis"/>
1011 <para>
1012 Команда <command>VBoxManage guestcontrol
1013 <replaceable>имя-ВМ</replaceable> list</command> позволяет
1014 показать настройки гостевого управления и информацию о статусе.
1015 Например, вывол показывает открытые гостевые сессии, гостевые
1016 процессы и файлы.
1017 </para>
1018 <variablelist>
1019 <varlistentry>
1020 <term><literal>all</literal>|<literal>sessions</literal>|<literal>processes</literal>|<literal>files</literal></term>
1021 <listitem><para>
1022 Указывает тип отображаемой информации.
1023 <literal>all</literal> показывает все доступные данные,
1024 <literal>sessions</literal> показывает гостевые сессии,
1025 <literal>processes</literal> показывает процессы и
1026 <literal>files</literal> показывает файлы.
1027 </para></listitem>
1028 </varlistentry>
1029 </variablelist>
1030 </refsect2>
1031 <refsect2 id="vboxmanage-guestcontrol-closeprocess">
1032 <title>Завершить процесс в сессии гостевой виртуальной машины</title>
1033 <remark role="help-copy-synopsis"/>
1034 <para>
1035 Команда <command>VBoxManage guestcontrol
1036 <replaceable>имя-ВМ</replaceable> closeprocess</command> позволяет
1037 завершить гостевой процесс работающий в гостевой сессии.
1038 Указывайте процесс через идентификатор процесса (PID) и сессию,
1039 используя ID сессии или имя.
1040 </para>
1041 <variablelist>
1042 <varlistentry>
1043 <term><option>--session-id=<replaceable>ID</replaceable></option></term>
1044 <listitem><para>
1045 Задает ID гостевой сессии.
1046 </para></listitem>
1047 </varlistentry>
1048 <varlistentry>
1049 <term><option>--session-name=<replaceable>имя</replaceable>|<replaceable>шаблон</replaceable></option></term>
1050 <listitem><para>
1051 Задает имя гостевой сессии. Используйте шаблон,
1052 содержащий подстановочные знаки для указания
1053 нескольких сессий.
1054 </para></listitem>
1055 </varlistentry>
1056 <varlistentry>
1057 <term><literal><replaceable>PID</replaceable> [<replaceable>PID</replaceable> ...]</literal></term>
1058 <listitem><para>
1059 Задает список PID гостевых процессов для завершения.
1060 </para></listitem>
1061 </varlistentry>
1062 </variablelist>
1063 </refsect2>
1064 <refsect2 id="vboxmanage-guestcontrol-closesession">
1065 <title>Закрыть сессию гостевой виртуальной машины</title>
1066 <remark role="help-copy-synopsis"/>
1067 <para>
1068 Команда <command>VBoxManage guestcontrol
1069 <replaceable>имя-ВМ</replaceable> closesession</command> позволяет
1070 закрыть гостевую сессию. Указывайте гостевую сессию или через ID
1071 сессии или через имя.
1072 </para>
1073 <variablelist>
1074 <varlistentry>
1075 <term><option>--session-id=<replaceable>ID</replaceable></option></term>
1076 <listitem><para>
1077 Задает ID гостевой сессии.
1078 </para></listitem>
1079 </varlistentry>
1080 <varlistentry>
1081 <term><option>--session-name=<replaceable>имя</replaceable>|<replaceable>шаблон</replaceable></option></term>
1082 <listitem><para>
1083 Задает имя гостевой сессии. Используйте шаблон,
1084 содержащий подстановочные знаки для указания
1085 нескольких сессий.
1086 </para></listitem>
1087 </varlistentry>
1088 <varlistentry>
1089 <term><option>--all</option></term>
1090 <listitem><para>
1091 Закрывает все гостевые сессии.
1092 </para></listitem>
1093 </varlistentry>
1094 </variablelist>
1095 </refsect2>
1096 <refsect2 id="vboxmanage-guestcontrol-updatega">
1097 <title>Обновить ПО Дополнений Гостевой ОС в гостевой виртуальной машине</title>
1098 <remark role="help-copy-synopsis"/>
1099 <para>
1100 Команда <command>VBoxManage guestcontrol
1101 <replaceable>имя-ВМ</replaceable> updatega</command> позволяет
1102 обновить ПО Дополнений Гостевой ОС, установленное в указанной
1103 гостевой ВМ.
1104 </para>
1105 <para>
1106 Альтернативные формы этой подкоманды
1107 <command>updateadditions</command> и
1108 <command>updateguestadditions</command>.
1109 </para>
1110 <variablelist>
1111 <varlistentry>
1112 <term><option>--source=<replaceable>новый-путь-к-iso</replaceable></option></term>
1113 <listitem><para>
1114 Задает абсолютный путь к <filename>.ISO</filename> файлу
1115 Дополнений Гостевой ОС в гостевой ВМ.
1116 </para></listitem>
1117 </varlistentry>
1118 <varlistentry>
1119 <term><option>--reboot</option></term>
1120 <listitem><para>
1121 Автоматический перезагружает гостевую систему после успешного
1122 обновления Дополнений Гостевой ОС.
1123 </para></listitem>
1124 </varlistentry>
1125 <varlistentry>
1126 <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
1127 <listitem><para>
1128 Задает максимальное время ожидания (в миллисекундах) заверешения
1129 полного обновления Дополнений Гостевой ОС. По умолчанию, максимальное
1130 время ожидания не используется.
1131 </para></listitem>
1132 </varlistentry>
1133 <varlistentry>
1134 <term><option>--verify</option></term>
1135 <listitem><para>
1136 Проверяет, что Дополнения Гостевой ОС обновлены успешно после
1137 успешной установки. Перезагрузка гостя обязательна.
1138 </para></listitem>
1139 </varlistentry>
1140 <varlistentry>
1141 <term><option>--wait-ready</option></term>
1142 <listitem><para>
1143 Ждет когда текущие Дополения Гостевой ОС готовы для
1144 обновления Дополений Гостевой ОС.
1145 </para>
1146 </listitem>
1147 </varlistentry>
1148 <varlistentry>
1149 <term><option>--wait-start</option></term>
1150 <listitem><para>
1151 Запускает <command>VBoxManage</command> процесс обновления
1152 в гостевой ВМ и ждет начала обновления Дополений Гостевой ОС
1153 перед завершения процесса <command>VBoxManage</command>.
1154 </para><para>
1155 По умолчанию, команда <command>VBoxManage</command> ждет
1156 завершения обновления Дополений Гостевой ОС перед
1157 завершением. Используйте эту опцию когда работающий
1158 процесс <command>VBoxManage</command> влияет на
1159 взаимодействие между установщиком и гостевой ОС.
1160 </para></listitem>
1161 </varlistentry>
1162 <varlistentry>
1163 <term><option>-- <replaceable>аргумент</replaceable> [<replaceable>аргумент</replaceable> ...]</option></term>
1164 <listitem><para>
1165 Задает необязательные аргументы командной строки, которые
1166 передаются программе обновления Дополнений Гостевой ОС.
1167 Можно использовать опцию <option>--</option> для передачи
1168 соответствующих аргументов программе обновления для
1169 модернизации еще не установленных функций.
1170 </para><para>
1171 Убедитесь, что командные аргументы, содержащие пробелы,
1172 заключены в кавычки.
1173 </para></listitem>
1174 </varlistentry>
1175 </variablelist>
1176 </refsect2>
1177 <refsect2 id="vboxmanage-guestcontrol-waitrunlevel">
1178 <title>Ждать гостевой уровень выполнения</title>
1179 <para>
1180 Команда <command>VBoxManage guestcontrol
1181 <replaceable>имя-ВМ</replaceable> waitrunlevel</command> позволяет
1182 ожидать достижения гостевого уровня выполнения.
1183 </para>
1184 <variablelist>
1185 <varlistentry>
1186 <term><option>--timeout=<replaceable>миллисекунды</replaceable></option></term>
1187 <listitem><para>
1188 Задать максимальное время ожидания (в миллисекундах)
1189 достижения уровня выполнения. По умолчанию максимальное
1190 время ожидания не используется.
1191 </para></listitem>
1192 </varlistentry>
1193 <varlistentry>
1194 <term><option><replaceable>system</replaceable>|<replaceable>userland</replaceable>|<replaceable>desktop</replaceable></option></term>
1195 <listitem><para>
1196 Задает ожидаемый уровень выполнения
1197 </para></listitem>
1198 </varlistentry>
1199 </variablelist>
1200 </refsect2>
1201 <refsect2 id="vboxmanage-guestcontrol-watch">
1202 <title>Показать текущую активность гостевого управления.</title>
1203 <remark role="help-copy-synopsis"/>
1204 <para>
1205 Команда <command>VBoxManage guestcontrol
1206 <replaceable>имя-ВМ</replaceable> watch</command> позволяет
1207 показать текущую активность гостевого управления.
1208 </para>
1209 </refsect2>
1210 </refsect1>
1211
1212 <refsect1>
1213 <title>Примеры</title>
1214 <remark role="help-scope" condition="GLOBAL"/>
1215 <para>
1216 Следующая команда <command>VBoxManage guestcontrol run</command>
1217 выполняет команду <command>ls -l /usr</command> в Oracle Linux ВМ
1218 <literal>My OL VM</literal> от имени пользователя
1219 <literal>user1</literal>.
1220 </para>
1221<screen>
1222$ VBoxManage --nologo guestcontrol "My OL VM" run --exe "/bin/ls" \
1223--username user1 --passwordfile pw.txt --wait-stdout -- -l /usr
1224</screen>
1225 <para>
1226 Опция <option>--exe</option> указывает абсолютный путь команды
1227 для запуска в гостевой ВМ, <filename>/bin/ls</filename>.
1228 Используйте опцию <option>--</option> для передачи любых
1229 аргументов, следующих после команды <command>ls</command>.
1230 </para>
1231 <para>
1232 Используйте опцию <option>--username</option> для указания
1233 имени пользователя, <literal>user1</literal> и опцию
1234 <option>--passwordfile</option> для указания имения файлы,
1235 содержащего пароль для пользователя <literal>user1</literal>,
1236 <filename>pw.txt</filename>.
1237 </para>
1238 <para>
1239 Опция <option>--wait-stdout</option> ожидает завершения
1240 гостевого процесса <command>ls</command> перед передачей
1241 кода заверешения и вывода команды. Опция <option>--nologo</option>
1242 подавляет вывод информации о логотипе.
1243 </para>
1244 <para>
1245 Следующая команда <command>VBoxManage guestcontrol run</command>
1246 выполняет команду <command>ipconfig</command> в Windows ВМ
1247 <literal>My Win VM</literal> от имени пользователя
1248 <literal>user1</literal>. Стандартные потоки ввода, вывода
1249 и ошибок перенаправляются из ВМ в хост-систему до завершения
1250 программы.
1251 </para>
1252<screen>
1253$ VBoxManage --nologo guestcontrol "My Win VM" run \
1254--exe "c:\\windows\\system32\\ipconfig.exe" \
1255--username user1 --passwordfile pw.txt --wait-stdout
1256</screen>
1257 <para>
1258 Опция <option>--exe</option> задает абсолютный путь команды для
1259 запуска в гостевой ВМ,
1260 <filename>c:\windows\system32\ipconfig.exe</filename>. Двойные
1261 слеши показанные в этом примере требуются только в UNIX
1262 хост-системах.
1263 </para>
1264 <para>
1265 Используйте опцию <option>--username</option> для указания имени
1266 пользователя, <literal>user1</literal> и опцию
1267 <option>--passwordfile</option> для указания имени файла,
1268 содержащего пароль для пользователя <literal>user1</literal>,
1269 <filename>pw.txt</filename>.
1270 </para>
1271 <para>
1272 Опция <option>--wait-stdout</option> ожидает завершения
1273 гостевого процесса <command>ls</command> перед передачей
1274 кода заверешения и вывода команды. Опция <option>--nologo</option>
1275 подавляет вывод информации о логотипе.
1276 </para>
1277 <para>
1278 Следующая команда <command>VBoxManage guestcontrol start</command>
1279 выполняет команду <command>ls -l /usr</command> в Oracle Linux ВМ
1280 <literal>My OL VM</literal> до завершения программы.
1281 </para>
1282<screen>
1283$ VBoxManage --nologo guestcontrol "My Win VM" start \
1284--exe "c:\\windows\\system32\\ipconfig.exe" \
1285--username user1 --passwordfile pw.txt --wait-stdout
1286</screen>
1287 </refsect1>
1288</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