ShellScript@2 - 殼層腳本 v2 工作

使用此工作，使用 bash 執行殼層腳本。

Syntax

# Shell script v2
# Run a shell script using Bash.
- task: ShellScript@2
  inputs:
    scriptPath: # string. Required. Script Path. 
    #args: # string. Arguments. 
  # Advanced
    #disableAutoCwd: false # boolean. Specify Working Directory. Default: false.
    #cwd: # string. Optional. Use when disableAutoCwd = true. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

輸入

scriptPath - 腳本路徑
string. 必要。

指定要執行之殼層腳本檔案之存放庫根目錄的相對路徑。

args - 參數
string.

指定您要傳遞至腳本的引數。

disableAutoCwd - 指定工作目錄
boolean. 預設值：false。

指定工作執行腳本的工作目錄。 如果值保留空白，工作會預設為腳本所在的資料夾。

cwd - 工作目錄
string. 選擇性。 使用 時 disableAutoCwd = true 。

指定執行腳本的工作目錄。 如果值保留空白，工作會使用存放庫的根目錄， (組建) 或成品 (發行) ，也就是 $(System.DefaultWorkingDirectory) 。

failOnStandardError - 標準錯誤失敗
boolean. 預設值：false。

如果值為 true ，則如果錯誤寫入 StandardError 資料流程，工作將會失敗。

工作控制項選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

備註

我可以在哪裡瞭解 Bash 腳本？

• 初學者/BashScripting 入門。
• 令人讚歎的 Bash更深入。

如何?設定變數，以供後續腳本和工作讀取？

若要深入瞭解如何在腳本中定義組建變數，請參閱 在腳本中定義和修改組建變數。

若要深入瞭解如何在腳本中定義發行變數，請參閱 在腳本中定義和修改您的發行變數

範例

在存放庫的根目錄中建立 test.sh 。 建議您從 Linux 環境建立此檔案， (例如實際的 Linux 電腦或Windows 子系統 Linux 版) ，讓行尾線正確無誤。 此外，在認可之前別忘 chmod +x test.sh 了。

#!/bin/bash
echo "Hello World"
echo "AGENT_WORKFOLDER is $AGENT_WORKFOLDER"
echo "AGENT_WORKFOLDER contents:"
ls -1 $AGENT_WORKFOLDER
echo "AGENT_BUILDDIRECTORY is $AGENT_BUILDDIRECTORY"
echo "AGENT_BUILDDIRECTORY contents:"
ls -1 $AGENT_BUILDDIRECTORY
echo "SYSTEM_HOSTTYPE is $SYSTEM_HOSTTYPE"
echo "Over and out."

將下列工作新增至管線，以執行先前的腳本。

- task: ShellScript@2
  inputs:
    scriptPath: 'test.sh'

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在 上執行	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的工作： sh
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
可設定變數	任意
代理程式版本	所有支援的代理程式版本。
工作類別	公用程式