# VBoxManage modifyvm

VBoxManage-modifyvm

1

VBoxManage-modifyvm

изменение настроек остановленной виртуальной машины

&product-name;

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --name=имя
          --groups= группа [,группа...]
          --description=описание
          --os-type=тип-ОС
          --icon-file=имя-файла
          --memory=размер-в-МБ
          --page-fusion=
              on
              off

          --vram=размер-в-МБ
          --acpi=
              on
              off

          --ioapic=
              on
              off

          --hardware-uuid=UUID
          --cpus=число-ЦПУ
          --cpu-hotplug=
              on
              off

          --plug-cpu=CPU-ID
          --unplug-cpu=CPU-ID
          --cpu-execution-cap=число
          --x86-pae=
              on
              off

          --x86-long-mode=
              on
              off

          --ibpb-on-vm-exit=
              on
              off

          --ibpb-on-vm-entry=
              on
              off

          --spec-ctrl=
              on
              off

          --l1d-flush-on-sched=
              on
              off

          --l1d-flush-on-vm-entry=
              on
              off

          --mds-clear-on-sched=
              on
              off

          --mds-clear-on-vm-entry=
              on
              off

          --cpu-profile=
              host
              Intel 8086
              Intel 80286
              Intel 80386

          --x86-hpet=
              on
              off

          --hwvirtex=
              on
              off

          --triple-fault-reset=
              on
              off

          --apic=
              on
              off

          --x86-x2apic=
              on
              off

          --paravirt-provider=
              none
              default
              legacy
              minimal
              hyperv
              kvm

          --paravirt-debug= ключ=значение [,ключ=значение...]
          --nested-paging=
              on
              off

          --large-pages=
              on
              off

          --x86-vtx-vpid=
              on
              off

          --x86-vtx-ux=
              on
              off

          --nested-hw-virt=
              on
              off

          --virt-vmsave-vmload=
              on
              off

          --accelerate-3d=
              on
              off

          --chipset=
              ich9
              piix3

        --iommu=
            none
            automatic
            amd
            intel

        --tpm-type=
            none
            1.2
            2.0
            host
            swtpm

          --tpm-location=
              расположение

          --firmware-logo-fade-in=
              on
              off

          --firmware-logo-fade-out=
              on
              off

          --firmware-logo-display-time=миллисекунды
          --firmware-logo-image-path=путь
          --firmware-boot-menu=
              disabled
              menuonly
              messageandmenu

          --firmware-apic=
              disabled
              apic
              x2apic

          --firmware-system-time-offset=миллисекунды
          --firmware-pxe-debug=
              on
              off

          --system-uuid-le=
              on
              off

          --bootX=
              none
              floppy
              dvd
              disk
              net

          --rtc-use-utc=
              on
              off

          --graphicscontroller=
              none
              vboxvga
              vmsvga
              vboxsvga
              qemuramfb

          --snapshot-folder=
              default
              путь

          --firmware=
              bios
              efi
              efi32
              efi64

          --guest-memory-balloon=размер-в-МБ
          --default-frontend=
              default
              имя

          --vm-process-priority=
              default
              flat
              low
              normal
              high

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --nicN=
              none
              null
              nat
              bridged
              intnet
              hostonly
              hostonlynet
              generic
              natnetwork

          --nic-typeN=
              Am79C970A
              Am79C973
              82540EM
              82543GC
              82545EM
              virtio

          --cable-connectedN=
              on
              off

          --nic-traceN=
              on
              off

          --nic-trace-fileN=имя-файла
          --nic-propertyN=имя= значение
          --nic-speedN=кбит-в-сек
          --nic-boot-prioN=приоритет
          --nic-promiscN=
              deny
              allow-vms
              allow-all

          --nic-bandwidth-groupN=
              none
              name

          --bridge-adapterN=
              none
              device-name

          --host-only-adapterN=
              none
              device-name

          --host-only-netN=имя-сети
          --intnetN=имя-сети
          --nat-networkN=имя-сети
          --nic-generic-drvN=имя-драйвера
          --mac-addressN=
              auto
              MAC-адрес

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --nat-netN=
              сеть
              default

          --nat-pfN=
              [имя-правила],tcp
              udp,[IP-хоста],порт-хоста,[IP-гостя],порт-гостя

          --nat-pfN=delete=имя-правила
          --nat-tftp-prefixN=префикс
          --nat-tftp-fileN=имя-файла
          --nat-tftp-serverN=IP-адрес
          --nat-bind-ipN=IP-адрес
          --nat-dns-pass-domainN=
              on
              off

          --nat-dns-proxyN=
              on
              off

          --nat-dns-host-resolverN=
              on
              off

          --nat-localhostreachableN=
              on
              off

          --nat-settingsN=[mtu],[отправка-сокет],[прием-сокет],[отправка-tcp],[прием-tcp]
          --nat-alias-modeN=
              default
              [log],[proxyonly],[sameports]

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --mouse=
              ps2
              usb
              usbtablet
              usbmultitouch

          --keyboard=
              ps2
              usb

          --uartN=
              off
              IO-база IRQ

          --uart-modeN=
              disconnected
              server канал
              client канал
              tcpserver порт
              tcpclient имя-хоста:порт
              file имя-файла
              имя-устройства

          --uart-typeN=
              16450
              16550A
              16750

          --lpt-modeN=имя-устройства
          --lptN=
              off
              IO-база IRQ

          --audio-controller=
              ac97
              hda
              sb16

          --audio-codec=
              stac9700
              ad1980
              stac9221
              sb16

          --audio-driver=
              none
              default
              null
              dsound
              was
              oss
              alsa
              pulse
              coreaudio

          --audio-enabled=
              on
              off

          --audio-in=
              on
              off

          --audio-out=
              on
              off

          --clipboard-mode=
              disabled
              hosttoguest
              guesttohost
              bidirectional

          --drag-and-drop=
              disabled
              hosttoguest
              guesttohost
              bidirectional

          --monitor-count=количество
          --usb-ehci=
              on
              off

          --usb-ohci=
              on
              off

          --usb-xhci=
              on
              off

          --usb-rename=старое-имя новое-имя

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --recording=
              on
              off

          --recording-screens=
              all
              ID-экрана [ID-экрана...]

          --recording-file=имя-файла
          --recording-max-size=МБ
          --recording-max-time=миллисекунды
          --recording-opts= ключ=значение [,ключ=значение...]
          --recording-video-fps=кадров-в-сек
          --recording-video-rate=rate
          --recording-video-res=ширина высота

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --vrde=
              on
              off

          --vrde-property=имя-свойства= значение-свойства
          --vrde-extpack=
              default
              имя

          --vrde-port=порт
          --vrde-address=IP-хоста
          --vrde-auth-type=
              null
              external
              guest

          --vrde-auth-library=
              default
              имя

          --vrde-multi-con=
              on
              off

          --vrde-reuse-con=
              on
              off

          --vrde-video-channel=
              on
              off

          --vrde-video-channel-quality=процент

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --teleporter=
              on
              off

          --teleporter-port=порт
          --teleporter-address=
              адрес
              empty

          --teleporter-password=пароль
          --teleporter-password-file=
              имя-файла
              stdin

          --cpuid-portability-level=уровень
          --cpuid-set=лист:подлист eax ebx ecx edx
          --cpuid-remove=лист:подлист
          --cpuid-remove-all

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --tracing-enabled=
              on
              off

          --tracing-config=строка
          --tracing-allow-vm-access=
              on
              off

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --usb-card-reader=
              on
              off

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --autostart-enabled=
              on
              off

          --autostart-delay=секунды

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --pci-attach=PCI-адрес-хоста@гостевой-PCI-адрес-шины
          --pci-detach=PCI-адрес-хоста

          VBoxManage modifyvm

            uuid
            имя-ВМ

          --testing-enabled=onoff
          --testing-mmio=onoff
          --testing-cfg-dwordidx=значение

## Описание

Команда `VBoxManage modifyvm` позволяет изменить свойства зарегистрированной неработающей на текущий момент виртуальной машины (ВМ).

Большинство этих свойств соответствуют настройкам ВМ отображаемых в диалоге Настройки Менеджера VirtualBox для каждой ВМ. Смотрите ct_working-with-vms. Однако, некоторые настройки могут отображаться или управляться только командой `VBoxManage`.

Можно использовать команду `VBoxManage modifyvm` для изменения настроек только если ВМ выключена. ВМ не может быть в работающем или сохраненном состоянии при использовании этой команды.

Можно использовать команду `VBoxManage controlvm` для изменения некоторых настроек ВМ динамически, пока ВМ работает. Смотрите vboxmanage-controlvm.

### Общие настройки

Следующие опции позволяют вам изменить общую информаицю о вашей ВМ.

Команда `VBoxManage modifyvm` поддерживает следующие опции:

`--name=`имя-ВМ``

- Изменяет имя ВМ и связанных с ней внутренних файлов. Смотрите vboxmanage-createvm.

`--groups=`группа``

- Изменяет членство в группе для ВМ. Имена групп всегда начинаются с символа слэш (`/`) и могут быть вложены. По умолчанию, ВМ - члены группы `/`. ВМ может входить в несколько групп, но ее первичная группа определяет структуру директорий, где внутренние файлы ВМ располагаются по умолчанию.

`--description=`описание``

- Изменяет необязательное описание ВМ. Используйте описание для записи подробностей о ВМ в осмысленном виде. Графический интерфейс понимает HTML разметку, тогда как команда `VBoxManage modifyvm` позволяет включать произвольный текст, который может содержать несколько строк.

`--os-type=`тип-ОС``

- Задает информацию о гостевой операционной системе (ОС) в ВМ. Используйте команду `VBoxManage list ostypes` для отображения идентификаторов типов ОС.

`--icon-file=`имя-файла``

- Задает путь к файлу иконки ВМ в формате PNG в хост-системе. Иконка отображается в интерфейсе Менеджера ВМ и когда ВМ запущена в режиме графического интерфейса.

`--memory=`размер``

- Задает количество оперативной памяти хоста, выделенной ВМ. Размер в МБ. Смотрите tk_create-vm.

`--page-fusion=on | off`

- Включает или отключает функцию Page Fusion, которая по умолчанию отключена. Используйте функцию Page Fusion для минимизации дублирования памяти между ВМ, имеющих подобную конфигурацию и работающих на той же хост-системе. Смотрите guestadd-pagefusion.

`--vram=`размер``

- Задает количество оперативной памяти, выделенной графической карте. Смотрите ct_settings-display.

`--acpi=on | off`

- Определяет поддерживает ли ВМ ACPI. Смотрите settings-motherboard.

`--ioapic=on | off`

- Определяет поддерживает ли ВМ I/O APIC. Смотрите settings-motherboard.

`--hardware-uuid=`uuid``

- Задает Универсальный Уникальный Идентификатор (UUID) для представления гостевой ВМ в таблицах памяти (DMI/SMBIOS), в оборудовании и свойствах ВМ. По умолчанию этот UUID оборудования такой же как UUID ВМ. Клонирование и функция портирования автоматически сохраняет значение UUID оборудования. Аналогично для экспорта и импорта виртуальной конфигурации, но только если обе операции выполняются &product-name;.

`--cpus=`число-ЦПУ``

- Задает количество виртуальных ЦПУ, назначенных ВМ. Смотрите settings-processor.

  Если горячее подключение ЦПУ включено, эта опция задает максимальное количество виртуальных ЦПУ, которые можно подключить к ВМ.

`--cpu-hotplug=on | off`

- Включает или выключает горячее подключение ЦПУ. Когда включено, можно динамически добавлять и удалять виртуальные ЦПУ в ВМ. Смотрите cpuhotplug.

`--plug-cpu=`CPU-ID``

- Добавляет виртуальный ЦПУ в ВМ. `CPU-ID` - это индекс добавляемого вируального ЦПУ. Допустимое значение индекса - это число от `0` до максимального количества ЦПУ, заданных опцией `--cpus`.

  Используйте эту опцию только когда включено горячее подключение ЦПУ.

`--unplug-cpu=`CPU-ID``

- Удалить виртуальный ЦПУ из ВМ. `CPU-ID` - это индекс удаляемого вируального ЦПУ. Допустимое значение индекса - это число от `1` до максимального количества ЦПУ, заданных опцией `--cpus`.

  Используйте эту опцию только когда включено горячее подключение ЦПУ.

  Обратите внимание, что нельзя удалить ЦПУ 0.

`--cpuexectioncap=`процент``

- Указывает, сколько времени ЦПУ может использовать виртуальный ЦПУ. Допустимые значения от `1` до `100`. Значение 50 показывает, что единичные виртуальный ЦПУ может использовать до 50% единичного ЦПУ хоста.

`--x86-pae=on | off`

- Включает или выключает расширение физических адресов (PAE). Смотрите settings-processor.

`--x86-long-mode=on | off`

- Включает или выключает длинный режим. Смотрите settings-processor.

`--ibpb-on-vm-exit=on | off`

- Включает использование барьера предсказателя неявных ветвлений (IBPB) при каждом выходе из ВМ.

`--ibpb-on-vm-entry=on | off`

- Включает использование барьера предсказателя неявных ветвлений (IBPB) при каждом входе в ВМ.

`--spec-ctrl=on | off`

- Включает или выключает отображение интерфейсов управления спекуляцией для гостевой ВМ. Эти интерфейсы должны быть доступны в хост-системе.

  В зависимости от ЦПУ хоста и нагрузки, включение управления спекуляцией может значительно уменьшить производительность.

`--l1d-flush-on-sched=on | off`

- Включает или отключает сброс кэша данных L1, когда поток запланирован на исполнение гостевого кода. Смотрите sec-rec-cve-2018-3646.

`--l1d-flush-on-vm-entry=on | off`

- Включает или отключает сброс кэша данных L1 при каждом входе в ВМ. Смотрите sec-rec-cve-2018-3646.

`--mds-clear-on-sched=on | off`

- Включает очистку буфера ЦПУ когда поток запланирован на выполнение гостевого кода. Смотрите sec-rec-cve-2018-12126-et-al.

`--mds-clear-on-vm-entry=on | off`

- Включает очистку буфера ЦПУ при каждом входе в ВМ. Смотрите sec-rec-cve-2018-12126-et-al.

`--cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386`

- Задает профиль, используемый для эмуляции гостевого ЦПУ. Задайте значение, основанное на ЦПУ хост-системы (`host`) или одной из следующих более старых микроархитектурах Intel: `8086`, `80286` или `80386`.

`--x86-hpet=on | off`

- Включает или выключает Таймер Событий Высокого Разрешения (HPET), заменяющий устаревший системный тайммер. Эта функция отключена по умолчанию. Заметим, что HPET поддерживается в Windows начиная с Vista.

`--hwvirtex=on | off`

- Включает или отключает использования расширение виртуализации оборудования в процессоре хост-системы. Такими расширениями являются Intel VT-x или AMD-V.

`--triple-fault-reset=on | off`

- Включает или отключает сброс гостевой ВМ вместо включения медитации гуру. Некоторые гостевые ВМ вызывают тройной сбой для сброса ЦПУ, поэтому иногда сброс гостевой ВМ - это наилучший исход. Эта опция применяется только к гостевым системам не использующих симметричную многопроцессорность (SMP).

`--apic=on | off`

- Включает или выключает APIC. С APIC, ОС может использовать более 16 запросов на прерывание (IRQ) избегая совместное использование IRQ для улучшения надежности. APIC включен по умолчанию. Смотрите settings-motherboard.

`--x86-x2apic=on | off`

- Включает или выключает функцию ЦПУ x2APIC. ЦПУ x2APIC позволяет ОС работать более эффективно в конфигурациях с большим количеством ядер и оптимизировать распределение прерываний в виртуализированном окружении. Эта функция включена по умолчанию.

  Отключите эту функцию если ОС, работающая в хост-системе, или гостевая ВМ не совместимы с ЦПУ x2APIC.

`--paravirt-provider=none | default | legacy | minimal | hyperv | kvm`

- Указывает один из следующих интерфейсов паравиртуализации предоставленный гостевой ОС:

  - `none` не предоставляет каких-либо интерфейсов паравиртуализации.

  - `default` выбирает подходящий интерфейс, основанный на типе гостевой ОС при старте ВМ. Это значение по умолчанию при создании новой ВМ.

  - `legacy` выбирает интерфейс паравиртуализации для ВМ, созданный более старыми версиями &product-name;.

  - `minimal` требуется для гостевых ВМ с Mac OS X.

  - `kvm` рекомендуется для гостевых ВМ Linux. Смотрите gimproviders.

  - `hyperv` рекомендуется для гостевых ВМ Windows. Смотрите gimproviders.

`--paravirt-debug=`свойство`=`значение``

- Задает отладочные свойства, специфичные для провайдера паравиртуализации, настроенного для указанной ВМ. Смотрите gimdebug.

`--nested-paging=on | off`

- Включает или отключает функцию вложенных страниц в процессоре хост-системы. Эта опция доступна только если аппаратная виртуализация включена. Смотрите sec-rec-cve-2018-3646.

`--large-pages=on | off`

- Включает или отключает использование гипервизором больших страниц, что может увеличить производительность до 5%. Использование больших страниц уменьшает использование TLB и накладные расходы. Эта опция доступна только если включены и аппаратная виртуализация и вложенные страницы.

`--x86-vtx-vpid=on | off`

- Включает или отключает использование функцию TLB c метками (VPID) в процессоре вашей хост-системы. Эта опция доступна только если аппаратная виртуализация включена на Intel VT-x.

`--x86-vtx-ux=on | off`

- Включает или отключает использование неограниченного гостевого режима для выполнения гостевой ВМ. Эта опция доступна только когда аппаратная виртуализация включена на Intel VT-x.

`--nested-hw-virt=on | off`

- Включает или отключает вложенну виртуализацию. Включение делает доступной функцию аппаратной виртуализации в ВМ. Смотрите nested-virt.

`--virt-vmsave-vmload=on | off`

- Если аппаратная виртуализация включена у хоста с ЦПУ AMD, эта настройка включает или отключает использование функцию виртуализированных vmsave/vmload во время исполнения ВМ. Включена по умолчанию. Рекомендуется оставить включенной, так как она имеет серьезное влияние на производительность при выполнении вложенных ВМ при использовании вложенной аппаратной виртуализации. nested-virt.

`--accelerate-3d=on | off`

- Включает или выключает аппаратное 3D ускорение для графических адаптеров, поддерживающих это. Эта опция работает только при установленных Дополнений Гостевой ОС. Смотрите guestadd-video.

`--chipset=piix3 | ich9`

- Задать чипсет Intel для эмуляции в &product-name;. Значение по умолчанию - это чипсет Intel PIIX3 (`piix3`).

  Изменяйте это значение только если нужно ослабить некоторые ограничения чипсета. Смотрите settings-motherboard.

`--iommu=none | automatic | amd | intel`

- Указывает типа IOMMU для эмуляции в &product-name;. И Intel и AMD IOMMU требуют в настоящее время использование чипсета Intel ICH9 (Смотрите опцию `--chipset`).

  Допустимые значения:

  - `none` – IOMMU отсутствует и это значение по умолчанию.

  - `automatic` – IOMMU присутствует, но его тип выбирается автоматически, соответствуя поставщику ЦПУ хоста при включении ВМ.

  - `amd` – AMD IOMMU присутствует.

  - `intel` – Intel IOMMU присутствует.

`--tpm-type=none | 1.2 | 2.0 | host | swtpm`

- Указывает тип TPM для эмуляции в &product-name;.

  Допустимы следующие значения:

  - `none` – TPM отсутствует и это значение по умолчанию.

  - `1.2` – TPM, соответствующий спецификации TCG 1.2, присутствует.

  - `2.0` – TPM, соответствующий спецификации TCG 2.0, присутствует.

  - `host` – TPM хост системы перенаправляется в гостевую систему. Может быть доступен не на всех поддерживаемых хост платформах.

  - `swtpm` – ВМ подключается к эмуляции внешнего TPM, совместимого с swtpm. Необходиму задать расположение TPM location для подключения (смотрите опцию `--tpm-location`).

`--firmware-logo-fade-in=on | off`

- Указывает, появляется ли логотип BIOS при старте ВМ. По умолчанию показывается логотип &product-name;.

`--firmware-logo-fade-out=on | off`

- Указывает, исчезает ли логотип BIOS при старте ВМ.

`--firmware-logo-display-time=`msec``

- Задает время отображения логотипа BIOS в миллисекундах.

`--firmware-logo-image-path=`pathname``

- Заменяет существующий логотип BIOS другим изображением. Заменяющее изображение должно быть несжатым 16-, 256- или 16М-цветным файлом bitmap (BMP), не содержащим информацию о цветовом пространстве (формат Windows 3.0). Также убедитесь что изображение не больше 640x480 пикселов.

`--firmware-boot-menu=disabled | menuonly | messageandmenu`

- Указывает, позволяет ли BIOS выбрать временное загрузочное устройство. Допустимые значения:

  - `disabled` выводит сообщение об альтернативном загрузочном устройстве и позволяет выбрать временное загрузочное устройство нажатием F12.

  - `menuonly` подавляет вывод сообщения об альтернативном загрузочном устройстве, но позволяет выбрать временное загрузочное устройство нажатием F12.

  - `messageandmenu` подавляет сообщение об альтернативном загрузочном устройстве и предотвращает выбор временного загрузочного устройства нажатием F12.

`--firmware-apic=x2apic | apic | disabled`

- Задает уровень APIC для прошивки. Допустимые значения: `x2apic`, `apic` и `disabled`. Когда значение `disabled`, ни версия `apic` ни версия `x2apic` не используются.

  Заметим, что если указать значение `x2apic` и x2APIC не поддерживается виртуальным ЦПУ, уровень APIC снижается до `apic`, если он поддерживается. Иначе, уровень APIC снижается до `disabled`. Аналогично, если указать значение `apic` и APIC не поддерживается виртуальным ЦПУ, уровень APIC снижается до `disabled`.

`--firmware-system-time-offset=`миллисекунды``

- Задает смещение времени в миллисекундах для гостевой ВМ по отношению ко времени в хост-системе. Если значение положительное, время в гостевой ВМ опережает время хост-системы.

`--firmware-pxe-debug=on | off`

- Включает или отключает дополнительный отладочный вывод при использовании загрузочного ROM Intel PXE. Отладочный вывод записывается в файл журнала в режиме выпуска. Смотрите collect-debug-info.

`--system-uuid-le=on | off`

- Включает или выключает представление системного UUID в форме little endian. Значение по умолчанию `on` для новых ВМ. Для старых ВМ значение `off` чтобы сохранить содержиммое таблицы DMI/SMBIOS неизменным, что может быть важно для активации лицензии Windows.

`--boot`N`=none | floppy | dvd | disk | net`

- Позволяет указать порядок загрузочных устройств для ВМ через назначение одного из типов устройств на каждый из четырех слотов загрузочных устройств, представленных `N` в имени опции.

  Значение 1 для в `N` представляет первое загрузочное устройство, и так далее.

  Типы устройств - это `floppy` для флоппи дисков, `dvd` для DVD или CD, `disk` для жестких дисков и `net` для сетевых устройств. Значение `none` показывает, что загрузочное устройство на указанный слот не назначено.

`--rtc-use-utc=on | off`

- Указывает, что часы реального времени (RTC) используют скоординированное универсальное время (UTC). Смотрите settings-motherboard.

`--graphicscontroller=none | vboxvga | vmsvga | vboxsvga`

- Задает используемый тип графического контроллера. Смотрите settings-screen.

`--snapshot-folder=default | `путь``

- Указывает имя папки для хранения снимков ВМ. `default` означает `Snapshots/` в папке машины.

`--firmware=bios | efi | efi32 | efi64`

- Указывает прошивку, используемую для загрузки ВМ. Допустимые значения: `bios`, `efi`, `efi32` или `efi64`. Используйте значения EFI с осторожностью.

  По умолчанию используется прошивка BIOS.

`--guest-memory-balloon=`размер``

- Задает размер гостевого memory balloon. Гостевой memory balloon - это память выделенная Дополнениями Гостевой ОС из гостевой ОС и возвращенная гипервизору для использования другими ВМ. Указывайте `размер` в мегабайтах. Значение по умолчанию `0` мегабайт. Смотрите guestadd-balloon.

`--default-frontend=default | `имя``

- Указывает фронтенд по умолчанию, используемый при старте указанной ВМ. Если указать `default`, ВМ запускается в окне рабочего стола пользователя. Смотрите vboxmanage-startvm.

`--vm-process-priority=default | flat | low | normal | high`

- Задает схему приоритета, используемую при старте и работе указанной ВМ.

  Допустимы следующие значения:

  - `default` – Приоритет процесса по умолчанию, опрелеляемый ОС.

  - `flat` – предполагает политику планирования, которая устанавливает для процесса приоритет по умолчанию, при этом, всем потокам процесса устанавливается один и тот же приоритет.

  - `low` – Предполагает политику планирования, которая устанавливает приоритет процесса в основном ниже приоритета по умолчанию ОС хоста.

  - `normal` – Предполагает политику планирования, которая честно разделяет ресурсы ЦПУ с другими процессами, имеющими приоритет по умолчанию ОС хоста.

  - `high` – Предполагает политику планирования, которая устанавливает приоритет процесса выше приоритета по умолчанию ОС хоста. Эта политика может повлиять на другие процессы, заставляя их ожидать ресурса ЦПУ больше положенного времени, что может привести к непредсказуемому поведению.

### Сетевые настройки

Следующие опции позволяют изменять сеть в вашей ВМ. Во всех этих опциях, `N` - это число больше нуля, представляющее определенный виртуальный сетевой адаптер, настраиваемый в данный момент.

`--nic`N`=none | null | nat | natnetwork | bridged | intnet | hostonly | generic`

- Настраивает тип сети используемый каждой виртуальной сетевой картов в ВМ.

  Следующие допустимые значения соответствуют режимам, описанных вnetworkingmodes:

  - `none` – Сеть отсутствует

  - `null` – Не подключен к хост-системе

  - `nat` – Используется преобразование адресов (NAT)

  - `natnetwork` – Используется сеть NAT

  - `bridged` – Используется сетевой мост

  - `intnet` – Используется внутренняя сеть

  - `hostonly` – Используется сеть хоста

  - `generic` – Доступ к редко используемым подрежимам

`--nic-type`N`=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio`

- Идентифицирует тип сетевого оборудования, которое &product-name; представляет гостевой ВМ для указанной виртуальной сетевой карты. Смотрите nichardware.

  Допустимы следующие значения:

  - `Am79C970A` представляет AMD PCNet PCI II.

  - `Am79C973` представляет AMD PCNet FAST III, что является значением по умолчанию.

  - `82540EM` представляет Intel PRO/1000 MT Desktop.

  - `82543GC` представляет Intel PRO/1000 T Server.

  - `82545EM` представляет Intel PRO/1000 MT Server.

  - `virtio` представляет паравиртуализированный сетевой адаптер.

`--cable-connected`N`=on | off`

- Временно отсоединяет виртуальный сетевой интерфейс, как будто вы вытащили сетевой кабель из физического сетевого интерфейса. Можно использовать эту опцию для сброса определенных программных компонентов в ВМ.

`--nic-trace`N`=on | off`

- Включает или выключает трассировку сети для указанной сетевой карты.

`--nic-trace-file`N`=`имя-файла``

- Задает абсолютный путь к файлу, куда записывать информаицю журнала трассировки. Используйте эту опцию если включена трассировка сети.

`--nic-property`N`=`имя`=`значение``

- Позволяет задать значения свойств и передать их редко используемым сетевым бэкендам. Для использования этой опции, необходимо также использовать опцию `--nic-generic-drv`.

  Свойства относятся к движку бэкенда и отличаются между UDP туннелем и драйверами бэкенда VDE. В качестве примера смотрите network_udp_tunnel.

`--nic-speed`N`=`кбит-в-сек``

- Указывает пропускную способность в килобит в секунду для редко используемых сетевых подрежимов, таких как сеть VDE и UDP туннель. Используйте эту опцию, только если использована опция `--nic` для включения generic сети для указанной виртуальной сетевой карты.

`--nic-boot-prio`N`=`приоритет``

- Назначает приоритет для каждой NIC, что определяет порядок, в котором соответствующий NIC используется для сетевой загруки PXE. Значение приоритета - это число в диапазоне от `0` до `4`. Приоритет `0`, который является значением по умолчанию, представляет наименьший приоритет. Приоритет `1` - это наибольший приоритет, а приоритеты `3` и `4` - ниже.

  Эта опция работает только когда используется загрузочный ROM Intel PXE.

`--nic-promisc`N`=deny | allow-vms | allow-all`

- Позволяет указать разрешен или запрещен неразборчивый режим указанной виртуальной сетевой карты ВМ. Эта опция имеет значение только для сетевого моста. Допустимые значения:

  - `deny` прячет любой траффик, не предназначенный данной ВМ. Это значение по умолчанию.

  - `allow-vms` прячет весь траффик хоста, но разрешает ВМ просматривать траффик других ВМ.

  - `allow-all` разрешает ВМ просматривать весь траффик.

`--nic-bandwidth-group`N`=none | `имя``

- Добавляет или удаляет назначение группы полосы пропускания к указанной виртуальной сетевой карте. Допустимые значения:

  - `none` удаляет любое текущее назначение группы полосы пропускания из указанного виртуального сетевого интерфейса.

  - `имя` добавляет назначение группы полосы пропускания к указанному виртуальному сетевому интерфейсу.

  Смотрите network_bandwidth_limit.

`--bridge-adapter`N`=none | `имя-устройства``

- Указывает интерфейс хоста используемого в указанном виртуальном сетевом интерфейсе. Смотрите network_bridged. Используйте эту опцию только если использована опция `--nic` для включения сетевого моста для указанной виртуальной сетевой карты.

`--host-only-adapter`N`=none | `имя-устройства``

- Указывает интерфейс сети хоста используемого в указанном виртуальном сетевом интерфейсе. Смотрите network_hostonly. Используйте эту опцию только если использована опция `--nic` для включения сети хоста для указанной виртуальной сетевой карты.

`--intnet`N`=`имя-сети``

- Указывает имя внутренней сети. Смотрите network_internal. Используйте эту опцию только если использована опция `--nic` для включения внутренней сети для указанной виртуальной сетевой карты.

`--nat-network`N`=`имя-сети``

- Указывает имя сети NAT, куда подключен адаптер. Используйте эту опцию только если тип сети `natnetwork`, а не `nat`.

`--nic-generic-drv`N`=`драйвер-бэкенда``

- Позволяет получить доступ к редко используемым сетевым подрежимам, таких как сети VDE и UDP туннель. Используйте эту опцию, только если использована опция `--nic` для включения generic сети для указанной виртуальной сетевой карты.

`--mac-address`N`=auto | `MAC-адрес``

- Указывает MAC адрес указанного сетевого адаптера ВМ. По умолчанию, &product-name; назначает случайный MAC адрес на каждый сетевой адаптер при создании ВМ.

### Настройкт сети NAT

В следующих опциях, используйте `N` для указания определенного виртуального сетевого адаптера, где нужно произвести изменения.

`--nat-net`N`=default | `сеть``

- Указывает диапазон IP адресов используемый в этой сети. Смотрите changenat. Используйте эту опцию только если тип сети `nat`, а не `natnetwork`.

`--nat-pf`N`=[`имя`],tcp | udp,[`IP-хоста`],`порт-хоста`,[`IP-гостя`],`порт-гостя``

- Указывает используемое правило перенаправления портов NAT. Смотрите natforward.

`--nat-pf`N`=delete `имя``

- Указывает правило перенаправления портов NAT для удаления. Смотрите natforward.

`--nat-tftp-prefix`N`=`префикс``

- Задает префикс, используемый во встроенном TFTP сервере. Например, можно использовать префикс, для указания, где расположен загрузочный файл. Смотрите nat-tftp и nat-adv-tftp.

`--nat-tftp-file`N`=`загрузочный-файл``

- Задает имя загрузочного файла TFTP. Смотрите nat-adv-tftp.

`--nat-tftp-server`N`=`сервер-tftp``

- Задает адрес сервера TFTP, откуда загружаться. Смотрите nat-adv-tftp.

`--nat-bind-ip`N`=`IP-адрес``

- Задает альтернативный IP адрес, на который привязывается движок NAT. Смотрите changenat. По умолчанию, движок NAT &product-name; перенаправляет пакеты TCP/IP через интерфейс по умолчанию, назначенный TCP/IP стеком хоста.

`--nat-dns-pass-domain`N`=on | off`

- Указывает, передает ли встроенный DHCP сервер имя домена для разрешения сетевого имени.

`--nat-dns-proxy`N`=on | off`

- Указывает, что движок NAT - это прокси для всех запросов DNS из гостевых систем в DNS серверы хост-системы. Смотрите nat-adv-dns.

`--nat-dns-host-resolver`N`=on | off`

- Указывает, что движок NAT использует механизм разрешения хост-системы для обработки DNS запросов. Смотрите nat-adv-dns.

`--nat-localhostreachable`N`=on | off`

- Указывает, что движок NAT разрешает траффик из гостя направленный на 10.0.2.2 передавать в локальную петлю хоста, то есть localhost или 127.0.0.1.

`--nat-settings`N`=[`mtu`],[`отправка-сокет`],[`прием-сокет`],[`отправка-tcp`],[`прием-tcp`]`

- Задает значения для настройки производительности NAT. Смотрите changenat.

`--nat-alias-mode`N`=default | [log],[proxyonly],[sameports]`

- Задает поведение ядра движка NAT:

  - `log` включает журналирование

  - `proxyonly` выключает режим псеводонимов и делает NAT прозрачным

  - `sameports` заставляет движок NAT отправлять пакеты через тот же порт, с которого они пришли

  - `default` выключает все режимы псевдонимов.

  Для более подробной информации смотрите nat-adv-alias.

### Другие настройки оборудования

Следующие опции позволяют настроить другое оборудование, такое как последовательный порт, монитор, аудио устройство, USB порты, буфер обмена и функционал Drag and Drop.

`--mouse=ps2 | usb | usbtablet | usbmultitouch`

- Задает режим мыши в ВМ. Допустимые значения: `ps2`, `usb`, `usbtablet` и `usbmultitouch`.

`--keyboard=ps2 | usb`

- Задает режим клавиатуры в ВМ. Допустимые значения: `ps2` и `usb`.

`--uart`N`=off | `I/O-база` `IRQ``

- Настраивает виртуальные последовательные порты ВМ. `N` представляет модифицируемый последовательный порт. Допустимые значения `off`, отключающее порт или базу I/O и IRQ. Для информации по значениям базы I/O и IRQ традиционных COM портов смотрите ct_serialports.

`--uart-mode`N`=`режим``

- Указывает, как &product-name; соединяет указанный виртуальный последовательный порт к хост-системе, где работает ВМ. Смотрите ct_serialports.

  Убедитесь, что сначала настроили виртуальный последовательный порт через опцию `--uart`N``.

  Задайте один из следующих режимов соединения для каждого порта:

  - `disconnected` показывает что, даже если последовательный порт отображается в гостевой ВМ, он не подключен. Это состояние подобно физическому COM порту без подключенного кабеля.

  - `server` `имя-канала` создает указанный именованный канал или сокет локального домена в хост системе и присоединяет виртуальное последовательное устройство к нему.

    В хост-системе Windows `имя-канала` - это именованный канала с именем в следующем формате: `\\.\pipe\`имя-канала``.

    В хост-системе Linux, `имя-канала` это сокет локального домена.

  - `client` `имя-канала` подключает виртуальное последовательное устройство к указанному именованному каналу или сокету локального домена.

    Заметим, что именованный канал или сокет локального домена должны уже существовать.

  - `tcpserver` `порт` создает сокет TCP с указанным портом TCP в хост-системе и подключает виртуальное последовательное устройство к нему.

    В UNIX-подобных системах используйте порты больше 1024 для не-root пользователей.

  - `tcpclient` `имя-хоста`:`порт` поключает виртуальное последовательное устройство к сокету TCP.

    Заметим, что TCP сокет должен уже существовать.

  - `file` `имя-файла` перенаправляет вывод последовательного порта в указанный файл. Убедитесь, что `имя-файла` - это абсолютный путь к файлу в хост-системе.

  - `имя-устройства` задает имя устройства физического аппаратного последовательного порта в указанной хост-системе, куда подсоединяется виртуальный последовательный порт.

    Используйте этот режим для подключения физического последовательного порта к ВМ.

    В хост-системах Windows имя устройства это COM порт такой как `COM1`. В хост-системах Linux имя устройства подобно `/dev/ttyS0`.

`--uart-type`N`=`тип-UART``

- Настраивает тип UART для указанного виртуального последовательного порта (`N`). Допустимые значения `16450`, `16550A` и `16750`. Значение по умолчанию `16550A`.

`--lpt-mode`N`=`имя-устройства``

- Задает имя устройства используемого параллельного порта.

  В хост-системах Windows используйте имя устройства как `lpt1`. В хост-системах Linux, используйте имя устройства как `/dev/lp0`.

`--lpt`N`=`I/O-база` `IRQ``

- Задает базовый адрес I/O и IRQ параллельного порта.

  Можно посмотреть базовый адрес I/O и IRQ, используемый для параллельного порта, в менеджере устройств.

`--audio-controller=`тип-контроллера``

- Задает аудио контроллер, используемый в ВМ. Допустимые значения: `ac97`, `hda` и `sb16`.

`--audio-codec=`тип-кодека``

- Указывает аудио кодек, используемый в ВМ. Допустимые значения: `stac9700`, `ad1980`, `stac9221` и `sb16`.

`--audio-driver=`тип``

- Указывает, что ВМ имеет поддержку аудио определенного типа. Допустимые значения: `none`, `default`, `null`, `dsound`, `was`, `oss`, `alsa`, `pulse` и `coreaudio`.

  Заметим, что типы аудио зависят от операционной системы хоста. Вывод справки по команде `VBoxManage modifyvm` поможет определить поддерживаемые типы аудио для вашей операционной системы.

  Для обеспечения максимальной совместимости между хостами можно использовать стандартный аудиодрайвер по умолчанию. В этом случае, виртуальная машина автоматически выберет наиболее подходящий аудиодрайвер для текущего доступного хоста.

`--audio-enabled=on|off`

- Указывает, следует ли включить или отключить звук для виртуальной машины.

  Эта опция имеет приоритет над опциями --audio-in и --audio-out, т.е. отключение звука с помощью этой опции приведет к полному отключению как входного, так и выходного звука.

`--audio-in=on|off`

- Указывает, включать или нет аудио захват из хост-системы.

`--audio-out=on|off`

- Указывает, включать или нет воспроизведение аудио из гостевой ВМ.

`--clipboard-mode=`значение``

- Указывает, как предоставляются данные буфера обмена между гостевой ВМ и хост-системой. Допустимые значения: `disabled`, `hosttoguest`, `guesttohost` и `bidirectional`. Смотрите ct_generalsettings.

  Функционал буфера обмена доступен только если Дополнения Гостевой ОС установлены в ВМ.

`--drag-and-drop=`значение``

- Указывает, как используется функция drag and drop между хост-системой и ВМ. Допустимые значения: `disabled`, `hosttoguest`, `guesttohost` и `bidirectional`. Смотрите guestadd-dnd.

  Функционал drag and drop доступен только если Дополнения Гостевой ОС установлены в ВМ.

`--monitor-count=`количество``

- Позволяет настроить несколько мониторов. Смотрите ct_settings-display.

`--usb-ohci=on | off`

- Включает или отключает виртуальный USB 1.1 контроллер ВМ. Смотрите settings-usb.

`--usb-ehci=on | off`

- Включает или отключает виртуальный USB 2.0 контроллер ВМ. Смотрите settings-usb.

`--usb-xhci=on | off`

- Включает или отключает виртуальный USB 3.0 контроллер ВМ. Это наиболее эффективная опция если ВМ поддерживает его. Смотрите settings-usb.

`--usb-rename=`старое-имя` `новое-имя``

- Переименовывает виртуальный USB контроллер ВМ из `старое-имя` в `новое-имя`.

### Настройки записи

Следующие опции позволяют изменить настройки записи видео, записи аудио или обоих.

`--recording=on | off`

- Включает или отключает запись сессии ВМ в файл WebM или VP8. Когда установлен в `on`, запись начинается при старте сессии ВМ.

`--recording-screens=all | `ID-экрана``

- Позволяет указать записываемый экран ВМ. С каждого экрана запись ведется в свой файл. Допустимые значения: `all`, то есть запись со всех экранов или один или несколько указанных экранов.

`--recording-file=`имя-файла``

- Задает имя файла куда сохранять запись.

`--recording-max-size=`МБ``

- Задает максимальный размер файла записанного видео в мегабайтах. Когда файл достигает указанного размера, запись останавливается. Если указано значение `0`, запись продолжается пока не будет остановлена вручную.

`--recording-max-time=`секунды``

- Задает максимальное записываемое время в секундах. При достижении указанного времени запись останавливается. Если указано значение `0`, запись продолжается пока не будет остановлена вручную.

`--recording-opts=`ключ`=`значение``

- Задает дополнительные свойства записи видео как разделенный запятыми список свойств в виде ключ-значение. Например `foo=bar,a=b`.

  Используйте эту опцию, только если вы опытный пользователь. Информацию о ключах смотрите в &product-name; Programming Guide and Reference.

`--recording-video-fps=`кадров-в-сек``

- Задает максимальное количество записываемых видеокадров в секунду (FPS). Запись игнорирует все кадры с более высокой частотой. Если увеличить FPS, меньше кадров будет проигнорировано но запись и размер файла с записью увеличится.

`--recording-video-rate=`битрейт``

- Задает битрейт видео в килобит в секунду. Если увеличить битрейт, качество записи улучшится но и размер записанного файла также увеличится.

`--recording-video-res=`ширина`x`высота``

- Задает разрешение записанного видео (ширина и высота) в пикселах.

### Настройки удаленной машины

Следующие опции позволяют изменить поведение расширения удаленного рабочего стола VirtualBox (VRDE).

`--vrde=on | off`

- Включает или отключает сервер VRDE.

`--vrde-property=TCP/Ports=`порт``

- `порт` - это порт или диапазон портов на которые подключается сервер VRDE. Значения `default` или `0` используют порт `3389`. Это стандартный порт RDP.

  Также cмотрите описание опции `--vrde-port`.

`--vrde-property=TCP/Address=`IP-адрес``

- `IP-адрес` - это IP адрес интерфейса сети хоста, к которому подключается сервер VRDE. Когда указана, сервер принимает подключения только на интерфейс сети хоста с этим IP адресом.

  Также cмотрите описание опции `--vrde-address`.

`--vrde-property=VideoChannel/Enabled=`значение``

- Указывает включен ли видеоканал VRDP или нет. `1` значит `on` и `0` значит `off`. Смотрите vrde-videochannel.

`--vrde-property=Quality=`значение``

- Задает значение между 10% и 100% включительно. Она представляет уровень сжатия JPEG в видеоканале сервера VRDE. Меньшее значение приводит к худшему качеству JPEG но более высокое сжатие. Смотрите vrde-videochannel.

`--vrde-property=DownscaleProtection=`значение``

- Включает или отключает функцию защиты от уменьшения масштаба. Допустимые значения `1` включающая функцию и `0`, отключающую ее.

  Когда эта функция включена, &product-name; определяет отображать ли видео:

  - Когда размер видео соответствуют размеру теневого буфера, видео рассматривается как полноэкранное и отображается.

  - Когда размер видео между полным экраном и порогом уменьшения масштаба, видео не отображается. Такое видео может быть окном приложения, нечитаемым при уменьшении масштаба.

  Когда эта функция отключена, все равно производится попытка отобразить видео.

`--vrde-property=Client/DisableDisplay=1`

- Отключает функцию отображения сервера VRDE.

  Для повторного включения этой функции, назначьте пустое значение. Например, для включения функии отображения укажите команду `VBoxManage modifyvm --vrde-property=Client/DisableDisplay=`. Смотрите vrde-customization.

`--vrde-property=DisableInput=1`

- Отключает функцию ввода сервера VRDE.

`--vrde-property=DisableAudio=1`

- Отключает функцию аудио сервера VRDE.

`--vrde-property=DisableUSB=1`

- Отключает функцию USB сервера VRDE.

`--vrde-property=Client/DisableClipboard=1`

- Отключает функцию буфера обмена сервера VRDE. Для включения этой функции, назначьте пустое значение. Смотрите vrde-customization.

`--vrde-property=DisableUpstreamAudio=1`

- Отключает функцию передачи аудио на сервер VRDE. Для включения этой функции назначьте пустое значение. Смотрите vrde-customization.

`--vrde-property=Client/DisableRDPDR=1`

- Отключает функцию RDP перенаправления устройств для смарт-карт сервера VRDE. Для включения этой функции назначьте пустое значение.

`--vrde-property=H3DRedirect/Enabled=1`

- Включает функию перенаправления 3D сервера VRDE. Для включения этой функции назначьте пустое значение.

`--vrde-property=Security/Method=`значение``

- Указывает следующую информаицю, требуемую для подключения:

  - `Negotiate` показывает, что разрешены подключения, имеющие и расширенную (TLS) и стандартную безопасность RDP. Метод безопасности согласуется с клиентом. Это значение по умолчанию.

  - `RDP` показывает, что принимается только подключение, имеющее стандартную безопасность RDP.

  - `TLS` показывает, что принимается только подключение, имеющее расширенную безопасность RDP. Клиент должен поддерживать TLS.

  Смотрите vrde-crypt.

`--vrde-property=ServerCertificate=`значение``

- Задает абсолютный путь к сертификату сервера. Смотрите vrde-crypt.

`--vrde-property=ServerPrivateKey=`значение``

- Задает абсолютный путь к приватному ключу сервера. Смотрите vrde-crypt.

`--vrde-property=CACertificate=`значение``

- Задает абсолютный путь к корневому самоподписанному сертификату. Смотрите vrde-crypt.

`--vrde-property Audio/RateCorrectionMode=`значение``

- Задает режим подключения аудио или путь к файлу аудио журнала. Допустимые значения:

  - `VRDP_AUDIO_MODE_VOID` - отсутствие режима. Используйте это значение для снятия используемого режима.

  - `VRDP_AUDIO_MODE_RC` - режим коррекции скорости.

  - `VRDP_AUDIO_MODE_LPF` - режим низкочастотного фильтра.

  - `VRDP_AUDIO_MODE_CS` - режим синхронизации с клиентом для предотвращения переполнения или недозаполнености очереди клиента.

`--vrde-property=LogPath=`значение``

- Задает абсолютный путь к файлу аудио журнала.

`--vrde-extpack=default | `имя``

- Задает библиотеку, используемую для удаленного доступа к ВМ. Значение `default` использует код RDP, который является частью пакета расширения &product-name;.

  Для использования модуля VRDE в VNC, укажите `VNC`. Смотрите otherextpacks.

`--vrde-port=default | `порт``

- `порт` - это порт или диапазон портов на которые подключается сервер VRDE. Значение `default` или `0` использует порт `3389`, который является стандартным портом RDP.

  Можно указать разделенный запятыми список портов или диапазонов портов. Используйте дефис между двумя номерами портов для задания диапазона. Сервер VRDE подключается только к одному доступному порту из списка. В один и тот же момент, только одна машина может использовать данный порт. Например, опция `--vrde-port=5000,5010-5012` указывает, что сервер может подключиться на один из следующих портов: `5000`, `5010`, `5011` или `5012`.

`--vrde-address=`IP-адрес``

- Задает IP адрес интерфейса сети хоста, на который подключается сервер VRDE. Если указать IP адрес, сервер VRDE принимает подключения только с указанного интерфейса сети хоста.

  Используйте эту опцию для указания, что сервер VRDP должен принимать IPv4, IPv6 или оба тип соединений:

  - Только IPv4: Используйте опцию `--vrde-address="0.0.0.0"`.

  - Только IPv6: Используйте опцию `--vrde-address="::"`.

  - И IPv6 и IPv4: Используйте опцию `--vrde-address=""`. Это значение по умолчанию.

`--vrde-auth-type=null | external | guest`

- Указывает использовать ли авторизацию и как ее проводить. Смотрите vbox-auth. Допустимые значения:

  - `null` - без аутентификации.

  - `external` - внешняя аутентификация через библиотеку аутентификации.

  - `guest` - аутентификация через гостевые пользовательские учетные записи. Этот неподдерживаемый метод требует установки Дополнений Гостевой ОС в ВМ.

`--vrde-auth-library=default | `имя``

- Задает библиотеку, используемую для аутентификации RDP. Библиотека по умолчанию для внешней аутентификации `VBoxAuth`. Смотрите vbox-auth.

`--vrde-multi-con=on | off`

- Включает или отключает функцию множественных подключений к серверу VRDE, если поддерживается. Смотрите vrde-multiconnection.

`--vrde-reuse-con=on | off`

- Задает поведение сервера VRDE когда множественные подключения отключены. Когда значение `on`, сервер разрешает подключение нового клиента и разрывает существующее. Когда значение `off`, новое подключение не принимается если клиент уже подключен к серверу. Это значение по умолчанию.

`--vrde-video-channel=on | off`

- Включает перенаправление видео, если поддерживается сервером VRDE. Смотрите vrde-videochannel.

`--vrde-video-channel-quality=`процент``

- Задает качество видео при перенаправлении как величина от 10 до 100 процентов. Процент представляет уровень сжатия JPEG, где меньшие значения ухудшают качество, но обеспечивают более высокое сжатие. Смотрите vrde-videochannel.

### Настройки портирования

Следующие опции позволяют настроить машину как цель портирования. Смотрите teleporting.

`--teleporter=on | off`

- Включает или выключает портирование. Когда включено, машина стартует и ждет получения запроса на портирование из сети вместо нормальной загрузки.

  Запросы на портирование принимаются на порт и адрес, указанный в следующих параметрах:

`--teleporter-port=`порт``

- Задает порт, который слушает ВМ для получения запросов на портирование из другой ВМ. `порт` - это любой свободный номер TCP/IP порта, такой как `6000`. Необходимо также указать опцию `--teleporter`.

`--teleporter-address=`IP-адрес``

- Задает IP адрес, который слушает ВМ для получения запросов на портирование из другой ВМ. `IP-адрес` - это любой IP адрес или имя хоста. Он указывает сокет TCP/IP для подключения. IP адрес по умолчанию `0.0.0.0`, который представляет любой IP адрес. Необходимо также указать опцию `--teleporter`.

`--teleporter-password=`пароль``

- Задает пароль, используемый для аутентификации. Когда указан, запрос на портирование успешен только тогда, когда пароль в исходной машине такой же, как и указанный.

`--teleporter-password-file=`имя-файла``

- Задает файл, содержащий пароль для использования в аутентификации. Когда указан, запрос на портирование успешен только тогда, когда пароль в исходной машине такой же, как и в указанном файле. Значение `stdin` читает пароль из стандартного потока ввода.

`--cpuid-portability-level=`уровень``

- Ограничивает способности виртуального ЦПУ, которые &product-name; представляет гостевой ОС использую правила портативности. Более высокие целые значения означают более ограниченное поведение. Уровень по умолчанию `0` показывает, что весь поддерживаемый хостом вируализированный функционал доступен гостевой системе. Значение `3` подавляет большинство функций. Значения `1` и `2` представляют ограничения между предыдущими уровнями. Поведение может меняться в зависимости от версии продукта.

`--cpuid-set=`лист`[:`подлист`] `eax` `ebx` `ecx` `edx``

- Опытные пользователи используют эту настройку перед операцией портирования (фактически перед запуском ВМ) для ограничения способностей виртуального ЦПУ, которые &product-name; предоставляет гостевой операционной системе. Это должно быть запущено и на исходной и на целевой машинах, вовлеченных в процесс портирования и определяет, что гостевая система увидит когда выполняет машинную инструкцию CPUID. Это может помочь с неправильным поведением приложений, которые неправильно предполагают, что присутствуют определенные способности ЦПУ. Значение параметра зависит от оборудования. Обратитесь к документации AMD или Intel.

  Значения `лист`, `подлист` (необязательно), `eax`, `ebx`, `ecx` и `edx` - это целые числа данные в шестнадцатиричном формате, то есть используя основание 16 без какого-либо префикса.

`--cpuid-remove=`лист`[:`подлист`]`

- Удаляет подстройку, установленную через `--cpuid-set`.

`--cpuid-remove-all`

- Удаляет все подстройки, установленные через `--cpuid-set`.

### Настройки отладки

Используйте следующие опции только для низкоуровневой отладки ВМ. Эти опции только для опытных пользователей.

`--tracing-enabled=on | off`

- Включает или отключает буфер трассировки. Заметим, что когда указан, буфер трассировки потребляет память и добавляет накладные расходы.

`--tracing-config=`строка-настроек``

- Включает конфигурацию трассировки, определяющую группу включенных точек трассировки.

`--tracing-allow-vm-access=on | off`

- Включает или отключает доступ ВМ к буферу трассировки. Значение по умолчанию `off`, что запрещает доступ.

### Настройки USB картридера

Следующие опции задают доступ гостевого окружения к USB картридеру. USB картридер может получить доступ к данным карт памяти, таких как CompactFlash (CF), Secure Digital (SD) и MultiMediaCard (MMC).

`--usb-card-reader=on | off`

- Включает или отключает интерфейс USB картридера.

### Автостарт ВМ в течение загрузки хост-системы

Следующие опции позволяют настроить функцию автостарта ВМ, которая автоматически стартует ВМ во время загрузки хост-системы. Требуется произвести некоторые настройки хост-системы перед использованием этой функции. Смотрите autostart.

`--autostart-enabled=on | off`

- Включает или отключает автостарт ВМ во время загрузки хост-системы для указанного пользователя.

`--autostart-delay=`секунды``

- Задает количество секунд, по истечении которых после загрузки хост-системы, ВМ стартует.

### Настройки сквозного режима PCI

Следующие опции позволяют настроить функцию сквозного режима PCI, которая на настоящий момент не доступна в &product-name;. Планируется вернуть данный функционал в будущем.

`--pci-attach=`PCI-адрес-хоста`[@`гостевой-PCI-адрес-шины`]`

- Подключает указанный сетевой контроллер PCI хоста к гостевой ВМ. Можно опционально указать шину PCI в гостевой ВМ, куда подключать контроллер.

`--pci-detach=`PCI-адрес-хоста``

- Отключает указанный сетевой контроллер PCI из подключенной PCI шины гостевой ВМ.

### Тестирование (ValidationKit / Bootsector)

Эти опции для настройки функционала тестирования VMM устройств и почти экслюзивно используются bootsector тестами в ValidationKit.

`--testing-enabled=on | off`

- Включен функционал тестирования VMMDev. Для подробной информации смотрите VMMDevTesting.h.

`--testing-mmio=on | off`

- Включена область MMIO для функционала тестирования VMMDev.

`--testing-cfg-dword`idx`=`значение``

- Это задает один из 10 DWORD значений конфигурации. `idx` должен быть в диапазоне от 0 до 9. `значение` ограничено 32 битами (DWORD).

## Примеры

Следующая команда изменяет описание для ВМ `ol7`.

    $ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4"

Следующая команда включает поддержку протокола удаленного рабочего стола VirtualBox (VRDP) для ВМ `ol7`.

    $ VBoxManage modifyvm ol7 --vrde on

## Смотрите также

vboxmanage-showvminfo, vboxmanage-controlvm, vboxmanage-createvm, vboxmanage-startvm vboxmanage-list