Fehlerbehebung¶

Häufige Probleme und ihre Lösung. Ist Ihr Problem nicht aufgeführt, wenden Sie sich an support@pvs-forge.com.

Geführte Selbsthilfe (Benachrichtigungen)¶

PVS Forge weist Sie auf die folgenden Probleme direkt in der App hin. Bricht ein Problem einen Imaging-Job ab, erscheint es im Benachrichtigungs-Center — dem Eintrag Notification unten in der Seitenleiste, mit einem Zähler für ungelesene Hinweise. Klicken Sie bei einem Eintrag auf Mögliche Lösung, um Ursache und Lösung zu sehen. Je nach Problem bietet der Dialog einen Befehl zum Kopieren und Ausführen auf dem Master Target, einen Sprung in die passenden Einstellungen oder eine Ein-Klick-Lösung (immer mit Rückfrage).

Beispiel: Ist PowerShell-Remoting auf dem Master Target deaktiviert, bietet der Hinweis „WinRM-Zugriff verweigert" den Befehl Enable-PSRemoting -Force zum Ausführen auf dem Ziel.

Funktioniert offline

Die geführte Selbsthilfe arbeitet vollständig offline und benötigt keinen API-Schlüssel und keinen Internetzugang.

Imaging startet nicht¶

Symptom: Der Play-Button reagiert nicht, oder es wird gemeldet, dass Imaging blockiert ist.

Lizenz erforderlich. Imaging ist lizenzgebunden. Ohne gültige Lizenz oder bei abgelaufener Testversion startet das Imaging nicht. Aktivieren oder erneuern Sie Ihre Lizenz auf der Seite Lizenz. Der Rest der Anwendung (Dashboard, Vergleich, vDisk-Speicher, Verlauf) bleibt nutzbar.
Zeile gehört zu einem laufenden Stapel. Ein Master Target, das Teil eines noch laufenden „Alle starten“-Stapels ist, kann erst wieder gestartet werden, wenn sein eigener Auftrag beendet ist; das Live-Log weist beim Play-Klick darauf hin. Andere Zeilen sind nicht betroffen — sie lassen sich einzeln oder als zweiter Stapel starten.
Erreichbarkeitsprüfung fehlgeschlagen. Beobachten Sie das Live-Log: Es zeigt, welcher Schritt fehlschlug (Ping, WinRM oder Store). Beheben Sie genau diesen Punkt und versuchen Sie es erneut.

Master Target nicht erreichbar (WinRM)¶

Symptom: Der Auftrag scheitert am WinRM-Schritt.

WinRM (Port 5985) muss auf dem Master Target aktiviert und vom PVS-Server erreichbar sein.
Erreichen Sie das Master Target immer über Hostname / FQDN, nicht über die IP — Kerberos benötigt den Hostnamen.
Prüfen Sie, ob die Imaging-Anmeldedaten (Einstellungen → Sicherheit) WinRM-Rechte auf dem Target haben.

Wurde WinRM auf dem Master Target noch nie eingerichtet, genügt ein einziger Befehl — auf dem Master Target in einer erhöhten PowerShell ausführen:

winrm quickconfig -quiet

Dieser Befehl aktiviert den WinRM-Dienst, richtet den HTTP-Listener auf Port 5985 ein und setzt die erforderliche Firewall-Regel — alles in einem Schritt.

Geplante Aufgabe lässt sich nicht registrieren¶

Symptom: Imaging scheitert beim Registrieren der Imaging-Aufgabe auf dem Master Target.

Die Imaging-Aufgabe läuft als Stapelverarbeitungs-Anmeldung (batch). Die häufigste Ursache auf gehärteten Targets ist ein fehlendes Benutzerrecht: das Imaging-Konto braucht Anmelden als Stapelverarbeitungsauftrag auf dem Master Target. Bei Tier-Härtung wird dieses Recht oft entzogen — das Imaging startet dann gar nicht, bis es erteilt ist. Die Anmeldung speichert kein Passwort, daher ist „Speicherung von Kennwörtern für die Netzwerkauthentifizierung nicht zulassen" nicht das Problem.

Schlägt die Registrierung oder der Start dennoch fehl, prüfen Sie, ob:

das Imaging-Konto Anmelden als Stapelverarbeitungsauftrag auf dem Target besitzt und nicht von einer Richtlinie „Anmelden als Stapelverarbeitungsauftrag verweigern" erfasst wird,
die Master-Target-Anmeldedaten lokale Administratorrechte auf dem Target haben,
WinRM (5985) vom PVS-Server erreichbar ist und
kein Drittanbieter-Agent auf dem Target die Aufgabenregistrierung blockiert.

gpresult /H report.html auf dem Target hilft zu bestätigen, welche Richtlinien angewendet werden.

Synchronisierung auf anderen PVS-Server schlägt fehl (SMB)¶

Symptom: Imaging wird abgeschlossen, aber die Synchronisierung auf einen anderen PVS-Server scheitert oder hängt ~20 Sekunden, bevor sie fehlschlägt.

SMB (Port 445) muss auf dem Sync-Ziel erreichbar sein. Entscheidend ist die Erreichbarkeit — eine existierende Firewall-Regel ist nicht dasselbe wie ein offener Port.
PVS Forge prüft SMB über IPv4. Löst ein Hostname zuerst auf IPv6 auf, kann ein ~22-Sekunden-IPv6-Timeout vor dem IPv4-Fallback auftreten. Stellen Sie IPv4-Konnektivität zu Port 445 sicher.
Achten Sie bei Targets mit mehreren NICs darauf, dass SMB auf der Schnittstelle offen ist, über die der Push tatsächlich läuft (Ihr LAN, nicht die Streaming-NIC).

Nicht genug Speicher auf dem Sync-Ziel¶

Symptom: Der Auftrag stoppt vor oder während der Synchronisierung mit einem Kapazitätsfehler.

PVS Forge prüft den freien Speicher vor dem Push und rechnet einen Sicherheitsaufschlag ein (eine VHDX ist typischerweise größer als der „belegt"-Wert des Dateisystems, da das Imaging Daten auf Blockebene plus NTFS-Metadaten erfasst). Geben Sie auf dem Ziel-Store Speicher frei oder synchronisieren Sie auf ein Ziel mit mehr Kapazität.

Imaging wartet kurz nach dem Start und versucht es erneut¶

Symptom: Kurz nach Beginn der Imaging-Phase zeigt das Live-Log eine Wiederholungs-Meldung, und der Auftrag wartet einige Minuten, bevor er weiterläuft.

Ursache & Lösung: In dem Moment, in dem die Bildaufnahme vorbereitet wird, muss Windows alle Schreibzugriffe auf dem Master Target kurz einfrieren und auf die Festplatte schreiben. Bei hoher Datenträgerlast (z. B. parallele Imaging-Aufträge, Backups oder Virenscans auf demselben Speicher) kann dabei eine Zeitüberschreitung auftreten. PVS Forge behandelt das als vorübergehend und wiederholt den Versuch automatisch bis zu dreimal (mit 2 bzw. 5 Minuten Wartezeit). In der Regel ist nichts zu tun — der Auftrag läuft von selbst weiter. Scheitert er auch nach drei Versuchen, reduzieren Sie die gleichzeitige Datenträgerlast auf dem Speicher des Master Targets und starten den Auftrag erneut.

Imaging bricht ganz am Ende ab („Datei in Verwendung")¶

Symptom: Die Imaging-Kopie läuft bis 100 %, der Auftrag scheitert aber beim Finalisieren der neuen vDisk — oft mit „Datei in Verwendung" / „wird von einem anderen Prozess verwendet", teils nur sporadisch oder wenn mehrere vDisks auf denselben Store gehen.

Ursache & Lösung: Ein Echtzeit-Virenschutz auf dem PVS-Server (z. B. Windows Defender) scannt die Store-vDisks beim Zugriff und kann eine bis ins Finalisieren offen halten. Nehmen Sie den vDisk-Store auf jedem PVS-Server vom Echtzeit-Scan aus — siehe Antivirus-Ausnahmen.

PVS Forge wird beim RDP-Sitzungs-Timeout beendet¶

Symptom: Ein Administrator startet PVS Forge in einer RDP-Sitzung auf dem PVS-Server, trennt die Sitzung und findet den Lauf später abgebrochen vor — ohne Benachrichtigung.

Ursache & Lösung: Der Server beendet getrennte (oder inaktive) RDP-Sitzungen nach einem Zeitlimit, und PVS Forge wird zusammen mit der Sitzung beendet. PVS Forge prüft das beim Start: Ist ein Zeitlimit aktiv, erscheint ein Hinweis im Benachrichtigungscenter. Die vorgeschlagene Lösung kann die lokale Gruppenrichtlinie direkt aus dem Hinweis auf Sitzung nie beenden setzen (mit Bestätigung). Beachten Sie: Eine Domänen-Gruppenrichtlinie überschreibt den lokalen Wert — wenden Sie sich in dem Fall an Ihren Domänen-Administrator; der Hinweis meldet sich beim nächsten Start erneut. Bis das Limit entfernt ist, lassen Sie die RDP-Sitzung während eines laufenden Auftrags verbunden.

PVS Forge startet im Demo-Modus¶

Symptom: Imaging-Optionen sind nicht verfügbar und die App weist auf einen eingeschränkten Modus hin.

Das Citrix-PVS-PowerShell-Snap-in (Citrix.PVS.Snapin) wurde nicht gefunden. PVS Forge muss auf einem PVS-Server mit installiertem Snap-in laufen. Der Demo-Modus dient nur dazu, die Oberfläche auf einer Maschine ohne PVS zu erkunden.

Es läuft nur eine Instanz¶

Symptom: Beim Start von PVS Forge erscheint die Meldung, dass es bereits läuft.

PVS Forge erlaubt eine einzige Instanz pro Host (über alle RDP-Sitzungen hinweg). Die Meldung nennt den Inhaber (Sitzung, Benutzer, Startzeit). Nutzen Sie die bestehende Instanz oder schließen Sie sie zuerst.