HOWTO · Batch

Aufforderung zur Benutzereingabe und Verwendung der Ergebnisse im Batch-Skript

Dieses Tutorial zeigt, wie wir Benutzereingaben entgegennehmen und die Ergebnisse in einem anderen Befehl mit Batch Script verwenden können.

Auf dieser Seite

Ein Windows-CMD-Batchskript kann die Person, die es ausführt, nach Text fragen, die Antwort in einer Variablen speichern und sie in späteren Befehlen verwenden. Der Befehl set /p erledigt alle drei Schritte: Er gibt eine Aufforderung aus, wartet auf eine Zeile Eingabe und weist den getippten Text einer Variablen zu. Diese Anleitung zeigt, wie Sie Eingaben abfragen, den Wert in einem Befehl verwenden, ihn validieren und die Aufforderung wiederholen, wenn die Antwort nicht verwendbar ist.

Eingabe mit set /p abfragen

Die allgemeine Form lautet set /p "variable=Prompt text: ". Der Befehl schreibt den Aufforderungstext ohne nachfolgenden Zeilenumbruch auf die Konsole, liest eine Zeile bis zur Eingabetaste und speichert sie in variable. Der Aufforderungstext ist optional: set /p "name=" wartet auf eine Eingabe, ohne etwas auszugeben. Steht die gesamte Zuweisung in Anführungszeichen wie in set /p "var=...", werden Leerzeichen und Zeichen wie & im Aufforderungstext nicht als Befehle interpretiert.

Speichern Sie diese Zeilen als greet.bat und führen Sie die Datei an einer Eingabeaufforderung aus:

@echo off

set /p "userName=Please enter your name: "

echo Hello, %userName%!

Wenn Sie das Skript ausführen und an der Aufforderung John eingeben, zeigt die Konsole die Aufforderung und die getippte Antwort in derselben Zeile und gibt anschließend Hello, John! aus. Die Antwort wird in userName gespeichert und bleibt bis zum Ende des Skripts verfügbar; %userName% wird überall dort, wo es später im Skript erscheint, zum getippten Text erweitert. Die Aufforderungs- und Ausgabetexte im Beispiel bleiben englisch, weil der Code unverändert übernommen wird.

Da set /p ein in cmd.exe eingebauter Befehl ist, laufen die Skripte in dieser Anleitung nur unter Windows. Sie werden als Syntax gezeigt, die Sie selbst speichern und ausführen können; der Text nach jedem Skript beschreibt, wie ein typischer interaktiver Lauf aussieht, und ist keine aufgezeichnete Ausgabe.

Den eingegebenen Wert in einem Befehl verwenden

Da die Antwort in einer normalen Umgebungsvariablen liegt, kann sie einen späteren Befehl steuern: etwa ein Verzeichnis, einen Dateinamen, einen Suchbegriff oder eine Option auswählen. Das folgende Beispiel fragt nach einem Ordnernamen und wechselt in ihn. Zwei Details machen es sicher:

  • Die Variable wird in Anführungszeichen verwendet ("%dirName%"), sodass auch ein Ordnername mit Leerzeichen funktioniert.
  • if exist prüft den Ordner, bevor cd ausgeführt wird, sodass ein Tippfehler eine klare Meldung statt eines fehlgeschlagenen Skripts erzeugt.

@echo off

set /p "dirName=Enter a folder name (for example Documents): "

if exist "%dirName%\" (

cd /d "%dirName%"

echo You are now in %cd%.

) else (

echo Could not find a folder named "%dirName%".

)

Bei einem typischen Lauf wechselt die Eingabe Downloads in diesen Ordner und gibt eine Zeile wie You are now in C:\Users\Ada\Downloads. aus – je nachdem, welches Verzeichnis gerade aktuell ist. Ein Name, zu dem kein Ordner passt, gibt Could not find a folder named "name" aus, wobei name durch den getippten Text ersetzt wird; die Meldungen des Beispiels bleiben wie im Code englisch.

"%dirName%\" prüft die Antwort als Verzeichnis; ohne den abschließenden Backslash würde if exist auch eine Datei mit diesem Namen akzeptieren. cd /d wechselt außerdem den Laufwerksbuchstaben, wenn die Antwort ein Pfad auf einem anderen Laufwerk ist.

Eingabe validieren und Fehler behandeln

Ein Benutzer kann die Eingabetaste drücken, ohne etwas einzutippen, Text eingeben, wo eine Zahl erwartet wird, oder einen Wert liefern, den das Skript nicht verwenden kann. Prüfen Sie die Variable, bevor Sie sie nutzen, und sagen Sie klar, was schiefgegangen ist.

Das Beispiel fragt nach einem Alter und wendet zwei Prüfungen an:

  • set "age=" leert die Variable zuerst, denn set /p lässt sie unverändert, wenn nur die Eingabetaste gedrückt wird, und if not defined fängt diesen Fall ab.
  • findstr /r "^[0-9][0-9]*$" bestätigt, dass die Antwort nur Ziffern enthält; if errorlevel 1 bedeutet, dass dies nicht der Fall ist.

@echo off

set "age="

set /p "age=Enter your age: "

if not defined age (

echo No value was entered.

goto :eof

)

echo %age%|findstr /r "^[0-9][0-9]*$" >nul

if errorlevel 1 (

echo "%age%" is not a whole number.

) else (

echo Age recorded: %age%.

)

Die Eingabe twelve lässt das Skript "twelve" is not a whole number. ausgeben. Die Eingabe 30 gibt Age recorded: 30. aus, und das Drücken der Eingabetaste ohne vorherige Eingabe gibt No value was entered. aus. Auch diese Meldungen bleiben englisch, weil das Beispiel bytegenau übernommen wird.

Für Prüfungen, die ein Zeichenkettenvergleich ausdrücken kann, setzen Sie beide Seiten in Anführungszeichen: if /i "%var%"=="yes". Für Prüfungen der Art „ist der vorherige Befehl fehlgeschlagen“ liest if errorlevel 1 den Exitcode. Wenn das Skript nicht fortfahren kann, beendet goto :eof es sauber; verwenden Sie exit /b 1 nur, wenn ein aufrufendes Skript einen von null verschiedenen Status benötigt.

Die Aufforderung wiederholen, bis die Eingabe akzeptabel ist

Eine Sprungmarke plus goto macht aus einer Aufforderung eine Schleife: Springen Sie zur Marke zurück, wann immer die Validierung fehlschlägt. Zählen Sie die Versuche und stoppen Sie nach einigen Versuchen, damit das Skript auch endet, wenn niemand antwortet – etwa wenn die Eingabe aus einer Datei oder einer Pipe statt von einer Tastatur kommt.

@echo off

setlocal

set "tries=0"



:askNumber

set /a "tries+=1"

if %tries% gtr 3 (

echo No usable answer after 3 attempts. Exiting.

goto :eof

)

set "num="

set /p "num=Please enter a whole number between 1 and 10: "

if not defined num (

echo Nothing was entered.

goto askNumber

)

echo %num%|findstr /r "^[0-9][0-9]*$" >nul

if errorlevel 1 (

echo "%num%" is not a whole number.

goto askNumber

)

if %num% lss 1 (

echo %num% is below the accepted range of 1 to 10.

goto askNumber

)

if %num% gtr 10 (

echo %num% is above the accepted range of 1 to 10.

goto askNumber

)

echo You entered a valid number: %num%.

Eine typische Sitzung läuft so ab: Das Skript fragt nach einer Zahl, fifteen wird mit "fifteen" is not a whole number. beantwortet und die Aufforderung wiederholt sich, 15 wird mit 15 is above the accepted range of 1 to 10. beantwortet und die Aufforderung wiederholt sich, und 5 wird mit You entered a valid number: 5. akzeptiert. Nach drei erfolglosen Versuchen endet die Schleife mit No usable answer after 3 attempts. Exiting.

lss und gtr vergleichen Zahlen, und findstr hat bereits bestätigt, dass die Antwort nur aus Ziffern besteht, sodass 2 korrekt im akzeptierten Bereich von 1 bis 10 liegt. Ein Vergleich in Anführungszeichen wie if "%num%" leq "10" vergleicht dagegen Text und würde einstellige Ziffern über 1 fälschlicherweise ablehnen. setlocal verhindert, dass tries und num in die aufrufende Umgebung gelangen.

Grenzen und sicherer Umgang mit Benutzereingaben

  • Nur Windows CMD. set /p ist ein in cmd.exe eingebauter Befehl; die hier beschriebene Methode gilt nicht für PowerShell oder Unix-Shells. Verwenden Sie in PowerShell stattdessen Read-Host; in bash erledigt read -p dieselbe Aufgabe.
  • Eine Zeile Klartext. Es wird eine einzelne Zeile bis zur Eingabetaste gelesen. Es gibt keine maskierte Eingabe für Geheimnisse und keine Cursor-Bearbeitung über die Rücktaste hinaus.
  • Keine Antwort behält den alten Wert. Das Drücken der Eingabetaste allein – oder das Ausführen des Skripts ohne Tastatureingabe – lässt die Variable unverändert. Leeren Sie sie mit set "var=" vor der Aufforderung und prüfen Sie danach mit if not defined.
  • Sonderzeichen bleiben erhalten, können aber spätere Befehle zerstören. Text mit &, |, <, > oder " wird wörtlich gespeichert. Verwenden Sie die Variable daher in Befehlen und Vergleichen in Anführungszeichen ("%var%") und validieren Sie, bevor der Wert eine Befehlszeile erreicht.
  • Nur einfache Eingaben. Sehr lange Antworten und komplexe Regeln sprengen if und findstr schnell. Für Menüs mit festen Optionen ist choice /c yn /m "Continue" einfacher; für umfangreichere Interaktion passt ein PowerShell-Skript besser.

Führen Sie dieses Beispiel aus, das denselben Aufforderungs-und-Antwort-Ablauf mit dem bash-eingebauten read -p zeigt; die Here-String-Syntax <<< "John" spielt dabei die Rolle von John tippen und die Eingabetaste drücken:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

read -r -p "Please enter your name: " userName <<< "John"
echo "Hello, $userName!"
Hello, John!

Auf einem echten Terminal zeigt read -p den Aufforderungstext vor dem Lesen an; die ausgegebene Begrüßung ist dasselbe Ergebnis, das das Batchskript mit set /p und echo erzeugt. Die im Code und in der Ausgabe angezeigten Texte bleiben englisch, weil das Beispiel bytegenau übernommen wird.

Zusammen eingesetzt – Erfassen mit set /p, Leeren und Validieren der Variable vor der Verwendung, Wiederholen mit einer begrenzten goto-Schleife und Setzen in Anführungszeichen in jedem Befehl – decken diese Techniken die meisten interaktiven Batch-Aufgaben zuverlässig ab.