BatchScript@1 - 批处理脚本 v1 任务

使用此任务可以运行 Windows .bat.cmd 脚本。 (可选)or .bat.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 .bat 脚本的.cmd参数。


modifyEnvironment - Modify Environment
boolean。 默认值:False

确定环境变量修改是否会影响后续任务。


workingFolder - 工作文件夹
string

运行脚本时的当前工作目录。 这默认为脚本所在的文件夹。


标准错误failOnStandardError - 失败
boolean。 默认值:false

如果为 true,则如果任何错误都写入 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'

要求

要求 DESCRIPTION
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 自承载代理必须具有与以下 要求 运行使用此任务的作业 功能: Cmd
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
Settable 变量 任意
代理版本 1.83.0 或更高版本
任务类别 效用