CmdLine@2 — задача командной строки версии 2

Статья
02/24/2025

Используйте эту задачу для запуска скрипта командной строки с помощью Bash в Linux, macOS и cmd.exe в Windows.

Синтаксис

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

Входные данные

script - Сценарий
string. Обязательный. Значение по умолчанию: echo Write your commands here\n\necho Hello world.

Содержимое скрипта, который требуется запустить.

script - Сценарий
string. Обязательный. Значение по умолчанию: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

Содержимое скрипта, который требуется запустить.

workingDirectory - Рабочий каталог
string.

Указывает рабочий каталог для выполнения команд. Если оставить его пустым, рабочий каталог будет $(Build.SourcesDirectory).

failOnStderr - Сбой при стандартной ошибке
boolean. Значение по умолчанию: false.

Если задано значение "true", задача завершается неудачно, если какие-либо ошибки записываются в поток стандартных ошибок.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Командная строка содержит ярлык в YAML: steps.script.

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

Выполнение пакета и . CMD-файлы

Azure Pipelines помещает содержимое встроенного скрипта во временный пакетный файл (CMD- файл), чтобы запустить его. Если вы хотите запустить пакетный файл из другого пакетного файла в Windows CMD, необходимо использовать call команду , в противном случае первый пакетный файл завершается. Это приведет к тому, что Azure Pipelines запустит запланированный скрипт до первого пакетного файла, затем запустит пакетный файл и после этого завершит шаг. Дополнительные строки в первом скрипте не выполняются. Перед выполнением пакетного файла на шаге скрипта Azure Pipelines всегда следует добавлять call его в предварительном виде.

Важно!

Возможно, вы не понимаете, что запускаете пакетный файл. Например, npm в Windows вместе со средствами, устанавливающимися с помощью npm install -g, фактически являются пакетными файлами. Всегда используйте для call npm <command> выполнения команд NPM в задаче командной строки в Windows.

Примеры

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

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	None
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Служебная программа

См. также раздел

Узнайте, как использовать подробные журналы для устранения неполадок.

Поделиться через