az deployment

管理訂用帳戶範圍的 Azure Resource Manager 範本部署。

命令

名稱 Description 類型 狀態
az deployment cancel

取消訂用帳戶範圍的部署。

核心 已取代
az deployment create

在訂用帳戶範圍啟動部署。

核心 已取代
az deployment delete

刪除訂用帳戶範圍的部署。

核心 已取代
az deployment export

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

核心 已取代
az deployment group

管理資源群組的 Azure Resource Manager 範本部署。

核心 GA
az deployment group cancel

取消資源群組的部署。

核心 GA
az deployment group create

在資源群組啟動部署。

核心 GA
az deployment group delete

刪除資源群組的部署。

核心 GA
az deployment group export

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

核心 GA
az deployment group list

列出資源群組中的部署。

核心 GA
az deployment group show

顯示資源群組的部署。

核心 GA
az deployment group validate

驗證範本是否在資源群組中有效。

核心 GA
az deployment group wait

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

核心 GA
az deployment group what-if

在資源群組範圍執行部署 What-If 作業。

核心 GA
az deployment list

列出訂用帳戶範圍的部署。

核心 已取代
az deployment mg

管理管理群組的 Azure Resource Manager 範本部署。

核心 GA
az deployment mg cancel

取消管理群組的部署。

核心 GA
az deployment mg create

在管理群組啟動部署。

核心 GA
az deployment mg delete

刪除管理群組的部署。

核心 GA
az deployment mg export

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

核心 GA
az deployment mg list

列出管理群組中的部署。

核心 GA
az deployment mg show

顯示管理群組的部署。

核心 GA
az deployment mg validate

驗證範本是否在管理群組中有效。

核心 GA
az deployment mg wait

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

核心 GA
az deployment mg what-if

在管理群組範圍執行部署 What-If 作業。

核心 GA
az deployment operation

管理訂用帳戶範圍的部署作業。

核心 GA
az deployment operation group

管理資源群組的部署作業。

核心 GA
az deployment operation group list

列出資源群組的部署作業。

核心 GA
az deployment operation group show

顯示資源群組的部署作業。

核心 GA
az deployment operation list

列出訂用帳戶範圍的部署作業。

核心 已取代
az deployment operation mg

管理管理群組的部署作業。

核心 GA
az deployment operation mg list

列出管理群組的部署作業。

核心 GA
az deployment operation mg show

顯示管理群組的部署作業。

核心 GA
az deployment operation show

在訂用帳戶範圍顯示部署作業。

核心 已取代
az deployment operation sub

管理訂用帳戶範圍的部署作業。

核心 GA
az deployment operation sub list

列出訂用帳戶範圍的部署作業。

核心 GA
az deployment operation sub show

在訂用帳戶範圍顯示部署作業。

核心 GA
az deployment operation tenant

管理租使用者範圍的部署作業。

核心 GA
az deployment operation tenant list

列出租使用者範圍的部署作業。

核心 GA
az deployment operation tenant show

在租使用者範圍顯示部署作業。

核心 GA
az deployment show

在訂用帳戶範圍顯示部署。

核心 已取代
az deployment sub

管理訂用帳戶範圍的 Azure Resource Manager 範本部署。

核心 GA
az deployment sub cancel

取消訂用帳戶範圍的部署。

核心 GA
az deployment sub create

在訂用帳戶範圍啟動部署。

核心 GA
az deployment sub delete

刪除訂用帳戶範圍的部署。

核心 GA
az deployment sub export

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

核心 GA
az deployment sub list

列出訂用帳戶範圍的部署。

核心 GA
az deployment sub show

在訂用帳戶範圍顯示部署。

核心 GA
az deployment sub validate

驗證範本是否在訂用帳戶範圍有效。

核心 GA
az deployment sub wait

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

核心 GA
az deployment sub what-if

在訂用帳戶範圍執行部署 What-If 作業。

核心 GA
az deployment tenant

管理租使用者範圍的 Azure Resource Manager 範本部署。

核心 GA
az deployment tenant cancel

取消租使用者範圍的部署。

核心 GA
az deployment tenant create

在租使用者範圍啟動部署。

核心 GA
az deployment tenant delete

刪除租使用者範圍的部署。

核心 GA
az deployment tenant export

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

核心 GA
az deployment tenant list

列出租使用者範圍的部署。

核心 GA
az deployment tenant show

在租使用者範圍顯示部署。

核心 GA
az deployment tenant validate

驗證範本是否在租使用者範圍內有效。

核心 GA
az deployment tenant wait

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

核心 GA
az deployment tenant what-if

在租使用者範圍執行部署 What-If 作業。

核心 GA
az deployment validate

驗證範本是否在訂用帳戶範圍有效。

核心 已取代
az deployment wait

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

核心 已取代

az deployment cancel

已被取代

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

取消訂用帳戶範圍的部署。

az deployment cancel --name

範例

取消訂用帳戶範圍的部署。

az deployment cancel -n deployment01

必要參數

--name -n

部署名稱。

全域參數
--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 deployment create

已被取代

此命令已被取代,並將在未來版本中移除。 請改用「部署子建立」。

在訂用帳戶範圍啟動部署。

請只指定 --template-file FILE 的其中一個 |--template-uri URI |--template-spec 以輸入 ARM 範本。

az deployment create --location
                     [--confirm-with-what-if]
                     [--handle-extended-json-format]
                     [--name]
                     [--no-prompt {false, true}]
                     [--no-wait]
                     [--parameters]
                     [--proceed-if-no-change]
                     [--query-string]
                     [--template-file]
                     [--template-spec]
                     [--template-uri]
                     [--what-if]
                     [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                     [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

範例

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

az deployment create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment create --location WestUS --template-file azuredeploy.json  \
    --parameters "{ \"policyName\": { \"value\": \"policy2\" }}"

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

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

從範本規格在訂用帳戶範圍建立部署

az deployment create --location WestUS --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

必要參數

--location -l

要儲存部署中繼資料的位置。

選擇性參數

--confirm-with-what-if -c

指示命令在執行部署之前執行部署 What-If。 然後,它會提示您確認資源變更,然後再繼續。

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

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

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

--name -n

部署名稱。

--no-prompt

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

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

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

預設值: False
--parameters -p

提供部署參數值。

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

--proceed-if-no-change

如果 What-If 結果不包含任何資源變更,請指示命令執行部署。 適用于設定 --confirm-with-what-if 時。

--query-string -q

在連結範本的情況下,要與 template-uri 搭配使用的查詢字串(SAS 權杖)。

--template-file -f

範本檔案或 Bicep 檔案的路徑。

--template-spec -s

範本規格資源識別碼。

--template-uri -u

範本檔案的 URI。

--what-if -w

指示命令執行部署 What-If。

--what-if-exclude-change-types -x

要從 What-If 結果中排除的資源變更類型空格分隔清單。 適用于設定 --confirm-with-what-if 時。

接受的值: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

What-If 結果的格式。 設定時 --confirm-with-what-if 適用。

接受的值: FullResourcePayloads, ResourceIdOnly
預設值: FullResourcePayloads
全域參數
--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 deployment delete

已被取代

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

刪除訂用帳戶範圍的部署。

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

範例

刪除訂用帳戶範圍的部署。

az deployment delete -n deployment01

必要參數

--name -n

部署名稱。

選擇性參數

--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 deployment export

已被取代

此命令已被取代,並將在未來版本中移除。 請改用「部署子匯出」。

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

az deployment export --name

範例

匯出用於訂用帳戶範圍部署的範本。

az deployment export --name MyDeployment

必要參數

--name -n

部署名稱。

全域參數
--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 deployment list

已被取代

此命令已被取代,並將在未來版本中移除。 請改用「部署子清單」。

列出訂用帳戶範圍的部署。

az deployment list [--filter]

範例

列出訂用帳戶範圍的部署。

az deployment list

選擇性參數

--filter
預覽

使用 OData 標記法篩選運算式。 您可以使用 --filter 「provisioningState eq '{state}'」 來篩選 provisioningState。 若要取得詳細資訊,請造訪 https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters

全域參數
--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 deployment show

已被取代

此命令已被取代,並將在未來版本中移除。 請改用 「部署子顯示」。

在訂用帳戶範圍顯示部署。

az deployment show --name

範例

在訂用帳戶範圍顯示部署。

az deployment show -n deployment01

必要參數

--name -n

部署名稱。

全域參數
--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 deployment validate

已被取代

此命令已被取代,並將在未來版本中移除。 請改用「部署子驗證」。

驗證範本是否在訂用帳戶範圍有效。

請只指定 --template-file FILE 的其中一個 |--template-uri URI |--template-spec 以輸入 ARM 範本。

az deployment validate --location
                       [--handle-extended-json-format]
                       [--name]
                       [--no-prompt {false, true}]
                       [--parameters]
                       [--query-string]
                       [--template-file]
                       [--template-spec]
                       [--template-uri]

範例

驗證範本是否在訂用帳戶範圍有效。

az deployment validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

必要參數

--location -l

要儲存部署中繼資料的位置。

選擇性參數

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

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

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

--name -n

部署名稱。

--no-prompt

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

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

提供部署參數值。

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

--query-string -q

在連結範本的情況下,要與 template-uri 搭配使用的查詢字串(SAS 權杖)。

--template-file -f

範本檔案或 Bicep 檔案的路徑。

--template-spec -s

範本規格資源識別碼。

--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 deployment wait

已被取代

此命令已被取代,並將在未來版本中移除。 請改用「部署子等候」。

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

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

範例

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

az deployment wait --deleted --name MyDeployment --subscription MySubscription

必要參數

--name -n

部署名稱。

選擇性參數

--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 來取得完整偵錯記錄。