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

Статья
03/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.

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

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

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

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

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

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

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

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

Нет.

Замечания

Командная строка содержит ярлык в 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
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Полезность

См. также

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

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