CmdLine@2 – úloha příkazového řádku v2

Článek
24. 02. 2025

Tato úloha slouží ke spuštění skriptu příkazového řádku pomocí Bash v Linuxu, macOS a cmd.exe ve Windows.

Syntax

YAML

# 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.

Vstupy

script - Skript
string. Povinná hodnota. Výchozí hodnota: echo Write your commands here\n\necho Hello world.

Obsah skriptu, který chcete spustit.

script - Skript
string. Povinná hodnota. Výchozí hodnota: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

Obsah skriptu, který chcete spustit.

workingDirectory - Pracovní adresář
string.

Určuje pracovní adresář pro spouštění příkazů. Pokud ho necháte prázdný, bude pracovní adresář $(Build.SourcesDirectory).

failOnStderr - Selhání při standardní chybě
boolean. Výchozí hodnota: false.

Pokud je hodnota nastavená na true, úloha selže, pokud jsou do streamu standardních chyb zapsány nějaké chyby.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Příkazový řádek obsahuje zástupce v YAML: steps.script.

yml

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

Spuštění dávky a . Soubory CMD

Azure Pipelines vloží obsah vloženého skriptu do dočasného dávkového souboru (.cmd), aby ho bylo možné spustit. Pokud chcete spustit dávkový soubor z jiného dávkového souboru v nástroji Windows CMD, musíte použít call příkaz, jinak se první dávkový soubor ukončí. Výsledkem bude, že Azure Pipelines spustí zamýšlený skript až do prvního dávkového souboru, pak spustí dávkový soubor a pak krok ukončí. Další řádky v prvním skriptu se nespustí. Před spuštěním dávkového souboru v kroku skriptu Azure Pipelines byste se měli vždy předem call přihlásit.

Důležité

Možná si neuvědomíte, že spouštíte dávkový soubor. Například npm ve Windows spolu s nástroji, které nainstalujete pomocí npm install -g, jsou ve skutečnosti dávkové soubory. Vždy používejte call npm <command> ke spouštění příkazů NPM v úloze příkazového řádku ve Windows.

Příklady

YAML

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Nástroj

Viz také

Naučte se používat podrobné protokoly pro řešení potíží.

Sdílet prostřednictvím