共用方式為


az group deployment

此命令群組已被取代,將在未來的版本中移除。 請改用「部署群組」。

管理 Azure Resource Manager 部署。

命令

名稱 Description 類型 狀態
az group deployment cancel

取消目前正在執行的範本部署。

核心 已取代
az group deployment create

開始部署。

核心 已取代
az group deployment delete

從部署歷程記錄中刪除部署。

核心 已取代
az group deployment export

匯出用於某個部署的範本。

核心 已取代
az group deployment list

取得某個資源群組的所有部署。

核心 已取代
az group deployment operation

管理部署作業。

核心 已取代
az group deployment operation list

取得部署的所有部署作業。

核心 已取代
az group deployment operation show

取得部署的作業。

核心 已取代
az group deployment show

取得部署。

核心 已取代
az group deployment validate

驗證範本是否語法正確。

核心 已取代
az group deployment wait

將 CLI 置於等候狀態,直到符合部署條件為止。

核心 已取代

az group deployment cancel

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

取消目前正在執行的範本部署。

只有當 provisioningState 已接受或執行時,您才能取消部署。 取消部署之後,provisioningState 會設定為 Canceled。 取消範本部署會停止目前正在執行的範本部署,並讓資源群組部分部署。

az group deployment cancel --name
                           --resource-group

必要參數

--name -n

部署名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment create

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

開始部署。

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

範例

使用本機 JSON 檔案中的參數,從遠端範本檔案建立部署。

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

使用 JSON 字串中的參數,從本機範本檔案建立部署。

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

使用本機參數檔案、遠端參數檔案,以及選擇性地覆寫索引鍵/值組,從本機範本建立部署。

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

必要參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--aux-subs
已被取代

選項 '--aux-subs' 已被取代,並將在未來版本中移除。 請改用 '--aux-tenants'。

將在跨租使用者部署期間使用的輔助訂用帳戶。

--aux-tenants

將在跨租使用者部署期間使用的輔助租使用者。

--handle-extended-json-format -j
已被取代

選項 '--handle-extended-json-format/-j' 已被取代,並將在未來版本中移除。

支援處理擴充範本內容,包括部署中的多行和批註。

--mode

累加式 (僅將資源新增至資源群組) 或 [完成] (從資源群組中移除額外的資源)。

接受的值: Complete, Incremental
預設值: Incremental
--name -n

部署名稱。 預設為範本檔案基底名稱。

--no-prompt

停用 ARM 範本遺漏參數提示的選項。 當值為 true 時,將會忽略要求使用者提供遺漏參數的提示。 預設值為 false。

接受的值: false, true
預設值: False
--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--parameters -p

提供部署參數值。

您可以使用語法、JSON 字串或 < KEY=VALUE > 組,從檔案 @{path} 提供參數。 參數會依序評估,因此當指派值兩次時,將會使用後者的值。 建議您先提供參數檔案,然後使用 KEY=VALUE 語法選擇性地覆寫。

--rollback-on-error

要在錯誤時復原至的部署名稱,或使用 做為旗標來回複至最後一次成功的部署。

--template-file -f

檔案系統中範本檔案或 Bicep 檔案的路徑。

--template-uri -u

遠端範本檔案的 URI。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment delete

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

從部署歷程記錄中刪除部署。

目前執行的範本部署無法刪除。 刪除範本部署會移除相關聯的部署作業。 刪除範本部署不會影響資源群組的狀態。 這是非同步作業,會傳回 202 的狀態,直到範本部署成功刪除為止。 位置回應標頭包含用來取得進程狀態的 URI。 當進程執行時,[位置] 標頭中 URI 的呼叫會傳回 202 的狀態。 當進程完成時,Location 標頭中的 URI 會在成功時傳回 204 的狀態。 如果非同步要求失敗,Location 標頭中的 URI 會傳回錯誤層級的狀態碼。

az group deployment delete --name
                           --resource-group
                           [--no-wait]

必要參數

--name -n

部署名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment export

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

匯出用於某個部署的範本。

az group deployment export --name
                           --resource-group

範例

匯出用於某個部署的範本。 (自動產生)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

必要參數

--name -n

部署名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment list

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

取得某個資源群組的所有部署。

az group deployment list --resource-group
                         [--filter]
                         [--top]

必要參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--filter

要套用至作業的篩選準則。 例如,您可以使用 $filter=provisioningState eq '{state}'。 預設值為 None。

--top

要取得的結果數目。 如果傳遞 null,則會傳回所有部署。 預設值為 None。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment show

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

取得部署。

az group deployment show --name
                         --resource-group

必要參數

--name -n

部署名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment validate

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

驗證範本是否語法正確。

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

範例

驗證範本是否語法正確。 (自動產生)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

必要參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--handle-extended-json-format -j
已被取代

選項 '--handle-extended-json-format/-j' 已被取代,並將在未來版本中移除。

支援處理擴充範本內容,包括部署中的多行和批註。

--mode

累加式 (僅將資源新增至資源群組) 或 [完成] (從資源群組中移除額外的資源)。

接受的值: Complete, Incremental
預設值: Incremental
--no-prompt

停用 ARM 範本遺漏參數提示的選項。 當值為 true 時,將會忽略要求使用者提供遺漏參數的提示。 預設值為 false。

接受的值: false, true
預設值: False
--parameters -p

提供部署參數值。

您可以使用語法、JSON 字串或 < KEY=VALUE > 組,從檔案 @{path} 提供參數。 參數會依序評估,因此當指派值兩次時,將會使用後者的值。 建議您先提供參數檔案,然後使用 KEY=VALUE 語法選擇性地覆寫。

--rollback-on-error

要在錯誤時復原至的部署名稱,或使用 做為旗標來回複至最後一次成功的部署。

--template-file -f

檔案系統中範本檔案或 Bicep 檔案的路徑。

--template-uri -u

遠端範本檔案的 URI。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az group deployment wait

已被取代

此命令已隱含取代,因為命令群組 'group deployment' 已被取代,且將在未來的版本中移除。 請改用「部署群組」。

將 CLI 置於等候狀態,直到符合部署條件為止。

az group deployment wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

範例

將 CLI 置於等候狀態,直到符合部署條件為止。 (自動產生)

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

將 CLI 置於等候狀態,直到符合部署條件為止。 (自動產生)

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

必要參數

--name -n

部署名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自訂 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--interval

輪詢間隔以秒為單位。

預設值: 30
--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。