Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gehen Sie wie nachfolgend beschrieben vor, um ein Windows-Skript .bat oder .cmd Skript auszuführen. Optional kann das .bat ODER-Skript .cmd Umgebungsvariablen dauerhaft ändern.
Syntax
# Batch script v1
# Run a Windows command or batch script and optionally allow it to change the environment.
- task: BatchScript@1
inputs:
filename: # string. Required. Path.
#arguments: # string. Arguments.
#modifyEnvironment: False # boolean. Modify Environment. Default: False.
# Advanced
#workingFolder: # string. Working folder.
#failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
Eingänge
filename
-
Pfad-
string. Erforderlich.
Der Pfad des .cmd.bat auszuführenden OR-Skripts. Dies sollte ein vollqualifizierter Pfad oder ein pfad relativ zum Standardarbeitsverzeichnis sein. (Bitte beachten Sie, dass sich das Arbeitsverzeichnis von workingFolderunterscheiden kann, das für diese Aufgabe angegeben werden kann.)
arguments
-
Argumente
string.
Die Argumente, die an das .cmd Skript or .bat übergeben werden.
modifyEnvironment
-
Umgebung ändern
boolean. Standardwert: False.
Bestimmt, ob sich Änderungen an Umgebungsvariablen auf nachfolgende Aufgaben auswirken.
workingFolder
-
Arbeitsordner
string.
Das aktuelle Arbeitsverzeichnis, wenn ein Skript ausgeführt wird. Dies ist standardmäßig der Ordner, in dem sich das Skript befindet.
failOnStandardError
-
fehler bei Standardfehler-
boolean. Standardwert: false.
Wenn dies zutrifft, schlägt diese Aufgabe fehl, wenn Fehler in den StandardError Datenstrom geschrieben werden.
Aufgabensteuerungsoptionen
Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.
Ausgabevariablen
Keiner.
Bemerkungen
Gehen Sie wie nachfolgend beschrieben vor, um ein Windows .bat- oder .cmd Skript auszuführen. Optional können Sie Umgebungsvariablen dauerhaft ändern.
Hinweis
Diese Aufgabe ist nicht mit Windows-Containern kompatibel. Wenn Sie ein Batchskript in einem Windows-Container ausführen müssen, verwenden Sie stattdessen die Befehlszeilenaufgabe .
Informationen zur Unterstützung mehrerer Plattformen finden Sie unter Plattformübergreifendes Scripting.
Beispiele
Erstellen Sie test.bat im Stammverzeichnis Ihres Repositorys:
@echo off
echo Hello World from %AGENT_NAME%.
echo My ID is %AGENT_ID%.
echo AGENT_WORKFOLDER contents:
@dir %AGENT_WORKFOLDER%
echo AGENT_BUILDDIRECTORY contents:
@dir %AGENT_BUILDDIRECTORY%
echo BUILD_SOURCESDIRECTORY contents:
@dir %BUILD_SOURCESDIRECTORY%
echo Over and out.
Um dieses Skript auszuführen, fügen Sie Ihrer Pipeline die folgende Aufgabe hinzu.
- task: BatchScript@1
inputs:
filename: 'test.bat'
Anforderungen
| Anforderung | BESCHREIBUNG |
|---|---|
| Pipelinetypen | YAML, Classic Build, Classic Release |
| Läuft auf | Agent, DeploymentGroup |
| Anforderungen | Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: Cmd |
| Funktionen | Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag. |
| Befehlseinschränkungen | Beliebig |
| Settable-Variablen | Beliebig |
| Agentversion | 1.83.0 oder höher |
| Vorgangskategorie | Nützlichkeit |