CmdLine@2 – Befehlszeilenaufgabe v2

  • Artikel

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.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

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.


script - Skript
string. Erforderlich. Standardwert. echo Write your commands here.

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 die Aufgabe fehl, wenn Fehler in den Standardfehlerdatenstrom geschrieben werden.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen über Steuerungsoptionen zusätzlich zu ihren Aufgabeneingaben. Weitere Informationen finden Sie unter Steuerelementoptionen 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 fügt Ihren Inlineskriptinhalt in eine temporäre Batchdatei (CMD) ein, um sie 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 beabsichtigtes Skript bis zur ersten Batchdatei ausführen und dann die Batchdatei ausführen und dann den Schritt beenden. Zusätzliche Zeilen im ersten Skript werden nicht ausgeführt. Sie sollten vor dem Ausführen einer Batchdatei in einem Azure Pipelines-Skriptschritt immer vorab ausgeführt call werden.

Wichtig

Möglicherweise wird nicht erkannt, dass Sie eine Batchdatei ausführen. Beispielsweise npm sind unter Windows zusammen mit allen Tools, die Sie installieren npm install -g, batchdateien. Verwenden call npm <command> Sie immer NPM-Befehle in einer Befehlszeilenaufgabe unter Windows.

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, Classic Build, Classic Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Dieser Vorgang erfüllt keine Anforderungen an nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Any
Settable-Variablen Any
Agent-Version Alle unterstützten Agent-Versionen.
Aufgabenkategorie Hilfsprogramm

Siehe auch