Installer- und Setup-Exit-Codes

Wenn Sie das Setup von Hand ausführen, zeigt sich ein Problem als Meldungsbox und der Exit-Code ist von keinem Interesse. Er wird das Einzige, was Sie haben, wenn die Installation unbeaufsichtigt läuft: eine stille Installation aus einem Skript, ein Paket, das von Microsoft Intune, SCCM/Configuration Manager, PDQ Deploy oder einem ähnlichen Tool eingesetzt wird, oder ein Schritt in einem Workstation-Image. In diesen Fällen ist der Exit-Code das, was das Tool als Erfolg oder Fehler aufzeichnet.

Eine Regel vor der Tabelle: nur 0 bedeutet Erfolg. Jeder Nicht-Null-Code bedeutet, dass das Setup nicht bis zum Ende durchlief, und zukünftige Versionen des zugrunde liegenden Installer-Frameworks — das Setup ist mit Inno Setup erstellt — können Codes hinzufügen, die hier nicht aufgeführt sind, sodass ein Deployment-Skript unerwartete Werte mit Anstand behandeln sollte, statt anzunehmen, diese Liste sei erschöpfend.

Das Setup still ausführen

Der Installer-Download ist ein ZIP, das das signierte Setup-Programm enthält. Entpacken Sie es zuerst, dann rufen Sie die ausführbare Datei mit den Standard-Inno-Setup-Schaltern auf, zum Beispiel:

SQLDataLensSetup_3024_20260810.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="%TEMP%\sqldl-install.log"
echo %ERRORLEVEL%

/SILENT zeigt das Fortschrittsfenster, fragt aber nichts; /VERYSILENT zeigt gar nichts. /LOG schreibt ein Installationslog, das das Erste ist, was Sie ansehen, wenn ein unten aufgeführter Code auf einem Rechner auftaucht, vor dem Sie nicht sitzen können. Die vollständige Schalter-Liste für die von Ihnen verwendete Version wird vom Setup selbst gedruckt:

SQLDataLensSetup_3024_20260810.exe /?

Dieser Aufruf gibt Exit-Code 0 zurück, weshalb Code 0 sowohl eine abgeschlossene Installation als auch eine Hilfe-Anfrage abdeckt. Wenn Sie eine Installation ganz ohne Installer benötigen — keine Erhöhung, keine Startmenü-Einträge, nichts in der Registry — ist das portable ZIP der bessere Weg: siehe Installation.

Die Exit-Codes

Code	Bedeutung	Was zu tun ist
`0`	Setup lief bis zum Ende durch, oder der /HELP bzw. /? Parameter wurde verwendet.	Nichts. Dies ist der Erfolgsfall und der einzige Code, den ein Deployment-Skript als "installiert" behandeln sollte.
`1`	Setup konnte nicht initialisiert werden.	Prüfen Sie, dass die Datei vollständig heruntergeladen und nicht blockiert oder in Quarantäne ist, dass freier Speicherplatz auf dem Zielvolume vorhanden ist und dass keine frühere Setup-Instanz noch läuft. Eine Fehlermeldung, die das Problem erklärt, wird normalerweise angezeigt, bevor dieser Code zurückgegeben wird.
`2`	Der Benutzer hat im Assistenten auf Abbrechen geklickt, bevor die Installation begann, oder "Nein" auf die einleitende "Dies installiert…"-Aufforderung geantwortet.	Technisch ist nichts schiefgelaufen — die Installation wurde abgelehnt. Bei einem unbeaufsichtigten Rollout bedeutet dies normalerweise, dass die Silent-Schalter fehlten, sodass der Assistent eine Frage stellte, die niemand beantworten konnte.
`3`	Ein fataler Fehler trat beim Übergang zur nächsten Installationsphase auf — beispielsweise zwischen den Assistentenseiten und der Installation selbst.	Dies sollte nur unter ungewöhnlichen Umständen auftreten, wie Speichermangel oder Windows-Ressourcen. Schließen Sie andere Anwendungen, starten Sie neu und versuchen Sie es erneut; wenn es sich auf demselben Rechner wiederholt, senden Sie uns die angezeigte Meldung.
`4`	Ein fataler Fehler trat während der Installation selbst auf.	Suchen Sie nach einer gesperrten oder verwendeten Datei, einem Zielverzeichnis, in das Sie nicht schreiben können, oder Antivirensoftware, die den Schreibvorgang abfängt. Beachten Sie, dass Fehler mit Abbrechen-, Wiederholen- oder Ignorieren-Option keine fatalen Fehler sind — wenn Sie dort Abbrechen wählen, wird stattdessen Code 5 zurückgegeben.
`5`	Der Benutzer hat während der Installation auf Abbrechen geklickt oder bei einer Abbrechen-Wiederholen-Ignorieren-Aufforderung Abbrechen gewählt.	Die Installation wurde mittendrin unterbrochen, das Ergebnis kann unvollständig sein. Führen Sie das Setup erneut aus oder deinstallieren und installieren Sie neu, bevor Sie den Rechner als installiert behandeln.
`6`	Der Setup-Prozess wurde vom Debugger beendet (Ausführen \| Beenden in der Compiler-IDE).	Dies werden Sie auf einem eingesetzten Rechner nicht sehen; es kommt aus einer Entwicklungsumgebung. Behandeln Sie es als "keine Installation erfolgt" und führen Sie das Setup normal aus.
`7`	Die Phase "Installation wird vorbereitet" stellte fest, dass Setup nicht mit der Installation fortfahren kann.	Etwas auf dem Rechner blockiert die Installation — typischerweise Dateien, die von einer laufenden Kopie der Anwendung verwendet werden. Schließen Sie SQL DATA LENS (und alles, was Dateien in seinem Verzeichnis hält) und führen Sie das Setup erneut aus. Eine Fehlermeldung, die den Grund erklärt, wird normalerweise angezeigt.
`8`	Die Phase "Installation wird vorbereitet" stellte fest, dass Setup nicht fortfahren kann und das System neu gestartet werden muss, um das Problem zu beheben.	Starten Sie Windows neu und führen Sie das Setup erneut aus. Behandeln Sie diesen Code in einem Deployment-Tool als "Neustart erforderlich, dann erneut versuchen" statt als Fehler.

Fragen zur Batchinstallation oder zu einem Code, der hier nicht erklärt ist? Schreiben Sie an support@sqldatalens.com.