Verwaltung von KVM-basierten virtuellen Maschinen über die Kommandozeile in Proxmox

In manchen Situationen ist die Nutzung des Web-Interfaces nicht erforderlich und es ist effizienter, virtuelle Maschinen direkt über das Terminal zu starten, zu stoppen oder zu verwalten. Proxmox stellt hierfür das Kommandozeilenwerkzeug qm bereit, das vollständige Kontrolle über KVM-basierte virtuelle Maschinen bietet.

Dieser Artikel erläutert die wesentlichen Befehle sowie deren Funktionsweise.

Voraussetzungen

Erforderlich sind:

• Ein Proxmox-VE-System
• Die VM-ID, die verwaltet werden soll
  (Alle vorhandenen VMs lassen sich mit qm list anzeigen)

Übersicht aller verfügbaren qm-Funktionen

Alle unterstützten Befehle können mit folgendem Kommando angezeigt werden:

qm

Nach Ausführung dieses Befehls erscheint eine Liste der verfügbaren Optionen:

qm <command> <vmid> [OPTIONS]
qm [create|set] <vmid>
        --memory  <MBYTES>    Arbeitsspeicher in MB (64 - 8192)
        --smp  <N>            Anzahl der CPUs
        --ostype NAME         Betriebssystemtyp
        --onboot [yes|no]     Start beim Systemboot
        --keyboard XX         Tastaturlayout für VNC
        --cpuunits <num>      CPU-Gewichtung für die VM
        --name <text>         Name der VM
        --boot [a|c|d|n]      Bootreihenfolge
        --bootdisk <disk>     Boot-Device
        --acpi (yes|no)       ACPI ein-/ausschalten
        --localtime (yes|no)  RTC auf Lokalzeit einstellen

        --vlan[0-9u] MODEL=XX:XX:XX:XX:XX:XX[,MODEL=YY:YY:YY:YY:YY:YY]

        --ide<N>    [file=]file][,media=d]
                    [,cyls=c,heads=h,secs=s[,trans=t]]
                    [,snapshot=on|off][,cache=on|off][,format=f]
        --ide<N> <GBYTES>     Neue Disk anlegen
        --ide<N> delete       Disk löschen
        --cdrom <file>        Alias für --ide2 <file>,media=cdrom

        --scsi<N>   [file=]file][,media=d]
                    [,cyls=c,heads=h,secs=s[,trans=t]]
                    [,snapshot=on|off][,cache=on|off][,format=f]
        --scsi<N> <GBYTES>    Neue SCSI-Disk anlegen
        --scsi<N> delete      Disk löschen

        --virtio<N> [file=]file][,media=d]
                    [,cyls=c,heads=h,secs=s[,trans=t]]
                    [,snapshot=on|off][,cache=on|off][,format=f]
        --virtio<N> <GBYTES>  Neue Virtio-Disk anlegen
        --virtio<N> delete    Disk löschen

qm monitor <vmid>       Verbindung zum VM-Monitor herstellen
qm start <vmid>         VM starten
qm reboot <vmid>        VM neu starten (Shutdown + Start)
qm shutdown <vmid>      VM geordnet herunterfahren
qm stop <vmid>          VM sofort stoppen (Hard Stop)
qm reset <vmid>         VM zurücksetzen (Stop + Start)
qm suspend <vmid>       VM anhalten
qm resume <vmid>        VM fortsetzen
qm destroy <vmid>       VM vollständig löschen (inkl. Dateien)

qm cdrom <vmid> [<device>] <path>  CD-ROM-Pfad setzen (<device> standardmäßig ide2)
qm cdrom <vmid> [<device>] eject   CD-ROM auswerfen

qm unlink <vmid> <file>  Ungenutzte Disk-Images löschen
qm vncproxy <vmid> <ticket>  VNC-Proxy öffnen
qm list                 Alle virtuellen Maschinen anzeigen

Ersetzen Sie <vmid> durch die tatsächliche VM-Nummer, zum Beispiel:

qm start 101

Warum ein geordnetes Herunterfahren fehlschlagen kann

Der Befehl:

qm shutdown <vmid>

funktioniert nur, wenn das Betriebssystem der VM ACPI-Shutdown-Signale unterstützt.

Sollte die VM den Befehl ignorieren, sind Anpassungen im jeweiligen Gastbetriebssystem notwendig:

Windows-Gäste

Aktivieren Sie das Herunterfahren ohne Anmeldung:

1. Öffnen Sie Win + R → gpedit.msc
2. Navigieren Sie zu:
   Computer Configuration → Windows Settings → Security Settings → Local Policies → Security Options
3. Aktivieren Sie:
   "Shutdown: Allow system to be shut down without having to log on."
4. Optional (um Hinweise zu vermeiden):
   Display Shutdown Event Tracker → Disabled

Linux-Gäste (Ubuntu, Debian usw.)

Installieren Sie acpid:

apt-get update
apt-get install acpid

Nach der Installation reagiert das System üblicherweise korrekt auf ACPI-Shutdown-Signale.

Alle virtuellen Maschinen stoppen

Der frühere Befehl qm stopall wird nicht mehr unterstützt.

Nutzen Sie stattdessen:

service pve-manager stop

Dieser Dienst versucht zunächst einen geordneten Shutdown und stoppt anschließend Container und VMs in der korrekten Reihenfolge.

Zusammenfassung

Die wichtigsten Befehle im Überblick:

qm start <id>        # VM starten
qm shutdown <id>     # Geordnet herunterfahren
qm stop <id>         # Sofort stoppen
qm reboot <id>       # Neustarten
qm reset <id>        # Hard Reset
qm list              # Alle VMs anzeigen

Stellen Sie sicher, dass ACPI aktiviert ist, um unnötige Hard-Stops zu vermeiden.