<?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>

