共用方式為

AzureCLI@1 - Azure CLI v1 工作

  • 發行項

在 Linux 代理程式上執行時或在 Windows 代理程式上執行時，針對殼層腳本中的 Azure 訂用帳戶執行 Azure CLI 命令。

語法

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

輸入

azureSubscription - Azure 訂用帳戶
輸入別名：connectedServiceNameARM。 string。 必須的。

選取部署的 Azure Resource Manager 訂用帳戶。


scriptLocation - 腳本位置
string。 必須的。 允許的值：inlineScript （內嵌腳本），scriptPath （腳本路徑）。 預設值：scriptPath。

選取腳本位置。


scriptPath - 文稿路徑
string。 scriptLocation = scriptPath時為必要項。

文本的完整路徑或相對於預設工作目錄的路徑。


inlineScript - 內嵌腳本
string。 scriptLocation = inlineScript時為必要項。

您可以在這裏內嵌撰寫文稿。 使用 Windows 代理程式時，請使用批次腳本。 使用以Linux為基礎的代理程式時，請使用殼層腳本。 針對批處理檔，請在每個 Azure 命令之前，使用前置詞 call。 您也可以使用自變數將預先定義和自訂變數傳遞至此腳本

請參閱下列範例。 第一個是殼層範例，第二個是批次範例：

azure --version || azure account show 

call  azure --version || call azure account show

arguments - 自變數
輸入別名：args。 string。

傳遞至腳本的自變數。


在腳本中 addSpnToEnvironment - Access 服務主體詳細數據
boolean。 預設值：false。

將您選擇的 Azure 端點服務主體識別碼和金鑰新增至腳本的執行環境。 您可以在文稿中使用 $servicePrincipalId 和 $servicePrincipalKey 變數。

僅在 Azure 端點具有服務主體驗證配置時，才會接受此作業。


useGlobalConfig - 使用全域 Azure CLI 組態
boolean。 預設值：false。

如果這是 false，此工作將會使用自己的個別 Azure CLI 組態目錄。 這可用來在平行 版本中 執行 Azure CLI 工作。


workingDirectory - 工作目錄
輸入別名：cwd。 string。

執行文稿的目前工作目錄。 如果保留空白，則此輸入是存放庫（組建）或成品（release）的根目錄，也就是 $(System.DefaultWorkingDirectory)。


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

如果此輸入為 true，當任何錯誤寫入 StandardError 數據流時，此工作將會失敗。 清除複選框以忽略標準錯誤，而是依賴結束代碼來判斷狀態。


工作控制選項

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

輸出變數

沒有。

備註

1.0 版的新功能：

  • 支援以 Python 為基礎的新 Azure CLI 2.0
  • 適用於跨平臺代理程式 （Linux、macOS 或 Windows）
  • 若要使用 Azure CLI 1.0 （以node.js為基礎），請切換至工作 0.0 版
  • 限制：- 不支援 Azure 傳統訂用帳戶。 Azure CLI 2.0 僅支援 Azure Resource Manager （ARM） 訂用帳戶。

需求

要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.0.0 或更新
工作類別 部署