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

az

Note

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。安装每个扩展，使其受益于其扩展功能。 Learn more about extensions.

命令

名称	说明	类型	Status
az acat	管理应用合规性自动化工具报告。	Extension	GA
az account	管理 Azure 订阅信息。	核心和扩展	GA
az acr	使用 Azure 容器注册表管理专用注册表。	核心和扩展	GA
az ad	通过 Microsoft 图形 API 管理 Azure 基于角色的访问控制（Azure RBAC）所需的Microsoft Entra ID（以前称为 Azure Active Directory、Azure AD、AAD）实体。	核心和扩展	GA
az advisor	管理 Azure 顾问。	Core	GA
az afd	管理 Azure Front Door 标准版/高级版。	Core	GA
az ai-examples	向帮助内容添加由 AI 驱动的示例。	Extension	Preview
az aks	管理 Azure Kubernetes 服务。	核心和扩展	GA
az aksarc	管理预配的群集。	Extension	GA
az alerts-management	管理 Azure 警报管理服务资源。	Extension	GA
az alias	管理 Azure CLI 别名。	Extension	GA
az amlfs	这是 Azure CLI 的扩展，用于管理 Amlfs 资源。	Extension	GA
az ams	管理Azure 媒体服务资源。	Core	GA
az aosm	管理 Azure 操作员服务管理器资源。	Extension	Preview
az apic	管理 Azure API 中心服务。	Extension	GA
az apim	管理 Azure API 管理服务。	Core	GA
az appconfig	管理应用程序配置。	Core	GA
az appservice	管理应用服务计划。	核心和扩展	GA
az arc-multicloud	arc-multicloud 的命令。	Extension	GA
az arcappliance	用于管理 Arc 资源桥的命令。	Extension	GA
az arcdata	用于使用已启用 Azure Arc 的数据服务的命令。	Extension	GA
az arcgateway	管理 Arc 计算机上的网关连接。	Extension	GA
az arize-ai	管理 Arize Ai。	Extension	GA
az aro	管理 Azure Red Hat OpenShift 群集。	Core	GA
az artifacts	管理 Azure Artifacts。	Extension	GA
az astronomer	管理 Azure 天文学家资源。	Extension	GA
az attestation	管理Microsoft Azure 证明（MAA）。	Extension	Experimental
az automanage	Manage Automanage.	Extension	GA
az automation	管理自动化帐户。	Extension	GA
az backup	管理Azure 备份。	Core	GA
az baremetalinstance	处理计算 Azure 裸实例的操作。	Extension	GA
az baremetalstorageinstance	处理存储 Azure 裸机实例的操作。	Extension	GA
az batch	管理 Azure Batch。	Core	GA
az bicep	Bicep CLI 命令组。	Core	GA
az billing	管理 Azure 计费。	Core	GA
az billing-benefits	Azure 计费权益命令。	Extension	GA
az blueprint	用于管理蓝图的命令。	Extension	Deprecated
az boards	管理 Azure Boards。	Extension	GA
az bot	管理 azure 机器人服务Microsoft。	Core	GA
az cache	用于管理使用参数缓存的 `--defer` CLI 对象的命令。	Core	GA
az capacity	Manage capacity.	Core	GA
az carbon	Manage Carbon.	Extension	GA
az cdn	管理 Azure 内容分发网络（CDN）。	Core	GA
az change-analysis	列出资源的更改。	Extension	GA
az cli-translator	将 ARM 模板或 REST API 转换为 CLI 脚本。	Extension	Experimental
az cloud	管理已注册的 Azure 云。	Core	GA
az cloud-service	管理云服务。	Extension	Experimental
az cloudhsm	管理云 Hsm 群集。	Extension	GA
az cognitiveservices	管理 Azure 认知服务帐户。	Core	GA
az command-change	CLI 模块元数据管理的命令。	Extension	GA
az communication	使用通信管理通信服务。	Extension	GA
az compute-fleet	管理 Azure 计算机群。	Core	Preview
az compute-recommender	管理计算资源的 SKU/区域/区域推荐器信息。	Core	Preview
az computeschedule	Computeschedule 批处理虚拟机作。	Extension	GA
az confcom	用于为 Azure 中的机密容器生成安全策略的命令。	Extension	GA
az confidentialledger	管理机密账本。	Extension	GA
az config	管理 Azure CLI 配置。	Core	Experimental
az configure	管理 Azure CLI 配置。此命令是交互式的。	Core	GA
az confluent	管理 confluent 组织。	Extension	GA
az connectedk8s	用于管理连接的 kubernetes 群集的命令。	Extension	GA
az connectedmachine	管理已启用 Azure Arc 的服务器。	Extension	GA
az connectedvmware	用于管理连接的 VMware 的命令。	Extension	GA
az connection	用于管理服务连接器本地连接的命令，允许本地环境连接 Azure 资源。如果要管理计算服务的连接，请运行“az webapp/containerapp/spring connection”。	核心和扩展	GA
az consumption	管理 Azure 资源的消耗。	Core	Preview
az container	管理Azure 容器实例。	核心和扩展	GA
az containerapp	管理 Azure 容器应用。	核心和扩展	GA
az cosmosdb	管理 Azure Cosmos DB 数据库帐户。	核心和扩展	GA
az costmanagement	Costmanagement.	Extension	GA
az custom-providers	用于管理自定义提供程序的命令。	Extension	GA
az customlocation	用于创建、获取、列出和删除 CustomLocations 的命令。	Extension	GA
az data-boundary	数据边界操作。	Core	GA
az data-transfer	跨域服务的命令，使客户能够跨安全域传输数据。	Extension	Preview
az databox	管理数据框。	Extension	GA
az databoxedge	使用 databoxedge 管理设备。	Core	Preview
az databricks	管理 databricks 工作区。	Extension	GA
az datadog	Manage Datadog.	Extension	GA
az datafactory	管理数据工厂。	Extension	GA
az datamigration	管理数据迁移。	Extension	GA
az dataprotection	Manage dataprotection.	Extension	GA
az datashare	管理 Data Share。	Extension	Experimental
az dedicated-hsm	使用硬件安全模块管理专用 hsm。	Extension	GA
az dependency-map	管理依赖项映射。	Extension	GA
az deployment	在订阅范围内管理 Azure 资源管理器模板部署。	Core	GA
az deployment-scripts	在订阅或资源组范围内管理部署脚本。	Core	GA
az desktopvirtualization	管理桌面虚拟化。	Extension	GA
az devcenter	使用开发中心管理资源。	Extension	GA
az devops	管理 Azure DevOps 组织级别操作。	Extension	GA
az disk	管理 Azure 托管磁盘。	Core	GA
az disk-access	管理磁盘访问资源。	Core	GA
az disk-encryption-set	磁盘加密集资源。	Core	GA
az disk-pool	管理 Azure 磁盘池。	Extension	GA
az dls	管理 Data Lake Store 帐户和文件系统。	Core	Preview
az dms	管理 Azure 数据迁移服务（经典）实例。	核心和扩展	GA
az dnc	管理委派网络。	Extension	Preview
az dns-resolver	管理 Dns 解析程序。	Extension	GA
az dt	管理 Azure 数字孪生解决方案和基础结构。	Extension	GA
az durabletask	用于管理 Durabletask 计划程序和 taskhubs 的命令。	Extension	GA
az dynatrace	Manage dynatrace.	Extension	GA
az edge-zones	管理边缘区域资源。	Extension	Preview
az edgeorder	管理 Edge 订单。	Extension	GA
az elastic	管理 Microsoft Elastic。	Extension	GA
az elastic-san	管理弹性 SAN。	Extension	GA
az eventgrid	管理Azure 事件网格主题、域、域主题、系统主题合作伙伴主题、事件订阅、系统主题事件订阅和合作伙伴主题事件订阅。	核心和扩展	GA
az eventhubs	Eventhubs.	Core	GA
az extension	管理和更新 CLI 扩展。	Core	GA
az fabric	管理 Microsoft Fabric 资源。	Extension	GA
az feature	管理资源提供程序功能。	Core	GA
az feedback	向 Azure CLI 团队发送反馈。	Core	GA
az find	我是 AI 机器人，我的建议基于我们的 Azure 文档以及 Azure CLI 和 Azure ARM 用户的使用模式。使用我改进 Azure 产品和文档。	Core	GA
az firmwareanalysis	用于管理固件分析的命令。	Extension	GA
az fleet	用于管理机群的命令。	Extension	GA
az fluid-relay	管理 Fluid Relay。	Extension	GA
az footprint		Extension	GA
az functionapp	管理函数应用。若要安装 Azure Functions Core 工具，请参阅 https://github.com/Azure/azure-functions-core-tools。	核心和扩展	GA
az fzf	用于通过 fzf 选择活动对象或默认对象的命令。	Extension	GA
az gallery	Azure Compute Gallery。	Extension	GA
az grafana	用于管理 Azure 托管 Grafana 资源的命令。	Extension	GA
az graph	查询 Azure 资源管理器管理的资源。	Extension	GA
az graph-services	对 Microsoft.GraphServices 资源类型执行操作。	Extension	GA
az group	管理资源组和模板部署。	Core	GA
az guestconfig	管理来宾配置。	Extension	GA
az hack	用于管理通常用于学生黑客的资源的命令。	Extension	GA
az hdinsight	管理 HDInsight 资源。	Core	GA
az healthbot	使用 healthbot 管理机器人。	Extension	Experimental
az healthcareapis	Azure Healthcare API 是一个安全的云平台，用于管理运行状况数据、支持分析、机器学习和可缩放的解决方案。	Extension	GA
az hpc-cache	用于管理 hpc 缓存的命令。	Extension	GA
az identity	管理托管标识。	Core	GA
az image	管理自定义虚拟机映像。	核心和扩展	GA
az import-export	管理导入导出。	Extension	Experimental
az informatica	在 Azure CLI 中管理与 Informatica 相关的所有资源。	Extension	GA
az init	这是一个毫不费力地设置配置工具。	Extension	Experimental
az interactive	启动交互模式。安装交互式扩展（如果尚未安装）。	Core	Preview
az internet-analyzer	用于管理 Internet 分析器的命令。	Extension	GA
az iot	管理物联网（IoT）资产。	核心和扩展	GA
az k8s-configuration	用于从 Microsoft.KubernetesConfiguration 管理资源的命令。	Extension	GA
az k8s-extension	用于管理 Kubernetes 扩展的命令。	Extension	GA
az k8s-runtime	管理 Arc Kubernetes 运行时资源。	Extension	GA
az keyvault	管理 KeyVault 密钥、机密和证书。	Core	GA
az kusto	Manage Kusto.	Extension	Experimental
az lab	管理 Azure 开发测试实验室。	Core	Preview
az lambda-test	管理 Lambda 测试。	Extension	GA
az large-instance	处理计算 Azure 大型实例的操作。	Extension	GA
az large-storage-instance	处理存储 Azure 大型实例的操作。	Extension	GA
az load	管理 Azure 负载测试资源。	Extension	GA
az lock	管理 Azure 锁。	Core	GA
az logic	Manage logic.	Extension	GA
az logicapp	管理逻辑应用。	Core	GA
az login	登录到 Azure。	Core	GA
az logout	注销以删除对 Azure 订阅的访问权限。	Core	GA
az maintenance	Manage Maintenance.	Extension	GA
az managed-cassandra	Azure 托管 Cassandra。	核心和扩展	GA
az managedapp	管理独立软件供应商（ISV）提供和维护的模板解决方案。	Core	GA
az managedservices	在 Azure 中管理注册分配和定义。	Core	GA
az managementpartner	允许合作伙伴将Microsoft合作伙伴网络（MPN）ID 关联到客户的 Azure 目录中的用户或服务主体。	Extension	GA
az maps	管理 Azure Maps。	Core	GA
az mariadb	管理 Azure Database for MariaDB 服务器。	Core	GA
az mcc	Microsoft 连接缓存 CLI 命令。	Extension	GA
az mdp	管理托管 DevOps 池的资源。	Extension	GA
az mesh	（预览）管理 Azure Service Fabric 网格资源。	Extension	Preview
az ml	使用 Azure CLI ML 扩展 v2 管理Azure 机器学习资源。	Extension	GA
az ml	使用 Azure CLI ML 扩展 v1 管理Azure 机器学习资源。	Extension	GA
az mobile-network	管理移动网络。	Extension	GA
az mongo-db	Manage MongoDB.	Extension	GA
az monitor	管理 Azure Monitor 服务。	核心和扩展	GA
az mysql	管理 Azure Database for MySQL 服务器。	核心和扩展	GA
az neon	在 Azure 中管理 Neon Postgres 数据库和相关资源。	Extension	GA
az netappfiles	管理Azure NetApp 文档（ANF）资源。	核心和扩展	GA
az network	管理 Azure 网络资源。	核心和扩展	GA
az network-analytics	网络分析命令组 Azure Operator Insights 资源操作。	Extension	GA
az network-function	管理网络功能。	Extension	GA
az networkcloud	管理网络云资源。	Extension	GA
az networkfabric	管理 Azure Network Fabric 管理服务 API。	Extension	GA
az new-relic	管理 Azure NewRelic 资源。	Extension	GA
az next	建议使用下一组命令。	Extension	Experimental
az nexusidentity	用于管理 Nexusidentity 密钥的命令。	Extension	GA
az nginx	管理 NGINX 部署资源。	Extension	GA
az notification-hub	管理通知中心。	Extension	GA
az offazure	管理要迁移的本地资源。	Extension	Experimental
az oracle-database	RP Oracle.Database 的命令模块。	Extension	GA
az orbital	Azure 轨道地面站即服务（GSaaS）。	Extension	GA
az palo-alto	管理 palo-alto networks 资源。	Extension	GA
az partnercenter	合作伙伴中心管理。	Extension	GA
az peering	Manage peering.	Extension	GA
az pipelines	管理 Azure Pipelines。	Extension	GA
az playwright-testing	管理Microsoft Playwright Testing 服务。	Extension	GA
az policy	管理资源策略。	Core	GA
az portal	Manage Portal.	Extension	GA
az postgres	管理 Azure Database for PostgreSQL 服务器。	核心和扩展	GA
az powerbi	管理 PowerBI 资源。	Extension	GA
az ppg	管理邻近放置组。	Core	GA
az private-link	专用链接关联 CLI 命令组。	Core	GA
az provider	管理资源提供程序。	Core	GA
az providerhub	使用 ProviderHub 管理资源。	Extension	GA
az purview	Manage Purview.	Extension	Preview
az quantum	管理 Azure Quantum 工作区并将作业提交到 Azure Quantum 提供程序。	Extension	Preview
az qumulo	使用 Azure CLI 管理 Qumulo 文件系统存储资源。	Extension	GA
az quota	Azure 资源提供程序的管理配额。	Extension	GA
az redis	管理 Azure 应用程序的专用 Redis 缓存。	Core	GA
az redisenterprise	管理 redisenterprise 缓存。	Extension	GA
az relay	管理 Azure 中继服务命名空间、WCF 中继、混合连接和规则。	Core	GA
az remote-rendering-account	使用混合现实管理远程渲染帐户。	Extension	GA
az repos	管理 Azure Repos。	Extension	GA
az reservations	Azure Reservations.	Extension	Preview
az resource	管理 Azure 资源。	Core	GA
az resource-mover	管理资源转移器服务 API。	Extension	GA
az resourcemanagement	Resourcemanagement CLI 命令组。	Core	GA
az rest	调用自定义请求。	Core	GA
az restore-point	使用 res 管理还原点。	Core	GA
az role	管理 Azure 基于角色的访问控制（Azure RBAC）。	Core	GA
az scenario	E2E 方案使用指南。	Extension	GA
az scvmm	用于管理 SCVMM 资源的 Arc 的命令。	Extension	GA
az search	管理 Azure 搜索服务、管理密钥和查询密钥。	Core	GA
az security	使用 Microsoft Defender for Cloud 管理安全状况。	Core	GA
az self-help	Azure SelfHelp 将帮助你排查 Azure 资源的问题。	Extension	Preview
az sentinel	管理Microsoft Sentinel。	Extension	GA
az serial-console	连接到 Linux/Windows 虚拟机或 VMSS 实例的串行控制台。	Extension	GA
az servicebus	Servicebus.	Core	GA
az sf	管理和管理 Azure Service Fabric 群集。	Core	GA
az sig	管理共享映像库。	核心和扩展	GA
az signalr	管理Azure SignalR 服务。	Core	GA
az site-recovery	管理 Site Recovery 服务。	Extension	GA
az snapshot	管理托管磁盘、本机 blob 或其他快照的时间点副本。	Core	GA
az sphere	管理 Azure Sphere 资源。	Extension	GA
az sql	管理Azure SQL 数据库和数据仓库。	核心和扩展	GA
az ssh	使用 AAD 颁发的打开证书通过 SSH 连接到资源（Azure VM、Arc 服务器等）。	Extension	GA
az sshkey	使用 vm 管理 ssh 公钥。	Core	GA
az stack	部署堆栈是一种本机 Azure 资源类型，可用于将资源集合作为原子单元执行操作。	Core	GA
az stack-hci	管理 Azure Stack HCI。	Extension	GA
az stack-hci-vm	使用 stack-hci-vm 管理 virtualmachine。	Extension	GA
az standby-container-group-pool	管理备用容器组池。	Extension	GA
az standby-vm-pool	管理备用虚拟机池。	Extension	GA
az staticwebapp	管理静态应用。	核心和扩展	GA
az storage	管理 Azure 云存储资源。	核心和扩展	GA
az storage-actions	Manage StorageActions.	Extension	GA
az storage-mover	管理顶级存储移动器资源。	Extension	GA
az storagesync	管理Azure 文件同步。	Extension	GA
az stream-analytics	管理流分析。	Extension	GA
az support	管理Azure 支持资源。	Extension	GA
az survey	接受 Azure CLI 调查。	Core	GA
az synapse	管理和操作 Synapse 工作区、Spark 池、SQL 池。	Core	GA
az tag	对资源进行标记管理。	Core	GA
az term	使用 marketplaceordering 管理市场协议。	Core	Experimental
az terraform	Azure Terraform 体验。	Extension	Preview
az trustedsigning	管理受信任的签名帐户。	Extension	Preview
az ts	在订阅或资源组范围内管理模板规格。	Core	GA
az tsi	管理 Azure 时序见解。	Extension	GA
az upgrade	升级 Azure CLI 和扩展。	Core	Preview
az version	默认情况下，以 JSON 格式或 --output 配置的格式显示 Azure CLI 模块和扩展的版本。	Core	GA
az vm	管理 Linux 或 Windows 虚拟机。	核心和扩展	GA
az vme	用于管理连接的 kubernetes 群集上的版本托管扩展的命令。	Extension	GA
az vmss	管理 Azure 虚拟机规模集（VMSS）中的虚拟机分组。	Core	GA
az vmware	用于管理Azure VMware 解决方案的命令。	Extension	GA
az webapp	管理 Web 应用。	核心和扩展	GA
az webpubsub	用于管理 Webpubsub 的命令。	Extension	GA
az workload-orchestration	管理工作负荷业务流程资源。	Extension	GA
az workloads	Manage workloads.	Extension	GA
az zones	用于验证可用性区域配置的命令。使用以下选项之一。	Extension	Preview

az configure

编辑

管理 Azure CLI 配置。此命令是交互式的。

对于自动化方案或设置所有可用选项，请使用新 az config选项。

az configure [--defaults]
             [--list-defaults {false, true}]
             [--scope {global, local}]

示例

设置默认资源组、webapp 和 VM 名称。

az configure --defaults group=myRG web=myweb vm=myvm

清除默认 Web 应用和 VM 名称。

az configure --defaults vm='' web=''

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--defaults -d

常见参数默认值的空格分隔的“name=value”对。

--list-defaults -l

列出所有适用的默认值。

属性	值
接受的值:	false, true

--scope

默认值的范围。将“local”用于仅在当前文件夹下有效的设置。

属性	值
默认值:	global
接受的值:	global, local

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az feedback

编辑

向 Azure CLI 团队发送反馈。

此命令是交互式的。如果可能，它会启动默认的 Web 浏览器，以打开 GitHub 问题创建页面，其中包含自动生成和预填充的正文。在提交问题正文之前，你将有机会编辑问题正文。

az feedback

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az find

编辑

我是 AI 机器人，我的建议基于我们的 Azure 文档以及 Azure CLI 和 Azure ARM 用户的使用模式。使用我改进 Azure 产品和文档。

az find []

示例

给我任何 Azure CLI 组，我将显示组中最受欢迎的命令。

az find "az storage"

给我任何 Azure CLI 命令，我将显示最常用的参数和子命令。

az find "az monitor activity-log list"

还可以输入搜索词，我将尝试帮助查找最佳命令。

az find "arm template"

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

<CLI_TERM>

需要一个示例的 Azure CLI 命令或组。

属性	值
Parameter group:	Positional

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az init

实验

此命令是实验性的，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

这是一个毫不费力地设置配置工具。

az init

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 interactive

预览

此命令处于预览阶段，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

启动交互模式。安装交互式扩展（如果尚未安装）。

有关交互模式的详细信息，请参阅： https://azure.microsoft.com/blog/welcome-to-azure-cli-shell/

az interactive [--style {bg, br, contrast, default, grey, halloween, neon, none, pastel, primary, purple, quiet}]
               [--update]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--style -s

shell 的颜色。

属性	值
接受的值:	bg, br, contrast, default, grey, halloween, neon, none, pastel, primary, purple, quiet

--update

将交互式扩展更新为最新的可用扩展。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

编辑

登录到 Azure。

默认情况下，此命令使用用户帐户登录。默认情况下，Azure CLI 在 Windows 上使用 Web 帐户管理器（WAM），在 Linux 和 macOS 上使用基于浏览器的登录名。如果 WAM 或 Web 浏览器不可用，Azure CLI 将回退到设备代码登录名。

[警告]强烈建议不要在命令行中使用用户名和密码进行身份验证。根据要求使用建议的身份验证方法之一。有关详细信息，请参阅 https://go.microsoft.com/fwlink/?linkid=2276314

[WARNING] --password 不再接受服务主体证书。使用 --certificate 传递服务主体证书。

若要使用服务主体登录，请指定 --service-principal。

若要使用托管标识登录，请指定 --identity。

有关详细信息，请参阅 https://learn.microsoft.com/cli/azure/authenticate-azure-cli。

az login [--allow-no-subscriptions]
         [--certificate]
         [--client-id]
         [--federated-token]
         [--identity]
         [--object-id]
         [--password]
         [--resource-id]
         [--scope]
         [--service-principal]
         [--tenant]
         [--use-cert-sn-issuer]
         [--use-device-code]
         [--username]

以交互方式登录。

az login

使用用户名和密码登录。这不适用于启用了双重身份验证的Microsoft帐户或帐户。如果密码的第一个字符为“-”，请使用 -p=secret。

az login --username johndoe@contoso.com --password VerySecret

使用客户端密码使用服务主体登录。如果密码的第一个字符为“-”，请使用 --password=secret。

az login --service-principal --username APP_ID --password CLIENT_SECRET --tenant TENANT_ID

使用证书使用服务主体登录。

az login --service-principal --username APP_ID --certificate /path/to/cert.pem --tenant TENANT_ID

使用系统分配的托管标识登录。

az login --identity

使用用户分配的托管标识的客户端 ID 登录。

az login --identity --client-id 00000000-0000-0000-0000-000000000000

使用用户分配的托管标识的资源 ID 登录。

az login --identity --resource-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-no-subscriptions

支持在没有订阅的情况下访问租户。运行租户级命令（如“az ad”）非常有用。

属性	值
默认值:	False

--certificate

包含密钥和公共证书的 PEM 文件。

--client-id

用户分配的托管标识的客户端 ID。

属性	值
Parameter group:	Managed Identity Arguments

--federated-token

可用于 OIDC 令牌交换的联合令牌。

--identity -i

使用托管标识登录。

属性	值
Parameter group:	Managed Identity Arguments
默认值:	False

--object-id

用户分配的托管标识的对象 ID。

属性	值
Parameter group:	Managed Identity Arguments

--password -p

用户密码或服务主体机密。如果未提供，将提示。

--resource-id

用户分配的托管标识的资源 ID。

属性	值
Parameter group:	Managed Identity Arguments

--scope

在 /authorize 请求中使用。它只能涵盖一个静态资源。

--service-principal

使用服务主体登录。

--tenant -t

使用服务主体时，必须提供Microsoft Entra 租户。

--use-cert-sn-issuer

使用使用者名称 + 颁发者（SN+I）身份验证来支持自动证书滚动更新。

--use-device-code

使用设备代码流。如果 Azure CLI 无法启动浏览器（例如，在远程 SSH 或 Cloud Shell 中）也会使用它。

属性	值
默认值:	False

--username -u

用户名或服务主体客户端 ID。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az logout

编辑

注销以删除对 Azure 订阅的访问权限。

az logout [--username]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--username

帐户用户（如果缺少）注销当前活动帐户。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az next

实验

此命令是实验性的，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

建议使用下一组命令。

有一些自定义配置：

[1] az config set next.execute_in_prompt=True/False 启用/关闭在交互模式下执行推荐命令的步骤。默认情况下打开。

[2] az config set next.recommended_type=all/scenario/command Set the default recommended type. All 是默认值。

[3] az config set next.output=json/jsonc/none/table/tsv/yaml/yamlc/status Set 默认输出格式。状态为默认值。

[4] az config set next.command_num_limit={command_amount_limit} 设置建议的命令项的限制。 5 是默认值。

[5] az config set next.scenario_num_limit={scenario_amount_limit} 设置建议方案项的限制。 5 是默认值。

[6] az config set next.show_arguments=True/False Show/hide the arguments of recommended items. 默认值是 False。

[7] az config set next.print_help=True/False Enable/disable 是否在执行每个命令之前主动打印帮助。默认值是 False。

az next [--command]
        [--scenario]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--command -c

指定此参数将仅推荐命令。

属性	值
默认值:	False

--scenario -s

指定此参数将仅推荐 E2E 方案。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 rest

调用自定义请求。

此命令使用登录凭据自动进行身份验证：如果未设置授权标头，则会附加标头 Authorization: Bearer <token>，从 AAD 检索到标头 <token> 。令牌的目标资源派生自 --url if --url 以终结点开头 az cloud show --query endpoints。还可以对自定义资源使用 --resource。

如果未设置 Content-Type 标头，并且 --body 是有效的 JSON 字符串，则 Content-Type 标头将默认为 application/json。

有关在 PowerShell 中传递 JSON，请参阅 https://github.com/Azure/azure-cli/blob/dev/doc/quoting-issues-with-powershell.md。

az rest --uri --url
        [--body]
        [--headers]
        [--method {delete, get, head, options, patch, post, put}]
        [--output-file]
        [--resource]
        [--skip-authorization-header]
        [--uri-parameters --url-parameters]

示例

通过 Microsoft Graph 获取审核日志

az rest --method get --url https://graph.microsoft.com/beta/auditLogs/directoryAudits

更新 Azure Active Directory Graph 用户的显示名称

(Bash or CMD)
az rest --method patch --url "https://graph.microsoft.com/v1.0/users/johndoe@azuresdkteam.onmicrosoft.com" --body "{\"displayName\": \"johndoe2\"}"

(Bash)
az rest --method patch --url "https://graph.microsoft.com/v1.0/users/johndoe@azuresdkteam.onmicrosoft.com" --body '{"displayName": "johndoe2"}'

(PowerShell)
az rest --method patch --url "https://graph.microsoft.com/v1.0/users/johndoe@azuresdkteam.onmicrosoft.com" --body '{\"displayName\": \"johndoe2\"}'

获取虚拟机

az rest --method get --uri /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2019-03-01

从 body.json 文件创建公共 IP 地址

az rest --method put --url https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{publicIpAddressName}?api-version=2019-09-01 --body @body.json

列出前三个资源（Bash）

az rest --method get --url https://management.azure.com/subscriptions/{subscriptionId}/resources?api-version=2019-07-01 --url-parameters \$top=3

必需参数

--uri --url -u

Request URL. 如果它不以主机开头，CLI 会将其假定为 Azure 资源 ID，并使用当前云显示的 az cloud show --query endpoints.resourceManagerARM 终结点作为前缀。通用令牌 {subscriptionId} 将替换为指定的 az account set当前订阅 ID。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--body -b

Request body. 使用 @{file} 从文件加载。有关不同终端中的问题，请参阅 https://github.com/Azure/azure-cli/blob/dev/doc/use_cli_effectively.md#quoting-issues。

--headers

KEY=VALUE 格式或 JSON 字符串中的空格分隔标头。使用 @{file} 从文件加载。

--method -m

HTTP 请求方法。

属性	值
默认值:	get
接受的值:	delete, get, head, options, patch, post, put

--output-file

将响应有效负载保存到文件。

--resource

CLI 应从 AAD 获取令牌的资源 URL，以便访问服务。令牌将放置在 Authorization 标头中。默认情况下，CLI 可以根据 --url 参数来弄清楚这一点，除非你未在“az cloud show --query endpoints”列表中使用。

--skip-authorization-header

不要自动追加授权标头。

属性	值
默认值:	False

--uri-parameters --url-parameters

在 URL 中查询参数。键=VALUE 格式或 JSON 字符串中的空格分隔查询。使用 @{file} 从文件加载。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 survey

接受 Azure CLI 调查。

通过共享你的体验来帮助我们改进 Azure CLI。此调查大约需要 3 分钟。在 https://go.microsoft.com/fwlink/?linkid=2203309了解详细信息。

az survey

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az upgrade

预览

此命令处于预览阶段，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

升级 Azure CLI 和扩展。

az upgrade [--all {false, true}]
           [--allow-preview --allow-preview-extensions {false, true}]
           [--yes]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--all

同时启用更新扩展。

属性	值
默认值:	true
接受的值:	false, true

--allow-preview --allow-preview-extensions

包括用于扩展安装的预览包（如果存在）。

属性	值
接受的值:	false, true

--yes -y

不要提示检查发行说明。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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 version

默认情况下，以 JSON 格式或 --output 配置的格式显示 Azure CLI 模块和扩展的版本。

az version

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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