$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $

VBoxManage controlvm

VBoxManage-controlvm 1
VBoxManage-controlvm изменение состояния и настроек работающей виртуальной машины &product-name;
`VBoxManage controlvm` uuid имя-ВМ pause `VBoxManage controlvm` uuid имя-ВМ resume `VBoxManage controlvm` uuid имя-ВМ reset `VBoxManage controlvm` uuid имя-ВМ poweroff `VBoxManage controlvm` uuid имя-ВМ savestate `VBoxManage controlvm` uuid имя-ВМ acpipowerbutton `VBoxManage controlvm` uuid имя-ВМ acpisleepbutton `VBoxManage controlvm` uuid имя-ВМ reboot `VBoxManage controlvm` uuid имя-ВМ shutdown `VBoxManage controlvm` uuid имя-ВМ keyboardputscancode hex hex `VBoxManage controlvm` uuid имя-ВМ keyboardputstring строка строка `VBoxManage controlvm` uuid имя-ВМ keyboardputfile имя-файла `VBoxManage controlvm` uuid имя-ВМ setlinkstateN on off `VBoxManage controlvm` uuid имя-ВМ nicN null nat bridged intnet hostonly generic natnetwork имя-устройства `VBoxManage controlvm` uuid имя-ВМ nictraceN on off `VBoxManage controlvm` uuid имя-ВМ nictracefileN имя-файла `VBoxManage controlvm` uuid имя-ВМ nicpropertyN имя-свойства=значение-свойства `VBoxManage controlvm` uuid имя-ВМ nicpromiscN deny allow-vms allow-all `VBoxManage controlvm` uuid имя-ВМ natpfN [имя-правила],tcp udp,IP-хоста, порт-хоста, IP-гостя, порт-гостя `VBoxManage controlvm` uuid имя-ВМ natpfN delete имя-правила `VBoxManage controlvm` uuid имя-ВМ guestmemoryballoon размер-balloon-памяти `VBoxManage controlvm` uuid имя-ВМ usbattach uuid адрес --capturefile=имя-файла `VBoxManage controlvm` uuid имя-ВМ usbdetach uuid адрес `VBoxManage controlvm` uuid имя-ВМ audioin on off `VBoxManage controlvm` uuid имя-ВМ audioout on off `VBoxManage controlvm` uuid имя-ВМ clipboard mode disabled hosttoguest guesttohost bidirectional `VBoxManage controlvm` uuid имя-ВМ draganddrop disabled hosttoguest guesttohost bidirectional `VBoxManage controlvm` uuid имя-ВМ vrde on off `VBoxManage controlvm` uuid имя-ВМ vrdeport port `VBoxManage controlvm` uuid имя-ВМ vrdeproperty имя-свойства=значение-свойства `VBoxManage controlvm` uuid имя-ВМ vrdevideochannelquality процент `VBoxManage controlvm` uuid имя-ВМ setvideomodehint разрешение-x разрешение-y бит/пиксел дисплей enabled:yes | no начальная-точка-x начальная-точка-y `VBoxManage controlvm` uuid имя-ВМ setscreenlayout экран on primary начальная-точка-x начальная-точка-y разрешение-x разрешение-y бит/пиксел off `VBoxManage controlvm` uuid имя-ВМ screenshotpng имя-файла display `VBoxManage controlvm` uuid имя-ВМ recording on off `VBoxManage controlvm` uuid vmname recording start --wait `VBoxManage controlvm` uuid vmname recording stop `VBoxManage controlvm` uuid vmname recording attach `VBoxManage controlvm` uuid имя-ВМ recording screens all none экран,[экран...] `VBoxManage controlvm` uuid имя-ВМ recording filename filename `VBoxManage controlvm` uuid имя-ВМ recording videores ширинаxвысота `VBoxManage controlvm` uuid имя-ВМ recording videorate битрейт `VBoxManage controlvm` uuid имя-ВМ recording videofps кадров/сек `VBoxManage controlvm` uuid имя-ВМ recording maxtime сек `VBoxManage controlvm` uuid имя-ВМ recording maxfilesize МБ `VBoxManage controlvm` uuid имя-ВМ setcredentials имя-пользователя --passwordfile= имя-файла пароль имя-домена --allowlocallogon= yes no `VBoxManage controlvm` uuid имя-ВМ teleport --host=имя-хоста --port=имя-порта --maxdowntime=мсек --passwordfile=имя-файла --password=пароль `VBoxManage controlvm` uuid имя-ВМ plugcpu ID `VBoxManage controlvm` uuid имя-ВМ unplugcpu ID `VBoxManage controlvm` uuid имя-ВМ cpuexecutioncap число `VBoxManage controlvm` uuid имя-ВМ vm-process-priority default flat low normal high `VBoxManage controlvm` uuid имя-ВМ webcam attach путь настройки `VBoxManage controlvm` uuid имя-ВМ webcam detach путь `VBoxManage controlvm` uuid имя-ВМ webcam list `VBoxManage controlvm` uuid имя-ВМ addencpassword ID файл-с-паролем - --removeonsuspend= yes no `VBoxManage controlvm` uuid имя-ВМ removeencpassword ID `VBoxManage controlvm` uuid имя-ВМ removeallencpasswords `VBoxManage controlvm` uuid имя-ВМ changeuartmodeN disconnected server имя-канала client имя-канала tcpserver порт tcpclient имя-хоста:порт file имя-файла имя-устройства `VBoxManage controlvm` uuid имя-ВМ autostart-enabledN on off `VBoxManage controlvm` uuid имя-ВМ autostart-delayсекунд

## Описание

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

### Приостановить виртуальную машину

Команда `VBoxManage controlvm имя-ВМ pause` временно приостанавливает выполнение ВМ. Когда ВМ приостановлена, ее состояние не изменяется постоянно.

Окно ВМ становится серым и заголовок окна показывает, что ВМ приостановлена на текущий момент. Это действие эквивалентно выбору Приостановить из меню Машина графического интерфейса.

### Возобновить выполнение приостановленной виртуальной машины

Команда `VBoxManage controlvm имя-ВМ resume` перезапускает выполнение приостановленной ВМ. Это действие эквивалентно выбору Возобновить из меню Машина графического интерфейса.

### Сбросить виртуальную машину

Команда `VBoxManage controlvm имя-ВМ reset` производит холодный сброс ВМ. У этой команды тот же эффект, как и нажатие кнопки "сброс" у физического компьютера.

Холодная перезагрузка немедленно перезапускает и перезагружает гостевую операционную системы (ОС). Состояние ВМ перед сбросом не сохраняется, поэтому можно потерять данные. Это действие эквивалентно выбору Сброс из меню Машина графического интерфейса.

### Выключить виртуальную машину

Команда `VBoxManage controlvm имя-ВМ poweroff` выключает ВМ. У этой команды тот же эффект как и вытаскивание кабеля питания из физического компьютера.

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

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

### Сохранить состояние виртуальной машины

Команда `VBoxManage controlvm имя-ВМ savestate` сохраняет текущее состояние ВМ на диск и затем останавливает ВМ.

Действие эквивалентно выбору Закрыть из меню Машина графического интерфейса или нажатию на кнопку "Закрыть" окна ВМ и затем выбору Сохранить состояние машины.

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

### Отправить ACPI сигнал выключения в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ acpipowerbutton` отправляет ACPI сигнал выключения в ВМ. У этой команды тот же эффект как и нажатие кнопки "Включить" на физическом компьютере.

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

### Отправить ACPI сигнал перехода в спящий режим в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ acpisleepbutton` отправляет ACPI сигнал перехода в спящий режим в ВМ.

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

### Перезагрузить гостевую ОС

Команда `VBoxManage controlvm имя-ВМ reboot` просит гостевую ОС перезагрузиться.

Эта команда работает только если установлена последняя версия Дополнений Гостевой ОС.

### Выключить гостевую ОС

Команда `VBoxManage controlvm имя-ВМ shutdown` просит гостевую ОС выключиться

Эта команда работает только если установлена последняя версия Дополнений Гостевой ОС.

### Отправить клавиатурные сканкоды в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ keyboardputscancode` отправляет команды клавиатурных сканкодов в ВМ.

По информации о клавиатурных сканкодах смотрите .

### Отправить клавиатурные строки в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ keyboardputstring` отправляет клавиатурные строки в ВМ.

### Отправить файл в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ keyboardputfile` отправляет файл в ВМ.

### Настроить цель для портирования виртуальной машины

Команда `VBoxManage controlvm имя-ВМ teleport` инициирует операцию портирования между указанной ВМ и указанной системой хоста. Смотрите .

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

`--host=имя-хоста`

  Указывает имя ВМ.

`--port=порт`

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

`--maxdowntime=мсек`

  Задает максимальное время простоя в миллисекундах для портируемой целевой виртуальной машины.

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

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

  Такой дизайн не соответствует рекомендациям Oracle по безопасности. Вы не должны указывать пароль в командной строке, потому что его можно увидеть в списке процессов.

  Опция `--password` является взаимоисключающей с опцией `--passwordfile`.

`--passwordfile=имя-файла`

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

  Если указатть в качестве имени файла `stdin`, можно читать пароль со стандартного потока ввода.

  Опция `--passwordfile` является взаимоисключающей с опцией `--password`.

### Установить состояние сетевого подключения для виртуальной машины

Команда `VBoxManage controlvm имя-ВМ setlinkstateN` позволяет подключить или отключить виртуальный сетевой кабель от экземпляра сетевого интерфейса(N). Допустимые значения: `on` и `off`. Значение по умолчанию `on`.

Перед подключением виртуального сетевого кабеля используйте команду `VBoxManage controlvm nictracefileN` во время работы ВМ для задания имени файла для записи журнала. Или используйте команду `VBoxManage modifyvm --nic-trace-fileN=имя-файла` для этих же целей, если ВМ не работает.

Эта подкоманда не влияет прямо на состояние работы ВМ.

### Задать тип сети, используемой виртуальной машиной

Команда `VBoxManage controlvm имя-ВМ nicN` указывает тип сети в указаной сетевой карте ВМ. Нумерация N начинается с `1`.

Следующие допустимые типы сети также описаны в :

- `null` указывает, что ВМ не подключена к хост-системе.

- `nat` указывает, что ВМ использует сетевое преобразование адресов (NAT).

- `bridged` указывает, что ВМ использует сетевой мост.

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

- `hostonly` указывает, что ВМ использует сеть хоста.

- `natnetwork` указывает, что ВМ испльзует сеть NAT.

- `generic` указывает, что у ВМ есть доступ у редко используемым под-режимами.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Отследить сетевой траффик виртуальной машины

Команда `VBoxManage controlvm имя-ВМ nictraceN` позволяет отслеживать сетевой траффик на указанной виртуальной сетевой карте (N). Нумерация N начинается с `1`. Допустимые значения: `on` и `off`. Значение по умолчанию `off`.

Когда устанавливается в `on`, необходимо использовать то же самое значение N для команды `VBoxManage controlvm имя-ВМ nictracefileN`, что было использовано для указания пути и имени файла журнала, в который производится запись результатов отслеживания.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать файл журнала для отслеживания сетевого траффика виртуальной машины

Команда `VBoxManage controlvm имя-ВМ nictracefileN` позволяет вам задать имя файла журнала для отслеживания сетевого траффика для указанной виртуальной сетевой карты (N). Нумерация N начинается с `1`. Убедитесь, что задано то же значение N, какое использовано для команд `VBoxManage controlvm имя-ВМ nicN` и `VBoxManage controlvm имя-ВМ nictraceN`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Указать используемый неразборчивый режим для виртуальной машины

Команда `VBoxManage controlvm имя-ВМ nicpromiscN` позволяет указать как обрабатывать неразборчивый режим для сетевого моста. Значение по умолчанию `deny` скрывает весь траффик, не предназначенный для этой ВМ. Значение `allow-vms` скрывает весь траффик хоста от этой ВМ, но позволяет ВМ просматривать траффик с других ВМ. Значение `allow-all` убирает это ограничение полностью.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать значение свойства сетевого бэкенда виртуальной машины

Команда `VBoxManage controlvm имя-ВМ nicpropertyN имя-свойства=значение-свойства` в комбинации с `nicgenericdrv` позволяет передать значения свойств в редко используемые сетевые бэкенды.

Эти свойства специфичны для бэкенда и различны между драйверами UDP туннеля и VDE бэкенда. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать правило для перенаправления портов NAT для виртуальной машины

Команда `VBoxManage controlvm имя-ВМ natpfN` задает правило перенаправления портов NAT. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

### Удалить правило для перенаправления портов NAT для виртуальной машины

Команда`VBoxManage controlvm имя-ВМ natpfN delete` удаляет указанное правило перенаправления портов NAT. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

### Изменить размер гостевого memory balloon виртуальной машины

Команда `VBoxManage controlvm имя-ВМ guestmemoryballoon` изменяет размер гостевого memory balloon. Гостевой memory balloon - это память выделенная Дополнениями Гостевой ОС &product-name; у гостевой системы и возвращенная гипервизору для использования другими ВМ. Значение указывается в мегабайтах. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

### Сделать USB устройство хост-системы видимым для виртуальной машины

Команда `VBoxManage controlvm имя-ВМ usbattach` динамически подключает USB устройство хоста к ВМ, что делает его видимым. Не нужно создавать фильтр.

Можно указывать USB устройство через Универсальный Уникальный Идентификатор (UUID) или через адрес в хост-системе. используйте команду `VBoxManage list usbhost` для получения информации об USB устройствах хост-системы.

Используйте опцию `--capturefile` для задания абсолютного пути к файлу для записи данных журналирования.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Сделать USB устройство хост-системы невидимым для виртуальной машины

Команда `VBoxManage controlvm имя-ВМ usbdetach` динамически отключает USB устройство хоста от ВМ, что делает его невидимым. Не нужно создавать фильтр.

Можно указывать USB устройство через Универсальный Уникальный Идентификатор (UUID) или через адрес в хост-системе. используйте команду `VBoxManage list usbhost` для получения информации об USB устройствах хост-системы.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Включить или выключить аудио захват из хост-системы

Команда `VBoxManage controlvm имя-ВМ audioin` указывает включить или выключить аудио захват из хост-системы. Допустимые значения: `on`, которая включает аудио захват и `off`, которая выключает аудио захват. Значение по умолчанию `off`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Включить или выключить аудио воспроизведение из виртуальной машины

Команда `VBoxManage controlvm имя-ВМ audioout` указывает включить или выключить аудио воспроизведение из гостевой ВМ. Допустимые значения: `on`, которая включает аудио воспроизведение и `off`, которая выключает аудио воспроизведение. Значение по умолчанию `off`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать как предоставить общий доступ к буферам обмена хост ОС или гостевой ОС

Команда `VBoxManage controlvm имя-ВМ clipboard mode` задает как предоставить общий доступ к буферам обмена гостевой системы или хоста хост-системе или ВМ. Допустимые значения: `disabled`, `hosttoguest`, `guesttohost` и `bidirectional`. Значение по умолчанию `disabled`. Смотрите .

Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, установленных в ВМ.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать режим Drag and Drop между хост-системой и виртуальной машиной

Команда `VBoxManage controlvm имя-ВМ draganddrop` Задает текущий режим drag and drop, используемый между хост-системой и ВМ. Допустимые значения: `disabled`, `hosttoguest`, `guesttohost` и `bidirectional`. Значение по умолчанию `disabled`. Смотрите .

Этот функционал требует наличия Дополнений Гостевой ОС &product-name;, установленных в ВМ.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Включить или выключить VRDE сервер

Команда `VBoxManage controlvm имя-ВМ vrde` включает или выключает сервер Расширения Удаленного Рабочего Стола VirtualBox (VRDE), если он установлен. Допустимые значения: `on` и `off`. Значение по умолчанию `off`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать порты VRDE сервера

Команда `VBoxManage controlvm имя-ВМ vrdeport` задает порт или диапазон портов к которым VRDE сервер может подключиться. Значение по умолчанию `default` или `0`, который обозначает стандартный RDP порт `3389`.

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

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать номера портов и IP адреса VRDE сервера

Команда `VBoxManage controlvm имя-ВМ vrdeproperty` указывает номера портов и IP адрес в ВМ, к которым может подключиться VRDE сервер.

Эта команда не влияет прямо на состояние выполнения ВМ.

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

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

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

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

- `VideoChannel/Enabled` позволяет подключить видеоканал Протокола Удаленного Рабочего Стола (VRDP). Допустимые значения `1` для включения видеоканала и `0` для выключения. Значение по умолчанию `0`. Смотрите .

- `VideoChannel/Quality` указывает уровень сжатия JPEG в видеоканале сервера VRDE. Допустимые значения между 10% и 100% включительно. Меньшие значения подразумевают худшее качество, но более высокое сжатие. Значение по умолчанию `100`. Смотрите .

- `VideoChannel/DownscaleProtection` позволяет подключить функцию защиты от уменьшения масштаба видеоканала. Укажите `1` для включения. По умолчанию выключено.

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

- `Client/DisableDisplay` позволяет отключить функцию отображения сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Значение по умолчанию null. Смотрите .

- `Client/DisableInput` позволяет отключить функцию ввода сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Значение по умолчанию `1`. Смотрите .

- `Client/DisableAudio` позволяет отключить функцию аудио сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Значение по умолчанию `1`. Смотрите .

- `Client/DisableUSB` позволяет отключить функцию USB сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Значение по умолчанию `1`. Смотрите .

- `Client/DisableClipboard` позволяет отключить функцию буфера обмена сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Используйте `Client/DisableClipboard=` для включения этой функции. Значение по умолчанию `1`. Смотрите .

- `Client/DisableUpstreamAudio` позволяет отключить функцию загрузки аудио на сервер VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Используйте `Client/DisableUpstreamAudio=` для включения этой функции. Значение по умолчанию `1`. Смотрите .

- `Client/DisableRDPDR` позволяет отключить функцию Перенаправления Устройств RDP Для Смарт-Карт сервера VRDE. Допустимые значения `1`, отключающее функцию и null (`""`), включающую эту функцию. Значение по умолчанию `1`. Смотрите .

- `H3DRedirect/Enabled` позволяет включить функцию Перенаправления 3D сервера VRDE. Допустимые значения `1`, включающее функцию и null (`""`), отключающую эту функцию. Смотрите .

- `Security/Method` указывает метод безопасности, используемый для подключения. Смотрите .

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

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

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

- `Security/ServerCertificate` указывает абсолютный путь к сертификату сервера, используемому в подключении. Смотрите .

- `Security/ServerPrivateKey` указывает абсолютный путь к приватному ключу сервера. Смотрите .

- `Security/CACertificate` указывает абсолютный путь к корневому самоподписанному сертификату. Смотрите .

- `Audio/RateCorrectionMode` указывает используемый режим коррекции битрейта.

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

  - `VRDP_AUDIO_MODE_RC` указывает, что надо использовать режим коррекции скорости.

  - `VRDP_AUDIO_MODE_LPF` указывает, что надо использовать режим НЧ фильтра.

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

- `Audio/LogPath` указывает абсолютный путь к файлу журнала аудио.

### Указать качество изображения для перенаправления видео VRDP

Команда `VBoxManage controlvm имя-ВМ vrdevideochannelquality` задает качество изображения как значение уровня сжатия JPEG для перенаправления видео. Допустимые значения между 10% и 100% включительно. Меньшие значения подразумевают худшее качество, но более высокое сжатие. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

### Указать режим видео для гостевой ВМ

Команда `VBoxManage controlvm имя-ВМ setvideomodehint` задает используемый режим видео для гостевой ВМ. У вас должны быть установлены Дополнения Гостевой ОС. Заметим, что данная функция работает не для всех гостевых систем.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать макет экрана для монитора в гостевой ВМ

Команда `VBoxManage controlvm имя-ВМ setscreenlayout` может быть использована для настройки ВМ с несколькими мониторами. Указанный экран гостевой ВМ может быть включен или отключен или может быть настроен пользовательский макет экрана.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Сделать снимок экрана с монитора виртуальной машины

Команда `VBoxManage controlvm имя-ВМ screenshotpng` делает снимок экрана с монитора гостевой системы и сохраняет его в формате PNG в указанном файле.

Эта команда не влияет прямо на состояние выполнения ВМ.

- имя-файла задает имя создаваемого PNG файла.

- монитор задает номер монитора откуда сделать снимок. Для ВМ с единственным монитором это значение `0`.

### Запись сессии виртуальной машины

Команда `VBoxManage controlvm имя-ВМ recording` включает или выключает запись сессии ВМ в WebM/VP8 файл. Допустимые значения `on`, которое начинает запись, когда стартует сессия ВМ и `off`, отключающее запись. Значение по умолчанию `off`.

Эта команда не влияет прямо на состояние выполнения ВМ.

Команда `VBoxManage controlvm имя-ВМ recording start` запускает запись сессии ВМ в WebM/VP8 файл.

Команда `VBoxManage controlvm имя-ВМ recording stop` останавливает запись сессии ВМ.

Команда `VBoxManage controlvm имя-ВМ recording attach` подключается к запущенной записи сессии ВМ.

Команда `VBoxManage controlvm имя-ВМ recording screens` позволяет задать экран ВМ для записи. Запись для каждого указанного вами экрана сохраняется в отдельный файл в папке машины. Нельзя изменять эту настройку пока запись включена.

Эта команда не влияет прямо на состояние выполнения ВМ.

- `all` указывает, что записывать все экраны ВМ.

- `none` указывает, что не надо записывать экраны.

- ID-экрана задает один или больше экранов ВМ для записи.

Команда `VBoxManage controlvm имя-ВМ recording filename` задает файл для сохранения записанной сессии. Нельзя изменять эту настройку пока запись включена.

По умолчанию запись сохраняется в файл, находящийся в папке машины, с именем ВМ в качестве имени файла и расширением `webm`.

Эта команда не влияет прямо на состояние выполнения ВМ.

Команда `VBoxManage controlvm имя-ВМ recording videores` задает разрешение записанного видео в пикселах. Нельзя изменять эту настройку пока включена запись.

Используйте инструмент Настройки для отображения настроек записи видео, основанных на разрешении (размере кадра). Смотрите поле Размер Кадра во вкладке Запись страницы Монитор для просмотра значения по умолчанию.

Эта команда не влияет прямо на состояние выполнения ВМ.

Разрешение задается в виде ширина `x` высота:

- ширина задает ширину в пикселах.

- высота задает высоту в пикселах.

Команда `VBoxManage controlvm имя-ВМ recording videorate` задает битрейт видео в килобит в секунду. Увеличение этого значения улучшает качество видео за счет увеличения размера файла. Нельзя изменять это значение пока включена запись.

Используйте инструмент Настройки для отображения настроек записи видео, основанных на размере кадра. Смотрите поле Качество Видео вкладки Запись страницы Монитор для просмотра значения по умолчанию.

Эта команда не влияет прямо на состояние выполнения ВМ.

Команда `VBoxManage controlvm имя-ВМ recording videofps` задает максимальную частоту видео для записи. Частота видео измеряется в кадрах в секунду (FPS). Запись пропускает кадры, имеющие частоту выше, чем указанный максимум. Увеличение частоты уменьшает количество пропущенных кадров и увеличивает размер файла. Нельзя изменять эту настройку пока включена запись.

Используйте инструмент Настройки для отображения настроек записи видео, основанных на размере кадра. Смотрите поле Частота Кадров во вкладке Запись страницы Монитор для просмотра значения по умолчанию.

Эта команда не влияет прямо на состояние выполнения ВМ.

Команда `VBoxManage controlvm имя-ВМ recording maxtime` задает максимальное время записи в секундах. Запись останавливается по прошествии заданного количества секунд. Если это значение равно нулю, запись продолжается пока не будет остановлена принудительно.

Эта команда не влияет прямо на состояние выполнения ВМ.

Команда `VBoxManage controlvm имя-ВМ recording maxfilesize` задает максимальный размер записанного видео в мегабайтах. Запись останавливается когда файл достигает заданного размера. Если это значение равно нулю, запись продолжается пока не будет остановлена принудительно. Нельзя изменять эту настройку пока включена запись.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Задать учетные данные для удаленного входа в виртуальные машины Windows

Команда `setcredentials` позволяет задать учетные данные для удаленного входа в Windows ВМ. Смотрите .

Эта команда не влияет прямо на состояние выполнения ВМ.

- имя-пользователя задает имя пользователя под которым необходимо производить вход в Windows ВМ.

- Опция `--passwordfile=имя-файла` задает файл откуда брать пароль для имя-пользователя.

  Опция `--passwordfile` взаимоисключающая с опцией `--password`.

- Опция `--password=пароль` задает пароль для имя-пользователя.

  Такой дизайн не соответствует рекомендациям Oracle по безопасности. Вы не должны указывать пароль в командной строке, потому что он может быть виден в списке процессов.

  Опция `--password` взаимоисключающая с опцией `--passwordfile`.

- Опция `--allowlocallogon` позволяет включать или отключать локальные входы. Допустимые значения `on` для включения локальных входов и `off` для отключения.

### Добавить виртуальный ЦПУ в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ plugcpu` добавляет виртуальный ЦПУ в указанную ВМ если горячее подключение ЦПУ включено. ID задает индекс добавляемого виртуального ЦПУ и он должен быть в диапазоне от 0 до максимального количества настроенных ЦПУ.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Удалить виртуальный ЦПУ из виртуальной машины

Команда `VBoxManage controlvm имя-ВМ unplugcpu` удаляет виртуальный ЦПУ из указанной ВМ если горячее подключение ЦПУ включено. ID задает индекс удаляемого виртуального ЦПУ и он должен быть в диапазоне от 0 до максимального количества настроенных ЦПУ. Нельзя удалить ЦПУ 0.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Установить максимальное время физического ЦПУ, используемого виртуальным ЦПУ

Команда `VBoxManage controlvm имя-ВМ cpuexecutioncap` задает максимальное количество времени физического ЦПУ используемого виртуальным ЦПУ. Допустимые значения - это процент между `1` и `100`. Значение `50` указывает, что единственный виртуальный ЦПУ может использовать до 50% физического ЦПУ. По умолчанию установлено `100`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Изменить приоритет процесса ВМ

Команда `VBoxManage controlvm имя-ВМ vm-process-priority` задает схему приоритета процесса ВМ используемую при старте и работе ВМ.

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

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

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

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

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

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

Эта команда не влияет прямо на состояние выполнения ВМ.

### Подключить вебкамеру к виртуальной машине

Команда `VBoxManage controlvm имя-ВМ webcam attach` подключает вебкамеру к работающей ВМ. Задайте вебкамеру через абсолютный путь к камере в ОС хоста или через псевдоним. Используйте команду `VBoxManage list webcams` для получения псевдонимов вебкамер.

Обратите внимание, что псевдоним `.0` - это устройство получения видео по умолчанию в ОС хоста. `.1` - это первое устройство получения видео, `.2` - второе, и т.д. Порядок устройств зависит от системы хоста.

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

Поддерживаются следующие настройки:

`MaxFramerate`

  Задает максимальную частоту кадров с которой видео отправляется в ВМ. Задается в кадрах в секунду. Более высокие значения увеличивают нагрузку на ЦПУ, так что этот параметр можно использовать для уменьшения нагрузки на ЦПУ. Значение по умолчанию - `no maximum limit`. Это значение позволяет ВМ использовать любую частоту кадров, поддерживаемую вебкамерой.

`MaxPayloadTransferSize`

  Задает максимальное количество байтов, принимаемого ВМ из эмулируемой камеры в одном буфере. Значение по умолчанию - `3060` байт, используемое некоторыми вебкамерами. Если ВМ способна использовать буферы большего размера, это может немного уменьшить нагрузку на ЦПУ. Заметим, что некоторые гостевые ОС могу не поддерживать более высокие значения `MaxPayloadTransferSize`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Отключить вебкамеру от виртуальной машины

Команда `VBoxManage controlvm имя-ВМ webcam detach` отключает вебкамеру от работающей ВМ. Задайте вебкамеру через абсолютный путь к камере в ОС хоста или через псевдоним. Используйте команду `VBoxManage list webcams` для получения псевдонимов вебкамер.

Когда вебкамера отключается от хоста, ОС хоста определяет поведение эмулируемой вебкамеры.

- Хосты Windows: Устройство эмулируемой вебкамеры отключается от ВМ автоматически.

- Хосты Mac OS X, которые работают по крайней мере под OS X 10.7: Устройство эмулируемой вебкамеры остается подключенным к ВМ. Его необходимо отключить вручную, используя команду `VBoxManage controlvm webcam detach`.

- Хосты Linux: Устройство эмулируемой вебкамеры отключается от ВМ автоматически только если вебкамера активно транслирует видео. Если эмулируемая камера не активна, необходимо отключить ее вручную, используя команду `VBoxManage controlvm имя-ВМ webcam detach`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Отобразить вебкамеры, подключенные к виртуальной машине

Команда `VBoxManage controlvm имя-ВМ webcam list` показывает вебкамеры, подключенные к работающей ВМ. Вывод отображает список абсолютных путей или псевдонимов подключенных к ВМ вебкамер, используя команду `VBoxManage controlvm имя-ВМ webcam attach`.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Передать пароль шифрования в виртуальную машину

Команда `VBoxManage controlvm имя-ВМ addencpassword` обеспечивает шифрованную ВМ имя-ВМ паролем шифрования для возможности старта в фоновом режиме. Укажите абсолютный путь к файлу с паролем в хост-системе. Если вместо имя-файла указан `-`, `VBoxManage` предложит ввести пароль.

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

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

Можно шифровать данные, хранящиеся в образах жестких дисков, испольуемых ВМ. &product-name; использует алгоритм AES в режиме XTS и поддерживает 128 и 256 битные ключи шифрования данных (DEK). Зашифрованный DEK хранится в свойствах носителя и расшифровывается при старте ВМ когда вы передаете пароль шифрования.

Используйте команду `VBoxManage encryptmedium` для создания носителя зашифрованного DEK. Смотрите .

Графический интерфейс &product-name; предложит ввести пароль шифрования при старте зашифрованной ВМ.

Используйте следующую команду для старта в фоновом режиме зашифрованной ВМ:

              $ VBoxManage startvm имя-ВМ --type headless

Затем, используйте следующую команду для передачи пароля шифрования:

              $ VBoxManage имя-ВМ controlvm addencpassword имя-ВМ -
              Пароль: пароль-шифрования

Эта команда не влияет прямо на состояние выполнения ВМ.

### Отозвать пароль шифрования из виртуальной машины

Команда `VBoxManage controlvm имя-ВМ removeencpassword` отзывает указанный пароль шифрования для всех зашифрованных носителей, подключенных к ВМ.

ID - идентификатор пароля, который вы хотите отозвать.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Отозвать все пароли шифрования из виртуальной машины

Команда `VBoxManage controlvm имя-ВМ removeallencpasswords` отзывает все пароли шифрования для всех зашифрованных носителей подключенных к ВМ.

Эта команда не влияет прямо на состояние выполнения ВМ.

### Изменить режим подключения виртуального последовательного порта в виртуальной машине

Команда `VBoxManage controlvm имя-ВМ changeuartmode` изменяет режим подключения для указанного виртуального последовательного порта. Допустимые значения последовательного порта - это числа, начинающиеся с `1`.

Эта команда не влияет прямо на состояние выполнения ВМ.

disconnected

  Отключает устройство.

server имя-канала

  Указывает имя канала сервера.

client имя-канала

  Указывает имя канала клиента.

tcpserver порт

  Указывает номер порта сервера TCP.

tcpclient имя-хоста:порт

  Указывает имя хоста и номер порта клиента TCP.

file имя-файла

  Указывает имя файла.

имя-устройства

  Указывает имя устройства.

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

Команда `VBoxManage controlvm имя-ВМ autostart-enabled` указывает включить или отключить автоматический старт ВМ во время загрузки хост-системы. Вы должны произвести некоторую настройку хост-системы перед тем как вы сможете использовать данный функционал. Смотрите . Допустимые значения `on`, включающую функцию автостарта для ВМ и `off`, отключающую ее. Значение по умолчанию `off`.

### Установить задержку старта ВМ во время загрузки хост-системы

Команда `VBoxManage controlvm имя-ВМ autostart-delay` задает задержку в секундах перед тем, как ВМ будет запущена во время загрузки хост-системы. Смотрите .

## Примеры

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

    $ VBoxManage controlvm ol7 pause

Следующая команда настраивает операции буфера обмена для ВМ `ol7`. Копирование данных буфера обмена разрешено в обоих направлениях между хостом и гостевой системой.

    $ VBoxManage controlvm ol7 clipboard mode bidirectional

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

, ,