使用此任务可以运行 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 脚本。 (可选)允许它永久修改环境变量。
例子
在存储库的根目录中创建 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'