Was sind die ERRORLEVEL-Werte, die von internen cmd.exe Befehle?

Den ERRORLEVEL wird ein Wert zurückgegeben, der von den meisten cmd.exe Befehle, wenn Sie am Ende die, die sich ändern, abhängig von einer Reihe von Bedingungen, so wissen Sie den Wert, der die Befehle return ist eine wertvolle information, die hilft, um besser zu schreiben Batch-Dateien. Alle externen .exe-Programme ändern der ERRORLEVEL wenn Sie am Ende (das ist eine inhärente Mechanismus der beiden ExitProcess und TerminateProcess Win-32-API-Funktionen) und in der Regel solche Werte sind dokumentiert, aber die Werte, die von internen cmd.exe Befehle werden nicht vollständig dokumentiert anderswo.

Einer Tabelle mit teilweise ERRORLEVEL-Werte angezeigt, bei diese Frage, aber nur für interne Befehle, set ERRORLEVEL=0 "bei Erfolg". Ich schlug vor der OP so eine Frage, um es zu ändern, um so auch die Werte, die von "nicht erfolgreich" - Kommandos, aber er weigerte sich und forderte mich auf post meine eigenen Frage/Antwort, so ist es hier! Sie müssen jedoch beachten, dass ein ERRORLEVEL anders als null wird nicht unbedingt bedeutet, dass der Befehl fehlgeschlagen! Es gibt einige Befehle, die Ende mit keine Fehler und geben Sie einen Wert größer als null, um anzugeben verschiedene "exit-status", darunter interne Befehle (wie SET /P).

Besser zu nutzen, die gebaut-in cmd.exe Befehle in Batch an .bat-Dateien, die wir brauchen, um zu wissen, die ERRORLEVEL-Werte, die Sie zurückgeben, und der Mechanismen, die in diesem management. Die Frage ist also, welche interne cmd.exe Befehle set ERRORLEVEL zu beliebigen Wert (einschließlich der null)?

InformationsquelleAutor Aacini | 2016-01-25
  1. 33

    In diesem beantworten Sie die ERRORLEVEL-Werte, die von allen internen cmd.exe Befehle werden beschrieben; Sie sind gruppiert nach der Art und Weise der Wert geändert und präsentiert sich als quick-reference Tabellen. Ich überprüfte andere ähnliche Tabellen, um die zu montieren, aber gefüllt werden die fehlenden Werte über durchgeführte tests in einem Windows-8.1-computer. Ich habe meine besten Aufwand für das erstellen dieser Tabellen vollständig und präzise, aber ich hatte nicht getestet, jede und jeder der Werte, über die hier berichtet wird, so kann es zu leichten Schwankungen.

    Tabelle 1 - Befehle, die sich nicht ändern, die vor den ERRORLEVEL-Wert

    BREAK
ECHO
ENDLOCAL
FOR      Not change the ERRORLEVEL by itself. See "Exit Code" below.
IF       Not change the ERRORLEVEL by itself.
PAUSE
RD       Not change the ERRORLEVEL on errors, but the "Exit Code". See below.
REM
RMDIR    Same as RD.
SET      Plain SET command (no arguments). See "Table 3" below.
TITLE

    Tabelle 2 - Befehle, set ERRORLEVEL auf 0 oder 1 je nach Ergebnis

    Command │ Set ERRORLEVEL = 0 when       │ Set ERRORLEVEL = 1 when
────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────
CD      │Current directory was changed. │Directory not exists or is not accessible.
CHDIR   │Same as CD.                    │
COLOR   │Color was changed.             │Background and foreground colors are the same.
COPY    │File(s) was processed.         │File not found or bad parameters given.
DATE    │Date was changed or not given. │User has no admin privileges.
DEL     │Almost always, excepting when: │Bad or no parameters given.
DIR     │Same as COPY.                  │
ERASE   │Same as DEL.                   │
MD      │Directory was created.         │Directory could not be created.
MKDIR   │Same as MD.                    │
MKLINK  │Link was created.              │Link could not be created or bad parameters given.
MOVE    │File(s) was moved/renamed.     │File not found, could not be moved/renamed or bad parameters.
PUSHD   │Same as CD.                    │+ Bad switch given.
REN     │Same as MOVE.                  │
RENAME  │Same as MOVE.                  │
SETLOCAL│New environment was created.   │Bad parameters given.
TIME    │Time was changed or not given. │User has no admin privileges.
TYPE    │Same as COPY.                  │
VERIFY  │Right or no parameters given.  │Bad parameters given.
VOL     │Volume label was displayed.    │Drive not found or bad parameters given.

    Tabelle 3 - Befehle und setzt ERRORLEVEL auf Fehler; sonst, nicht ändern, es

    Command      │E│ Set ERRORLEVEL to = when
─────────────┼─┼────────────────────────────────────────────────────────────────────────
ASSOC        │*│1 = Extension associations could not be changed.
CLS          │ │1 = Bad switch given.
DPATH        │*│1 = Data path could not be established.
FTYPE        │*│1 = File type associations could not be changed.
GOTO label   │ │1 = Label not exist *in a subroutine* (equivalent to: EXIT /B 1).
KEYS         │ │1 = Bad switch given.
PATH         │*│1 = Path could not be changed.
POPD         │ │1 = Bad switch given.
PROMPT       |*│1 = Prompt could not be changed.
SET var      │*│1 = No variable with such name exists.
SET var=value│*│1 = Variable name start with "/" not enclosed in quotes.
SET /P       │*│1 = Read an empty line or at end of file.
SET /A       │*│1073750988 = Unbalanced parentheses, 1073750989 = Missing operand, 
             │ │1073750990 = Syntax error, 1073750991 = Invalid number,
             │ │1073750992 = Number larger than 32-bits, 1073750993 = Division by zero.
SHIFT        │ │1 = Bad switch given.

    Den "E" - Spalte in Tabelle 3 zeigen die Befehle ändern Ihr Verhalten entsprechend der "Extensions" - status, wie beschrieben in der zugehörigen Dokumentation. Wenn die Erweiterungen aktiviert sind (Standardeinstellung) und diese Befehle sind in einer Datei mit .CMD - Erweiterung statt .BAT man diese Befehle legen SETERRORLEVEL = 0, wenn Sie endet ohne Fehler, das ist, wenn die Bedingungen in Tabelle 3 beschrieben sind nicht vorhanden.

    Tabelle 4 - Sonderfälle

    CALL Table1     │If the called command is anyone of Table 1 (excepting FOR and IF): set ERRORLEVEL = 0.
CALL subroutine │If the subroutine is called, not change prior ERRORLEVEL value;
                │otherwise (subroutine not exists): set ERRORLEVEL = 1.
EXIT /B, EXIT   │Not change prior ERRORLEVEL value.
EXIT /B number  │Set ERRORLEVEL to given number.
EXIT number     │Ends cmd.exe and set its returning ERRORLEVEL value to given number.
START command   │If command is started, not change ERRORLEVEL; otherwise, set ERRORLEVEL = 9059.
START /WAIT bat |When the started Batch file end, set ERRORLEVEL = value from 'EXIT number' commmand.
notExist        │If a non-existent command is entered for execution, set ERRORLEVEL = 9009.
VER             │Set ERRORLEVEL = 0 almost always. If /? parameter is given, not change ERRORLEVEL.

    Exit-Code-management

    Es gibt zwei Möglichkeiten zu testen, die ERRORLEVEL-Wert: über IF ERRORLEVEL /IF %ERRORLEVEL% - Befehl, oder über den command && thenCmd when ERRORLEVEL is 0 || elseCmd when ERRORLEVEL is not 0 konstruieren. Jedoch, bestimmten Befehle und-Umleitung-Fehler liefert einen Wert, der funktioniert nur im zweiten Fall und ist nicht spiegelt sich in den ERRORLEVEL; wir nennen Sie "Exit Code" diesen Wert. Wenn dieser Exit-Code nicht null ist, kann es weitergegeben werden, um den ERRORLEVEL-die Ausführung eines Befehls in Tabelle 1 in der elseCmd Teil. Lesen Sie weitere details in dieser Angelegenheit an dieser Beitrag.

    Tabelle 5 - Befehle oder Funktionen auf, die den Exit-Code

    Feature      │ Set Exit Code to = when
─────────────┼─────────────────────────────────────────────────────────────────────────
command      │1 = Command not exist (when ERRORLEVEL = 9009).
redirection  │1 = File not exists in "<", path not exists or access denied in ">" ">>".
drive:       |1 = Drive unit not exists.
POPD         |1 = No matching PUSHD was previously executed.
RD           │1 = Bad switch given, 2 = Directory not found, 5 = Access denied,
             │32 = Directory in use, 145 = Directory not empty.
FOR /F       │1 = No data was processed.

    Zum Beispiel, um zu testen, ob eine Umleitung der Fehler passiert ist, verwenden Sie diese:

    command > C:\Path\that\does\not\exist\file.txt || rem
if errorlevel 1 echo Previous redirection failed

    In diesem Beispiel die rem Befehl wird verwendet, um kopieren Sie die Exit-Code, um den ERRORLEVEL, aber auch jede andere interne Befehl, dass die Erhaltung der ERRORLEVEL verwendet werden können (ausgenommen FOR und IF).

    Um zu testen, ob ein Laufwerk vorhanden ist:

    U: || rem
if errorlevel 1 echo Previous set current drive to U: unit failed

    Weitere Beispiele:

    rd c:\Some\directory 2> NUL || rem
if %errorlevel% equ 0 (
   echo Directory deleted
) else if %errorlevel% equ 2 (
   echo Directory not found
) else if %errorlevel% equ 5 (
   echo Can not access the directory, check rights
) else if %errorlevel% equ 32 (
   echo Can not delete current directory
) else if %errorlevel% equ 145 (
   echo Directory is not empty, use /S switch
)


(for /F "options" %%a in (input.txt) do echo %%a) || rem
if errorlevel 1 echo Previous FOR didn't processed any value
    • Ich hätte geschworen, es war nicht mehr da, wenn ich Sie geprüft habe. Vielleicht hatten Sie mehrere schnell hintereinander bearbeitet. Es gibt so viele Dinge zu testen, ich vermute, es kann eine lange Zeit dauern, bevor die Antwort vollständig ist. Ideal jede Möglichkeit, jeden Befehl sollte getestet werden mit ungültigen Werten, sowohl mit als auch ohne ||. Ich finde es seltsam, dass einige Befehle Erzeugung von nicht-null-Werte außer 1, aber die meisten produzieren 1. Ich vermute, dass zusätzliche Befehle in der Lage sein könnte, um die Ausbeute etwas anderes als 0 oder 1. Sicherlich gibt es weitere nicht-börsennotierte Bedingungen, die zumindest dazu führen ERRORLEVEL 1.
    • Gut, diese Tabellen sind definitiv sinnvoll, auch wenn Sie nicht alle möglichen Fehler-Situationen, in der alle existierenden Befehle (BTW ein kleines Beispiel, eine einfache Möglichkeit zu prüfen, für die admin-Privilegien: date %date%). Trotzdem, die neue Daten können Hinzugefügt werden, sobald Sie entdeckt werden, aber ich bezweifle wirklich, dass alle normalen in Batch-Datei-Benutzer kann verlangen, ein Wert, der nicht bereits hier aufgeführt...
    • Ich möchte wirklich nicht, um nicht-standard-Mechanismen, die erfordern eine zusätzliche Erklärung und das wird sicherlich nicht verwendet werden, die von der überwiegenden Mehrheit der Benutzer. Ich fügte goto labelNotExist Tabelle 3.
    • EXIT und EXIT number nicht wieder ein ERRORLEVEL, sondern die Rückkehr ein Prozess exit-code. Wenn die abschließende cmd-Sitzung selbst war ins Leben gerufen durch ein Elternteil cmd.exe Sitzung, dann die übergeordnete Sitzung mit der exit-code als mit einem externen Befehl übertragen wird der exit-code der Wert, um die Eltern ERRORLEVEL.
    • Ich bin damit einverstanden, entfernte ich meinen letzten Kommentar. Aber goto unknownLabel nur setzt den errorlevel, wenn ich es mit || sonst die batch beendet und der errorlevel bleibt unverändert
    • die schlechte Schalter sind verschiedene Arten von syntax-Fehler hier ist wieder von der internen Befehle, nehmen Sie das bad geht in den account - pastebin.com/2t2QsjRB
    • Ich denke, das ist genau das, was ich sagte, in Tabelle 4: "EXIT │Endet cmd.exe und legen Sie Ihrer Rücksendung den ERRORLEVEL-Wert angegebenen Zahl ist". Tun Sie denken, ist nicht klar genug? IMO eine weitere Erklärung an dieser Stelle wäre verwirrend statt hilfreich.
    • Err, Nein. goto unknowLabel ist ähnlich wie exit /B 1 wenn es ausgeführt wird in einer Unterroutine. Das Verhalten, das Sie beschreiben, passiert nur, wenn die goto unknowLabel ausgeführt wird, in der Haupt-Datei (die original-Batch-Datei ausgeführt von der Eingabeaufforderung). Allerdings goto unknowLabel in einem Unterprogramm bedeutet nicht "Pause" ein iterativer for in der gleichen Weise goto label oder exit /B 1 gilt: der Zyklus weiter bis zum letzten Wert und an diesem Punkt eine exit /B ausgeführt wird.
    • Ja, die schlechte switch-Fehler gemeldet wird, als ein standard-Fehler in der mehrere Befehle (BTW interessante Tabelle! Ich werde es überprüfen, und ändern Sie die Daten hier benötigt werden). Die nur einen internen Befehl, der Bericht ein schlechter switch-Fehler-anders als andere Fehler RD über den Exit-Code.
    • Umm, Nein, was Sie gesagt haben über die AUSFAHRT nicht gerade einverstanden mit meiner Bemerkung, die Sie halb bestätigen mit Ihrer Aussage, dass mehr Erklärung wäre verwirrend. Ich Stimme zu, es ist verwirrend, aber ich denke auch, dass es wichtig ist, sonst hätte ich es nicht geschrieben, der Kommentar.
    • Der Wert von EXIT number Befehl ist immer umgewandelt in den ERRORLEVEL, wenn ein solcher Befehl wird verwendet, das in einer Batch-Datei (das ist der Zweck dieser Frage, die, wie ursprünglich erwähnt). Aus dieser Sicht EXIT number Befehl nicht setzt den ERRORLEVEL-und Z-Wert kann verwendet werden, in eine hintere if ERRORLEVEL ein, so dass keine weiteren Erläuterungen notwendig sind. Bin ich falsch? Der Zweck dieser Tabellen ist die Bereitstellung von Referenz-Informationen, die nützlich für die Batch-Datei Programmierer, nicht zu diskutieren, jeden möglichen Aspekt dieser Befehle.
    • 255 wenn The process tried to write to a nonexistent pipe. . Zum emulieren braucht man ein batch mit schwerer Syntaxfehler in for,if oder ungültige Erweiterung. Versuchen mit test-bat-Datei, wie rem %~ und dann test.bat|rem und drucken Sie dann die errorlevel.
    • Das ist seltsam. Ja, dein Beispiel zeigt einen errorlevel von 255, aber so ein Wert ist nicht von der "nicht vorhandenen pipe" error. Versuchen: (pause>CON & echo No pipe) | rem zeigen, dass die gleichen Fehler, aber mit ein errorlevel null...
    • In der Tat, eine Batch-Datei mit @echo off und rem %~ zeigt nicht die "nicht vorhandene pipe" - Fehler, aber DO kehren Sie ein errorlevel von 255 bei der Ausführung, wie Sie sagte: test.bat|rem. Dies kann bedeuten, dass 255 zeigen, dass der Prozess auf der linken Seite des Rohres eine bestimmte Art von Fehler...
    • du hast Recht. Die parsing-Fehler produziert, 255. Ich habe namens der Fledermaus über powershell zu sehen, der errorlevel. Dinge wie if a a a , for /f a a a und die %~ 255 zurückgegeben.
    • btw. einige Befehl unterscheidet sich das Verhalten mit Befehlserweiterungen deaktiviert.
    • Die Befehle, die ändern Ihr Verhalten mit Erweiterungen deaktiviert sind ausdrücklich erwähnt in Tabelle 3. Meinst du einen anderen Befehl, anders als diese hier?
    • rd,del,cd,pushd set Fehler Stufe 1, wenn keine vorhandene Netzwerk-Pfad übergeben wird . Wahrscheinlich einige externe Funktion aufgerufen wird.
    • start "" /d "c:\notExistingDir" notepad legt den errorlevel mit 9084 . Es gibt einige weitere Fälle, beim start exit-code 1 und errorlevel 0
    • Denken Sie daran, dass die ERRORLEVEL-Funktionalität hat sich durch die abwechslungsreiche OS-version! In Windows NT 4, plain SET zurücksetzen würde ERRORLEVEL auf 0. Auch Verwandte Ressourcen: errorlevels zur Verfügung - wie Sie überprüfen und einstellen errorlevels zur Verfügung, Dynamische Umgebungsvariablen - exit-Code Variablen, warum sollten Sie Never Set Errorlevel, und Raymond Chen blog auf ERRORLEVEL ist nicht %ERRORLEVEL%.
    • Mmmm... Der Zweck dieser Antwort ist nicht zu lehren, über den ERRORLEVEL details, sondern nur zu zeigen, dass die Werte, die von internen Befehle. Die verlinkten Seiten sind ziemlich veraltet. Ja, man sollte niemals die ERRORLEVEL-variable, aber die genaue gleichen Punkt, gelten für CD, DATUM, UHRZEIT und RANDOM dynamic Variablen...
    • Mmmm... Und doch, Sie haben einen Abschnitt und die Beispiele in der Antwort auf Exit-Code-Management. Außerdem, der wichtigste Punkt und der erste Satz in meinem Kommentar war, dass ERRORLEVEL werden können, abhängig von der version. Und während eine Liste von ERRORLEVEL-Werte ist hilfreich, abfangen von Fehlern ist so viel komplexer. Siehe beispielsweise das Beitrag, wo es sinnvoll ist, dass %ERRORLEVEL% ist nicht der zuverlässigste Weg, um Fehler aufzufangen! Ich hinterließ einen Kommentar unterhalb dieses großartige Antwort zu Punkt Menschen nur zu lernen, über die Fehlerbehebung in batch-Dateien, um einige hilfreiche Ressourcen.
    • ERRORLEVEL ist die Funktionalität nicht abhängig von der version. Wenn einfachen SET-Befehl wirklich den errorlevel auf den Wert "(in der Regel 0)", dann ist es ein besonderer Fall von "Windows NT 4 (und 2000?)". Vielleicht eine kleine Anmerkung über diesen Punkt wird am Ende des Tabelle 3 genug sein, aber ich konnte nicht finden, eine zuverlässig Quelle, die bestätigen dieses Verhalten (Rob van der Woude ' s Seiten sind nicht zuverlässig)... ich bereits im Lieferumfang enthalten ein link zu einer solchen "großen Antwort" am Ende des Exit-Code-management - Abschnitt, in den Satz: "Lesen Sie weitere details in dieser Angelegenheit auf diesem posten".
    • echo(>&1||rem legt den errorlevel mit 1 und druckt diese Nachricht The handle could not be duplicated during redirection of handle 1.

    InformationsquelleAutor Aacini
Schreibe einen Kommentar