Windows-Exit-Codes jenseits von Erfolg/Fehler: Bitmaske bei robocopy, Installer-Codes bei msiexec und $LASTEXITCODE

Worum es geht

robocopy fasst mehrere voneinander unabhängige Ja/Nein-Aussagen in einem einzigen Exit-Wert zusammen; die dokumentierten Werte setzen sich bitweise zusammen (1 kopiert, 2 zusätzlich, 4 abweichend, 8 Fehler):

Wert	Bedeutung
0	Es wurden keine Dateien kopiert; kein Fehler; keine Abweichung (das Ziel stimmte bereits mit der Quelle überein)
1	Alle Dateien wurden erfolgreich kopiert
2	Im Ziel existieren zusätzliche Dateien/Verzeichnisse, die in der Quelle nicht vorhanden sind
3	Dateien wurden kopiert, und es existieren zusätzliche Dateien
5	Dateien wurden kopiert, und einige davon wiesen Abweichungen auf
6	Zusätzliche und abweichende Dateien sind vorhanden, es wurde aber nichts kopiert und nichts ist fehlgeschlagen
7	Dateien wurden kopiert, es lag eine Abweichung vor, und es waren zusätzliche Dateien vorhanden
8	Mehrere Dateien wurden nicht kopiert

Die dokumentierte Regel lautet: "Any value equal to or greater than 8 indicates that there was at least one failure during the copy operation". Unterhalb von 8 ist die Zahl rein informativ und kein Kriterium für Erfolg oder Misserfolg.

msiexec liefert spezifische Fehlercodes des Windows Installers, von denen zwei in Wahrheit Erfolgsmeldungen sind:

Code	Name	Bedeutung
0	ERROR_SUCCESS	Normal abgeschlossen
1603	ERROR_INSTALL_FAILURE	Bei der Installation ist ein schwerwiegender Fehler aufgetreten
1618	ERROR_INSTALL_ALREADY_RUNNING	Eine andere Installation läuft bereits
3010	ERROR_SUCCESS_REBOOT_REQUIRED	"A restart is required to complete the install. This message indicates success."
1641	ERROR_SUCCESS_REBOOT_INITIATED	"The installer has initiated a restart. This message indicates success."

$LASTEXITCODE bietet in PowerShell Zugriff auf den tatsächlichen Code eines nativen Programms, doch sein Wert hängt davon ab, wie das Skript aufgerufen wurde: Bei direktem Aufruf oder über & bleibt er unverändert, ausser das Skript ruft exit auf oder führt einen nativen Befehl aus. Über pwsh -File wird er bei einer nicht abgefangenen Ausnahme zu 1 oder zum per exit angegebenen Wert, bei Erfolg zu 0. Über pwsh -Command wird er zu 1, wenn der letzte Befehl $? auf false gesetzt hat, andernfalls zu 0; jeder spezifischere native Code wird dabei auf 1 reduziert.

sc.exe verwendet keine kleine feste Tabelle, sondern gibt den zugrunde liegenden Win32-Systemfehlercode direkt aus, etwa 1060 (ERROR_SERVICE_DOES_NOT_EXIST, "The specified service does not exist as an installed service"). Die Codes sind in der Referenz zu den System Error Codes nachzuschlagen, statt eine kurze, abschliessende Aufzählung anzunehmen.

Warum es wichtig ist

Ein Skript, das robocopy ...; if ($LASTEXITCODE -ne 0) { fail } prüft, behandelt den Normalfall «nichts zu kopieren» (0) und «erfolgreich kopiert» (1) uneinheitlich. Zudem lässt es einen msiexec-Lauf scheitern, der eigentlich erfolgreich war und lediglich einen Neustart benötigt (3010/1641).

So wird es angewendet

• Bei robocopy if ($LASTEXITCODE -ge 8) { fail } prüfen, nicht -ne 0.
• Bei msiexec 0, 3010 und 1641 als Erfolg werten (bei den letzten beiden einen Neustart einplanen); 1603 und 1618 als echte Fehler werten.
• $LASTEXITCODE unmittelbar nach dem nativen Aufruf sichern, bevor ein anderer Befehl den Wert überschreibt, und beachten, welcher Aufrufmodus (-File oder -Command) die Granularität einebnet.
• Bei sc.exe das numerische Ergebnis anhand der Referenz der Systemfehlercodes zuordnen, statt eine fest codierte switch-Anweisung zu verwenden.

Stolpersteine

• Der Code von robocopy oder msiexec wird in einer Automatisierungs-Pipeline wie ein einfacher Boolean (0 gegen ungleich 0) behandelt.
• Die Annahme, dass der Modus -Command den spezifischen Code eines nativen Programms erhält; er wird auf 0 oder 1 reduziert, sofern der Befehl nicht mit exit $LASTEXITCODE endet.