Der QEMU Guest Agent ist ein kleiner Dienst, der im Gastsystem läuft und mit dem Hypervisor kommuniziert. Unter Proxmox VE sorgt er dafür, dass die VM sauber heruntergefahren werden kann, dass Backups konsistent sind und dass die IP-Adressen der VM in der Übersicht angezeigt werden. In dieser Anleitung richten Sie den Agenten auf einer Windows-VM ein und prüfen, ob er funktioniert.

Wozu brauche ich den Guest Agent?

  • Sauberes Herunterfahren: Proxmox fährt Windows über den Agenten ordentlich herunter, statt nur ein ACPI-Signal zu senden, das Windows gelegentlich ignoriert.
  • Konsistente Backups: Vor einem Snapshot-Backup friert der Agent die Dateisysteme kurz ein (fs-freeze). So landen keine halb geschriebenen Daten im Backup.
  • IP-Adressen in der Übersicht: Proxmox zeigt im Reiter Summary die IP-Adressen der VM an.
  • Zeitabgleich und weitere Befehle vom Host aus, etwa das Setzen eines Passworts.

Voraussetzungen

  • Eine Windows-VM unter Proxmox VE (Windows Server 2016 oder neuer, Windows 10/11)
  • Die virtio-win.iso als CD-Laufwerk in der VM eingebunden (siehe unseren Artikel VirtIO-Treiber-ISO herunterladen und in Proxmox einbinden)
  • Administratorrechte in Windows

Schritt 1: Den Agenten in Proxmox aktivieren

  1. Wählen Sie die VM aus und öffnen Sie Options.
  2. Doppelklicken Sie auf QEMU Guest Agent.
  3. Setzen Sie den Haken bei Use QEMU Guest Agent und bestätigen Sie.

Wichtig: Die Einstellung fügt der VM ein zusätzliches virtuelles Gerät hinzu (einen VirtIO-Serial-Port). Damit es aktiv wird, muss die VM komplett heruntergefahren und neu gestartet werden. Ein Neustart aus Windows heraus reicht nicht.

Schritt 2: Den Agenten in Windows installieren

Es gibt zwei Wege. Der einfachste ist der Komplett-Installer:

  1. Öffnen Sie im Explorer das CD-Laufwerk mit der VirtIO-ISO.
  2. Starten Sie virtio-win-guest-tools.exe und folgen Sie dem Assistenten.

Der Installer richtet neben dem Agenten auch alle VirtIO-Treiber ein, darunter den benötigten VirtIO-Serial-Treiber.

Wer nur den Agenten installieren möchte, findet das Paket im Ordner guest-agent der ISO:

D:\guest-agent\qemu-ga-x86_64.msi

In diesem Fall muss der VirtIO-Serial-Treiber (Ordner vioserial) bereits installiert sein. Ohne ihn startet der Agent nicht.

Schritt 3: Dienst in Windows prüfen

Öffnen Sie eine PowerShell als Administrator und prüfen Sie den Dienststatus:

Get-Service QEMU-GA

Die Ausgabe sollte Running anzeigen. Falls der Dienst gestoppt ist, starten Sie ihn und setzen den Starttyp auf automatisch:

Set-Service QEMU-GA -StartupType Automatic
Start-Service QEMU-GA

Schritt 4: Verbindung vom Proxmox-Host testen

Auf dem Proxmox-Node können Sie den Agenten direkt ansprechen. Ersetzen Sie 100 durch die ID Ihrer VM:

qm agent 100 ping
qm agent 100 network-get-interfaces

Kommt beim ersten Befehl keine Fehlermeldung zurück und liefert der zweite die Netzwerkkarten samt IP-Adressen, ist alles eingerichtet. In der Weboberfläche erscheinen die IP-Adressen nun auch im Reiter Summary der VM.

Fehlerbehebung

„QEMU guest agent is not running“

Das ist die häufigste Meldung. Prüfen Sie der Reihe nach:

  1. Ist die Option in Proxmox aktiviert, und wurde die VM danach kalt gestartet (Stop/Start statt Reboot)?
  2. Läuft der Dienst QEMU-GA in Windows?
  3. Ist im Geräte-Manager unter Systemgeräte ein VirtIO Serial Driver ohne Warnsymbol vorhanden?

Der Dienst startet und beendet sich sofort wieder

Meist fehlt der VirtIO-Serial-Port, weil die Option in Proxmox nicht aktiv ist oder die VM noch nicht neu gestartet wurde. Fahren Sie die VM vollständig herunter, starten Sie sie neu und prüfen Sie den Dienst erneut.

Backups bleiben beim „fs-freeze“ hängen

Das kommt bei älteren Agent-Versionen vor. Aktualisieren Sie die VirtIO-ISO auf die aktuelle Version und führen Sie virtio-win-guest-tools.exe erneut aus.

Gut zu wissen

Der Agent benötigt praktisch keine Ressourcen und sollte auf jeder Windows-VM unter Proxmox laufen. Eine Anleitung für Linux finden Sie in unserem Artikel QEMU Guest Agent unter Debian und Ubuntu installieren.

Sie suchen einen fertig eingerichteten Windows-Server ohne eigenen Hypervisor? Werfen Sie einen Blick auf unsere Windows-vServer.

War diese Antwort hilfreich? 0 Benutzer fanden dies hilfreich (0 Stimmen)

Beliebteste Artikel

Installation der VirtIO-Treiber für Windows auf Proxmox VMs

Die VirtIO-Treiber (virtio-win.iso) sind für jede Windows-VM unter Proxmox VE unverzichtbar: Ohne...
Anleitung zur manuellen IPv4- und IPv6-Konfiguration auf Windows Servern

Einführung Die Konfiguration von IP-Adressen ist ein grundlegender Schritt, um sicherzustellen,...
VirtIO-Treiber für Windows: ISO einbinden und Treiber installieren

Wer Windows in einer virtuellen Maschine unter Proxmox VE betreibt, braucht die VirtIO-Treiber....
Windows-vServer: Erste Schritte und RDP absichern

Ihr Windows-vServer ist bereitgestellt und Sie haben die Zugangsdaten erhalten. Bevor Sie...
Remotedesktop-Verbindung zu Ihrem Windows-Server herstellen

Mit dem Remotedesktop-Protokoll (RDP) arbeiten Sie auf Ihrem Windows-Server, als säßen Sie direkt...