CmdLine@2 : Task "Befehlszeile v2"

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um ein Befehlszeilenskript mit Bash unter Linux, macOS und cmd.exe unter Windows auszuführen.

Syntax

# Command Line v2
# Run a command line script using Bash on Linux and macOS and cmd.exe on Windows.
- task: CmdLine@2
  inputs:
    script: # string. Required. Script. 
  # Advanced
    #workingDirectory: # string. Working Directory. 
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.

Eingaben

script - Skript
string. Erforderlich. Standardwert. echo Write your commands here\n\necho Hello world.

Der Inhalt des Skripts, das Sie ausführen möchten.

script - Skript
string. Erforderlich. Standardwert. echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

Der Inhalt des Skripts, das Sie ausführen möchten.

workingDirectory - Arbeitsverzeichnis
string.

Gibt das Arbeitsverzeichnis an, in dem Befehle ausgeführt werden sollen. Wenn Sie es leer lassen, lautet das Arbeitsverzeichnis $(Build.SourcesDirectory).

failOnStderr - Fehler beim Standardfehler
boolean. Standardwert. false.

Wenn der Wert auf true festgelegt ist, schlägt der Vorgang fehl, wenn Fehler in den Standardfehlerstream geschrieben werden.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Die Befehlszeile verfügt über eine Verknüpfung in YAML: steps.script.

- script: # inline script
  workingDirectory: #
  displayName: #
  failOnStderr: #
  env: { string: string } # mapping of environment variables to add

Ausführen von Batch und . CMD-Dateien

Azure Pipelines legt den Inhalt Ihres Inline-Skripts in einer temporären Batchdatei (.cmd) ab, um es auszuführen. Wenn Sie eine Batchdatei aus einer anderen Batchdatei in Windows CMD ausführen möchten, müssen Sie den call Befehl verwenden. Andernfalls wird die erste Batchdatei beendet. Dies führt dazu, dass Azure Pipelines Ihr geplantes Skript bis zum ersten Aufruf einer Batchdatei ausführt, dann die aufgerufene Batchdatei ausführt und den Schritt beendet. Die restlichen Zeilen im ersten Skript werden nicht mehr ausgeführt. Sie sollten immer vor dem Ausführen einer Batchdatei in einem Azure Pipelines-Skriptschritt voranstellen call .

Wichtig

Möglicherweise wissen Sie nicht, dass Sie eine Batchdatei ausführen. Unter Windows sind beispielsweise npm zusammen mit allen Tools, die Sie mit npm install -ginstallieren, tatsächlich Batchdateien. Verwenden Sie call npm <command> immer , um NPM-Befehle in einer Befehlszeilenaufgabe unter Windows auszuführen.

Beispiele

steps:
- script: date /t
  displayName: Get the date
- script: dir
  workingDirectory: $(Agent.BuildDirectory)
  displayName: List contents of a folder
- script: |
    set MYVAR=foo
    set
  displayName: Set a variable and then display all
  env:
    aVarFromYaml: someValue

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Hilfsprogramm

Weitere Informationen

Erfahren Sie, wie Sie ausführliche Protokolle für die Problembehandlung verwenden.

Freigeben über