BatchScript@1 - Задача пакетного скрипта версии 1

2025-06-24

Используйте эту задачу для запуска Windows .bat или .cmd скрипта. При .bat необходимости скрипт or .cmd может постоянно изменять переменные среды.

Синтаксис

# Batch script v1
# Run a Windows command or batch script and optionally allow it to change the environment.
- task: BatchScript@1
  inputs:
    filename: # string. Required. Path. 
    #arguments: # string. Arguments. 
    #modifyEnvironment: False # boolean. Modify Environment. Default: False.
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

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

Путь filename -
string. Обязательное.

Путь к сценарию .cmd or .bat для выполнения. Это должен быть полный путь или один относительно рабочего каталога по умолчанию. (Обратите внимание, что рабочий каталог может отличаться от workingFolder, который может быть указан для этой задачи.)

arguments - аргументы
string.

Аргументы, передаваемые в скрипт or .cmd.bat .

modifyEnvironment - Изменение среды
boolean. Значение по умолчанию: False.

Определяет, повлияют ли изменения переменных среды на последующие задачи.

workingFolder - Рабочая папка
string.

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

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

Если это верно, эта задача завершится ошибкой, если в поток StandardError записываются ошибки.

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

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

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

Нет.

Замечания

Используйте эту задачу для запуска сценария Windows .bat или .cmd. При необходимости разрешите ему постоянно изменять переменные среды.

Замечание

Эта задача несовместима с контейнерами Windows. Если вам нужно запустить пакетный сценарий в контейнере Windows, используйте вместо этого задачу командной строки .

Сведения о поддержке нескольких платформ см. в разделе Кроссплатформенные скрипты.

Примеры

Создайте test.bat в корне вашего репозитория:

@echo off
echo Hello World from %AGENT_NAME%.
echo My ID is %AGENT_ID%.
echo AGENT_WORKFOLDER contents:
@dir %AGENT_WORKFOLDER%
echo AGENT_BUILDDIRECTORY contents:
@dir %AGENT_BUILDDIRECTORY%
echo BUILD_SOURCESDIRECTORY contents:
@dir %BUILD_SOURCESDIRECTORY%
echo Over and out.

Чтобы запустить этот скрипт, добавьте в конвейер следующую задачу.

- task: BatchScript@1
  inputs:
    filename: 'test.bat'

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: Cmd
Возможности	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.83.0 или более поздней версии
Категория задач	Полезность