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'

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
要求	自我裝載代理程式必須具有 功能， 符合下列 需求， 執行使用此工作的作業： Cmd
能力	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.83.0 或更新
工作類別	效用