共用方式為


AzureResourceGroupDeployment@1 - Azure 資源群組部署 v1 工作

使用此工作來部署、啟動、停止和刪除 Azure 資源群組。

此工作已被取代;使用 AzureResourceGroupDeployment@2

語法

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

輸入

ConnectedServiceNameSelector - Azure 連線類型
string。 允許的值:ConnectedServiceName(Azure Resource Manager)、ConnectedServiceNameClassic(Azure 傳統)。 預設值:ConnectedServiceName

必須的。 選取包含部署 Azure 訂用帳戶的服務連線。


ConnectedServiceName - Azure 訂用帳戶
stringConnectedServiceNameSelector = ConnectedServiceName時為必要項。

必須的。 選取包含部署 Azure 訂用帳戶的服務連線。


ConnectedServiceNameClassic - Azure 傳統訂用帳戶
stringConnectedServiceNameSelector = ConnectedServiceNameClassic時為必要項。

選取部署的 Azure 傳統訂用帳戶。


action - 動作
stringConnectedServiceNameSelector = ConnectedServiceName時為必要項。 允許的值:Create Or Update Resource GroupSelect Resource GroupStart(啟動虛擬機)、Stop(停止虛擬機)、Restart(重新啟動虛擬機)、Delete(刪除虛擬機)、DeleteRG(刪除資源群組)。 預設值:Create Or Update Resource Group

要對 Azure 資源或資源群組執行的動作。


actionClassic - 動作
stringConnectedServiceNameSelector = ConnectedServiceNameClassic時為必要項。 允許的值:Select Resource Group (選取雲端服務)。 預設值:Select Resource Group

要對 Azure 資源或雲端服務執行的動作。


resourceGroupName - 資源群組
stringConnectedServiceNameSelector = ConnectedServiceName時為必要項。

提供資源群組的名稱。


cloudService - 雲端服務
stringConnectedServiceNameSelector = ConnectedServiceNameClassic時為必要項。

提供雲端服務的名稱。


location - 位置
stringaction = Create Or Update Resource Group時為必要項。 允許的值:Australia EastAustralia SoutheastBrazil SouthCanada CentralCanada EastCentral IndiaCentral USEast AsiaEast USEast US 2 Japan EastJapan WestNorth Central USNorth EuropeSouth Central USSouth IndiaSoutheast AsiaUK SouthUK WestWest Central USWest EuropeWest IndiaWest USWest US 2。 預設值:East US

要部署資源群組的位置。 如果資源群組已存在於訂用帳戶中,則會忽略此值。


csmFile - 範本
stringaction = Create Or Update Resource Group時為必要項。

指定指向 Azure Resource Manager 樣本的路徑或模式。 深入瞭解 Azure Resource Manager 範本。 若要立即開始使用,請使用此範例範本


csmParametersFile - 範本參數
string。 選擇性。 action = Create Or Update Resource Group時使用 。

指定參數檔案的 URL。 範例 URL:https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

若要使用儲存在私人記憶體帳戶中的檔案,請在範本的 URL 中擷取並包含共用存取簽章 (SAS) 令牌。 範例:<blob_storage_url>/template.json?<SAStoken> 若要將參數檔案上傳至記憶體帳戶併產生 SAS 令牌,請使用 Azure 檔案複製 工作,或使用 PowerShellAzure CLI遵循步驟。

若要在方格中檢視範本參數,請按兩下 [覆寫範本參數] 文字框旁的 []。 此功能要求在來源啟用 CORS 規則。 如果範本位於 Azure 記憶體 Blob 中,請參閱 跨原始來源資源分享 啟用 CORS。


overrideParameters - 覆寫範本參數
string。 選擇性。 action = Create Or Update Resource Group時使用 。

指定要覆寫的範本參數。

若要在方格中檢視範本參數,請按兩下 [覆寫參數] 文字框中旁的 [...]。 此功能要求在來源啟用 CORS 規則。 如果範本位於 Azure 記憶體 Blob 中,請參考此字串以啟用 CORS,或在文字框中輸入要覆寫的範本參數。

範例: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

如果參數值有多個單字,請以引號括住單字,即使您使用變數傳遞值也一樣。 例如: -name "parameter value" -name2 "$(var)" 。 若要覆寫物件類型參數,請使用字串化的 JSON 物件。 例如: -options ["option1"] -map {"key1": "value1" }


deploymentMode - 部署模式
stringaction = Create Or Update Resource Group時為必要項。 允許的值:Validation(僅限驗證)、IncrementalComplete。 預設值:Incremental

Incremental 模式會將部署當做資源群組的累加式更新來處理。 它會保留存在於資源群組中但未指定於範本中的未變更資源。

Complete 模式會刪除不在範本中的資源。 完整模式所需的時間比累加模式還多。 如果工作逾時,請考慮增加逾時或變更為 Incremental 模式。

警告

完整模式將會刪除範本中未指定之資源群組中的所有現有資源。 請檢閱您要部署的資源群組是否不包含範本中未指定的任何必要資源。

Validate 模式可讓您在建立實際資源之前,先找出範本的問題。

備註

Validate 模式一律會建立資源群組,即使未部署任何資源也一樣。

深入瞭解 部署模式。


enableDeploymentPrerequisitesForCreate - 啟用部署必要條件
boolean。 選擇性。 action = Create Or Update Resource Group時使用 。 預設值:false

僅適用於資源群組包含虛擬機時。

選擇 [部署群組] 選項會在每部虛擬機上設定部署群組代理程式。

選取 WinRM 選項會使用自我簽署憑證,透過埠 5986 上的 HTTPS 通訊協定設定 Windows 遠端管理 (WinRM) 接聽程式。 在 Azure 機器上執行部署作業需要此設定。 如果目標虛擬機由負載平衡器支援,請確定已針對目標埠 (5986) 設定輸入 NAT 規則。


enableDeploymentPrerequisitesForSelect - 啟用部署必要條件
boolean。 選擇性。 action = Select Resource Group時使用 。 預設值:false

僅適用於資源群組包含虛擬機時。

選擇 [部署群組] 選項會在每部虛擬機上設定部署群組代理程式。

選取 WinRM 選項會使用自我簽署憑證,透過埠 5986 上的 HTTPS 通訊協定設定 Windows 遠端管理 (WinRM) 接聽程式。 在 Azure 機器上執行部署作業需要此設定。 如果目標虛擬機由負載平衡器支援,請確定已針對目標埠 (5986) 設定輸入 NAT 規則。


outputVariable - 資源群組
string

選取現有資源群組時為必要專案。 提供資源群組變數的名稱。 變數可作為 $(variableName) 來參考後續工作中的資源群組,例如在目標機器上部署應用程式的PowerShell中。

只有在選取的動作 CreateUpdateSelect時才有效。


工作控制選項

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

輸出變數

沒有。

需求

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