你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
az deployment
在订阅范围内管理 Azure 资源管理器模板部署。
命令
az deployment cancel
此命令已弃用，将在将来的版本中删除。 请改用“部署子取消”。
取消订阅范围内的部署。
az deployment cancel --name示例
取消订阅范围内的部署。
az deployment cancel -n deployment01必需参数
部署名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment create
此命令已弃用，将在将来的版本中删除。 请改用“部署子创建”。
在订阅范围内启动部署。
请仅指定一个 --template-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"必需参数
用于存储部署元数据的位置。
可选参数
指示命令在执行部署之前运行部署 What-If。 然后，它会提示你确认资源更改，然后再继续。
选项“--handle-extended-json-format/-j”已弃用，将在将来的版本中删除。
支持处理扩展模板内容，包括部署中的多行和注释。
部署名称。
禁用 ARM 模板缺少参数提示的选项。 如果值为 true，则会忽略要求用户提供缺失参数的提示。 默认值为 false。
不等待长时间运行的操作完成。
提供部署参数值。
可以使用语法、JSON 字符串或 <KEY=VALUE> 对从文件@{path}提供参数。 参数按顺序计算，因此在为值分配两次时，将使用后一个值。 建议先提供参数文件，然后使用 KEY=VALUE 语法选择性地替代参数文件。
指示命令在 What-If 结果不包含任何资源更改时执行部署。 在设置 --confirm-with-what-if 时适用。
在链接模板的情况下，要与模板 URI 一起使用的查询字符串（SAS 令牌）。
模板文件或 Bicep 文件的路径。
模板规格资源 ID。
模板文件的 URI。
指示命令运行部署 What-If。
要从 What-If 结果中排除的资源更改类型的空格分隔列表。 在设置 --confirm-with-what-if 时适用。
What-If 结果的格式。 设置时 --confirm-with-what-if 适用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment delete
此命令已弃用，将在将来的版本中删除。 请改用“部署子删除”。
删除订阅范围内的部署。
az deployment delete --name
[--no-wait]示例
删除订阅范围内的部署。
az deployment delete -n deployment01必需参数
部署名称。
可选参数
不等待长时间运行的操作完成。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment export
此命令已弃用，将在将来的版本中删除。 请改用“部署子导出”。
导出用于部署的模板。
az deployment export --name示例
导出用于订阅范围内的部署的模板。
az deployment export --name MyDeployment必需参数
部署名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment list
此命令已弃用，将在将来的版本中删除。 请改用“部署子列表”。
列出订阅范围内的部署。
az deployment list [--filter]示例
列出订阅范围内的部署。
az deployment list可选参数
使用 OData 表示法筛选表达式。 可以使用 --filter “provisioningState eq '{state}'”筛选 provisioningState。 若要获取详细信息，请访问 https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment show
此命令已弃用，将在将来的版本中删除。 请改用“部署子显示”。
在订阅范围内显示部署。
az deployment show --name示例
在订阅范围内显示部署。
az deployment show -n deployment01必需参数
部署名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az deployment validate
此命令已弃用，将在将来的版本中删除。 请改用“部署子验证”。
验证模板在订阅范围内是否有效。
请仅指定一个 --template-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必需参数
用于存储部署元数据的位置。
可选参数
选项“--handle-extended-json-format/-j”已弃用，将在将来的版本中删除。
支持处理扩展模板内容，包括部署中的多行和注释。
部署名称。
禁用 ARM 模板缺少参数提示的选项。 如果值为 true，则会忽略要求用户提供缺失参数的提示。 默认值为 false。
提供部署参数值。
可以使用语法、JSON 字符串或 <KEY=VALUE> 对从文件@{path}提供参数。 参数按顺序计算，因此在为值分配两次时，将使用后一个值。 建议先提供参数文件，然后使用 KEY=VALUE 语法选择性地替代参数文件。
在链接模板的情况下，要与模板 URI 一起使用的查询字符串（SAS 令牌）。
模板文件或 Bicep 文件的路径。
模板规格资源 ID。
模板文件的 URI。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --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必需参数
部署名称。
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。
等到删除为止。
等待资源存在。
轮询间隔（以秒为单位）。
最大等待（以秒为单位）。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈