通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az deployment mg

管理组的 Azure 资源管理器模板部署。

命令

名称 说明 类型 Status
az deployment mg cancel

取消管理组中的部署。

 Core GA
az deployment mg create

在管理组中启动部署。

 Core GA
az deployment mg delete

删除管理组中的部署。

 Core GA
az deployment mg export

导出用于部署的模板。

 Core GA
az deployment mg list

列出管理组的部署。

 Core GA
az deployment mg show

在管理组中显示部署。

 Core GA
az deployment mg validate

验证模板是否在管理组中有效。

 Core GA
az deployment mg wait

将 CLI 置于等待状态，直到满足部署条件。

 Core GA
az deployment mg what-if

在管理组范围内执行部署 What-If 操作。

 Core GA

az deployment mg cancel

编辑

取消管理组中的部署。

az deployment mg cancel --management-group-id
                        --name

示例

取消管理组中的部署。

az deployment mg cancel -m testmg -n deployment01

必需参数

--management-group-id -m

管理组 ID。

--name -n

部署名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg create

编辑

在管理组中启动部署。

请仅指定一个 --template-file 文件 |--template-uri URI |--template-spec，用于输入 ARM 模板。

az deployment mg create --location
                        --management-group-id
                        [--confirm-with-what-if]
                        [--handle-extended-json-format]
                        [--mode {Complete, Incremental}]
                        [--name]
                        [--no-prompt {false, true}]
                        [--no-wait]
                        [--parameters]
                        [--proceed-if-no-change]
                        [--query-string]
                        [--template-file]
                        [--template-spec]
                        [--template-uri]
                        [--validation-level {Provider, ProviderNoRbac, Template}]
                        [--what-if]
                        [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                        [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

示例

使用本地 JSON 文件中的参数从远程模板文件在管理组创建部署。

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

使用 JSON 字符串中的参数，从本地模板文件在管理组创建部署。

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

使用参数文件、远程参数文件以及有选择地重写键/值对，从本地模板创建管理组的部署。

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

必需参数

--location -l

用于存储部署元数据的位置。

--management-group-id -m

要创建部署的管理组 ID。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--confirm-with-what-if -c

在执行部署之前，指示命令运行部署 What-If。 然后，它会提示你确认资源更改，然后再继续。

--handle-extended-json-format -j
已放弃

选项“--handle-extended-json-format/-j”已弃用，将在将来的版本中删除。

支持处理扩展模板内容，包括部署中的多行和注释。

--mode

用于部署资源的模式。 此值可以是增量值，也可以是“完成”。 在增量模式下，部署资源而不删除模板中不包含的现有资源。 在“完成”模式下，将部署资源，并删除模板中不包含的资源组中的现有资源。 使用“完成”模式时请注意，因为可能会无意中删除资源。

属性 值
默认值: Incremental
接受的值: Complete, Incremental
--name -n

部署名称。

--no-prompt

禁用 ARM 模板缺少参数提示的选项。 如果值为 true，则会忽略要求用户提供缺失参数的提示。 默认值为 false。

属性 值
默认值: False
接受的值: false, true
--no-wait

不等待长时间运行的操作完成。

属性 值
默认值: False
--parameters -p

提供部署参数值。

可以使用 @{path} 语法、JSON 字符串或 <KEY=VALUE> 对从文件提供参数。 参数按顺序计算，因此在为值分配两次时，将使用后一个值。 建议先提供参数文件，然后使用 KEY=VALUE 语法选择性地替代参数文件。

--proceed-if-no-change

指示命令在 What-If 结果不包含资源更改时执行部署。 在设置 --confirm-with-what-if 时适用。

--query-string -q

在链接模板的情况下，要与模板 URI 一起使用的查询字符串（SAS 令牌）。

--template-file -f

模板文件或 Bicep 文件的路径。

--template-spec -s

模板规格资源 ID。

--template-uri -u

模板文件的 URI。

--validation-level

部署验证级别。 可设置为“Provider”（默认值）、“Template”或“ProviderNoRbac”。 使用验证级别的“提供程序”，ARM 将执行完全验证，并检查你是否有足够的权限来部署模板中的所有资源。 使用验证级别为“providerNoRbac”，ARM 将执行完全验证，但只会检查每个资源的读取权限。 使用验证级别为“模板”时，将只执行静态验证：预检和权限检查将被跳过。

属性 值
接受的值: Provider, ProviderNoRbac, Template
--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
接受的值: FullResourcePayloads, ResourceIdOnly
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg delete

编辑

删除管理组中的部署。

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

示例

删除管理组中的部署。

az deployment mg delete -m testmg -n deployment01

必需参数

--management-group-id -m

管理组 ID。

--name -n

部署名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--no-wait

不等待长时间运行的操作完成。

属性 值
默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg export

编辑

导出用于部署的模板。

az deployment mg export --management-group-id
                        --name

示例

导出用于管理组部署的模板。

az deployment mg export --management-group-id testmg --name MyDeployment

必需参数

--management-group-id -m

管理组 ID。

--name -n

部署名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg list

编辑

列出管理组的部署。

az deployment mg list --management-group-id
                      [--filter]

示例

列出管理组的部署。

az deployment mg list -m testmg

必需参数

--management-group-id -m

管理组 ID。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--filter
预览

使用 OData 表示法筛选表达式。 可以使用 --filter “provisioningState eq '{state}'”筛选 provisioningState。 若要获取详细信息，请访问 https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg show

编辑

在管理组中显示部署。

az deployment mg show --management-group-id
                      --name

示例

在管理组中显示部署。

az deployment mg show -m testmg -n deployment01

必需参数

--management-group-id -m

管理组 ID。

--name -n

部署名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg validate

编辑

验证模板是否在管理组中有效。

请仅指定一个 --template-file 文件 |--template-uri URI |--template-spec，用于输入 ARM 模板。

az deployment mg validate --location
                          --management-group-id
                          [--handle-extended-json-format]
                          [--name]
                          [--no-prompt {false, true}]
                          [--parameters]
                          [--query-string]
                          [--template-file]
                          [--template-spec]
                          [--template-uri]
                          [--validation-level {Provider, ProviderNoRbac, Template}]

示例

验证模板是否在管理组中有效。

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

验证模板是否在管理组中有效。 (autogenerated)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

必需参数

--location -l

用于存储部署元数据的位置。

--management-group-id -m

要创建部署的管理组 ID。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--handle-extended-json-format -j
已放弃

选项“--handle-extended-json-format/-j”已弃用，将在将来的版本中删除。

支持处理扩展模板内容，包括部署中的多行和注释。

--name -n

部署名称。

--no-prompt

禁用 ARM 模板缺少参数提示的选项。 如果值为 true，则会忽略要求用户提供缺失参数的提示。 默认值为 false。

属性 值
默认值: False
接受的值: false, true
--parameters -p

提供部署参数值。

可以使用 @{path} 语法、JSON 字符串或 <KEY=VALUE> 对从文件提供参数。 参数按顺序计算，因此在为值分配两次时，将使用后一个值。 建议先提供参数文件，然后使用 KEY=VALUE 语法选择性地替代参数文件。

--query-string -q

在链接模板的情况下，要与模板 URI 一起使用的查询字符串（SAS 令牌）。

--template-file -f

模板文件或 Bicep 文件的路径。

--template-spec -s

模板规格资源 ID。

--template-uri -u

模板文件的 URI。

--validation-level

部署验证级别。 可设置为“Provider”（默认值）、“Template”或“ProviderNoRbac”。 使用验证级别的“提供程序”，ARM 将执行完全验证，并检查你是否有足够的权限来部署模板中的所有资源。 使用验证级别为“providerNoRbac”，ARM 将执行完全验证，但只会检查每个资源的读取权限。 使用验证级别为“模板”时，将只执行静态验证：预检和权限检查将被跳过。

属性 值
接受的值: Provider, ProviderNoRbac, Template
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg wait

编辑

将 CLI 置于等待状态，直到满足部署条件。

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

必需参数

--management-group-id -m

管理组 ID。

--name -n

部署名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--created

等待在“Succeeded”中使用“provisioningState”创建。

属性 值
参数组: Wait Condition Arguments
默认值: False
--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

属性 值
参数组: Wait Condition Arguments
--deleted

等到删除为止。

属性 值
参数组: Wait Condition Arguments
默认值: False
--exists

等待资源存在。

属性 值
参数组: Wait Condition Arguments
默认值: False
--interval

轮询间隔（以秒为单位）。

属性 值
参数组: Wait Condition Arguments
默认值: 30
--timeout

最大等待（以秒为单位）。

属性 值
参数组: Wait Condition Arguments
默认值: 3600
--updated

等到 provisioningState 更新为“Succeeded”。

属性 值
参数组: Wait Condition Arguments
默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az deployment mg what-if

编辑

在管理组范围内执行部署 What-If 操作。

请仅指定一个 --template-file 文件 |--template-uri URI |--template-spec，用于输入 ARM 模板。

az deployment mg what-if --location
                         --management-group-id
                         [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                         [--name]
                         [--no-pretty-print]
                         [--no-prompt {false, true}]
                         [--parameters]
                         [--query-string]
                         [--result-format {FullResourcePayloads, ResourceIdOnly}]
                         [--template-file]
                         [--template-spec]
                         [--template-uri]
                         [--validation-level {Provider, ProviderNoRbac, Template}]

示例

在管理组中执行部署 What-If 操作。

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

使用 ResourceIdOnly 格式在管理组中执行部署 What-If 操作。

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

在不打印结果的情况下，在管理组中执行部署 What-If 操作。

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

必需参数

--location -l

用于存储部署元数据的位置。

--management-group-id -m

要创建部署的管理组 ID。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--exclude-change-types -x

要从 What-If 结果中排除的资源更改类型的空格分隔列表。

属性 值
接受的值: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

部署名称。

--no-pretty-print

禁用 What-If 结果的漂亮打印。 设置后，将使用输出格式类型。

--no-prompt

禁用 ARM 模板缺少参数提示的选项。 如果值为 true，则会忽略要求用户提供缺失参数的提示。 默认值为 false。

属性 值
默认值: False
接受的值: false, true
--parameters -p

提供部署参数值。

可以使用 @{path} 语法、JSON 字符串或 <KEY=VALUE> 对从文件提供参数。 参数按顺序计算，因此在为值分配两次时，将使用后一个值。 建议先提供参数文件，然后使用 KEY=VALUE 语法选择性地替代参数文件。

--query-string -q

在链接模板的情况下，要与模板 URI 一起使用的查询字符串（SAS 令牌）。

--result-format -r

What-If 结果的格式。

属性 值
默认值: FullResourcePayloads
接受的值: FullResourcePayloads, ResourceIdOnly
--template-file -f

模板文件或 Bicep 文件的路径。

--template-spec -s

模板规格资源 ID。

--template-uri -u

模板文件的 URI。

--validation-level

部署验证级别。 可设置为“Provider”（默认值）、“Template”或“ProviderNoRbac”。 使用验证级别的“提供程序”，ARM 将执行完全验证，并检查你是否有足够的权限来部署模板中的所有资源。 使用验证级别为“providerNoRbac”，ARM 将执行完全验证，但只会检查每个资源的读取权限。 使用验证级别为“模板”时，将只执行静态验证：预检和权限检查将被跳过。

属性 值
接受的值: Provider, ProviderNoRbac, Template
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False