Product SiteDocumentation Site

40.3. Управление ВМ с помощью qm

Если веб-интерфейс PVE недоступен, можно управлять ВМ в командной строке (используя сеанс SSH, из консоли noVNC, или зарегистрировавшись на физическом хосте).
qm — это инструмент для управления ВМ Qemu/KVM в PVE. Утилиту qm можно использовать для создания/удаления ВМ, для управления работой ВМ (запуск/остановка/приостановка/возобновление), для установки параметров в соответствующем конфигурационном файле, а также для создания виртуальных дисков.
qm <КОМАНДА> [АРГУМЕНТЫ] [ОПЦИИ]
Чтобы просмотреть доступные для управления ВМ команды можно выполнить следующую команду:
# qm help
В таблице Команды qm приведены описания команд qm.

Таблица 40.1. Команды qm

Команда
Описание
qm agent
Пвсевдоним для qm guest cmd
qm block <vmid>
Заблокировать ВМ.
  • vmid — идентификатор ВМ.
qm cleanup <vmid> <clean-shutdown> <guest-requested>
Очищает ресурсы, такие как сенсорные устройства, vgpu и т.д. Вызывается после выключения, сбоя ВМ и т. д.
  • vmid — идентификатор ВМ (100 — 999999999);
  • clean-shutdown — указывает, корректно ли была завершена работа qemu;
  • guest-requested — указывает, было ли завершение работы запрошено гостем или через qmp.
qm clone <vmid> <newid> [ОПЦИИ]
Создать копию ВМ/шаблона.
  • vmid — идентификатор ВМ (100 — 999999999);
  • newid — VMID для клона (100 — 999999999);
  • --bwlimit <целое число> — переопределить ограничение пропускной способности ввода-вывода (в КиБ/с) (0–N);
  • --description <строка> — описание новой ВМ;
  • --format <qcow2 | raw | vmdk> — целевой формат хранения файлов (действительно только для полного клона);
  • --full <логическое значение> — создать полную копию всех дисков (используется по умолчанию при клонировании ВМ). Для шаблонов ВМ по умолчанию пытается создать связанный клон;
  • --name <строка> — имя новой ВМ;
  • --pool <строка> — пул, в который будет добавлена ВМ;
  • --snapname <строка> — имя снимка;
  • --storage <строка> — целевое хранилище для полного клона;
  • --target <строка> — целевой узел (доступно в случае, если исходная ВМ находится в общем хранилище).
qm cloudinit dump <vmid> <type>
Получить автоматически сгенерированную конфигурацию cloud-init.
  • vmid — идентификатор ВМ;
  • type — тип конфигурации (meta | network | user).
qm cloudinit pending <vmid>
Получить конфигурацию cloud-init с текущими и ожидающими значениями.
  • vmid — идентификатор ВМ.
qm cloudinit update <vmid>
Восстановить и изменить диск конфигурации cloud-init.
  • vmid — идентификатор ВМ.
qm config <vmid> <ОПЦИИ>
Вывести конфигурацию ВМ с применёнными ожидающими изменениями конфигурации. Для вывода текущей конфигурации следует указать параметр current.
  • vmid — идентификатор ВМ;
  • --current <логическое значение> — вывести текущие значения вместо ожидающих (по умолчанию 0);
  • --snapshot <строка> — вывести значения конфигурации из данного снимка.
qm create <vmid> <ОПЦИИ>
Создать или восстановить ВМ.
Некоторые опции:
  • vmid — идентификатор ВМ;
  • --acpi <логическое значение> — включить/отключить ACPI (по умолчанию 1);
  • --affinity <строка> — список ядер хоста, используемых для выполнения гостевых процессов, например: 0,5,8-11;
  • --agent [enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>] — включить/отключить связь с гостевым агентом QEMU;
  • --arch <aarch64 | x86_64> — архитектура виртуального процессора;
  • --archive <строка> — создать ВМ из архива. Указывается либо путь к файлу .tar или .vma, либо идентификатор тома резервной копии хранилища PVE;
  • --args <строка> — передача произвольных аргументов в KVM;
  • --audio0 device=<ich9-intel-hda|intel-hda|AC97>[,driver=<spice|none>] — настройка аудиоустройства;
  • --balloon <целое число> — объём целевой оперативной памяти для ВМ в МиБ (0 отключает Balloon Driver);
  • --bios <ovmf | seabios> — реализация BIOS (по умолчанию seabios);
  • --boot [order=<устройство[;устройство...]>] — порядок загрузки ВМ;
  • --bwlimit <целое число> — переопределить ограничение пропускной способности ввода-вывода (в КиБ/с);
  • --cdrom <volume> — псевдоним опции ide2;
  • --cicustom [meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>] — cloud-init: указать пользовательские файлы для замены автоматически созданных;
  • --cipassword <пароль> — cloud-init: пароль для пользователя. Рекомендуется использовать ключи SSH вместо пароля;
  • --citype <configdrive2 | nocloud | opennebula> — формат конфигурации cloud-init;
  • --ciupgrade <логическое значение> — cloud-init: выполнить автоматическое обновление пакета после первой загрузки (по умолчанию 1);
  • --ciuser <строка> — cloud-init: имя пользователя для изменения пароля и ключей SSH вместо настроенного пользователя по умолчанию;
  • --cores <целое число> — количество ядер на сокет (по умолчанию 1);
  • --cpu <тип> — эмулируемый тип процессора;
  • --cpulimit <целое число (0–128)> — ограничение использования процессора (по умолчанию 0);
  • --cpuunits <целое число (1–262144)> — вес ЦП для ВМ будет ограничен значением [1, 10000] в cgroup v2 (по умолчанию cgroup v1: 1024, cgroup v2: 100);
  • --description <строка> — описание ВМ;
  • --efidisk0 [file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,import-from=<source volume>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>] — диск для хранения переменных EFI;
  • --force <логическое значение> — разрешить перезапись существующей ВМ (требуется опция --archive);
  • --freeze <логическое значение> — заморозить процессор при запуске;
  • --hookscript <строка> — описание ВМ;
  • --ipconfig[n] [gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] — cloud-init: указать IP-адрес и шлюз для соответствующего интерфейса;
  • --kvm <логическое значение> — включить/отключить аппаратную виртуализацию KVM (по умолчанию 1);
  • --live-restore <логическое значение> — запустить ВМ из резервной копии и восстановить её в фоновом режиме (только PBS). Требуется опция --archive;
  • --localtime <логическое значение> — установите часы реального времени (RTC) на местное время;
  • --lock <backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending> — заблокировать/разблокировать ВМ;
  • --machine <тип> — тип машины QEMU;
  • --memory [current=]<целое число> — свойства памяти;
  • --migrate_downtime <число> — максимально допустимое время простоя (в секундах) для миграции (по умолчанию 0,1);
  • --migrate_speed <целое число> — максимальная скорость (в МБ/с) для миграции (по умолчанию 0 — не ограничивать скорость);
  • --name <строка> — имя ВМ;
  • --nameserver <строка> — cloud-init: устанавливает IP-адрес DNS-сервера для контейнера;
  • --net <сеть> — сетевые устройства;
  • --numa <логическое значение> — включить/отключить NUMA (по умолчанию 0);
  • --numa[n] <топология> — топология NUMA;
  • --onboot <логическое значение> — запускать ВМ во время загрузки системы (по умолчанию 0);
  • --ostype <l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp> — гостевая ОС;
  • --pool <строка> — добавить ВМ в указанный пул;
  • --protection <логическое значение> — установить флаг защиты ВМ (по умолчанию 0). Флаг защиты отключит возможность удаления ВМ и удаления дисковых операций;
  • --reboot <логическое значение> — разрешить перезагрузку (по умолчанию 1). Если установлено значение 0, ВМ завершит работу при перезагрузке;
  • --rng0 [source=] </dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<целое число>] [,period=<целое число>] — настройть генератор случайных чисел на основе VirtIO;
  • --sata[n] <описание> — использовать в качестве жёсткого диска SATA или компакт-диск (n от 0 до 5). Чтобы выделить новый том используется синтаксис STORAGE_ID:SIZE_IN_GiB. Для импорта из существующего тома используется STORAGE_ID:0 и параметр import-from;
  • --scsi[n] <описание> — использовать в качестве жёсткого диска SCSI или компакт-диск (n от 0 до 30). Чтобы выделить новый том используется синтаксис STORAGE_ID:SIZE_IN_GiB. Для импорта из существующего тома используется STORAGE_ID:0 и параметр import-from;
  • --scsihw <lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single> — модель контроллера SCSI (по умолчанию lsi);
  • searchdomain <строка> — cloud-init: устанавить домены поиска DNS для контейнера;
  • serial[n] (/dev/.+|socket) — последовательное устройство внутри ВМ (n от 0 до 3);
  • --shares <целое число (0–50000)> — объем разделяемой памяти (по умолчанию 1000);
  • --sockets <целое число> — количество сокетов процессора (по умолчанию 1);
  • --spice_enhancements [foldersharing=<1|0>] [,videostreaming=<off|all|filter>] — настройки для SPICE;
  • --sshkeys <путь к файлу> — cloud-init: настройка общедоступных ключей SSH (по одному ключу в строке, формат OpenSSH).;
  • --start <логическое значение> — запустить ВМ после создания (по умолчанию 0);
  • --startup `[[порядок=]\d+] [,up=\d+] [,down=\d+] ` — поведение при запуске и выключении. Порядок — неотрицательное число, определяющее общий порядок запуска. Выключение выполняется в обратном порядке. up/down — задержка включения/выключения в секундах;
  • --storage <строка> — хранилище;
  • --tablet <логическое значение> — включить/отключить USB-планшет (по умолчанию 1);
  • --tags <строка> — теги ВМ;
  • --template <логическое значение> — включить/отключить шаблон (по умолчанию 0);
  • --tpmstate0 <диск> — настроить диск для хранения состояния TPM. Формат фиксированный — raw;
  • --unique <логическое значение> — назначить уникальный случайный адрес Ethernet;
  • --usb[n] [[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>] — настройка USB-устройства (n — от 0 до 4, для версии машины >= 7.1 и ostype l26 или windows > 7, n может достигать 14);
  • --vcpus <целое число> — количество виртуальных процессоров с горячим подключением;
  • --vga [[type=]<enum>] [,clipboard=<vnc>] [,memory=<целое число>] — настройка VGA;
  • virtio[n] <описание> — использовать жёсткий диск VIRTIO (n от 0 до 15);
  • vmgenid <UUID> — установить идентификатор поколения ВМ (по умолчанию 1 — генерировать автоматически);
  • --vmstatestorage <строка>  — хранилище по умолчанию для томов/файлов состояния ВМ;
  • --watchdog [[model=]<i6300esb|ib700>] [,action=<enum>]  — создать сторожевое устройство виртуального оборудования.
qm delsnapshot <vmid> <snapname> <ОПЦИИ>
Удалить снимок ВМ.
  • vmid — идентификатор ВМ;
  • snapshot — имя снимка;
  • --force <логическое значение> — удалить из файла конфигурации, даже если удаление снимков диска не удалось.
qm destroy <vmid> [ОПЦИИ]
Уничтожить ВМ и все её тома (будут удалены все разрешения, специфичные для ВМ).
  • vmid — идентификатор ВМ;
  • --destroy-unreferenced-disks <логическое значение> — дополнительно уничтожить все диски, не указанные в конфигурации, но с совпадающим VMID из всех включенных хранилищ (по умолчанию 0);
  • --purge <логическое значение> — удалить VMID из конфигураций резервного копирования и высокой доступности;
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root).
qm disk import <vmid> <source> <storage>[ОПЦИИ]
Импортировать образ внешнего диска в неиспользуемый диск ВМ. Формат образа должен поддерживаться qemu-img.
  • vmid — идентификатор ВМ;
  • source — путь к образу диска;
  • storage — идентификатор целевого хранилища;
  • --format <qcow2 | raw | vmdk> — целевой формат.
qm disk move <vmid> <disk> <storage> [ОПЦИИ]
Переместить том в другое хранилище или в другую ВМ.
  • vmid — идентификатор ВМ;
  • disk — диск, который необходимо переместить (например, scsi1);
  • storage — целевое хранилище;
  • --bwlimit <целое число> — переопределить ограничение пропускной способности ввода-вывода (в КиБ/с);
  • --delete <логическое значение> — удалить исходный диск после успешного копирования. По умолчанию исходный диск сохраняется как неиспользуемый (по умолчанию 0);
  • --digest <строка> — запретить изменения, если текущий файл конфигурации имеет другой SHA1 дайджест (можно использовать для предотвращения одновременных изменений);
  • --format <qcow2 | raw | vmdk> — целевой формат;
  • --target-digest <строка> — запретить изменения, если текущий файл конфигурации целевой ВМ имеет другой SHA1 дайджест (можно использовать для обнаружения одновременных модификаций);
  • --target-disk <efidisk0 | ide0 | ide1| …| virtio9 > — ключ конфигурации, в который будет перемещен диск на целевой ВМ (например, ide0 или scsi1). По умолчанию используется ключ исходного диска;
  • --target-vmid <целое число> — идентификатор целевой ВМ.
qm disk rescan [ОПЦИИ]
Пересканировать все хранилища и обновить размеры дисков и неиспользуемые образы дисков.
  • --dryrun <логическое значение> — не записывать изменения в конфигурацию ВМ (по умолчанию 0);
  • --vmid <целое число> — идентификатор ВМ.
qm disk resize <vmid> <disk> <size> [ОПЦИИ]
Увеличить размер диска.
  • vmid — идентификатор ВМ;
  • disk — диск, размер которого необходимо увеличить (например, scsi1);
  • size — новый размер. Со знаком «+» значение прибавляется к фактическому размеру тома, а без него значение принимается как абсолютное. Уменьшение размера диска не поддерживается;
  • --digest <строка> — запретить изменения, если текущий файл конфигурации имеет другой SHA1 дайджест (можно использовать для предотвращения одновременных изменений);
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root).
qm disk unlink <vmid> --idlist <строка> [ОПЦИИ]
Отсоединить/удалить образы дисков.
  • vmid — идентификатор ВМ;
  • --idlist <строка> — список идентификаторов дисков, которые необходимо удалить;
  • --force <логическое значение> — принудительное физическое удаление (иначе диск будет удалён из файла конфигурации и будет создана дополнительная запись конфигурации с именем unused[n], которая содержит идентификатор тома).
qm guest cmd <vmid> <команда>
Выполнить команды гостевого агента QEMU.
  • vmid — идентификатор ВМ;
  • команда — команда QGA (fsfreeze-freeze | fsfreeze-status | fsfreeze-thaw | fstrim | get-fsinfo | get-host-name | get-memory-block-info | get-memory-blocks | get-osinfo | get-time | get-timezone | get-users | get-vcpus | info | network-get-interfaces | ping | shutdown | suspend-disk | suspend-hybrid | suspend-ram).
qm guest exec <vmid> [<extra-args>] [ОПЦИИ]
Выполнить данную команду через гостевой агент.
  • vmid — идентификатор ВМ;
  • extra-args — дополнительные аргументы в виде массива;
  • --pass-stdin <логическое значение> — если установлено, читать STDIN до EOF и пересылать гостевому агенту через входные данные (по умолчанию 0). Допускается максимум 1 МБ;
  • --synchronous <логическое значение> — если установлено значение 0, возвращает pid немедленно, не дожидаясь завершения команды или тайм-аута (по умолчанию 1);
  • --timeout <целое число> — максимальное время синхронного ожидания завершения команды. Если достигнуто, возвращается pid. Для отключения следует установить значение 0 (по умолчанию 30).
qm guest exec-status <vmid> <pid>
Получить статус данного pid, запущенного гостевым агентом.
  • vmid — идентификатор ВМ;
  • pid — PID для запроса.
qm guest passwd <vmid> <username> [ОПЦИИ]
Установить пароль для данного пользователя.
  • vmid — идентификатор ВМ;
  • username — пользователь, для которого устанавливается пароль;
  • crypted <логическое значение> — если пароль уже был передан через crypt(), следует установить значение 1 (по умолчанию 0).
qm help [extra-args] [ОПЦИИ]
Показать справку по указанной команде.
  • extra-args — показать справку по конкретной команде;
  • --verbose <логическое значение> — подробный формат вывода.
qm importdisk
Псевдоним для qm disk import.
qm importovf <vmid> <manifest> <storage> [ОПЦИИ]
Создать новую ВМ, используя параметры, считанные из манифеста OVF.
  • vmid — идентификатор ВМ;
  • manifest — путь до файла ovf;
  • storage — идентификатор целевого хранилища;
  • --format <qcow2 | raw | vmdk> — целевой формат.
qm list [ОПЦИИ]
Вывести список ВМ узла.
  • --full <логическое значение> — определить полный статус активных ВМ.
qm listsnapshot <vmid>
Вывести список снимков ВМ.
  • vmid — идентификатор ВМ;
qm migrate <vmid> <target> [ОПЦИИ]
Перенос ВМ. Создаёт новую задачу миграции.
  • vmid — идентификатор ВМ;
  • target — целевой узел;
  • --bwlimit <целое число> — переопределить ограничение пропускной способности ввода-вывода (в КиБ/с);
  • --force <логическое значение> — разрешить миграцию ВМ, использующих локальные устройства (может использовать только root);
  • --migration_network <строка> — CIDR (под)сети, которая используется для миграции;
  • --migration_type <insecure | secure> — трафик миграции по умолчанию шифруется с использованием SSH-туннеля. В безопасных сетях эту функцию можно отключить для повышения производительности;
  • --online <логическое значение> — использовать онлайн-/живую миграцию, если ВМ запущена (игнорируется, если ВМ остановлена);
  • --targetstorage <строка> — сопоставление исходных и целевых хранилищ. Предоставление только одного идентификатора хранилища сопоставляет все исходные хранилища с этим хранилищем. Если указать специальное значение 1, каждое исходное хранилище будет сопоставлено самому себе;
  • --online <логическое значение> — включить живую миграцию хранилища для локального диска.
qm monitor <vmid>
Войти в интерфейс монитора QEMU.
  • vmid — идентификатор ВМ.
qm move-disk
Псевдоним для qm disk move.
qm move_disk
Псевдоним для qm disk move.
qm nbdstop <vmid>
Остановить встроенный сервер NBD.
  • vmid — идентификатор ВМ.
qm pending <vmid>
Получить конфигурацию ВМ с текущими и ожидающими значениями.
  • vmid — идентификатор ВМ.
qm reboot <vmid> [ОПЦИИ]
Перезагрузить ВМ. Применяет ожидающие изменения.
  • vmid — идентификатор ВМ;
  • --timeout <целое число> — максимальное время ожидания для выключения.
qm remote-migrate <vmid> [<target-vmid>] <target-endpoint> --target-bridge <строка> --target-storage <строка> [ОПЦИИ]
Перенос ВМ в удалённый кластер. Создаёт новую задачу миграции. ЭКСПЕРИМЕНТАЛЬНАЯ функция!
  • vmid — идентификатор ВМ;
  • target-vmid — идентификатор целевой ВМ;
  • target-endpoint — удалённая целевая конечная точка apitoken=<API токен PVE, включая секретное значение> ,host=<имя или IP удалённого узла> [,fingerprint=<отпечаток сертификата удаленного хоста, если ему не доверяет системное хранилище>] [,port=<целое число>];
  • --bwlimit <целое число> — переопределить ограничение пропускной способности ввода-вывода (в КиБ/с);
  • --delete <логическое значение> — удалить исходную ВМ и связанные с ней данные после успешной миграции (по умолчанию 0). По умолчанию исходная ВМ остается в исходном кластере в остановленном состоянии;
  • --online <логическое значение> — использовать онлайн-/живую миграцию, если ВМ запущена (игнорируется, если ВМ остановлена);
  • --target-bridge <строка> — сопоставление исходных и целевых мостов. Предоставление только одного идентификатора моста сопоставляет все исходные мосты с этим мостом. Предоставление специального значения 1 сопоставит каждый исходный мост с самим собой;
  • --target-storage <строка> — сопоставление исходных и целевых хранилищ. Предоставление только одного идентификатора хранилища сопоставляет все исходные хранилища с этим хранилищем. Если указать специальное значение 1, каждое исходное хранилище будет сопоставлено самому себе;
  • --online <логическое значение> — включить живую миграцию хранилища для локального диска.
qm rescan
Псевдоним для qm disk rescan.
qm reset <vmid> [ОПЦИИ]
Сбросить ВМ.
  • vmid — идентификатор ВМ;
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root).
qm resize
Псевдоним для qm disk resize.
qm resume <vmid> [ОПЦИИ]
Возобновить работу ВМ.
  • vmid — идентификатор ВМ;
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root).
qm rollback <vmid> <snapname> [ОПЦИИ]
Откат состояния ВМ до указанного снимка.
  • vmid — идентификатор ВМ;
  • snapname — имя снимка;
  • --start <логическое значение> — запустить ВМ после отката (по умолчанию 0). ВМ будут запускаться автоматически, если снимок включает ОЗУ.
qm sendkey <vmid> <ключ> [ОПЦИИ]
Послать нажатия клавиш на ВМ.
  • vmid — идентификатор ВМ;
  • ключ — ключ (в кодировке qemu monitor, например, ctrl-shift);
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root).
qm set <vmid> [ОПЦИИ]
Установить параметры ВМ.
Некоторые опции:
  • vmid — идентификатор ВМ;
  • --acpi <логическое значение> — включить/отключить ACPI (по умолчанию 1);
  • --affinity <строка> — список ядер хоста, используемых для выполнения гостевых процессов, например: 0,5,8-11;
  • --agent [enabled=]<1|0> [,freeze-fs-on-backup=<1|0>] [,fstrim_cloned_disks=<1|0>] [,type=<virtio|isa>] — включить/отключить связь с гостевым агентом QEMU;
  • --arch <aarch64 | x86_64> — архитектура виртуального процессора;
  • --args <строка> — передача произвольных аргументов в KVM;
  • --audio0 device=<ich9-intel-hda|intel-hda|AC97>[,driver=<spice|none>] — настройка аудиоустройства;
  • --balloon <целое число> — объём целевой оперативной памяти для ВМ в МиБ (0 отключает Balloon Driver);
  • --bios <ovmf | seabios> — реализация BIOS (по умолчанию seabios);
  • --boot [order=<устройство[;устройство...]>] — порядок загрузки ВМ;
  • --cdrom <volume> — псевдоним опции ide2;
  • --cicustom [meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>] — cloud-init: указать пользовательские файлы для замены автоматически созданных;
  • --cipassword <пароль> — cloud-init: пароль для пользователя. Рекомендуется использовать ключи SSH вместо пароля;
  • --citype <configdrive2 | nocloud | opennebula> — формат конфигурации cloud-init;
  • --ciupgrade <логическое значение> — cloud-init: выполнить автоматическое обновление пакета после первой загрузки (по умолчанию 1);
  • --ciuser <строка> — cloud-init: имя пользователя для изменения пароля и ключей SSH вместо настроенного пользователя по умолчанию;
  • --cores <целое число> — количество ядер на сокет (по умолчанию 1);
  • --cpu <тип> — эмулируемый тип процессора;
  • --cpulimit <целое число (0–128)> — ограничение использования процессора (по умолчанию 0);
  • --cpuunits <целое число (1–262144)> — вес ЦП для ВМ будет ограничен значением [1, 10000] в cgroup v2 (по умолчанию cgroup v1: 1024, cgroup v2: 100);
  • --delete <строка> — список настроек, которые необходимо удалить;
  • --description <строка> — описание ВМ;
  • --digest <строка> — запретить изменения, если текущий файл конфигурации имеет другой дайджест SHA1 (можно использовать для предотвращения одновременных изменений);
  • --efidisk0 [file=]<volume> [,efitype=<2m|4m>] [,format=<enum>] [,import-from=<source volume>] [,pre-enrolled-keys=<1|0>] [,size=<DiskSize>] — диск для хранения переменных EFI;
  • --force <логическое значение> — разрешить перезапись существующей ВМ (требуется опция --archive);
  • --freeze <логическое значение> — заморозить процессор при запуске;
  • --hookscript <строка> — описание ВМ;
  • --hostpci[n] [описание] — сопоставить PCI-устройства хоста с гостевыми устройствами;
  • --ide[n] [описание] — использовать в качестве жёсткого диска IDE или компакт-диск (n от 0 до 3). Чтобы выделить новый том используется синтаксис STORAGE_ID:SIZE_IN_GiB. Для импорта из существующего тома используется STORAGE_ID:0 и параметр import-from;
  • --ipconfig[n] [gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] — cloud-init: указать IP-адрес и шлюз для соответствующего интерфейса;
  • --kvm <логическое значение> — включить/отключить аппаратную виртуализацию KVM (по умолчанию 1);
  • --localtime <логическое значение> — установите часы реального времени (RTC) на местное время;
  • --lock <backup | clone | create | migrate | rollback | snapshot | snapshot-delete | suspended | suspending> — заблокировать/разблокировать ВМ;
  • --machine <тип> — тип машины QEMU;
  • --memory [current=]<целое число> — свойства памяти;
  • --migrate_downtime <число> — максимально допустимое время простоя (в секундах) для миграции (по умолчанию 0,1);
  • --migrate_speed <целое число> — максимальная скорость (в МБ/с) для миграции (по умолчанию 0 — не ограничивать скорость);
  • --name <строка> — имя ВМ;
  • --nameserver <строка> — cloud-init: устанавливает IP-адрес DNS-сервера для контейнера;
  • --net <сеть> — сетевые устройства;
  • --numa <логическое значение> — включить/отключить NUMA (по умолчанию 0);
  • --numa[n] <топология> — топология NUMA;
  • --onboot <логическое значение> — запускать ВМ во время загрузки системы (по умолчанию 0);
  • --ostype <l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win10 | win11 | win7 | win8 | wvista | wxp> — гостевая ОС;
  • --protection <логическое значение> — установить флаг защиты ВМ (по умолчанию 0). Флаг защиты отключит возможность удаления ВМ и удаления дисковых операций;
  • --reboot <логическое значение> — разрешить перезагрузку (по умолчанию 1). Если установлено значение 0, ВМ завершит работу при перезагрузке;
  • --revert <строка> — отменить ожидающее изменение;
  • --rng0 [source=] </dev/urandom|/dev/random|/dev/hwrng> [,max_bytes=<целое число>] [,period=<целое число>] — настройть генератор случайных чисел на основе VirtIO;
  • --sata[n] <описание> — использовать в качестве жёсткого диска SATA или компакт-диск (n от 0 до 5). Чтобы выделить новый том используется синтаксис STORAGE_ID:SIZE_IN_GiB. Для импорта из существующего тома используется STORAGE_ID:0 и параметр import-from;
  • --scsi[n] <описание> — использовать в качестве жёсткого диска SCSI или компакт-диск (n от 0 до 30). Чтобы выделить новый том используется синтаксис STORAGE_ID:SIZE_IN_GiB. Для импорта из существующего тома используется STORAGE_ID:0 и параметр import-from;
  • --scsihw <lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single> — модель контроллера SCSI (по умолчанию lsi);
  • searchdomain <строка> — cloud-init: устанавить домены поиска DNS для контейнера;
  • serial[n] (/dev/.+|socket) — последовательное устройство внутри ВМ (n от 0 до 3);
  • --shares <целое число (0–50000)> — объем разделяемой памяти (по умолчанию 1000);
  • --skiplock <логическое значение> — игнорировать блокировки (только root может использовать эту опцию);
  • --sockets <целое число> — количество сокетов процессора (по умолчанию 1);
  • --spice_enhancements [foldersharing=<1|0>] [,videostreaming=<off|all|filter>] — настройки для SPICE;
  • --sshkeys <путь к файлу> — cloud-init: настройка общедоступных ключей SSH (по одному ключу в строке, формат OpenSSH).;
  • --startup `[[порядок=]\d+] [,up=\d+] [,down=\d+] ` — поведение при запуске и выключении. Порядок — неотрицательное число, определяющее общий порядок запуска. Выключение выполняется в обратном порядке. up/down — задержка включения/выключения в секундах;
  • --tablet <логическое значение> — включить/отключить USB-планшет (по умолчанию 1);
  • --tags <строка> — теги ВМ;
  • --template <логическое значение> — включить/отключить шаблон (по умолчанию 0);
  • --tpmstate0 <диск> — настроить диск для хранения состояния TPM. Формат фиксированный — raw;
  • --usb[n] [[host=]<HOSTUSBDEVICE|spice>] [,mapping=<mapping-id>] [,usb3=<1|0>] — настройка USB-устройства (n — от 0 до 4, для версии машины >= 7.1 и ostype l26 или windows > 7, n может достигать 14);
  • --vcpus <целое число> — количество виртуальных процессоров с горячим подключением;
  • --vga [[type=]<enum>] [,clipboard=<vnc>] [,memory=<целое число>] — настройка VGA;
  • --virtio[n] <описание> — использовать жёсткий диск VIRTIO (n от 0 до 15);
  • --vmgenid <UUID> — установить идентификатор поколения ВМ (по умолчанию 1 — генерировать автоматически);
  • --vmstatestorage <строка>  — хранилище по умолчанию для томов/файлов состояния ВМ;
  • --watchdog [[model=]<i6300esb|ib700>] [,action=<enum>]  — создать сторожевое устройство виртуального оборудования.
qm showcmd <vmid> [ОПЦИИ]
Показать командную строку, которая используется для запуска ВМ (информация для отладки).
  • vmid — идентификатор ВМ;
  • --pretty <логическое значение> — поместить каждый параметр на новой строке;
  • --snapshot <строка> — получить значения конфигурации из данного снимка.
qm shutdown <vmid> [ОПЦИИ]
Выключение ВМ (эмуляция нажатия кнопки питания). Гостевой ОС будет отправлено событие ACPI.
  • vmid — идентификатор ВМ;
  • --forceStop <логическое значение> — убедиться, что ВМ остановлена (по умолчанию 0);
  • --keepActive <логическое значение> — не деактивировать тома хранения (по умолчанию 0);
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root);
  • --timeout <целое число> — максимальный таймаут в секундах.
qm snapshot <vmid> <snapname> [ОПЦИИ]
Сделать снимок ВМ.
  • vmid — идентификатор ВМ;
  • snapname — имя снимка;
  • --description <строка> — описание или комментарий;
  • --vmstate <логическое значение> — сохранить vmstate.
qm start <vmid> [ОПЦИИ]
Запустить ВМ.
  • vmid — идентификатор ВМ;
  • --force-cpu <строка> — переопределить cpu QEMU заданной строкой;
  • --machine <тип> — указывает тип компьютера QEMU (например, pc+pve0);
  • --migratedfrom <строка> — имя узла кластера;
  • --migration_network <строка> — CIDR (под)сети, которая используется для миграции;
  • --migration_type <insecure | secure> — трафик миграции по умолчанию шифруется с использованием SSH-туннеля. В безопасных сетях эту функцию можно отключить для повышения производительности;
  • --keepActive <логическое значение> — не деактивировать тома хранения (по умолчанию 0);
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root);
  • --stateuri <строка> — некоторые команды сохраняют/восстанавливают состояние из этого места;
  • --targetstorage <строка> — сопоставление исходных и целевых хранилищ. Предоставление только одного идентификатора хранилища сопоставляет все исходные хранилища с этим хранилищем. Если указать специальное значение 1, каждое исходное хранилище будет сопоставлено самому себе;
  • --timeout <целое число> — максимальный таймаут в секундах (по умолчанию max(30, память ВМ в ГБ)).
qm status <vmid> [ОПЦИИ]
Показать статус ВМ.
  • vmid — идентификатор ВМ;
  • --verbose <логическое значение> — подробный вывод.
qm stop <vmid> [ОПЦИИ]
Останов ВМ (эмуляция выдергивания вилки). Процесс qemu немедленно завершается.
  • vmid — идентификатор ВМ;
  • --keepActive <логическое значение> — не деактивировать тома хранения (по умолчанию 0);
  • --migratedfrom <строка> — имя узла кластера;
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root);
  • --timeout <целое число> — максимальный таймаут в секундах.
qm suspend <vmid> [ОПЦИИ]
Приостановить ВМ.
  • vmid — идентификатор ВМ;
  • --skiplock <логическое значение> — игнорировать блокировки (может использовать только root);
  • --statestorage <строка>хранилище состояния ВМ (должна быть указана опция --todisk);
  • --todisk <логическое значение> — приостанавливает работу ВМ на диск. Будет возобновлено при следующем запуске ВМ (по умолчанию 0).
qm template <vmid> [ОПЦИИ]
Создать шаблон.
  • vmid — идентификатор ВМ;
  • --disk <диск> — если в базовый образ нужно преобразовать только один диск (например, sata1).
qm terminal <vmid> [ОПЦИИ]
Открыть терминал с помощью последовательного устройства (на ВМ должно быть настроено последовательное устройство, например, Serial0: Socket).
  • vmid — идентификатор ВМ;
  • --escape <строка> — escape-символ (по умолчанию ^O);
  • --iface <serial0 | serial1 | serial2 | serial3> — последовательное устройство (по умолчанию используется первое подходящее устройство).
qm unlink
Псевдоним для qm disk unlink.
qm unlock <vmid>
Разблокировать ВМ.
  • vmid — идентификатор ВМ.
qm vncproxy <vmid>
Проксировать VNC-трафик ВМ на стандартный ввод/вывод.
  • vmid — идентификатор ВМ.
qm wait <vmid> [ОПЦИИ]
Подождать, пока ВМ не будет остановлена.
  • vmid — идентификатор ВМ;
  • --timeout <целое число> — максимальный таймаут в секундах (по умолчанию — не ограничено).
Примеры использования утилиты qm:
  • создать ВМ, используя ISO-файл, загруженный в локальное хранилище, с диском IDE 21 ГБ, в хранилище local-lvm:
    # qm create 300 -ide0 local-lvm:21 -net0 e1000 -cdrom local:iso/alt-server-10.0-x86_64.iso
    
  • запуск ВМ с VM ID 109:
    # qm start 109
    
  • отправить запрос на отключение, и дождаться остановки ВМ:
    # qm shutdown 109 && qm wait 109
    
  • отправить сочетание клавиш CTRL+SHIFT на ВМ:
    # qm sendkey 109 ctrl-shift
    
  • войти в интерфейс монитора QEMU и вывести список доступных команд:
    # qm monitor 109
    qm> help