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

az aks

Note

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。安装每个扩展，使其受益于其扩展功能。了解更多关于扩展的信息。

Azure Kubernetes 服务。

命令

名称	说明	类型	Status
az aks addon	用于管理和查看单个加载项条件的命令。	Extension	GA
az aks addon disable	在群集中禁用已启用的 Kubernetes 加载项。	Extension	GA
az aks addon enable	启用 Kubernetes 加载项。	Extension	GA
az aks addon list	列出给定群集中所有 Kubernetes 加载项的状态。	Extension	GA
az aks addon list-available	列出可用的 Kubernetes 加载项。	Extension	GA
az aks addon show	显示给定群集中已启用 Kubernetes 加载项的状态和配置。	Extension	GA
az aks addon update	更新已启用的 Kubernetes 加载项。	Extension	GA
az aks agent	运行 AI 助手来分析和排查 Kubernetes 群集问题。	Extension	GA
az aks agent-init	初始化和验证 AKS 代理的 LLM 提供程序/模型配置。	Extension	GA
az aks app	用于管理 AKS 应用的命令。	Extension	Preview
az aks app up	通过 GitHub 操作部署到 AKS。	Extension	Preview
az aks approuting	用于管理应用路由加载项的命令。	核心和扩展	GA
az aks approuting disable	禁用应用路由加载项。	Core	GA
az aks approuting disable (aks-preview 扩展)	禁用应用路由加载项。	Extension	GA
az aks approuting enable	启用应用路由。	Core	GA
az aks approuting enable (aks-preview 扩展)	启用应用路由。	Extension	GA
az aks approuting update	更新应用路由加载项。	Core	GA
az aks approuting update (aks-preview 扩展)	更新应用路由加载项。	Extension	GA
az aks approuting zone	用于管理应用路由 DNS 区域的命令。	核心和扩展	GA
az aks approuting zone add	将 DNS 区域添加到应用路由。	Core	GA
az aks approuting zone add (aks-preview 扩展)	将 DNS 区域添加到应用路由。	Extension	GA
az aks approuting zone delete	从应用路由中删除 DNS 区域。	Core	GA
az aks approuting zone delete (aks-preview 扩展)	从应用路由中删除 DNS 区域。	Extension	GA
az aks approuting zone list	列出应用路由中的 DNS 区域 ID。	Core	GA
az aks approuting zone list (aks-preview 扩展)	列出应用路由中的 DNS 区域 ID。	Extension	GA
az aks approuting zone update	替换应用路由中的 DNS 区域。	Core	GA
az aks approuting zone update (aks-preview 扩展)	替换应用路由中的 DNS 区域。	Extension	GA
az aks bastion	使用 Azure Bastion 连接到托管 Kubernetes 群集。	Extension	GA
az aks browse	在 Web 浏览器中显示 Kubernetes 群集的仪表板。	Core	GA
az aks browse (aks-preview 扩展)	在 Web 浏览器中显示 Kubernetes 群集的仪表板。	Extension	GA
az aks check-acr	验证 ACR 是否可从 AKS 群集访问。	Core	GA
az aks check-network	用于排查托管 Kubernetes 群集中的网络连接问题的命令。	Extension	GA
az aks check-network outbound	对托管 Kubernetes 群集中的节点执行出站网络连接检查。	Extension	GA
az aks command	请参阅“az aks command invoke”、“az aks command result”中的详细信息用法。	Core	GA
az aks command invoke	在 aks 群集上运行 shell 命令（使用 kubectl、helm），同时支持附加文件。	Core	GA
az aks command result	从之前触发的“aks 命令调用”中提取结果。	Core	GA
az aks connection	用于管理 aks 连接的命令。	核心和扩展	Preview
az aks connection create	在 aks 和目标资源之间创建连接。	核心和扩展	Preview
az aks connection create app-insights	创建与 app-insights 的 aks 连接。	Core	Preview
az aks connection create appconfig	创建与 appconfig 的 aks 连接。	Core	Preview
az aks connection create cognitiveservices	创建与认知服务的 aks 连接。	Core	Preview
az aks connection create confluent-cloud	创建与 confluent-cloud 的 aks 连接。	Core	Preview
az aks connection create cosmos-cassandra	创建与 cosmos-cassandra 的 aks 连接。	Core	Preview
az aks connection create cosmos-gremlin	创建与 cosmos-gremlin 的 aks 连接。	Core	Preview
az aks connection create cosmos-mongo	创建与 cosmos-mongo 的 aks 连接。	Core	Preview
az aks connection create cosmos-sql	创建与 cosmos-sql 的 aks 连接。	Core	Preview
az aks connection create cosmos-table	创建与 cosmos-table 的 aks 连接。	Core	Preview
az aks connection create eventhub	创建与 eventhub 的 aks 连接。	Core	Preview
az aks connection create keyvault	创建与 keyvault 的 aks 连接。	Core	Preview
az aks connection create mongodb-atlas	创建与 mongodb-atlas 的 aks 连接。	Core	Preview
az aks connection create mysql	创建与 mysql 的 aks 连接。	Core	预览和弃用
az aks connection create mysql-flexible	创建与 mysql 灵活连接的 aks 连接。	Core	Preview
az aks connection create mysql-flexible (serviceconnector-passwordless 扩展)	创建与 mysql 灵活连接的 aks 连接。	Extension	GA
az aks connection create neon-postgres	创建与 neon-postgres 的 aks 连接。	Core	Preview
az aks connection create postgres	创建与 postgres 的 aks 连接。	Core	预览和弃用
az aks connection create postgres-flexible	创建与 postgres 灵活连接的 aks 连接。	Core	Preview
az aks connection create postgres-flexible (serviceconnector-passwordless 扩展)	创建与 postgres 灵活连接的 aks 连接。	Extension	GA
az aks connection create redis	创建与 redis 的 aks 连接。	Core	Preview
az aks connection create redis-enterprise	创建与 redis-enterprise 的 aks 连接。	Core	Preview
az aks connection create servicebus	创建与 servicebus 的 aks 连接。	Core	Preview
az aks connection create signalr	创建与信号器的 aks 连接。	Core	Preview
az aks connection create sql	创建与 sql 的 aks 连接。	Core	Preview
az aks connection create sql (serviceconnector-passwordless 扩展)	创建与 sql 的 aks 连接。	Extension	GA
az aks connection create storage-blob	创建与 storage-blob 的 aks 连接。	Core	Preview
az aks connection create storage-file	创建与存储文件的 aks 连接。	Core	Preview
az aks connection create storage-queue	创建与存储队列的 aks 连接。	Core	Preview
az aks connection create storage-table	创建与存储表的 aks 连接。	Core	Preview
az aks connection create webpubsub	创建与 Webpubsub 的 aks 连接。	Core	Preview
az aks connection delete	删除 aks 连接。	Core	Preview
az aks connection list	列出 aks 的连接。	Core	Preview
az aks connection list-configuration	列出 aks 连接的源配置。	Core	Preview
az aks connection list-support-types	列出 aks 连接支持的客户端类型和身份验证类型。	Core	Preview
az aks connection show	获取 aks 连接的详细信息。	Core	Preview
az aks connection update	更新 aks 连接。	Core	Preview
az aks connection update app-insights	将 aks 更新到 app-insights 连接。	Core	Preview
az aks connection update appconfig	将 aks 更新为 appconfig 连接。	Core	Preview
az aks connection update cognitiveservices	将 aks 更新为认知服务连接。	Core	Preview
az aks connection update confluent-cloud	将 aks 更新为 confluent-cloud 连接。	Core	Preview
az aks connection update cosmos-cassandra	将 aks 更新为 cosmos-cassandra 连接。	Core	Preview
az aks connection update cosmos-gremlin	将 aks 更新为 cosmos-gremlin 连接。	Core	Preview
az aks connection update cosmos-mongo	将 aks 更新为 cosmos-mongo 连接。	Core	Preview
az aks connection update cosmos-sql	将 aks 更新为 cosmos-sql 连接。	Core	Preview
az aks connection update cosmos-table	将 aks 更新为 cosmos-table 连接。	Core	Preview
az aks connection update eventhub	将 aks 更新到 eventhub 连接。	Core	Preview
az aks connection update keyvault	将 aks 更新为 keyvault 连接。	Core	Preview
az aks connection update mongodb-atlas	将 aks 更新为 mongodb-atlas 连接。	Core	Preview
az aks connection update mysql	将 aks 更新到 mysql 连接。	Core	预览和弃用
az aks connection update mysql-flexible	将 aks 更新为 mysql 灵活连接。	Core	Preview
az aks connection update neon-postgres	将 aks 更新为 neon-postgres 连接。	Core	Preview
az aks connection update postgres	将 aks 更新为 postgres 连接。	Core	预览和弃用
az aks connection update postgres-flexible	将 aks 更新为 postgres 灵活连接。	Core	Preview
az aks connection update redis	将 aks 更新为 redis 连接。	Core	Preview
az aks connection update redis-enterprise	将 aks 更新为 redis-enterprise 连接。	Core	Preview
az aks connection update servicebus	将 aks 更新到 servicebus 连接。	Core	Preview
az aks connection update signalr	将 aks 更新为信号器连接。	Core	Preview
az aks connection update sql	将 aks 更新到 sql 连接。	Core	Preview
az aks connection update storage-blob	将 ak 更新到 storage-blob 连接。	Core	Preview
az aks connection update storage-file	将 ak 更新到存储文件连接。	Core	Preview
az aks connection update storage-queue	将 ak 更新到存储队列连接。	Core	Preview
az aks connection update storage-table	将 ak 更新到存储表连接。	Core	Preview
az aks connection update webpubsub	将 aks 更新到 webpubsub 连接。	Core	Preview
az aks connection validate	验证 aks 连接。	Core	Preview
az aks connection wait	将 CLI 置于等待状态，直到满足连接条件。	Core	Preview
az aks create	新建托管 Kubernetes 群集。	Core	GA
az aks create (aks-preview 扩展)	新建托管 Kubernetes 群集。	Extension	GA
az aks delete	删除托管的 Kubernetes 群集。	Core	GA
az aks delete (aks-preview 扩展)	删除托管的 Kubernetes 群集。	Extension	GA
az aks disable-addons	禁用 Kubernetes 加载项。	Core	GA
az aks disable-addons (aks-preview 扩展)	禁用 Kubernetes 加载项。	Extension	GA
az aks draft	用于在项目目录中生成部署文件的命令，并将其部署到 AKS 群集。	Extension	GA
az aks draft create	为项目目录生成 Dockerfile 和所需的最低 Kubernetes 部署文件（helm、kustomize、manifests）。	Extension	GA
az aks draft generate-workflow	生成 GitHub 工作流，以便自动生成并部署到 AKS。	Extension	GA
az aks draft setup-gh	为应用程序设置 GitHub OIDC。	Extension	GA
az aks draft up	然后`az aks draft setup-gh`运行 `az aks draft generate-workflow` 。	Extension	GA
az aks draft update	将应用程序更新为可访问 Internet。	Extension	GA
az aks egress-endpoints	用于管理托管 Kubernetes 群集中的出口终结点的命令。	Extension	GA
az aks egress-endpoints list	列出需要或建议为群集加入允许列表的出口终结点。	Extension	GA
az aks enable-addons	启用 Kubernetes 加载项。	Core	GA
az aks enable-addons (aks-preview 扩展)	启用 Kubernetes 加载项。	Extension	GA
az aks extension	用于管理 Kubernetes 群集中的扩展的命令。	Extension	GA
az aks extension create	在托管群集上创建群集扩展实例。请参阅末尾的示例，了解如何创建群集扩展。	Extension	GA
az aks extension delete	删除群集扩展。	Extension	GA
az aks extension list	列出群集扩展。	Extension	GA
az aks extension show	显示群集扩展。	Extension	GA
az aks extension type	在 Azure Kubernetes 服务中管理扩展类型。	Extension	GA
az aks extension type list	列出可用的群集扩展类型。用于筛选的属性包括 kubernetes 版本、群集的位置。	Extension	GA
az aks extension type show	显示群集扩展类型的属性。用于筛选的属性包括 kubernetes 版本、群集的位置。	Extension	GA
az aks extension type version	在 Azure Kubernetes 服务中管理扩展类型版本。	Extension	GA
az aks extension type version list	列出可用的群集扩展类型版本。用于筛选的属性包括 kubernetes 版本、群集的位置。	Extension	GA
az aks extension type version show	显示与群集扩展类型版本关联的属性。用于筛选的属性包括 kubernetes 版本、群集的位置。	Extension	GA
az aks extension update	更新群集扩展的可变属性。	Extension	GA
az aks get-credentials	获取托管 Kubernetes 群集的访问凭据。	Core	GA
az aks get-credentials (aks-preview 扩展)	获取托管 Kubernetes 群集的访问凭据。	Extension	GA
az aks get-upgrades	获取可用于托管 Kubernetes 群集的升级版本。	Core	GA
az aks get-upgrades (aks-preview 扩展)	获取可用于托管 Kubernetes 群集的升级版本。	Extension	GA
az aks get-versions	获取可用于创建托管 Kubernetes 群集的版本。	Core	GA
az aks get-versions (aks-preview 扩展)	获取可用于创建托管 Kubernetes 群集的版本。	Extension	GA
az aks identity-binding	用于管理 Azure Kubernetes 服务中的标识绑定的命令。	Extension	GA
az aks identity-binding create	在托管 Kubernetes 群集中创建新的标识绑定。	Extension	GA
az aks identity-binding delete	删除托管 Kubernetes 群集中的特定标识绑定。	Extension	GA
az aks identity-binding list	列出托管 Kubernetes 群集下的所有标识绑定。	Extension	GA
az aks identity-binding show	显示托管 Kubernetes 群集中特定标识绑定的详细信息。	Extension	GA
az aks install-cli	下载并安装 Kubernetes 命令行工具 kubectl。下载并安装 kubelogin，这是实现 Azure 身份验证的客户端 go 凭据（exec）插件。	Core	GA
az aks jwtauthenticator	用于管理 Azure Kubernetes 服务中的 JWT 验证器的命令。	Extension	GA
az aks jwtauthenticator add	将 JWT 验证器添加到托管群集。	Extension	GA
az aks jwtauthenticator delete	从托管群集中删除 JWT 验证器。	Extension	GA
az aks jwtauthenticator list	列出托管群集中的所有 JWT 验证器。	Extension	GA
az aks jwtauthenticator show	显示托管群集中 JWT 身份验证器的详细信息。	Extension	GA
az aks jwtauthenticator update	更新托管群集中的 JWT 验证器。	Extension	GA
az aks kanalyze	完成 kollect 后显示 Kubernetes 群集的诊断结果。	Extension	GA
az aks kollect	收集 Kubernetes 群集的诊断信息。	Extension	GA
az aks list	列出托管 Kubernetes 群集。	Core	GA
az aks list (aks-preview 扩展)	列出托管 Kubernetes 群集。	Extension	GA
az aks loadbalancer	用于管理托管 Kubernetes 群集中的负载均衡器配置的命令。	Extension	GA
az aks loadbalancer add	将负载均衡器配置添加到托管 Kubernetes 群集。	Extension	GA
az aks loadbalancer delete	从托管 Kubernetes 群集中删除负载均衡器配置。	Extension	GA
az aks loadbalancer list	列出托管 Kubernetes 群集中的所有负载均衡器配置。	Extension	GA
az aks loadbalancer rebalance-nodes	跨特定负载均衡器重新平衡节点。	Extension	GA
az aks loadbalancer show	显示托管 Kubernetes 群集中特定负载均衡器配置的详细信息。	Extension	GA
az aks loadbalancer update	更新托管 Kubernetes 群集中的负载均衡器配置。	Extension	GA
az aks machine	获取有关托管群集节点池中的计算机的信息。	核心和扩展	GA
az aks machine add	将计算机添加到指定的节点池。	Extension	GA
az aks machine list	获取有关代理池中所有计算机的 IP 地址、主机名的信息。	Core	GA
az aks machine list (aks-preview 扩展)	列出代理池中所有计算机的详细信息。	Extension	GA
az aks machine show	显示 managedcluster 代理池中特定计算机的 IP 地址、主机名。	Core	GA
az aks machine show (aks-preview 扩展)	显示 managedcluster 代理池中特定计算机的详细信息。	Extension	GA
az aks maintenanceconfiguration	用于管理托管 Kubernetes 群集中的维护配置的命令。	核心和扩展	GA
az aks maintenanceconfiguration add	在托管 Kubernetes 群集中添加维护配置。	Core	GA
az aks maintenanceconfiguration add (aks-preview 扩展)	在托管 Kubernetes 群集中添加维护配置。	Extension	GA
az aks maintenanceconfiguration delete	删除托管 Kubernetes 群集中的维护配置。	Core	GA
az aks maintenanceconfiguration delete (aks-preview 扩展)	删除托管 Kubernetes 群集中的维护配置。	Extension	GA
az aks maintenanceconfiguration list	列出托管 Kubernetes 群集中的维护配置。	Core	GA
az aks maintenanceconfiguration list (aks-preview 扩展)	列出托管 Kubernetes 群集中的维护配置。	Extension	GA
az aks maintenanceconfiguration show	显示托管 Kubernetes 群集中维护配置的详细信息。	Core	GA
az aks maintenanceconfiguration show (aks-preview 扩展)	显示托管 Kubernetes 群集中维护配置的详细信息。	Extension	GA
az aks maintenanceconfiguration update	更新托管 Kubernetes 群集的维护配置。	Core	GA
az aks maintenanceconfiguration update (aks-preview 扩展)	更新托管 Kubernetes 群集的维护配置。	Extension	GA
az aks mesh	用于管理 Azure 服务网格的命令。	核心和扩展	GA
az aks mesh disable	禁用 Azure 服务网格。	Core	GA
az aks mesh disable (aks-preview 扩展)	禁用 Azure 服务网格。	Extension	GA
az aks mesh disable-egress-gateway	禁用 Azure 服务网格出口网关。	Extension	GA
az aks mesh disable-ingress-gateway	禁用 Azure 服务网格入口网关。	Core	GA
az aks mesh disable-ingress-gateway (aks-preview 扩展)	禁用 Azure 服务网格入口网关。	Extension	GA
az aks mesh disable-istio-cni	禁用 Azure 服务网格代理重定向机制的 Istio CNI 链接。	Extension	GA
az aks mesh enable	启用 Azure 服务网格。	Core	GA
az aks mesh enable (aks-preview 扩展)	启用 Azure 服务网格。	Extension	GA
az aks mesh enable-egress-gateway	启用 Azure 服务网格出口网关。	Extension	GA
az aks mesh enable-ingress-gateway	启用 Azure 服务网格入口网关。	Core	GA
az aks mesh enable-ingress-gateway (aks-preview 扩展)	启用 Azure 服务网格入口网关。	Extension	GA
az aks mesh enable-istio-cni	为 Azure 服务网格代理重定向机制启用 Istio CNI 链接。	Extension	GA
az aks mesh get-revisions	发现可用的 Azure 服务网格修订版及其兼容性。	Core	GA
az aks mesh get-revisions (aks-preview 扩展)	发现可用的 Azure 服务网格修订版及其兼容性。	Extension	GA
az aks mesh get-upgrades	发现可用的 Azure 服务网格升级。	Core	GA
az aks mesh get-upgrades (aks-preview 扩展)	发现可用的 Azure 服务网格升级。	Extension	GA
az aks mesh upgrade	用于管理 Azure 服务网格升级的命令。	核心和扩展	GA
az aks mesh upgrade complete	完成 Azure 服务网格升级。	Core	GA
az aks mesh upgrade complete (aks-preview 扩展)	完成 Azure 服务网格升级。	Extension	GA
az aks mesh upgrade rollback	回滚 Azure 服务网格升级。	Core	GA
az aks mesh upgrade rollback (aks-preview 扩展)	回滚 Azure 服务网格升级。	Extension	GA
az aks mesh upgrade start	启动 Azure 服务网格升级。	Core	GA
az aks mesh upgrade start (aks-preview 扩展)	启动 Azure 服务网格升级。	Extension	GA
az aks namespace	用于管理托管 Kubernetes 群集中的命名空间的命令。	Extension	Preview
az aks namespace add	将命名空间添加到托管 Kubernetes 群集。	Extension	Preview
az aks namespace delete	删除托管 Kubernetes 群集中的托管命名空间。	Extension	Preview
az aks namespace get-credentials	获取托管命名空间的访问凭据。	Extension	Preview
az aks namespace list	列出托管 Kubernetes 群集中的托管命名空间。	Extension	Preview
az aks namespace show	显示托管 Kubernetes 群集中托管命名空间的详细信息。	Extension	Preview
az aks namespace update	更新托管 Kubernetes 群集上的命名空间。	Extension	Preview
az aks nodepool	用于管理 Kubernetes kubernetes 群集中的节点池的命令。	核心和扩展	GA
az aks nodepool add	将节点池添加到托管 Kubernetes 群集。	Core	GA
az aks nodepool add (aks-preview 扩展)	将节点池添加到托管 Kubernetes 群集。	Extension	GA
az aks nodepool delete	删除托管 Kubernetes 群集中的代理池。	Core	GA
az aks nodepool delete (aks-preview 扩展)	删除托管 Kubernetes 群集中的代理池。	Extension	GA
az aks nodepool delete-machines	删除托管群集代理池中的特定计算机。	Core	GA
az aks nodepool delete-machines (aks-preview 扩展)	删除托管群集代理池中的特定计算机。	Extension	GA
az aks nodepool get-upgrades	获取托管 Kubernetes 群集的代理池的可用升级版本。	Core	GA
az aks nodepool get-upgrades (aks-preview 扩展)	获取托管 Kubernetes 群集的代理池的可用升级版本。	Extension	GA
az aks nodepool list	列出托管 Kubernetes 群集中的节点池。获取群集运行 `kubectl get nodes` 命令中的节点列表。	Core	GA
az aks nodepool list (aks-preview 扩展)	列出托管 Kubernetes 群集中的节点池。	Extension	GA
az aks nodepool manual-scale	用于管理 nodepool virtualMachineProfile.scale.manual 的命令。	核心和扩展	GA
az aks nodepool manual-scale add	将新的手动添加到托管 Kubernetes 群集中的 VirtualMachines 代理池。	Core	GA
az aks nodepool manual-scale add (aks-preview 扩展)	将新的手动添加到托管 Kubernetes 群集中的 VirtualMachines 代理池。	Extension	GA
az aks nodepool manual-scale delete	删除托管 Kubernetes 群集中 VirtualMachines 代理池的现有手动操作。	Core	GA
az aks nodepool manual-scale delete (aks-preview 扩展)	删除托管 Kubernetes 群集中 VirtualMachines 代理池的现有手动操作。	Extension	GA
az aks nodepool manual-scale update	更新托管 Kubernetes 群集中 VirtualMachines 代理池的现有手册。	Core	GA
az aks nodepool manual-scale update (aks-preview 扩展)	更新托管 Kubernetes 群集中 VirtualMachines 代理池的现有手册。	Extension	GA
az aks nodepool operation-abort	中止 nodepool 上的上次运行操作。	Core	GA
az aks nodepool operation-abort (aks-preview 扩展)	中止 nodepool 上的上次运行操作。	Extension	GA
az aks nodepool scale	缩放托管 Kubernetes 群集中的节点池。	Core	GA
az aks nodepool scale (aks-preview 扩展)	缩放托管 Kubernetes 群集中的节点池。	Extension	GA
az aks nodepool show	显示托管 Kubernetes 群集中节点池的详细信息。	Core	GA
az aks nodepool show (aks-preview 扩展)	显示托管 Kubernetes 群集中节点池的详细信息。	Extension	GA
az aks nodepool snapshot	用于管理节点池快照的命令。	核心和扩展	GA
az aks nodepool snapshot create	创建节点池快照。	Core	GA
az aks nodepool snapshot create (aks-preview 扩展)	创建节点池快照。	Extension	GA
az aks nodepool snapshot delete	删除节点池快照。	Core	GA
az aks nodepool snapshot delete (aks-preview 扩展)	删除节点池快照。	Extension	GA
az aks nodepool snapshot list	列出节点池快照。	Core	GA
az aks nodepool snapshot list (aks-preview 扩展)	列出节点池快照。	Extension	GA
az aks nodepool snapshot show	显示 nodepool 快照的详细信息。	Core	GA
az aks nodepool snapshot show (aks-preview 扩展)	显示 nodepool 快照的详细信息。	Extension	GA
az aks nodepool snapshot update	更新 nodepool 快照上的标记。	Core	GA
az aks nodepool snapshot update (aks-preview 扩展)	更新 nodepool 快照上的标记。	Extension	GA
az aks nodepool snapshot wait	等待节点池快照达到所需状态。	Core	GA
az aks nodepool start	在托管 Kubernetes 群集中启动已停止的代理池。	Core	GA
az aks nodepool start (aks-preview 扩展)	在托管 Kubernetes 群集中启动已停止的代理池。	Extension	GA
az aks nodepool stop	停止在托管 Kubernetes 群集中运行代理池。	Core	GA
az aks nodepool stop (aks-preview 扩展)	停止在托管 Kubernetes 群集中运行代理池。	Extension	GA
az aks nodepool update	更新节点池属性。	Core	GA
az aks nodepool update (aks-preview 扩展)	更新节点池属性。	Extension	GA
az aks nodepool upgrade	升级托管 Kubernetes 群集中的节点池。	Core	GA
az aks nodepool upgrade (aks-preview 扩展)	升级托管 Kubernetes 群集中的节点池。	Extension	GA
az aks nodepool wait	等待节点池达到所需状态。	Core	GA
az aks oidc-issuer	与 Oidc 颁发者相关的命令。	Core	GA
az aks oidc-issuer rotate-signing-keys	轮换 oidc 颁发者服务帐户签名密钥。	Core	GA
az aks operation	用于管理和查看托管 Kubernetes 群集上的操作的命令。	Extension	GA
az aks operation-abort	中止托管群集上的上次运行操作。	Core	GA
az aks operation-abort (aks-preview 扩展)	中止托管群集上的上次运行操作。	Extension	GA
az aks operation show	显示托管 Kubernetes 群集上特定操作的详细信息。	Extension	GA
az aks operation show-latest	显示托管 Kubernetes 群集上最新操作的详细信息。	Extension	GA
az aks pod-identity	用于管理托管 Kubernetes 群集中的 Pod 标识的命令。	Extension	GA
az aks pod-identity add	将 Pod 标识添加到托管 Kubernetes 群集。	Extension	GA
az aks pod-identity delete	从托管 Kubernetes 群集中删除 Pod 标识。	Extension	GA
az aks pod-identity exception	用于管理托管 Kubernetes 群集中的 Pod 标识异常的命令。	Extension	GA
az aks pod-identity exception add	将 Pod 标识异常添加到托管 Kubernetes 群集。	Extension	GA
az aks pod-identity exception delete	从托管 Kubernetes 群集中删除 Pod 标识异常。	Extension	GA
az aks pod-identity exception list	列出托管 Kubernetes 群集中的 Pod 标识异常。	Extension	GA
az aks pod-identity exception update	更新托管 Kubernetes 群集中的 Pod 标识异常。	Extension	GA
az aks pod-identity list	列出托管 Kubernetes 群集中的 Pod 标识。	Extension	GA
az aks remove-dev-spaces	从托管 Kubernetes 群集中删除 Azure Dev Spaces。	Core	Deprecated
az aks rotate-certs	轮换托管 Kubernetes 群集上的证书和密钥。	Core	GA
az aks rotate-certs (aks-preview 扩展)	轮换托管 Kubernetes 群集上的证书和密钥。	Extension	GA
az aks safeguards	管理部署安全措施。	Core	GA
az aks safeguards create	为托管群集启用部署安全措施。	Core	GA
az aks safeguards delete	禁用托管群集的部署安全措施。	Core	GA
az aks safeguards list	按父资源列出 DeploymentSafeguards。	Core	GA
az aks safeguards show	显示托管群集的部署保障配置。	Core	GA
az aks safeguards update	更新托管群集的部署保障配置。	Core	GA
az aks safeguards wait	将 CLI 置于等待状态，直到满足条件。	Core	GA
az aks scale	缩放托管 Kubernetes 群集中的节点池。	Core	GA
az aks scale (aks-preview 扩展)	缩放托管 Kubernetes 群集中的节点池。	Extension	GA
az aks show	显示托管 Kubernetes 群集的详细信息。	Core	GA
az aks show (aks-preview 扩展)	显示托管 Kubernetes 群集的详细信息。	Extension	GA
az aks snapshot	用于管理节点池快照的命令。	Extension	Deprecated
az aks snapshot create	创建群集的快照。	Extension	GA
az aks snapshot delete	删除群集快照。	Extension	GA
az aks snapshot list	列出群集快照。	Extension	GA
az aks snapshot show	显示群集快照的详细信息。	Extension	GA
az aks start	启动以前停止的托管群集。	Core	GA
az aks start (aks-preview 扩展)	启动以前停止的托管群集。	Extension	GA
az aks stop	停止托管群集。	Core	GA
az aks stop (aks-preview 扩展)	停止托管群集。	Extension	GA
az aks trustedaccess	用于管理受信任访问安全功能的命令。	Core	GA
az aks trustedaccess role	用于管理受信任访问角色的命令。	Core	GA
az aks trustedaccess role list	列出受信任的访问角色。	Core	GA
az aks trustedaccess rolebinding	用于管理受信任访问角色绑定的命令。	Core	GA
az aks trustedaccess rolebinding create	创建新的受信任访问角色绑定。	Core	GA
az aks trustedaccess rolebinding delete	根据名称删除受信任的访问角色绑定。	Core	GA
az aks trustedaccess rolebinding list	列出所有受信任的访问角色绑定。	Core	GA
az aks trustedaccess rolebinding show	根据绑定名称获取特定的受信任访问角色绑定。	Core	GA
az aks trustedaccess rolebinding update	更新受信任的访问角色绑定。	Core	GA
az aks update	更新托管 Kubernetes 群集。在没有可选参数的情况下调用时，会尝试将群集移动到其目标状态，而无需更改当前群集配置。这可用于移出非成功状态。	Core	GA
az aks update (aks-preview 扩展)	更新托管 Kubernetes 群集的属性。	Extension	GA
az aks update-credentials	更新托管 Kubernetes 群集（例如服务主体）的凭据。	Core	GA
az aks upgrade	将托管 Kubernetes 群集升级到较新的版本。	Core	GA
az aks upgrade (aks-preview 扩展)	将托管 Kubernetes 群集升级到较新的版本。	Extension	GA
az aks use-dev-spaces	将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用。	Core	Deprecated
az aks use-dev-spaces (dev-spaces 扩展)	将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用。	Extension	GA
az aks wait	等待托管 Kubernetes 群集达到所需状态。	Core	GA
az aks wait (aks-preview 扩展)	等待托管 Kubernetes 群集达到所需状态。	Extension	GA

az aks agent

运行 AI 助手来分析和排查 Kubernetes 群集问题。

此命令允许你提问有关 Azure Kubernetes 群集的问题，并使用 AI 模型获取答案。无需手动设置环境变量！可以使用配置文件或配置文件以交互方式 az aks agent-init 配置所有模型和凭据信息。

az aks agent [--aks-mcp {false, true}]
             [--api-key]
             [--config-file]
             [--max-steps]
             [--model]
             [--name]
             [--no-echo-request]
             [--no-interactive]
             [--refresh-toolsets]
             [--resource-group]
             [--show-tool-output]
             [--status]
             []

示例

询问群集中上次配置的模型的 Pod 问题

az aks agent "Why are my pods not starting?" --name MyManagedCluster --resource-group MyResourceGroup

使用 Azure OpenAI 询问群集中的 Pod 问题

az aks agent "Why are my pods not starting?" --name MyManagedCluster --resource-group MyResourceGroup --model azure/gpt-4.1

使用 OpenAI 询问群集中的 Pod 问题

az aks agent "Why are my pods not starting?" --name MyManagedCluster --resource-group MyResourceGroup --model gpt-4o

使用配置文件运行代理

az aks agent "Check kubernetes pod resource usage" --config-file /path/to/custom.yaml --name MyManagedCluster --resource-group MyResourceGroup
Here is an example of config file:
```json
llms:
  - provider: "azure"
    MODEL_NAME: "gpt-4.1"
    AZURE_API_BASE: "https://<your-base-url>"
    AZURE_API_KEY: "<your-api-key>"
# define a list of mcp servers, mcp server can be defined
mcp_servers:
  aks_mcp:
    description: "The AKS-MCP is a Model Context Protocol (MCP) server that enables AI assistants to interact with Azure Kubernetes Service (AKS) clusters"
    url: "http://localhost:8003/sse"

# try adding your own tools or toggle the built-in toolsets here
# e.g. query company-specific data, fetch logs from your existing observability tools, etc
# To check how to add a customized toolset, please refer to https://docs.robusta.dev/master/configuration/holmesgpt/custom_toolsets.html#custom-toolsets
# To find all built-in toolsets, please refer to https://docs.robusta.dev/master/configuration/holmesgpt/builtin_toolsets.html
toolsets:
  # add a new json processor toolset
  json_processor:
    description: "A toolset for processing JSON data using jq"
    prerequisites:
      - command: "jq --version"  # Ensure jq is installed
    tools:
      - name: "process_json"
        description: "A tool that uses jq to process JSON input"
        command: "echo '{{ json_input }}' | jq '.'"  # Example jq command to format JSON
  # disable a built-in toolsets
  aks/core:
    enabled: false
  ```

在交互模式下运行，没有问题

az aks agent "Check the pod status in my cluster" --name MyManagedCluster --resource-group MyResourceGroup --model azure/gpt-4.1 --api-key "sk-xxx"

在非交互式批处理模式下运行

az aks agent "Diagnose networking issues" --no-interactive --max-steps 15 --model azure/gpt-4.1

在分析期间显示详细的工具输出

az aks agent "Why is my service workload unavailable in namespace workload-ns?" --show-tool-output --model azure/gpt-4.1

使用自定义配置文件

az aks agent "Check kubernetes pod resource usage" --config-file /path/to/custom.yaml --model azure/gpt-4.1

在没有原始问题的回显的情况下运行代理

az aks agent "What is the status of my cluster?" --no-echo-request --model azure/gpt-4.1

刷新工具集以获取最新的可用工具

az aks agent "What is the status of my cluster?" --refresh-toolsets --model azure/gpt-4.1

显示代理状态（MCP 就绪情况）

az aks agent --status

在交互模式下运行，没有问题

az aks agent "Check the pod status in my cluster" --name MyManagedCluster --resource-group MyResourceGroup --model azure/my-gpt4.1-deployment --api-key "sk-xxx"

在非交互式批处理模式下运行

az aks agent "Diagnose networking issues" --no-interactive --max-steps 15 --model azure/my-gpt4.1-deployment

在分析期间显示详细的工具输出

az aks agent "Why is my service workload unavailable in namespace workload-ns?" --show-tool-output --model azure/my-gpt4.1-deployment

使用自定义配置文件

az aks agent "Check kubernetes pod resource usage" --config-file /path/to/custom.yaml --model azure/my-gpt4.1-deployment

在没有原始问题的回显的情况下运行代理

az aks agent "What is the status of my cluster?" --no-echo-request --model azure/my-gpt4.1-deployment

刷新工具集以获取最新的可用工具

az aks agent "What is the status of my cluster?" --refresh-toolsets --model azure/my-gpt4.1-deployment

可选参数

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

--aks-mcp

为增强功能启用 AKS MCP 集成。传统模式是默认模式。

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

--api-key

用于 LLM 的 API 密钥（如果未提供，请使用环境变量AZURE_API_KEY，OPENAI_API_KEY）。（已弃用）。

--config-file

配置文件的路径。

属性	值
默认值:	C:\azureCli\aksAgent.yaml

--max-steps

LLM 可以执行的最大步骤数来调查问题。

属性	值
默认值:	40

--model

指定要用于 AI 助手的 LLM 提供程序和模型或部署。

--model 参数确定将用于分析群集的大型语言模型（LLM）和提供程序。对于 OpenAI，请直接使用模型名称（例如 gpt-4o）。对于 Azure OpenAI，请使用 azure/<deployment name> （例如 azure/gpt-4.1）。每个提供程序可能需要不同的环境变量和模型命名约定。有关支持的提供程序、模型模式和所需环境变量的完整列表，请参阅 https://docs.litellm.ai/docs/providers。注意：对于 Azure OpenAI，建议将部署名称设置为模型名称，直到 https://github.com/BerriAI/litellm/issues/13950 解析为止。

--name -n

托管群集的名称。

--no-echo-request

禁用回显输出中提供给 AKS 代理的问题。

属性	值
默认值:	False

--no-interactive

禁用交互模式。设置后，代理不会提示输入，并且将在批处理模式下运行。

属性	值
默认值:	False

--refresh-toolsets

刷新工具集状态。

属性	值
默认值:	False

--resource-group -g

资源组的名称。

--show-tool-output

显示分析期间调用的每个工具的输出。

属性	值
默认值:	False

--status

显示 AKS 代理配置和状态信息。

属性	值
默认值:	False

使用可用工具询问任何问题和答案。

属性	值
Parameter group:	Positional

全局参数

--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 aks agent-init

初始化和验证 AKS 代理的 LLM 提供程序/模型配置。

此命令以交互方式指导你选择 LLM 提供程序和模型、验证连接，并保存配置以供以后使用。可以多次运行此命令来添加或更新不同的模型配置。

az aks agent-init

示例

初始化 Azure OpenAI、OpenAI 或其他 llms 的配置

az aks agent-init

全局参数

--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 aks bastion

使用 Azure Bastion 连接到托管 Kubernetes 群集。

此命令将启动子shell，kubeconfig 设置为通过 Bastion 连接到群集。使用退出或 Ctrl-D（即 EOF）退出子Shell。

az aks bastion --name
               --resource-group
               [--admin]
               [--bastion]
               [--port]
               [--yes]

示例

使用 Azure Bastion 和自定义端口和管理员凭据连接到托管 Kubernetes 群集。

az aks bastion -g MyResourceGroup --name MyManagedCluster --bastion MyBastionResource --port 50001 --admin

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--admin

使用群集管理员凭据连接到堡垒。

属性	值
默认值:	False

--bastion

配置为连接到当前 AKS 群集的预部署 Bastion 资源的名称或资源 ID。

如果未指定，该命令将尝试标识群集节点资源组中的现有 Bastion 资源。

--port

用于堡垒连接的本地端口号。

如果未提供，将使用随机端口。

--yes -y

不要提示确认。

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

编辑

在 Web 浏览器中显示 Kubernetes 群集的仪表板。

az aks browse --name
              --resource-group
              [--disable-browser]
              [--listen-address]
              [--listen-port]

示例

在 Web 浏览器中显示 Kubernetes 群集的仪表板。 (autogenerated)

az aks browse --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--disable-browser

建立端口转发后，请勿启动 Web 浏览器。

手动启动 Web 浏览器或自动测试时添加此参数。

属性	值
默认值:	False

--listen-address

仪表板的侦听地址。

添加此参数以侦听特定 IP 地址。

属性	值
默认值:	127.0.0.1

--listen-port

仪表板的侦听端口。

当其他进程使用默认侦听端口或不可用时添加此参数。

属性	值
默认值:	8001

全局参数

--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 aks browse (aks-preview 扩展)

在 Web 浏览器中显示 Kubernetes 群集的仪表板。

az aks browse --name
              --resource-group
              [--disable-browser]
              [--listen-address]
              [--listen-port]

示例

在 Web 浏览器中显示 Kubernetes 群集的仪表板。 (autogenerated)

az aks browse --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--disable-browser

建立端口转发后，请勿启动 Web 浏览器。

手动启动 Web 浏览器或自动测试时添加此参数。

属性	值
默认值:	False

--listen-address

仪表板的侦听地址。

添加此参数以侦听特定 IP 地址。

属性	值
默认值:	127.0.0.1

--listen-port

仪表板的侦听端口。

当其他进程使用默认侦听端口或不可用时添加此参数。

属性	值
默认值:	8001

全局参数

--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 aks check-acr

编辑

验证 ACR 是否可从 AKS 群集访问。

az aks check-acr --acr
                 --name
                 --resource-group
                 [--node-name]

示例

验证 ACR 是否可从 AKS 群集访问。

az aks check-acr --name MyManagedCluster --resource-group MyResourceGroup --acr myacr.azurecr.io

必需参数

--acr

ACR 的 FQDN。

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--node-name

要执行 acr 拉取测试检查的特定节点的名称。如果未指定，则会在随机节点上检查它。

全局参数

--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 aks create

编辑

Breaking change

默认 SSH 密钥行为将更改。如果未提供 SSH 密钥参数，则命令的行为将类似于传递“--no-ssh-key”，而不是在下一个计划于 2025 年 11 月发布的中断性变更版本（2.79.0）中失败。

新建托管 Kubernetes 群集。

az aks create --name
              --resource-group
              [--aad-admin-group-object-ids]
              [--aad-tenant-id]
              [--aci-subnet-name]
              [--admin-username]
              [--aks-custom-headers]
              [--ampls-resource-id]
              [--api-server-authorized-ip-ranges]
              [--apiserver-subnet-id]
              [--app-routing-default-nginx-controller --ardnc {AnnotationControlled, External, Internal, None}]
              [--appgw-id]
              [--appgw-name]
              [--appgw-subnet-cidr]
              [--appgw-subnet-id]
              [--appgw-watch-namespace]
              [--assign-identity]
              [--assign-kubelet-identity]
              [--attach-acr]
              [--auto-upgrade-channel {node-image, none, patch, rapid, stable}]
              [--azure-keyvault-kms-key-id]
              [--azure-keyvault-kms-key-vault-network-access {Private, Public}]
              [--azure-keyvault-kms-key-vault-resource-id]
              [--azure-monitor-workspace-resource-id]
              [--bootstrap-artifact-source {Cache, Direct}]
              [--bootstrap-container-registry-resource-id]
              [--ca-certs --custom-ca-trust-certificates]
              [--ca-profile --cluster-autoscaler-profile]
              [--client-secret]
              [--container-storage-version {1, 2}]
              [--crg-id]
              [--data-collection-settings]
              [--defender-config]
              [--disable-acns-observability]
              [--disable-acns-security]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-local-accounts]
              [--disable-public-fqdn]
              [--disable-rbac]
              [--disable-run-command]
              [--disable-snapshot-controller]
              [--dns-name-prefix]
              [--dns-service-ip]
              [--edge-zone]
              [--enable-aad]
              [--enable-acns]
              [--enable-addons]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-app-routing]
              [--enable-asm --enable-azure-service-mesh]
              [--enable-azure-container-storage]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-defender]
              [--enable-encryption-at-host]
              [--enable-fips-image]
              [--enable-high-log-scale-mode {false, true}]
              [--enable-image-cleaner]
              [--enable-keda]
              [--enable-managed-identity]
              [--enable-msi-auth-for-monitoring {false, true}]
              [--enable-node-public-ip]
              [--enable-oidc-issuer]
              [--enable-private-cluster]
              [--enable-secret-rotation]
              [--enable-secure-boot]
              [--enable-sgxquotehelper]
              [--enable-static-egress-gateway]
              [--enable-syslog {false, true}]
              [--enable-ultra-ssd]
              [--enable-vpa]
              [--enable-vtpm]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--ephemeral-disk-nvme-perf-tier {Basic, Premium, Standard}]
              [--ephemeral-disk-volume-type {EphemeralVolumeOnly, PersistentVolumeWithAnnotation}]
              [--fqdn-subdomain]
              [--generate-ssh-keys]
              [--gmsa-dns-server]
              [--gmsa-root-domain-name]
              [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
              [--grafana-resource-id]
              [--host-group-id]
              [--http-proxy-config]
              [--if-match]
              [--if-none-match]
              [--image-cleaner-interval-hours]
              [--ip-families]
              [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
              [--ksm-metric-annotations-allow-list]
              [--ksm-metric-labels-allow-list]
              [--kubelet-config]
              [--kubernetes-version]
              [--linux-os-config]
              [--load-balancer-backend-pool-type {nodeIP, nodeIPConfiguration}]
              [--load-balancer-idle-timeout]
              [--load-balancer-managed-outbound-ip-count]
              [--load-balancer-managed-outbound-ipv6-count]
              [--load-balancer-outbound-ip-prefixes]
              [--load-balancer-outbound-ips]
              [--load-balancer-outbound-ports]
              [--load-balancer-sku {basic, standard}]
              [--location]
              [--max-count]
              [--max-pods]
              [--message-of-the-day]
              [--min-count]
              [--nat-gateway-idle-timeout]
              [--nat-gateway-managed-outbound-ip-count]
              [--network-dataplane {azure, cilium}]
              [--network-plugin {azure, kubenet, none}]
              [--network-plugin-mode {overlay}]
              [--network-policy]
              [--no-ssh-key]
              [--no-wait]
              [--node-count]
              [--node-os-upgrade-channel {NodeImage, None, SecurityPatch, Unmanaged}]
              [--node-osdisk-diskencryptionset-id]
              [--node-osdisk-size]
              [--node-osdisk-type {Ephemeral, Managed}]
              [--node-provisioning-default-pools {Auto, None}]
              [--node-provisioning-mode {Auto, Manual}]
              [--node-public-ip-prefix-id]
              [--node-public-ip-tags]
              [--node-resource-group]
              [--node-vm-size]
              [--nodepool-allowed-host-ports]
              [--nodepool-asg-ids]
              [--nodepool-labels]
              [--nodepool-name]
              [--nodepool-tags]
              [--nodepool-taints]
              [--nrg-lockdown-restriction-level {ReadOnly, Unrestricted}]
              [--os-sku {AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204}]
              [--outbound-type {loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--pod-cidrs]
              [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
              [--pod-subnet-id]
              [--ppg]
              [--private-dns-zone]
              [--revision]
              [--rotation-poll-interval]
              [--service-cidr]
              [--service-cidrs]
              [--service-principal]
              [--skip-subnet-role-assignment]
              [--sku {automatic, base}]
              [--snapshot-id]
              [--ssh-key-value]
              [--storage-pool-name]
              [--storage-pool-option {NVMe, Temp}]
              [--storage-pool-size]
              [--storage-pool-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
              [--tags]
              [--tier {free, premium, standard}]
              [--vm-set-type]
              [--vm-sizes]
              [--vnet-subnet-id]
              [--windows-admin-password]
              [--windows-admin-username]
              [--workspace-resource-id]
              [--yes]
              [--zones]

示例

使用现有的 SSH 公钥创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --ssh-key-value /path/to/publickey

创建具有特定版本的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.16.9

创建具有较大节点池的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-count 7

创建具有默认 kubernetes 版本、默认 SKU 负载均衡器（标准）和默认 VM 集类型的 Kubernetes 群集（VirtualMachineScaleSets）。

az aks create -g MyResourceGroup -n MyManagedCluster

使用标准 SKU 负载均衡器和两个 AKS 为负载均衡器出站连接使用情况创建 KUBERnetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2

创建具有标准 SKU 负载均衡器的 Kubernetes 群集，其中两个出站 AKS 托管 IP 的空闲流超时为 5 分钟和 8000 个分配的每台计算机端口

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2 --load-balancer-idle-timeout 5 --load-balancer-outbound-ports 8000

使用标准 SKU 负载均衡器创建 Kubernetes 群集，并使用提供的公共 IP 进行负载均衡器出站连接使用情况。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ips <ip-resource-id-1,ip-resource-id-2>

使用标准 SKU 负载均衡器创建 Kubernetes 群集，并使用提供的公共 IP 前缀作为负载均衡器出站连接使用情况。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ip-prefixes <ip-prefix-resource-id-1,ip-prefix-resource-id-2>

使用 AKS 托管 NAT 网关创建 Kubernetes 群集，其中两个出站 AKS 托管 IP 空闲流超时 4 分钟

az aks create -g MyResourceGroup -n MyManagedCluster --nat-gateway-managed-outbound-ip-count 2 --nat-gateway-idle-timeout 4 --outbound-type managedNATGateway --generate-ssh-keys

创建具有基本 SKU 负载均衡器和 AvailabilitySet vm 集类型的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku basic --vm-set-type AvailabilitySet

创建具有授权 apiserver IP 范围的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 193.168.1.0/24,194.168.1.0/24,195.168.1.0

创建支持托管标识的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-managed-identity

使用 userDefinedRouting、标准负载均衡器 SKU 和预配置路由表的自定义子网创建 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --outbound-type userDefinedRouting --load-balancer-sku standard --vnet-subnet-id customUserSubnetVnetID

创建支持 Windows 代理池的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$'

创建支持启用了 AHUB 的 Windows 代理池的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-ahub

创建启用了托管 AAD 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

使用自己的密钥创建具有服务器端加密的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-osdisk-diskencryptionset-id <disk-encryption-set-resource-id>

创建启用了临时 OS 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

创建启用了 EncryptionAtHost 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-encryption-at-host

创建启用了 UltraSSD 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-ultra-ssd

创建启用了 Azure RBAC 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad --enable-azure-rbac

使用自定义控制平面标识和 kubelet 标识创建 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --assign-identity <control-plane-identity-resource-id> --assign-kubelet-identity <kubelet-identity-resource-id>

在 Edge 区域中创建 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --location <location> --kubernetes-version 1.20.7 --edge-zone <edge-zone-name>

创建具有特定 OS SKU 的 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --os-sku Ubuntu

使用自定义标记创建 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --tags "foo=bar" "baz=qux"

使用自定义标头创建 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --aks-custom-headers WindowsContainerRuntime=containerd

创建启用了 FIPS 的 OS 的 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-fips-image

使用启用 Windows gmsa 并在群集使用的 vnet 中设置 DNS 服务器，创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-windows-gmsa

创建支持 Windows gmsa 但未在群集使用的 vnet 中设置 DNS 服务器的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-windows-gmsa --gmsa-dns-server "10.240.0.4" --gmsa-root-domain-name "contoso.com"

使用快照 ID 创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

创建支持主机组 ID 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyMC --kubernetes-version 1.20.13 --location westus2 --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize --enable-managed-identity --assign-identity <user_assigned_identity_resource_id>

创建未安装 CNI 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --network-plugin none

创建启用了 KEDA 工作负荷自动缩放程序的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-keda

创建启用了 Prometheus 集成的 Azure Monitor 托管服务的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-monitor-metrics

使用垂直 Pod 自动缩放程序创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-vpa

使用容量预留组（CRG）ID 创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyMC --kubernetes-version 1.20.9 --node-vm-size VMSize --assign-identity "subscriptions/SubID/resourceGroups/RGName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID" --enable-managed-identity --crg-id "subscriptions/SubID/resourceGroups/RGName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

创建启用了 Azure 服务网格的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-service-mesh

创建具有 IP 分配模式设置为“StaticBlock”的节点池的 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --os-sku Ubuntu --max-pods MaxPodsPerNode --network-plugin azure --vnet-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/NodeSubnet --pod-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/PodSubnet --pod-ip-allocation-mode StaticBlock

使用 VirtualMachines vm 集类型创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3

创建具有自动节点预配的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-provisioning-mode Auto

创建包含自动节点预配和无默认池的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-provisioning-mode Auto --node-provisioning-default-pools None

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aad-admin-group-object-ids

将设置为群集管理员的 aad 组对象 ID 的逗号分隔列表。

--aad-tenant-id

Azure Active Directory 租户的 ID。

--aci-subnet-name

要在其中部署虚拟节点的现有 VNet 中的子网的名称。

--admin-username -u

在节点 VM 上创建用于 SSH 访问的用户帐户。

属性	值
默认值:	azureuser

--aks-custom-headers

用于指定自定义标头的逗号分隔键值对。

--ampls-resource-id

用于监视加载项的 Azure Monitor 专用链接范围的资源 ID。

--api-server-authorized-ip-ranges

已授权 API 服务器 IP 范围的逗号分隔列表。设置为 0.0.0.0/32，将 apiserver 流量限制到节点池。

--apiserver-subnet-id

要向其分配控制平面 apiserver pod 的现有 VNet 中的子网 ID（需要 --enable-apiserver-vnet-integration）。

--app-routing-default-nginx-controller --ardnc

配置默认 nginx 入口控制器类型。有效值为 annotationControlled （默认行为）、外部、内部或无。

属性	值
接受的值:	AnnotationControlled, External, Internal, None

--appgw-id

要用于 AGIC 的现有应用程序网关的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-name

在节点资源组中创建/使用的应用程序网关的名称。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-cidr

子网 CIDR 用于创建用于部署应用程序网关的新子网。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-id

用于部署应用程序网关的现有子网的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-watch-namespace

指定 AGIC 应监视的命名空间。可以是单个字符串值，也可以是命名空间的逗号分隔列表。

属性	值
Parameter group:	Application Gateway Arguments

--assign-identity

指定用于控制平面使用情况的现有用户分配标识，以便管理群集资源组。

--assign-kubelet-identity

为 kubelet 的使用指定现有用户分配的标识，该标识通常用于从 ACR 拉取映像。

--attach-acr

向名称或资源 ID 指定的 ACR 授予“acrpull”角色分配。

--auto-upgrade-channel

指定自动升级的升级通道。

属性	值
接受的值:	node-image, none, patch, rapid, stable

--azure-keyvault-kms-key-id

Azure Key Vault 密钥的标识符。

--azure-keyvault-kms-key-vault-network-access

Azure 密钥库的网络访问。

允许的值为“Public”、“Private”。如果未设置，则默认键入“Public”。要求使用 --azure-keyvault-kms-key-id。

属性	值
接受的值:	Private, Public

--azure-keyvault-kms-key-vault-resource-id

Azure 密钥库的资源 ID。

--azure-monitor-workspace-resource-id

Azure Monitor 工作区的资源 ID。

--bootstrap-artifact-source

启动群集时配置项目源。

项目包括加载项映像。使用“Direct”从 MCR 下载项目，将项目“缓存”下载到Azure 容器注册表。

属性	值
默认值:	Direct
接受的值:	Cache, Direct

--bootstrap-container-registry-resource-id

配置容器注册表资源 ID。必须使用“缓存”作为启动项目源。

--ca-certs --custom-ca-trust-certificates

包含最多 10 个空白行分隔证书的文件的路径。仅对 Linux 节点有效。

这些证书由自定义 CA 信任功能使用，并将添加到节点的信任存储中。

--ca-profile --cluster-autoscaler-profile

用于配置群集自动缩放程序的键=值对的逗号分隔列表。传递空字符串以清除配置文件。

--client-secret

与服务主体关联的机密。如果 --service-principal 指定此参数，则需要此参数。

--container-storage-version

设置 Azure 容器存储版本，默认情况下将安装最新版本。

属性	值
接受的值:	1, 2

--crg-id

用于将新群集与现有容量预留组资源关联的 crg ID。

--data-collection-settings

包含监视加载项数据收集设置的 JSON 文件的路径。

--defender-config

包含 Microsoft Defender 配置文件配置的 JSON 文件的路径。

--disable-acns-observability

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络可观测性功能。

--disable-acns-security

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络安全功能。

--disable-disk-driver

禁用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--disable-file-driver

禁用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--disable-local-accounts

如果设置为 true，则会为此群集禁用静态凭据。

属性	值
默认值:	False

--disable-public-fqdn

禁用专用群集的公共 fqdn 功能。

属性	值
默认值:	False

--disable-rbac

禁用 Kubernetes 基于角色的访问控制。

--disable-run-command

禁用群集的“运行”命令功能。

属性	值
默认值:	False

--disable-snapshot-controller

禁用 CSI 快照控制器。

属性	值
默认值:	False

--dns-name-prefix -p

创建的主机名的前缀。如果未指定，请使用托管群集和资源组名称生成主机名。

--dns-service-ip

分配给 Kubernetes DNS 服务的 IP 地址。

此地址必须位于由“--service-cidr”指定的 Kubernetes 服务地址范围内。例如，10.0.0.10。

--edge-zone

边缘区域的名称。

--enable-aad

为群集启用托管 AAD 功能。

属性	值
默认值:	False

--enable-acns

在群集上启用高级网络功能。启用此操作会产生额外的费用。对于非 cilium 群集，acns 安全性默认处于禁用状态，直到收到进一步通知。

--enable-addons -a

在逗号分隔列表中启用 Kubernetes 加载项。

这些加载项可用：- http_application_routing：使用自动公共 DNS 名称创建配置入口。 - 监视：启用 Log Analytics 监视。如果存在，请使用 Log Analytics 默认工作区，否则将创建一个工作区。指定“--workspace-resource-id”以使用现有工作区。指定“--enable-msi-auth-for-monitoring”以使用托管标识身份验证。指定“--enable-syslog”以从节点启用 syslog 数据收集。请注意，MSI 必须启用“--data-collection-settings”以配置数据收集设置指定专用链接的“--ampls-resource-id”。请注意，必须启用 MSI。指定“--enable-high-log-scale-mode”，为容器日志启用高日志缩放模式。请注意，必须启用 MSI。如果启用了监视加载项 --no-wait 参数将不起作用 - azure-policy ：启用 Azure policy。 AKS 的 Azure Policy 加载项以集中、一致的方式在群集上实现大规模强制措施和安全措施。有关详细信息，请查看 aka.ms/aks/policy。 - 虚拟节点：启用 AKS 虚拟节点。要求 --aci-subnet-name 提供现有子网的名称供虚拟节点使用。 aci-subnet-name 必须位于由 --vnet-subnet-id（必需）指定的同一 vnet 中。 - confcom ：启用 confcom 加载项，这将默认启用 SGX 设备插件。 - open-service-mesh：启用 Open Service Mesh 加载项。 - azure-keyvault-secrets-provider：启用 Azure Keyvault 机密提供程序加载项。

--enable-ahub

为 Windows VM 启用 Azure 混合用户权益（AHUB）。

属性	值
默认值:	False

--enable-ai-toolchain-operator

向群集启用 AI 工具链操作员。

属性	值
默认值:	False

--enable-apiserver-vnet-integration

启用用户 vnet 与控制平面 apiserver Pod 的集成。

属性	值
默认值:	False

--enable-app-routing

启用应用程序路由加载项。

属性	值
默认值:	False

--enable-asm --enable-azure-service-mesh

启用 Azure 服务网格加载项。

--enable-azure-container-storage

启用 Azure 容器存储。可用作标志（默认值为 True）或存储池类型值：（azureDisk、ephemeralDisk、elasticSan）。

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--enable-azure-monitor-metrics

使用用于 Prometheus 集成的 Azure Monitor 托管服务启用 kubernetes 群集。

属性	值
默认值:	False

--enable-azure-rbac

启用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler

启用群集自动缩放程序，默认值为 false。

如果指定，请确保 kubernetes 版本大于 1.10.6。

属性	值
默认值:	False

--enable-cost-analysis

启用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。有关详细信息，请参阅 aka.ms/aks/docs/cost-analysis。

属性	值
默认值:	False

--enable-defender

启用 Microsoft Defender 安全配置文件。

属性	值
默认值:	False

--enable-encryption-at-host

启用 EncryptionAtHost，默认值为 false。

属性	值
默认值:	False

--enable-fips-image

在代理节点上使用启用了 FIPS 的 OS。

属性	值
默认值:	False

--enable-high-log-scale-mode

为容器日志启用高日志缩放模式。

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

--enable-image-cleaner

启用 ImageCleaner 服务。

属性	值
默认值:	False

--enable-keda

启用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--enable-managed-identity

使用系统分配的托管标识来管理群集资源组。可以显式指定“--service-principal”和“--client-secret”以禁用托管标识，否则将启用它。

--enable-msi-auth-for-monitoring

为监视加载项启用托管标识身份验证。

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

--enable-node-public-ip

启用 VMSS 或 VM 节点公共 IP。

属性	值
默认值:	False

--enable-oidc-issuer

启用 OIDC 颁发者。

属性	值
默认值:	False

--enable-private-cluster

启用专用群集。

属性	值
默认值:	False

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-secure-boot

在群集中的所有节点池上启用安全启动。必须使用 VMSS 或 VM 代理池类型。

属性	值
默认值:	False

--enable-sgxquotehelper

为 confcom 加载项启用 SGX 报价帮助程序。

属性	值
默认值:	False

--enable-static-egress-gateway

启用群集的静态出口网关加载项。

属性	值
默认值:	False

--enable-syslog

为监视加载项启用 syslog 数据收集。

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

--enable-ultra-ssd

启用 UltraSSD，默认值为 false。

属性	值
默认值:	False

--enable-vpa

为群集启用垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--enable-vtpm

在群集中的所有节点池上启用 vTPM。必须使用 VMSS 或 VM 代理池类型。

属性	值
默认值:	False

--enable-windows-gmsa

启用 Windows gmsa。

属性	值
默认值:	False

--enable-windows-recording-rules

启用 Azure Monitor 指标加载项时启用 Windows 录制规则。

属性	值
默认值:	False

--enable-workload-identity

启用工作负荷标识加载项。

属性	值
默认值:	False

--ephemeral-disk-nvme-perf-tier

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	Basic, Premium, Standard

--ephemeral-disk-volume-type

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	EphemeralVolumeOnly, PersistentVolumeWithAnnotation

--fqdn-subdomain

为具有自定义专用 DNS 区域方案的专用群集创建的 FQDN 前缀。

--generate-ssh-keys

生成 SSH 公钥和私钥文件（如果缺少）。密钥将存储在 ~/.ssh 目录中。

属性	值
默认值:	False

--gmsa-dns-server

为此群集指定 Windows gmsa 的 DNS 服务器。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gmsa-root-domain-name

为此群集指定 Windows gmsa 的根域名。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gpu-instance-profile

用于分区多 gpu Nvidia GPU 的 GPU 实例配置文件。

属性	值
接受的值:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--grafana-resource-id

Azure 托管 Grafana 工作区的资源 ID。

--host-group-id

用于预配代理节点池的完全限定专用主机组 ID。

--http-proxy-config

此群集的 HTTP 代理配置。

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--image-cleaner-interval-hours

ImageCleaner 扫描间隔。

--ip-families

用于群集网络的 IP 版本的逗号分隔列表。

每个 IP 版本应采用 IPvN 格式。例如，IPv4。

--k8s-support-plan

从“KubernetesOfficial”或“AKSLongTermSupport”中进行选择，并使用“AKSLongTermSupport”获得 1 个额外的 CVE 修补程序。

属性	值
接受的值:	AKSLongTermSupport, KubernetesOfficial

--ksm-metric-annotations-allow-list

将在资源标签指标中使用的其他 Kubernetes 标签键的逗号分隔列表。默认情况下，指标仅包含名称和命名空间标签。若要包括其他标签，请在其复数形式和 Kubernetes 标签键中提供资源名称列表，以便允许它们（例如“=namespaces=[k8s-label-1，k8s-label-n,...]，pods=[app],...）”。 可以改为为每个资源提供一个“”，以允许任何标签，但这会产生严重的性能影响（例如“=pods=[]”。

--ksm-metric-labels-allow-list

将在资源标签指标中使用的其他 Kubernetes 标签键的逗号分隔列表。默认情况下，指标仅包含名称和命名空间标签。若要包含其他标签，请在其复数形式中提供资源名称列表，以及想要允许它们的 Kubernetes 标签键（例如“=namespaces=[k8s-label-1，k8s-label-n,...]，pods=[app],...）”。 可以改为为每个资源提供一个“”，以允许任何标签，但这会产生严重的性能影响（例如“=pods=[]”。

--kubelet-config

包含代理节点的 Kubelet 配置的 JSON 文件的路径。 https://aka.ms/aks/custom-node-config。

--kubernetes-version -k

用于创建群集的 Kubernetes 版本，例如“1.16.9”。

属性	值
值来源:	`az aks get-versions`

--linux-os-config

包含 Linux 代理节点 OS 配置的 JSON 文件的路径。 https://aka.ms/aks/custom-node-config。

--load-balancer-backend-pool-type

负载均衡器后端池类型。

定义托管入站后端池的 LoadBalancer 后端池类型。 nodeIP 表示 VM 将通过将其专用 IP 地址添加到后端池来附加到 LoadBalancer。 nodeIPConfiguration 表示 VM 将通过引用 VM 的 NIC 中的后端池 ID 附加到 LoadBalancer。

属性	值
接受的值:	nodeIP, nodeIPConfiguration

--load-balancer-idle-timeout

负载均衡器空闲超时（以分钟为单位）。

负载均衡器出站流的所需空闲超时，默认值为 30 分钟。请在 [4， 100] 范围内指定一个值。

--load-balancer-managed-outbound-ip-count

负载均衡器托管的出站 IP 计数。

负载均衡器出站连接的托管出站 IP 的所需数量。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-managed-outbound-ipv6-count

负载均衡器管理的出站 IPv6 IP 计数。

负载均衡器出站连接的托管出站 IPv6 IP 的所需数量。仅适用于双堆栈（--ip 系列 IPv4，IPv6）。

--load-balancer-outbound-ip-prefixes

负载均衡器出站 IP 前缀资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 前缀资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ips

负载均衡器出站 IP 资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ports

负载均衡器出站分配端口。

负载均衡器后端池中每个 VM 所需的出站端口数。默认情况下，设置为 0，它使用基于 VM 数的默认分配。

--load-balancer-sku

Azure 负载均衡器群集的 SKU 选择。基本或标准。默认值为“standard”。

在 AKS 群集的基本或标准AZURE 负载均衡器 SKU 之间进行选择。

属性	值
接受的值:	basic, standard

--location -l

Location. az account list-locations 中的值。可以使用 az configure --defaults location=<location> 配置默认位置。

--max-count

指定了“--enable-cluster-autoscaler”时用于自动缩放程序的最大节点计数。请在 [1， 1000] 范围内指定值。

--max-pods -m

可部署到节点的最大 Pod 数。

如果未指定，则基于网络插件的默认值。 30（对于“azure”），对于“kubenet”为 110，对于“none”，则为 250。

--message-of-the-day

包含当天所需消息的文件的路径。仅适用于 Linux 节点。将写入 /etc/motd。

--min-count

指定“--enable-cluster-autoscaler”时用于自动缩放程序的最小节点计数。请在 [1， 1000] 范围内指定值。

--nat-gateway-idle-timeout

NAT 网关空闲超时（以分钟为单位）。

NAT 网关出站流的所需空闲超时，默认值为 4 分钟。请在 [4， 120] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--nat-gateway-managed-outbound-ip-count

NAT 网关托管出站 IP 计数。

NAT 网关出站连接的托管出站 IP 数。请在 [1， 16] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--network-dataplane

要使用的网络数据平面。

Kubernetes 群集中使用的网络数据平面。指定“azure”以使用 Azure 数据平面（默认）或“cilium”来启用 Cilium 数据平面。

属性	值
接受的值:	azure, cilium

--network-plugin

要使用的 Kubernetes 网络插件。

为高度可缩放的网络指定“azure”，为基于子网 NAT 的路由分配 IP 分配指定“kubenet”，如果未配置任何网络，则为“none”。默认值为“azure”。

属性	值
接受的值:	azure, kubenet, none

--network-plugin-mode

要使用的网络插件模式。

用于控制网络插件应在其中运行的模式。默认值为“overlay”。如果未将“azure”指定为网络插件，则从 VNET 为 Pod 提供可路由 IP。

属性	值
接受的值:	overlay

--network-policy

要使用的网络策略引擎。

Azure 提供了三个网络策略引擎，用于强制实施可与“azure”网络插件一起使用的网络策略。可以指定以下值：

Azure 网络策略管理器的“azure”
由 Cilium 提供支持的 Azure CNI 的“cilium”
Tigera 创立的开源网络和网络安全解决方案的“calico”
如果未安装网络策略引擎（默认值），则为“none”。默认为“none”（网络策略已禁用）。

--no-ssh-key -x

不要使用或创建本地 SSH 密钥。

若要使用此选项创建群集后访问节点，请使用 Azure 门户。

属性	值
默认值:	False

--no-wait

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

属性	值
默认值:	False

--node-count -c

Kubernetes 节点池中的节点数。创建群集后，可以使用它更改其节点池 az aks scale的大小。

属性	值
默认值:	3

--node-os-upgrade-channel

更新节点上 OS 的方式。可以是 NodeImage、None、SecurityPatch 或非托管。

属性	值
接受的值:	NodeImage, None, SecurityPatch, Unmanaged

--node-osdisk-diskencryptionset-id -d

用于在代理节点 os 磁盘上启用静态加密的磁盘加密集的 ResourceId。

--node-osdisk-size

节点池中每个节点的 OS 磁盘 GiB 大小。最小 30 GiB。

--node-osdisk-type

要用于给定代理池中的计算机的 OS 磁盘类型：临时或托管。如果可能与 VM 大小和 OS 磁盘大小结合使用，则默认为“临时”。创建后可能不会更改此池。

属性	值
接受的值:	Ephemeral, Managed

--node-provisioning-default-pools

为节点预置配置的默认 Karpenter NodePools 集。有效值为“Auto”和“None”。

为节点预置配置的默认 Karpenter NodePools 集。有效值为“Auto”和“None”。自动：预配了一组标准 Karpenter NodePools。无：未预配 Karpenter NodePools。警告：将此从现有群集上的“自动”更改为“无”将导致删除默认的 Karpenter NodePools，这反过来又会耗尽并删除与这些池关联的节点。强烈建议不要这样做，除非有空闲节点准备好接收该作驱逐的 Pod。

属性	值
接受的值:	Auto, None

--node-provisioning-mode

设置群集的节点预配模式。有效值为“Auto”和“Manual”。有关“自动”模式的详细信息，请参阅 aka.ms/aks/nap。

属性	值
接受的值:	Auto, Manual

--node-public-ip-prefix-id

用于向 VMSS 或 VM 节点分配公共 IP 的公共 IP 前缀 ID。

--node-public-ip-tags

节点公共 IP 的 ipTag。

--node-resource-group

节点资源组是将在其中创建所有客户资源的资源组，例如虚拟机。

--node-vm-size -s

要创建为 Kubernetes 节点的虚拟机的大小。如果用户未指定一个，服务器将为她/他选择默认的 VM 大小。

--nodepool-allowed-host-ports

公开节点池上的主机端口。指定时，格式应是具有协议的范围（例如）的空间分隔列表。 80/TCP 443/TCP 4000-5000/TCP。

--nodepool-asg-ids

节点池网络接口应属于的应用程序安全组的 ID。指定时，格式应为空格分隔的 ID 列表。

--nodepool-labels

所有节点池的节点标签。请参阅 https://aka.ms/node-labels 标签语法。

--nodepool-name

节点池名称，最多 12 个字母数字字符。

属性	值
默认值:	nodepool1

--nodepool-tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--nodepool-taints

所有节点池的节点排斥。

--nrg-lockdown-restriction-level

托管节点资源组的限制级别。

群集的托管节点资源组上允许的权限限制级别、支持的值是“不受限制”和“ReadOnly”（建议的 ReadOnly）。

属性	值
接受的值:	ReadOnly, Unrestricted

--os-sku

代理节点池的 OS SKU。 Ubuntu 或 AzureLinux。

属性	值
接受的值:	AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204

--outbound-type

如何为群集配置出站流量。

在 loadBalancer、userDefinedRouting、managedNATGateway、userAssignedNATGateway 和 none 之间进行选择。如果未设置，则默认为 type loadBalancer。要求使用预配置的路由表和 --load-balancer-sku 作为标准提供 --vnet-subnet-id。

属性	值
接受的值:	loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting

--pod-cidr

使用 Azure CNI 覆盖或 Kubenet 时分配 Pod IP 的 CIDR 表示法 IP 范围（2028 年 3 月 31 日，Kubenet 将停用）。

此范围不得与任何子网 IP 范围重叠。例如，172.244.0.0/16。请参阅 https://aka.ms/aks/azure-cni-overlay。

--pod-cidrs

使用 Azure CNI 覆盖或 Kubenet 时，CIDR 表示法 IP 范围的逗号分隔列表（2028 年 3 月 31 日，Kubenet 将停用）。

每个范围不得与任何子网 IP 范围重叠。例如，“172.244.0.0/16，fd0：abcd：：/64”。请参阅 https://aka.ms/aks/azure-cni-overlay。

--pod-ip-allocation-mode

设置 IP 分配模式，了解如何将 Azure Pod 子网中的 Pod IP 分配到 AKS 群集中的节点。选择的是单个 IP 的动态批处理或一组 CIDR 块的静态分配。接受的值是“DynamicIndividual”或“StaticBlock”。

与“azure”网络插件一起使用。需要 --pod-subnet-id。

属性	值
接受的值:	DynamicIndividual, StaticBlock

--pod-subnet-id

要将群集中的 Pod 分配到的现有 VNet 中的子网 ID（需要 azure 网络插件）。

--ppg

PPG 的 ID。

--private-dns-zone

专用群集的专用 DNS 区域模式。

允许的值为“system”、“none”或自定义专用 DNS 区域资源 ID。如果未设置，则默认为类型系统。要求使用 --enable-private-cluster。

--revision

要安装的 Azure 服务网格修订版。

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--service-cidr

从中分配服务群集 IP 的 CIDR 表示法 IP 范围。

此范围不得与任何子网 IP 范围重叠。例如 10.0.0.0/16。

--service-cidrs

CIDR 表示法 IP 范围的逗号分隔列表，用于分配服务群集 IP。

每个范围不得与任何子网 IP 范围重叠。例如，“10.0.0.0/16,2001：abcd：：/108”。

--service-principal

用于对 Azure API 进行身份验证的服务主体。

--skip-subnet-role-assignment

跳过子网的角色分配（高级网络）。

如果指定，请确保服务主体有权访问子网。

属性	值
默认值:	False

--sku

指定托管群集的 SKU 名称。使用“--sku 基础”可启用基本托管群集。使用“--sku 自动”可启用自动托管群集。

属性	值
接受的值:	automatic, base

--snapshot-id

用于创建此群集的源快照 ID。

--ssh-key-value

在节点 VM 上安装的、用于 SSH 访问的公钥路径或密钥内容。例如，“ssh-rsa AAAAB...剪断。。。UcyupgH azureuser@linuxvm'。

属性	值
默认值:	~\.ssh\id_rsa.pub

--storage-pool-name

为 Azure 容器存储设置存储池名称。

--storage-pool-option

为 Azure 容器存储设置临时磁盘存储池选项。

属性	值
接受的值:	NVMe, Temp

--storage-pool-size

为 Azure 容器存储设置存储池大小。

--storage-pool-sku

为 Azure 容器存储设置 Azure 磁盘类型存储池 SKU。

属性	值
接受的值:	PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

托管群集的标记。将标记由云提供商管理的托管群集实例和所有资源。

--tier

指定托管群集的 SKU 层。 “层标准”支持具有财务支持的 SLA 的标准托管群集服务。 “层免费”没有经济支持的 SLA。

属性	值
接受的值:	free, premium, standard

--vm-set-type

代理池 vm 集类型。 VirtualMachineScaleSets 或 AvailabilitySet 或 VirtualMachines。默认值为“VirtualMachineScaleSets”。

--vm-sizes

以逗号分隔的 VM 大小列表。仅适用于 VirtualMachines 节点池。如果未 --vm-sizes 指定但 --node-vm-size 指定值，将使用值 --node-vm-size 。如果两者均未指定，则默认为 Linux Standard_DS2_v2或 windows Standard_D2s_v3。

--vnet-subnet-id

要在其中部署群集的现有 VNet 中子网的 ID。

--windows-admin-password

用于 Windows 节点 VM 的用户帐户密码。

windows-admin-password 规则： - 最小长度： 14 个字符 - 最大长度： 123 个字符 - 复杂性要求：以下 4 个条件中的 3 个需要满足 * 具有较低字符 * 具有大写字符 * 具有数字 * 具有特殊字符（Regex match [\W_]） - 不允许的值：“abc@123”， “P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password！”、“Password1”、“Password22”、“iloveyou！”参考： https://free.blessedness.top/dotnet/api/microsoft.azure.management.compute.models.virtualmachinescalesetosprofile.adminpassword?view=azure-dotnet.

--windows-admin-username

在 Windows 节点 VM 上创建的用户帐户。

windows-admin-username 规则： - 限制：不能以“.”结尾 - 不允许的值：“administrator”、“admin”、“user1”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0 sys”、“test2”、“test3”、“user4”、“user5”。 - 最小长度：1 个字符 - 最大长度：20 个字符引用： https://free.blessedness.top/dotnet/api/microsoft.azure.management.compute.models.virtualmachinescalesetosprofile.adminusername?view=azure-dotnet。

--workspace-resource-id

要用于存储监视数据的现有 Log Analytics 工作区的资源 ID。如果未指定，则使用默认的 Log Analytics 工作区（如果存在）否则创建一个。

--yes -y

不要提示确认。

属性	值
默认值:	False

--zones -z

将放置代理节点的可用性区域。此外，若要将代理节点安装到多个区域，需要传递用空白分隔的区域编号（1,2 或 3）。例如 - 若要拥有所有 3 个区域，应输入 --zones 1 2 3。

全局参数

--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 aks create (aks-preview 扩展)

Breaking change

新建托管 Kubernetes 群集。

az aks create --name
              --resource-group
              [--aad-admin-group-object-ids]
              [--aad-tenant-id]
              [--aci-subnet-name]
              [--acns-advanced-networkpolicies {FQDN, L7, None}]
              [--acns-datapath-acceleration-mode {BpfVeth, None}]
              [--acns-transit-encryption-type {None, WireGuard}]
              [--admin-username]
              [--aks-custom-headers]
              [--ampls-resource-id]
              [--api-server-authorized-ip-ranges]
              [--apiserver-subnet-id]
              [--app-routing-default-nginx-controller --ardnc {AnnotationControlled, External, Internal, None}]
              [--appgw-id]
              [--appgw-name]
              [--appgw-subnet-cidr]
              [--appgw-subnet-id]
              [--appgw-watch-namespace]
              [--assign-identity]
              [--assign-kubelet-identity]
              [--attach-acr]
              [--auto-upgrade-channel {node-image, none, patch, rapid, stable}]
              [--azure-keyvault-kms-key-id]
              [--azure-keyvault-kms-key-vault-network-access {Private, Public}]
              [--azure-keyvault-kms-key-vault-resource-id]
              [--azure-monitor-workspace-resource-id]
              [--bootstrap-artifact-source {Cache, Direct}]
              [--bootstrap-container-registry-resource-id]
              [--ca-certs --custom-ca-trust-certificates]
              [--ca-profile --cluster-autoscaler-profile]
              [--client-secret]
              [--cluster-service-load-balancer-health-probe-mode {Servicenodeport, Shared}]
              [--cluster-snapshot-id]
              [--container-storage-version {1, 2}]
              [--crg-id]
              [--data-collection-settings]
              [--defender-config]
              [--disable-acns-observability]
              [--disable-acns-security]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-local-accounts]
              [--disable-opentelemetry-logs]
              [--disable-opentelemetry-metrics]
              [--disable-public-fqdn]
              [--disable-rbac]
              [--disable-run-command]
              [--disable-snapshot-controller]
              [--disk-driver-version {v1, v2}]
              [--dns-name-prefix]
              [--dns-service-ip]
              [--dns-zone-resource-ids]
              [--edge-zone]
              [--enable-aad]
              [--enable-acns]
              [--enable-addons]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-app-routing]
              [--enable-asm --enable-azure-service-mesh]
              [--enable-azure-container-storage]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-app-monitoring]
              [--enable-azure-monitor-logs]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-defender]
              [--enable-encryption-at-host]
              [--enable-fips-image]
              [--enable-gateway-api]
              [--enable-high-log-scale-mode {false, true}]
              [--enable-hosted-system]
              [--enable-image-cleaner]
              [--enable-image-integrity]
              [--enable-imds-restriction]
              [--enable-keda]
              [--enable-managed-identity]
              [--enable-msi-auth-for-monitoring {false, true}]
              [--enable-node-public-ip]
              [--enable-oidc-issuer]
              [--enable-opentelemetry-logs]
              [--enable-opentelemetry-metrics]
              [--enable-optimized-addon-scaling]
              [--enable-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--enable-private-cluster]
              [--enable-retina-flow-logs]
              [--enable-secret-rotation]
              [--enable-secure-boot]
              [--enable-sgxquotehelper]
              [--enable-static-egress-gateway]
              [--enable-syslog {false, true}]
              [--enable-ultra-ssd]
              [--enable-upstream-kubescheduler-user-configuration]
              [--enable-vpa]
              [--enable-vtpm]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--ephemeral-disk-nvme-perf-tier {Basic, Premium, Standard}]
              [--ephemeral-disk-volume-type {EphemeralVolumeOnly, PersistentVolumeWithAnnotation}]
              [--fqdn-subdomain]
              [--generate-ssh-keys]
              [--gmsa-dns-server]
              [--gmsa-root-domain-name]
              [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
              [--grafana-resource-id]
              [--host-group-id]
              [--http-proxy-config]
              [--if-match]
              [--if-none-match]
              [--image-cleaner-interval-hours]
              [--ip-families]
              [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
              [--kms-infrastructure-encryption {Disabled, Enabled}]
              [--ksm-metric-annotations-allow-list]
              [--ksm-metric-labels-allow-list]
              [--kube-proxy-config]
              [--kubelet-config]
              [--kubernetes-version]
              [--linux-os-config]
              [--load-balancer-backend-pool-type]
              [--load-balancer-idle-timeout]
              [--load-balancer-managed-outbound-ip-count]
              [--load-balancer-managed-outbound-ipv6-count]
              [--load-balancer-outbound-ip-prefixes]
              [--load-balancer-outbound-ips]
              [--load-balancer-outbound-ports]
              [--load-balancer-sku {basic, standard}]
              [--location]
              [--max-count]
              [--max-pods]
              [--message-of-the-day]
              [--min-count]
              [--nat-gateway-idle-timeout]
              [--nat-gateway-managed-outbound-ip-count]
              [--network-dataplane {azure, cilium}]
              [--network-plugin {azure, kubenet, none}]
              [--network-plugin-mode {overlay}]
              [--network-policy]
              [--no-ssh-key]
              [--no-wait]
              [--node-count]
              [--node-init-taints --nodepool-initialization-taints]
              [--node-os-upgrade-channel {NodeImage, None, SecurityPatch, Unmanaged}]
              [--node-osdisk-diskencryptionset-id]
              [--node-osdisk-size]
              [--node-osdisk-type {Ephemeral, Managed}]
              [--node-provisioning-default-pools {Auto, None}]
              [--node-provisioning-mode {Auto, Manual}]
              [--node-public-ip-prefix-id]
              [--node-public-ip-tags]
              [--node-resource-group]
              [--node-vm-size]
              [--nodepool-allowed-host-ports]
              [--nodepool-asg-ids]
              [--nodepool-labels]
              [--nodepool-name]
              [--nodepool-tags]
              [--nodepool-taints]
              [--nrg-lockdown-restriction-level {ReadOnly, Unrestricted}]
              [--opentelemetry-logs-port]
              [--opentelemetry-metrics-port]
              [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404}]
              [--outbound-type {block, loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--pod-cidrs]
              [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
              [--pod-subnet-id]
              [--ppg]
              [--private-dns-zone]
              [--revision]
              [--rotation-poll-interval]
              [--safeguards-excluded-ns]
              [--safeguards-level {Enforcement, Off, Warning}]
              [--safeguards-version]
              [--service-cidr]
              [--service-cidrs]
              [--service-principal]
              [--skip-subnet-role-assignment]
              [--sku {automatic, base}]
              [--snapshot-id]
              [--ssh-access {disabled, localuser}]
              [--ssh-key-value]
              [--storage-pool-name]
              [--storage-pool-option {NVMe, Temp}]
              [--storage-pool-size]
              [--storage-pool-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
              [--tags]
              [--tier {free, premium, standard}]
              [--vm-set-type]
              [--vm-sizes]
              [--vnet-subnet-id]
              [--windows-admin-password]
              [--windows-admin-username]
              [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
              [--workspace-resource-id]
              [--yes]
              [--zones]

示例

使用现有的 SSH 公钥创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --ssh-key-value /path/to/publickey

创建具有特定版本的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.13.9

创建具有较大节点池的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-count 7

创建启用了群集 autosclaler 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.13.9 --node-count 3 --enable-cluster-autoscaler --min-count 1 --max-count 5

使用 k8s 1.13.9 创建 kubernetes 群集，但使用 vmas。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.13.9 --vm-set-type AvailabilitySet

创建具有默认 kubernetes vesrion、默认 SKU 负载均衡器（标准）和默认 VM 集类型的 kubernetes 群集（VirtualMachineScaleSets）。

az aks create -g MyResourceGroup -n MyManagedCluster

使用标准 SKU 负载均衡器和两个 AKS 为负载均衡器出站连接使用情况创建 KUBERnetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2

使用标准 SKU 负载均衡器创建 Kubernetes 群集，并使用提供的公共 IP 进行负载均衡器出站连接使用情况。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ips <ip-resource-id-1,ip-resource-id-2>

使用标准 SKU 负载均衡器创建 Kubernetes 群集，并使用提供的公共 IP 前缀作为负载均衡器出站连接使用情况。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ip-prefixes <ip-prefix-resource-id-1,ip-prefix-resource-id-2>

创建具有标准 SKU 负载均衡器的 Kubernetes 群集，其中两个出站 AKS 托管 IP 的空闲流超时为 5 分钟和 8000 个分配的每台计算机端口

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2 --load-balancer-idle-timeout 5 --load-balancer-outbound-ports 8000

使用 AKS 托管 NAT 网关创建 Kubernetes 群集，其中两个出站 AKS 托管 IP 空闲流超时 4 分钟

az aks create -g MyResourceGroup -n MyManagedCluster --nat-gateway-managed-outbound-ip-count 2 --nat-gateway-idle-timeout 4

创建具有基本 SKU 负载均衡器和 AvailabilitySet vm 集类型的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku basic --vm-set-type AvailabilitySet

创建具有授权 apiserver IP 范围的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 193.168.1.0/24,194.168.1.0/24,195.168.1.0

使用自己的密钥创建具有服务器端加密的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-osdisk-diskencryptionset-id <disk-encryption-set-resource-id>

使用 userDefinedRouting、标准负载均衡器 SKU 和预配置路由表的自定义子网创建 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --outbound-type userDefinedRouting --load-balancer-sku standard --vnet-subnet-id customUserSubnetVnetID

创建支持启用了 AHUB 的 Windows 代理池的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-ahub

创建启用了托管 AAD 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

创建启用了临时 os 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

使用自定义标记创建 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --tags "foo=bar" "baz=qux"

创建启用了 EncryptionAtHost 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-encryption-at-host

创建启用了 UltraSSD 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-ultra-ssd

使用自定义控制平面标识和 kubelet 标识创建 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --assign-identity <control-plane-identity-resource-id> --assign-kubelet-identity <kubelet-identity-resource-id>

创建启用了 Azure RBAC 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad --enable-azure-rbac

创建具有特定 os-sku 的 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --os-sku Ubuntu

使用启用 Windows gmsa 并在群集使用的 vnet 中设置 DNS 服务器，创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-windows-gmsa

创建支持 Windows gmsa 但未在群集使用的 vnet 中设置 DNS 服务器的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password 'replacePassword1234$' --enable-windows-gmsa --gmsa-dns-server "10.240.0.4" --gmsa-root-domain-name "contoso.com"

使用 nodepool 快照 ID 创建 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

使用群集快照 ID 创建 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --cluster-snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/managedclustersnapshots/mysnapshot1"

使用容量预留组（CRG）ID 创建 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyMC --kubernetes-version 1.20.9 --node-vm-size VMSize --assign-identity CRG-RG-ID --enable-managed-identity --crg-id "subscriptions/SubID/resourceGroups/RGName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

创建支持主机组 ID 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyMC --kubernetes-version 1.20.13 --location westus2 --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize --enable-managed-identity --assign-identity <user_assigned_identity_resource_id>

创建未安装 CNI 的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --network-plugin none

创建一个 kubernetes 群集，其安全措施设置为“警告”

az aks create -g MyResourceGroup -n MyManagedCluster --safeguards-level Warning --enable-addons azure-policy

创建一个 kubernetes 群集，其安全措施设置为“警告”，并且排除了一些命名空间

az aks create -g MyResourceGroup -n MyManagedCluster --safeguards-level Warning --safeguards-excluded-ns ns1,ns2 --enable-addons azure-policy

创建启用了 Azure 服务网格的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-service-mesh

创建启用了 Azure Monitor 指标的 Kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azuremonitormetrics

创建启用了 Azure Monitor 应用监视的 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-monitor-app-monitoring

创建启用了 OpenTelemetry 指标集合的 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-metrics --enable-azuremonitormetrics

创建启用了 OpenTelemetry 日志收集的 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-logs --enable-addons monitoring

创建启用了 Azure Monitor 日志的 Kubernetes 群集（速记）

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-monitor-logs

在自定义端口上使用 OpenTelemetry 指标创建 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-metrics --opentelemetry-metrics-port 8888 --enable-azuremonitormetrics

在自定义端口上使用 OpenTelemetry 日志创建 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-logs --opentelemetry-logs-port 4317 --enable-azure-monitor-logs

创建具有 IP 分配模式设置为“StaticBlock”的节点池的 kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --os-sku Ubuntu --max-pods MaxPodsPerNode --network-plugin azure --vnet-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/NodeSubnet --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/PodSubnet --pod-ip-allocation-mode StaticBlock

使用 VirtualMachines nodepool 创建 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3

使用完全托管的系统节点池创建 Kubernetes 群集

az aks create -g MyResourceGroup -n MyManagedCluster --enable-managed-system-pool

使用标准发布通道中的网关 API CRD 的托管安装，创建启用了 Azure 服务网格加载项的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-azure-service-mesh --enable-gateway-api

创建启用了托管系统组件的自动群集。

az aks create -g MyResourceGroup -n MyManagedCluster --sku automatic --enable-hosted-system

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aad-admin-group-object-ids

将设置为群集管理员的 aad 组对象 ID 的逗号分隔列表。

--aad-tenant-id

Azure Active Directory 租户的 ID。

--aci-subnet-name

要在其中部署虚拟节点的现有 VNet 中的子网的名称。

--acns-advanced-networkpolicies

预览

用于在使用“--enable-acns”启用高级网络功能时，在群集上启用高级网络策略（None、FQDN 或 L7）。

属性	值
接受的值:	FQDN, L7, None

--acns-datapath-acceleration-mode

预览

用于在使用“--enable-acns”启用高级网络功能时在群集上设置加速模式（无或 BpfVeth）。

属性	值
接受的值:	BpfVeth, None

--acns-transit-encryption-type

预览

指定 ACNS 的传输加密类型。可用值为“None”和“WireGuard”。

属性	值
接受的值:	None, WireGuard

--admin-username -u

在节点 VM 上创建用于 SSH 访问的用户帐户。

属性	值
默认值:	azureuser

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--ampls-resource-id

预览

用于监视加载项的 Azure Monitor 专用链接范围的资源 ID。

--api-server-authorized-ip-ranges

已授权 API 服务器 IP 范围的逗号分隔列表。设置为 0.0.0.0/32，将 apiserver 流量限制到节点池。

--apiserver-subnet-id

预览

要向其分配控制平面 apiserver pod 的现有 VNet 中的子网 ID（需要 --enable-apiserver-vnet-integration）。

--app-routing-default-nginx-controller --ardnc

配置默认 nginx 入口控制器类型。有效值为 annotationControlled （默认行为）、外部、内部或无。

属性	值
接受的值:	AnnotationControlled, External, Internal, None

--appgw-id

要用于 AGIC 的现有应用程序网关的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-name

在节点资源组中创建/使用的应用程序网关的名称。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-cidr

子网 CIDR 用于创建用于部署应用程序网关的新子网。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-id

用于部署应用程序网关的现有子网的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-watch-namespace

指定 AGIC 应监视的命名空间。可以是单个字符串值，也可以是命名空间的逗号分隔列表。

属性	值
Parameter group:	Application Gateway Arguments

--assign-identity

指定用于管理群集资源组的现有用户分配标识。

--assign-kubelet-identity

为 kubelet 的使用指定现有用户分配的标识，该标识通常用于从 ACR 拉取映像。

--attach-acr

向名称或资源 ID 指定的 ACR 授予“acrpull”角色分配。

--auto-upgrade-channel

指定自动升级的升级通道。它可以快速、稳定、修补、节点映像或无，无表示禁用自动升级。

属性	值
接受的值:	node-image, none, patch, rapid, stable

--azure-keyvault-kms-key-id

Azure Key Vault 密钥的标识符。

--azure-keyvault-kms-key-vault-network-access

Azure 密钥库的网络访问。

允许的值为“Public”、“Private”。如果未设置，则默认键入“Public”。要求使用 --azure-keyvault-kms-key-id。

属性	值
默认值:	Public
接受的值:	Private, Public

--azure-keyvault-kms-key-vault-resource-id

Azure 密钥库的资源 ID。

--azure-monitor-workspace-resource-id

Azure Monitor 工作区的资源 ID。

--bootstrap-artifact-source

预览

启动群集时配置项目源。

项目包括加载项映像。使用“Direct”从 MCR 下载项目，将项目“缓存”下载到Azure 容器注册表。

属性	值
默认值:	Direct
接受的值:	Cache, Direct

--bootstrap-container-registry-resource-id

预览

配置容器注册表资源 ID。必须使用“缓存”作为启动项目源。

--ca-certs --custom-ca-trust-certificates

预览

包含最多 10 个空白行分隔证书的文件的路径。仅适用于 Linux 节点。

这些证书由自定义 CA 信任功能使用，并将添加到节点的信任存储中。

--ca-profile --cluster-autoscaler-profile

用于配置群集自动缩放程序的键=值对的空间分隔列表。传递空字符串以清除配置文件。

--client-secret

与服务主体关联的机密。如果 --service-principal 指定此参数，则需要此参数。

--cluster-service-load-balancer-health-probe-mode

预览

设置群集服务运行状况探测模式。

设置群集服务运行状况探测模式。默认值为“Servicenodeport”。

属性	值
接受的值:	Servicenodeport, Shared

--cluster-snapshot-id

预览

源群集快照 ID 用于创建新群集。

--container-storage-version

设置 Azure 容器存储版本，默认情况下将安装最新版本。

属性	值
接受的值:	1, 2

--crg-id

预览

用于将新群集与现有容量预留组资源关联的 crg-id。

--data-collection-settings

预览

包含监视加载项数据收集设置的 JSON 文件的路径。

--defender-config

包含 Microsoft Defender 配置文件配置的 JSON 文件的路径。

--disable-acns-observability

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络可观测性功能。

--disable-acns-security

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络安全功能。

--disable-disk-driver

禁用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--disable-file-driver

禁用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--disable-local-accounts

（预览版）如果设置为 true，则会为此群集禁用静态凭据。

属性	值
默认值:	False

--disable-opentelemetry-logs

预览

禁用 OpenTelemetry 日志收集。

属性	值
默认值:	False

--disable-opentelemetry-metrics

预览

禁用 OpenTelemetry 指标集合。

属性	值
默认值:	False

--disable-public-fqdn

禁用专用群集的公共 fqdn 功能。

属性	值
默认值:	False

--disable-rbac

禁用 Kubernetes 基于角色的访问控制。

--disable-run-command

禁用群集的“运行”命令功能。

属性	值
默认值:	False

--disable-snapshot-controller

禁用 CSI 快照控制器。

属性	值
默认值:	False

--disk-driver-version

指定 AzureDisk CSI 驱动程序版本。

属性	值
接受的值:	v1, v2

--dns-name-prefix -p

创建的主机名的前缀。如果未指定，请使用托管群集和资源组名称生成主机名。

--dns-service-ip

分配给 Kubernetes DNS 服务的 IP 地址。

此地址必须位于由“--service-cidr”指定的 Kubernetes 服务地址范围内。例如，10.0.0.10。

--dns-zone-resource-ids

预览

要与应用路由加载项一起使用的 DNS 区域资源的资源 ID 的逗号分隔列表。

--edge-zone

边缘区域的名称。

--enable-aad

为群集启用托管 AAD 功能。

属性	值
默认值:	False

--enable-acns

在群集上启用高级网络功能。启用此操作会产生额外的费用。对于非 cilium 群集，acns 安全性默认处于禁用状态，直到收到进一步通知。

--enable-addons -a

在逗号分隔列表中启用 Kubernetes 加载项。

这些加载项可用：

监视：启用 Log Analytics 监视。如果存在，请使用 Log Analytics 默认工作区，否则将创建一个工作区。指定“--workspace-resource-id”以使用现有工作区。如果启用了监视加载项 --no-wait 参数将不起作用
virtual-node：启用 AKS 虚拟节点。要求 --aci-subnet-name 提供现有子网的名称供虚拟节点使用。 aci-subnet-name 必须位于由 --vnet-subnet-id（必需）指定的同一 vnet 中。
azure-policy：启用 Azure policy。 AKS 的 Azure Policy 加载项以集中、一致的方式在群集上实现大规模强制措施和安全措施。启用部署安全措施时是必需的。有关详细信息，请查看 aka.ms/aks/policy。
ingress-appgw：启用应用程序网关入口控制器加载项（预览）。
confcom：启用 confcom 加载项，这将默认启用 SGX 设备插件（预览版）。
open-service-mesh：启用 Open Service Mesh 加载项（预览版）。
gitops：启用 GitOps（预览版）。
azure-keyvault-secrets-provider：启用 Azure Keyvault 机密提供程序加载项。
web_application_routing：启用应用路由加载项（预览版）。指定“--dns-zone-resource-id”以配置 DNS。

--enable-ahub

为 Windows VM 启用 Azure 混合用户权益（AHUB）。

属性	值
默认值:	False

--enable-ai-toolchain-operator

预览

向群集启用 AI 工具链操作员。

属性	值
默认值:	False

--enable-apiserver-vnet-integration

预览

启用用户 vnet 与控制平面 apiserver Pod 的集成。

属性	值
默认值:	False

--enable-app-routing

预览

启用应用程序路由加载项。

属性	值
默认值:	False

--enable-asm --enable-azure-service-mesh

启用 Azure 服务网格。

--enable-azure-container-storage

启用 Azure 容器存储。可用作标志（默认值为 True）或存储池类型值：（azureDisk、ephemeralDisk、elasticSan）。

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--enable-azure-monitor-app-monitoring

预览

启用 Azure Monitor 应用程序监视。

属性	值
默认值:	False

--enable-azure-monitor-logs

为群集启用 Azure Monitor 日志。

这相当于使用“--enable-addons 监视”。启用 Log Analytics 监视。如果存在，请使用 Log Analytics 默认工作区，否则将创建一个工作区。指定“--workspace-resource-id”以使用现有工作区。如果启用了监视加载项 --no-wait 参数将不起作用。

属性	值
默认值:	False

--enable-azure-monitor-metrics

启用 Azure Monitor 指标配置文件。

属性	值
默认值:	False

--enable-azure-rbac

启用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler

启用群集自动缩放程序，默认值为 false。

如果指定，请确保 kubernetes 版本大于 1.10.6。

属性	值
默认值:	False

--enable-cost-analysis

启用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。有关详细信息，请参阅 aka.ms/aks/docs/cost-analysis。

属性	值
默认值:	False

--enable-defender

启用 Microsoft Defender 安全配置文件。

属性	值
默认值:	False

--enable-encryption-at-host

在代理节点池上启用 EncryptionAtHost。

属性	值
默认值:	False

--enable-fips-image

在代理节点上使用启用了 FIPS 的 OS。

属性	值
默认值:	False

--enable-gateway-api

从标准发布通道启用网关 API CRD 的托管安装。要求至少启用一个托管网关 API 入口提供程序。

属性	值
默认值:	False

--enable-high-log-scale-mode

预览

为容器日志启用高日志缩放模式。

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

--enable-hosted-system

预览

使用完全托管的系统组件创建群集。这仅适用于创建新的自动群集。

属性	值
默认值:	False

--enable-image-cleaner

启用 ImageCleaner 服务。

属性	值
默认值:	False

--enable-image-integrity

启用 ImageIntegrity 服务。

属性	值
默认值:	False

--enable-imds-restriction

预览

在群集中启用 IMDS 限制。非 hostNetwork Pod 将无法访问 IMDS。

属性	值
默认值:	False

--enable-keda

预览

启用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--enable-managed-identity

使用托管标识管理群集资源组。可以显式指定“--service-principal”和“--client-secret”以禁用托管标识，否则将启用它。

--enable-msi-auth-for-monitoring

预览

使用群集的分配标识（而不是 Log Analytics 工作区的共享密钥）将监视数据发送到 Log Analytics。

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

--enable-node-public-ip

启用 VMSS 节点公共 IP。

属性	值
默认值:	False

--enable-oidc-issuer

启用 OIDC 颁发者。

属性	值
默认值:	False

--enable-opentelemetry-logs

预览

启用 OpenTelemetry 日志收集。要求启用 Azure Monitor 日志。

属性	值
默认值:	False

--enable-opentelemetry-metrics

预览

启用 OpenTelemetry 指标集合。要求启用 Azure Monitor 指标。

属性	值
默认值:	False

--enable-optimized-addon-scaling

预览

为群集启用优化的加载项缩放功能。

属性	值
默认值:	False

--enable-pod-identity

（预览）启用 Pod 标识加载项。

属性	值
默认值:	False

--enable-pod-identity-with-kubenet

（预览）使用 Kubnet 网络插件为群集启用 Pod 标识加载项。

属性	值
默认值:	False

--enable-private-cluster

启用专用群集。

属性	值
默认值:	False

--enable-retina-flow-logs

在群集上启用高级网络流日志收集功能。

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-secure-boot

预览

在群集中的所有节点池上启用安全启动。必须使用 VMSS 代理池类型。

属性	值
默认值:	False

--enable-sgxquotehelper

为 confcom 加载项启用 SGX 报价帮助程序。

属性	值
默认值:	False

--enable-static-egress-gateway

预览

启用群集的静态出口网关加载项。

属性	值
默认值:	False

--enable-syslog

预览

为监视加载项启用 syslog 数据收集。

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

--enable-ultra-ssd

在代理节点池上启用 UltraSSD。

属性	值
默认值:	False

--enable-upstream-kubescheduler-user-configuration

预览

为群集上游的 kube-scheduler 启用用户定义的计划程序配置。

属性	值
默认值:	False

--enable-vpa

预览

为群集启用垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--enable-vtpm

预览

在群集中的所有节点池上启用 vTPM。必须使用 VMSS 代理池类型。

属性	值
默认值:	False

--enable-windows-gmsa

启用 Windows gmsa。

属性	值
默认值:	False

--enable-windows-recording-rules

启用 Azure Monitor 指标加载项时启用 Windows 录制规则。

属性	值
默认值:	False

--enable-workload-identity

（预览）启用工作负荷标识加载项。

属性	值
默认值:	False

--ephemeral-disk-nvme-perf-tier

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	Basic, Premium, Standard

--ephemeral-disk-volume-type

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	EphemeralVolumeOnly, PersistentVolumeWithAnnotation

--fqdn-subdomain

为具有自定义专用 DNS 区域方案的专用群集创建的 FQDN 前缀。

--generate-ssh-keys

生成 SSH 公钥和私钥文件（如果缺少）。

属性	值
默认值:	False

--gmsa-dns-server

为此群集指定 Windows gmsa 的 DNS 服务器。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gmsa-root-domain-name

为此群集指定 Windows gmsa 的根域名。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gpu-instance-profile

用于分区多 gpu Nvidia GPU 的 GPU 实例配置文件。

属性	值
接受的值:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--grafana-resource-id

Azure 托管 Grafana 工作区的资源 ID。

--host-group-id

（预览）用于预配代理节点池的完全限定专用主机组 ID。

--http-proxy-config

此群集的 Http 代理配置。

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--image-cleaner-interval-hours

ImageCleaner 扫描间隔。

--ip-families

用于群集网络的 IP 版本的逗号分隔列表。

每个 IP 版本应采用 IPvN 格式。例如，IPv4。

--k8s-support-plan

从“KubernetesOfficial”或“AKSLongTermSupport”中进行选择，并使用“AKSLongTermSupport”获得 1 个额外的 CVE 修补程序。

属性	值
接受的值:	AKSLongTermSupport, KubernetesOfficial

--kms-infrastructure-encryption

预览

使用服务管理的密钥启用 Kubernetes 资源对象的静态加密。

为 Kubernetes 资源对象启用基础结构加密。此功能使用服务管理的密钥为群集机密和配置提供静态加密。有关详细信息，请参阅 https://aka.ms/aks/kubernetesResourceObjectEncryption。

属性	值
默认值:	Disabled
接受的值:	Disabled, Enabled

--ksm-metric-annotations-allow-list

--ksm-metric-labels-allow-list

--kube-proxy-config

此群集的 Kube-proxy 配置。

--kubelet-config

代理节点的 Kubelet 配置。

--kubernetes-version -k

用于创建群集的 Kubernetes 版本，例如“1.7.12”或“1.8.7”。

属性	值
值来源:	`az aks get-versions`

--linux-os-config

Linux 代理节点的 OS 配置。

--load-balancer-backend-pool-type

负载均衡器后端池类型。

负载均衡器后端池类型，支持的值为 nodeIP 和 nodeIPConfiguration。

--load-balancer-idle-timeout

负载均衡器空闲超时（以分钟为单位）。

负载均衡器出站流的所需空闲超时，默认值为 30 分钟。请在 [4， 100] 范围内指定一个值。

--load-balancer-managed-outbound-ip-count

负载均衡器托管的出站 IP 计数。

负载均衡器出站连接的托管出站 IP 的所需数量。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-managed-outbound-ipv6-count

负载均衡器管理的出站 IPv6 IP 计数。

负载均衡器出站连接的托管出站 IPv6 IP 的所需数量。仅适用于双堆栈（--ip 系列 IPv4，IPv6）。

--load-balancer-outbound-ip-prefixes

负载均衡器出站 IP 前缀资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 前缀资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ips

负载均衡器出站 IP 资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ports

负载均衡器出站分配端口。

负载均衡器后端池中每个 VM 所需的出站端口数。默认情况下，设置为 0，它使用基于 VM 数的默认分配。请在 [0， 64000] 范围内指定一个值为 8 的值。

--load-balancer-sku

Azure 负载均衡器群集的 SKU 选择。基本或标准。

在 AKS 群集的基本或标准AZURE 负载均衡器 SKU 之间进行选择。

属性	值
接受的值:	basic, standard

--location -l

Location. az account list-locations 中的值。可以使用 az configure --defaults location=<location> 配置默认位置。

--max-count

指定了“--enable-cluster-autoscaler”时用于自动缩放程序的最大节点计数。请在 [1， 1000] 范围内指定值。

--max-pods -m

可部署到节点的最大 Pod 数。

如果未指定，则基于网络插件的默认值。 30（对于“azure”），对于“kubenet”为 110，对于“none”，则为 250。

属性	值
默认值:	0

--message-of-the-day

包含当天所需消息的文件的路径。仅适用于 Linux 节点。将写入 /etc/motd。

--min-count

指定“--enable-cluster-autoscaler”时用于自动缩放程序的微型节点计数。请在 [1， 1000] 范围内指定值。

--nat-gateway-idle-timeout

NAT 网关空闲超时（以分钟为单位）。

NAT 网关出站流的所需空闲超时，默认值为 4 分钟。请在 [4， 120] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--nat-gateway-managed-outbound-ip-count

NAT 网关托管出站 IP 计数。

NAT 网关出站连接的托管出站 IP 数。请在 [1， 16] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--network-dataplane

要使用的网络数据平面。

Kubernetes 群集中使用的网络数据平面。指定“azure”以使用 Azure 数据平面（默认）或“cilium”来启用 Cilium 数据平面。

属性	值
接受的值:	azure, cilium

--network-plugin

要使用的 Kubernetes 网络插件。

为 VNET 中的可路由 Pod IP 指定“azure”，为具有覆盖网络的不可路由 Pod IP 指定“kubenet”，如果未配置任何网络，则为“none”。

属性	值
接受的值:	azure, kubenet, none

--network-plugin-mode

要使用的网络插件模式。

用于控制网络插件应在其中运行的模式。例如，与 --network-plugin=azure 一起使用的“覆盖”将为群集中的 Pod 使用覆盖网络（非 VNET IP）。

属性	值
接受的值:	overlay

--network-policy

（预览）要使用的 Kubernetes 网络策略。

与“azure”网络插件一起使用。为 Azure 网络策略管理器指定“azure”，为 calico 网络策略控制器指定“calico”，为由 Cilium 提供支持的 Azure CNI 覆盖层指定“cilium”。默认为“”（网络策略已禁用）。

--no-ssh-key -x

不要使用或创建本地 SSH 密钥。

若要使用此选项创建群集后访问节点，请使用 Azure 门户。

属性	值
默认值:	False

--no-wait

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

属性	值
默认值:	False

--node-count -c

Kubernetes 节点池中的节点数。指定 --enable-cluster-autoscaler 时需要它。创建群集后，可以使用它更改其节点池 az aks scale的大小。

属性	值
默认值:	3

--node-init-taints --nodepool-initialization-taints

预览

使用 aks 创建操作创建的节点池的节点初始化污点。

--node-os-upgrade-channel

更新节点上 OS 的方式。可以是 NodeImage、None、SecurityPatch 或非托管。

属性	值
接受的值:	NodeImage, None, SecurityPatch, Unmanaged

--node-osdisk-diskencryptionset-id -d

用于在代理节点 os 磁盘上启用静态加密的磁盘加密集的 ResourceId。

--node-osdisk-size

节点池中每个节点的 OS 磁盘 GiB 大小。最小 30 GiB。

属性	值
默认值:	0

--node-osdisk-type

要用于给定代理池中的计算机的 OS 磁盘类型。如果可能与 VM 大小和 OS 磁盘大小结合使用，则默认为“临时”。创建后可能不会更改此池。（“临时”或“Managed”）。

属性	值
接受的值:	Ephemeral, Managed

--node-provisioning-default-pools

预览

为节点预置配置的默认 Karpenter NodePools 集。有效值为“Auto”和“None”。

属性	值
接受的值:	Auto, None

--node-provisioning-mode

预览

设置群集的节点预配模式。有效值为“Auto”和“Manual”。有关“自动”模式的详细信息，请参阅 aka.ms/aks/nap。

属性	值
接受的值:	Auto, Manual

--node-public-ip-prefix-id

用于将公共 IP 分配给 VMSS 节点的公共 IP 前缀 ID。

--node-public-ip-tags

节点公共 IP 的 ipTag。

--node-resource-group

节点资源组是将在其中创建所有客户资源的资源组，例如虚拟机。

--node-vm-size -s

要创建为 Kubernetes 节点的虚拟机的大小。如果用户未指定一个，服务器将为她/他选择默认的 VM 大小。

--nodepool-allowed-host-ports

预览

公开节点池上的主机端口。指定后，格式应为带协议的范围的逗号分隔列表，例如。80/TCP，443/TCP，4000-5000/TCP。

--nodepool-asg-ids

预览

节点池网络接口应属于的应用程序安全组的 ID。指定后，格式应为逗号分隔的 ID 列表。

--nodepool-labels

此群集中所有节点池的节点标签。请参阅 https://aka.ms/node-labels 标签语法。

--nodepool-name

节点池名称，最多包含 12 个字母数字字符。

属性	值
默认值:	nodepool1

--nodepool-tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--nodepool-taints

此群集中所有节点池的节点排斥。

--nrg-lockdown-restriction-level

托管节点资源组的限制级别。

群集的托管节点资源组上允许的权限限制级别、支持的值是“不受限制”和“ReadOnly”（建议的 ReadOnly）。

属性	值
接受的值:	ReadOnly, Unrestricted

--opentelemetry-logs-port

预览

OpenTelemetry 日志收集的端口（如果未指定，将使用默认端口）。

--opentelemetry-metrics-port

预览

OpenTelemetry 指标集合的端口（如果未指定，将使用默认端口）。

--os-sku

代理节点池的 os-sku。 Ubuntu、Ubuntu2204、Ubuntu2404、CBLMariner、AzureLinux、AzureLinux、AzureLinux3、AzureLinuxOSGuard、AzureLinux3OSGuard 或 Flatcar（如果未设置）默认为 Ubuntu;当 os 类型为 Windows 时，Windows2019、Windows2022、Windows2025 或 WindowsAnnual，当前默认值为 Windows2022（如果未设置）。

属性	值
接受的值:	AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404

--outbound-type

如何为群集配置出站流量。

在 loadBalancer、userDefinedRouting、managedNATGateway、userAssignedNATGateway、none 和 block 之间进行选择。如果未设置，则默认为 type loadBalancer。要求使用预配置的路由表和 --load-balancer-sku 作为标准提供 --vnet-subnet-id。

属性	值
接受的值:	block, loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting

--pod-cidr

使用 Azure CNI 覆盖或 Kubenet 时分配 Pod IP 的 CIDR 表示法 IP 范围（2028 年 3 月 31 日，Kubenet 将停用）。

此范围不得与任何子网 IP 范围重叠。例如，172.244.0.0/16。请参阅 https://aka.ms/aks/azure-cni-overlay。

--pod-cidrs

使用 Azure CNI 覆盖或 Kubenet 时，CIDR 表示法 IP 范围的逗号分隔列表（2028 年 3 月 31 日，Kubenet 将停用）。

每个范围不得与任何子网 IP 范围重叠。例如，172.244.0.0/16。请参阅 https://aka.ms/aks/azure-cni-overlay。

--pod-ip-allocation-mode

与“azure”网络插件一起使用。需要 --pod-subnet-id。

属性	值
接受的值:	DynamicIndividual, StaticBlock

--pod-subnet-id

要将群集中的 Pod 分配到的现有 VNet 中的子网 ID（需要 azure 网络插件）。

--ppg

PPG 的 ID。

--private-dns-zone

专用群集的专用 DNS 区域模式。 “none”模式处于预览状态。

允许的值为“system”、“none”（预览版）或自定义专用 DNS 区域资源 ID。如果未设置，则默认为类型系统。要求使用 --enable-private-cluster。

--revision

要安装的 Azure 服务网格修订版。

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--safeguards-excluded-ns

预览

要从部署安全措施中排除的 Kubernetes 命名空间的逗号分隔列表。

--safeguards-level

预览

部署保护级别。接受的值是 [Off， Warning， Enforcement]。要求启用 Azure Policy 加载项。

属性	值
接受的值:	Enforcement, Off, Warning

--safeguards-version

预览

要使用的部署保障版本。默认的“v1.0.0”使用 ListSafeguardsVersions API 发现可用版本。

--service-cidr

从中分配服务群集 IP 的 CIDR 表示法 IP 范围。

此范围不得与任何子网 IP 范围重叠。例如 10.0.0.0/16。

--service-cidrs

从中分配服务群集 IP 的 CIDR 表示法 IP 范围的逗号分隔列表。

每个范围不得与任何子网 IP 范围重叠。例如 10.0.0.0/16。

--service-principal

用于对 Azure API 进行身份验证的服务主体。

如果未指定，则会在 $HOME.azure\aksServicePrincipal.json 创建并缓存新的服务主体，供后续 az aks 命令使用。

--skip-subnet-role-assignment

跳过子网的角色分配（高级网络）。

如果指定，请确保服务主体有权访问子网。

属性	值
默认值:	False

--sku

指定托管群集的 SKU 名称。 “--sku base”启用基本托管群集。 “--sku 自动”启用自动托管群集。

属性	值
接受的值:	automatic, base

--snapshot-id

用于创建此群集的源节点池快照 ID。

--ssh-access

预览

为此群集中的第一个系统池配置 SSH 设置。使用“disabled”禁用 SSH 访问，使用“localuser”通过私钥启用 SSH 访问。请注意，此配置不会对以后创建新节点池生效，请使用选项 az aks nodepool add --ssh-access 为新节点池配置 SSH 访问。

属性	值
默认值:	localuser
接受的值:	disabled, localuser

--ssh-key-value

在节点 VM 上安装的、用于 SSH 访问的公钥路径或密钥内容。例如，“ssh-rsa AAAAB...剪断。。。UcyupgH azureuser@linuxvm'。

属性	值
默认值:	~\.ssh\id_rsa.pub

--storage-pool-name

为 Azure 容器存储设置存储池名称。

--storage-pool-option

为 Azure 容器存储设置临时磁盘存储池选项。

属性	值
接受的值:	NVMe, Temp

--storage-pool-size

为 Azure 容器存储设置存储池大小。

--storage-pool-sku

为 Azure 容器存储设置 Azure 磁盘类型存储池 SKU。

属性	值
接受的值:	PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

托管群集的标记。将标记由云提供商管理的托管群集实例和所有资源。

--tier

指定托管群集的 SKU 层。 “层标准”支持具有财务支持的 SLA 的标准托管群集服务。 “层免费”没有经济支持的 SLA。

属性	值
接受的值:	free, premium, standard

--vm-set-type

代理池 vm 集类型。 VirtualMachineScaleSets、AvailabilitySet 或 VirtualMachines（预览版）。

--vm-sizes

预览

以逗号分隔的大小列表。必须使用 VirtualMachines 代理池类型。

--vnet-subnet-id

要在其中部署群集的现有 VNet 中子网的 ID。

--windows-admin-password

用于 Windows 节点 VM 的用户帐户密码。

windows-admin-password 规则： - 最小长度： 14 个字符 - 最大长度： 123 个字符 - 复杂性要求：以下 4 个条件中的 3 个需要满足 * 具有较低字符 * 具有大写字符 * 具有数字 * 具有特殊字符（Regex match [\W_]） - 不允许的值：“abc@123”， “P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password！”、“Password1”、“Password22”、“iloveyou！”参考： https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.management.compute.models.virtualmachinescalesetosprofile.adminpassword?view=azure-dotnet.

--windows-admin-username

在 Windows 节点 VM 上创建的用户帐户。

windows-admin-username 规则： - 限制：不能以“.”结尾 - 不允许的值：“administrator”、“admin”、“user1”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0 sys”、“test2”、“test3”、“user4”、“user5”。 - 最小长度：1 个字符 - 最大长度：20 个字符引用： https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.management.compute.models.virtualmachinescalesetosprofile.adminusername?view=azure-dotnet。

--workload-runtime

确定节点可以运行的工作负荷的类型。默认为 OCIContainer。

属性	值
默认值:	OCIContainer
接受的值:	KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi

--workspace-resource-id

要用于存储监视数据的现有 Log Analytics 工作区的资源 ID。如果未指定，则使用默认的 Log Analytics 工作区（如果存在）否则创建一个。

--yes -y

不要提示确认。

属性	值
默认值:	False

--zones -z

将放置代理节点的可用性区域的空间分隔列表。

全局参数

--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 aks delete

编辑

删除托管的 Kubernetes 群集。

az aks delete --name
              --resource-group
              [--if-match]
              [--no-wait]
              [--yes]

示例

删除托管的 Kubernetes 群集。 (autogenerated)

az aks delete --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--if-match

仅当实体与此字符串匹配时，请求才应继续。默认值为无。

--no-wait

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

属性	值
默认值:	False

--yes -y

不要提示确认。

属性	值
默认值:	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 aks delete (aks-preview 扩展)

删除托管的 Kubernetes 群集。

az aks delete --name
              --resource-group
              [--if-match]
              [--ignore-pod-disruption-budget]
              [--no-wait]
              [--yes]

示例

删除托管的 Kubernetes 群集。 (autogenerated)

az aks delete --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--if-match

仅当实体与此字符串匹配时，请求才应继续。默认值为无。

--ignore-pod-disruption-budget

Ignore-pod-disruption-budget=true，在不考虑 Pod 中断预算的情况下删除节点上的这些 Pod。默认值为无。

--no-wait

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

属性	值
默认值:	False

--yes -y

不要提示确认。

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

编辑

禁用 Kubernetes 加载项。

az aks disable-addons --addons
                      --name
                      --resource-group
                      [--no-wait]

示例

禁用 Kubernetes 加载项。 (autogenerated)

az aks disable-addons --addons virtual-node --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--addons -a

在逗号分隔的列表中禁用 Kubernetes 加载项。

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks disable-addons (aks-preview 扩展)

禁用 Kubernetes 加载项。

az aks disable-addons --addons
                      --name
                      --resource-group
                      [--no-wait]

示例

禁用 Kubernetes 加载项。 (autogenerated)

az aks disable-addons --addons virtual-node --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--addons -a

在逗号分隔的列表中禁用 Kubernetes 加载项。

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks enable-addons

编辑

启用 Kubernetes 加载项。

这些加载项可用：

http_application_routing：使用自动公共 DNS 名称创建配置入口。
监视：启用 Log Analytics 监视。需要“--workspace-resource-id”。需要托管标识身份验证的“--enable-msi-auth-for-monitoring”。需要“--enable-syslog”才能从节点启用 syslog 数据收集。请注意，必须启用 MSI。需要专用链接的“--ampls-resource-id”。请注意，必须启用 MSI。需要“--enable-high-log-scale-mode”才能为容器日志启用高日志缩放模式。请注意，必须启用 MSI。如果启用了监视加载项 --no-wait 参数将不起作用
virtual-node：启用 AKS 虚拟节点。要求 --subnet-name 提供现有子网的名称供虚拟节点使用。
azure-policy：启用 Azure policy。 AKS 的 Azure Policy 加载项以集中、一致的方式在群集上实现大规模强制措施和安全措施。有关详细信息，请查看 aka.ms/aks/policy。
ingress-appgw：启用应用程序网关入口控制器加载项。
open-service-mesh：启用 Open Service Mesh 加载项。
azure-keyvault-secrets-provider：启用 Azure Keyvault 机密提供程序加载项。

az aks enable-addons --addons
                     --name
                     --resource-group
                     [--ampls-resource-id]
                     [--appgw-id]
                     [--appgw-name]
                     [--appgw-subnet-cidr]
                     [--appgw-subnet-id]
                     [--appgw-watch-namespace]
                     [--data-collection-settings]
                     [--enable-high-log-scale-mode {false, true}]
                     [--enable-msi-auth-for-monitoring {false, true}]
                     [--enable-secret-rotation]
                     [--enable-sgxquotehelper]
                     [--enable-syslog {false, true}]
                     [--no-wait]
                     [--rotation-poll-interval]
                     [--subnet-name]
                     [--workspace-resource-id]

示例

启用 Kubernetes 加载项。 (autogenerated)

az aks enable-addons --addons virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet MySubnetName

启用具有子网前缀的 ingress-appgw 加载项。

az aks enable-addons --name MyManagedCluster --resource-group MyResourceGroup --addons ingress-appgw --appgw-subnet-cidr 10.225.0.0/16 --appgw-name gateway

启用 open-service-mesh 加载项。

az aks enable-addons --name MyManagedCluster --resource-group MyResourceGroup --addons open-service-mesh

必需参数

--addons -a

在逗号分隔列表中启用 Kubernetes 加载项。

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--ampls-resource-id

用于监视加载项的 Azure Monitor 专用链接范围的资源 ID。

--appgw-id

要用于 AGIC 的现有应用程序网关的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-name

在节点资源组中创建/使用的应用程序网关的名称。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-cidr

子网 CIDR 用于创建用于部署应用程序网关的新子网。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-id

用于部署应用程序网关的现有子网的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-watch-namespace

指定 AGIC 应监视的命名空间。可以是单个字符串值，也可以是命名空间的逗号分隔列表。

属性	值
Parameter group:	Application Gateway Arguments

--data-collection-settings

包含监视加载项数据收集设置的 JSON 文件的路径。

--enable-high-log-scale-mode

为容器日志启用高日志缩放模式。

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

--enable-msi-auth-for-monitoring

为监视加载项启用托管标识身份验证。

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

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-sgxquotehelper

为 confcom 加载项启用 SGX 报价帮助程序。

属性	值
默认值:	False

--enable-syslog

为监视加载项启用 syslog 数据收集。

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

--no-wait

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

属性	值
默认值:	False

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--subnet-name -s

要与虚拟节点加载项一起使用的现有子网的名称。

--workspace-resource-id

要用于存储监视数据的现有 Log Analytics 工作区的资源 ID。

全局参数

--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 aks enable-addons (aks-preview 扩展)

启用 Kubernetes 加载项。

这些加载项可用：http_application_routing - 使用自动公共 DNS 名称创建配置入口。监视 - 启用 Log Analytics 监视。如果存在，请使用 Log Analytics 默认工作区，否则将创建一个工作区。指定“--workspace-resource-id”以使用现有工作区。如果启用了监视加载项 --no-wait 参数将不起作用虚拟节点 - 启用 AKS 虚拟节点。要求 --subnet-name 提供现有子网的名称供虚拟节点使用。 azure-policy - 启用 Azure Policy。 AKS 的 Azure Policy 加载项以集中、一致的方式在群集上实现大规模强制措施和安全措施。有关详细信息，请查看 aka.ms/aks/policy。 ingress-appgw - 启用应用程序网关入口控制器加载项（预览版）。 open-service-mesh - 启用 Open Service Mesh 加载项（预览版）。 gitops - 启用 GitOps（预览版）。 azure-keyvault-secrets-provider - 启用 Azure Keyvault 机密提供程序加载项。 web_application_routing - 启用应用路由加载项（预览版）。指定“--dns-zone-resource-id”以配置 DNS。

az aks enable-addons --addons
                     --name
                     --resource-group
                     [--aks-custom-headers]
                     [--ampls-resource-id]
                     [--appgw-id]
                     [--appgw-name]
                     [--appgw-subnet-cidr]
                     [--appgw-subnet-id]
                     [--appgw-watch-namespace]
                     [--data-collection-settings]
                     [--dns-zone-resource-ids]
                     [--enable-high-log-scale-mode {false, true}]
                     [--enable-msi-auth-for-monitoring {false, true}]
                     [--enable-secret-rotation]
                     [--enable-sgxquotehelper]
                     [--enable-syslog {false, true}]
                     [--no-wait]
                     [--rotation-poll-interval]
                     [--subnet-name]
                     [--workspace-resource-id]

示例

启用 Kubernetes 加载项。 (autogenerated)

az aks enable-addons --addons virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

启用具有子网前缀的 ingress-appgw 加载项。

az aks enable-addons --name MyManagedCluster --resource-group MyResourceGroup --addons ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

启用 open-service-mesh 加载项。

az aks enable-addons --name MyManagedCluster --resource-group MyResourceGroup --addons open-service-mesh

必需参数

--addons -a

在逗号分隔列表中启用 Kubernetes 加载项。

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--ampls-resource-id

预览

用于监视加载项的 Azure Monitor 专用链接范围的资源 ID。

--appgw-id

要用于 AGIC 的现有应用程序网关的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-name

在节点资源组中创建/使用的应用程序网关的名称。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-cidr

子网 CIDR 用于创建用于部署应用程序网关的新子网。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-subnet-id

用于部署应用程序网关的现有子网的资源 ID。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--appgw-watch-namespace

指定 AGIC 应监视的命名空间。可以是单个字符串值，也可以是命名空间的逗号分隔列表。与 ingress-azure 加载项一起使用。

属性	值
Parameter group:	Application Gateway Arguments

--data-collection-settings

预览

包含监视加载项数据收集设置的 JSON 文件的路径。

--dns-zone-resource-ids

预览

要与应用路由加载项一起使用的 DNS 区域资源的资源 ID 的逗号分隔列表。

--enable-high-log-scale-mode

预览

为容器日志启用高日志缩放模式。

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

--enable-msi-auth-for-monitoring

预览

使用群集的分配标识（而不是 Log Analytics 工作区的共享密钥）将监视数据发送到 Log Analytics。

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

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-sgxquotehelper

为 confcom 加载项启用 SGX 报价帮助程序。

属性	值
默认值:	False

--enable-syslog

预览

为监视加载项启用 syslog 数据收集。

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

--no-wait

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

属性	值
默认值:	False

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--subnet-name -s

要使用的虚拟节点的子网名称。

--workspace-resource-id

要用于存储监视数据的现有 Log Analytics 工作区的资源 ID。

全局参数

--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 aks get-credentials

编辑

获取托管 Kubernetes 群集的访问凭据。

默认情况下，凭据合并到 .kube/config 文件中，以便 kubectl 可以使用它们。有关详细信息，请参阅 -f 参数。

az aks get-credentials --name
                       --resource-group
                       [--admin]
                       [--context]
                       [--file]
                       [--format]
                       [--overwrite-existing]
                       [--public-fqdn]

示例

获取托管 Kubernetes 群集的访问凭据。 (autogenerated)

az aks get-credentials --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--admin -a

获取群集管理员凭据。默认值：群集用户凭据。

在具有 Azure Active Directory 集成的群集上，这会绕过正常的 Azure AD 身份验证，如果永久阻止你无权访问有权访问群集的有效 Azure AD 组，则可以使用它。需要“Azure Kubernetes 服务群集管理员”角色。

属性	值
默认值:	False

--context

如果指定，请覆盖默认上下文名称。参数 --admin 优先于 --context.

--file -f

要更新的 Kubernetes 配置文件。改用“-”将 YAML 打印为 stdout。

属性	值
默认值:	~\.kube\config

--format

指定返回的凭据的格式。可用值为 [“exec”， “azure”]。仅当请求 AAD 群集的 clusterUser 凭据时生效。

--overwrite-existing

覆盖具有相同名称的任何现有群集条目。

属性	值
默认值:	False

--public-fqdn

获取具有服务器地址为公共 fqdn 的专用群集凭据。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

凭据始终采用 YAML 格式，因此实际上忽略此参数。

属性	值
默认值:	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 aks get-credentials (aks-preview 扩展)

获取托管 Kubernetes 群集的访问凭据。

az aks get-credentials --name
                       --resource-group
                       [--admin]
                       [--aks-custom-headers]
                       [--context]
                       [--file]
                       [--format {azure, exec}]
                       [--overwrite-existing]
                       [--public-fqdn]
                       [--user]

示例

获取托管 Kubernetes 群集的访问凭据。 (autogenerated)

az aks get-credentials --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--admin -a

获取群集管理员凭据。默认值：群集用户凭据。

属性	值
默认值:	False

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--context

如果指定，请覆盖默认上下文名称。

--file -f

要更新的 Kubernetes 配置文件。改用“-”将 YAML 打印为 stdout。

属性	值
默认值:	~\.kube\config

--format

指定返回的凭据的格式。可用值为 [“exec”， “azure”]。仅当请求 AAD 群集的 clusterUser 凭据时生效。

属性	值
接受的值:	azure, exec

--overwrite-existing

覆盖具有相同名称的任何现有群集条目。

属性	值
默认值:	False

--public-fqdn

获取具有服务器地址为公共 fqdn 的专用群集凭据。

属性	值
默认值:	False

--user -u

获取用户的凭据。仅在 --admin 为 False 时有效。默认值：群集用户凭据。

属性	值
默认值:	clusterUser

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

凭据始终采用 YAML 格式，因此实际上忽略此参数。

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

编辑

获取可用于托管 Kubernetes 群集的升级版本。

az aks get-upgrades --name
                    --resource-group

示例

获取托管 Kubernetes 群集可用的升级版本

az aks get-upgrades --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks get-upgrades (aks-preview 扩展)

获取可用于托管 Kubernetes 群集的升级版本。

az aks get-upgrades --name
                    --resource-group

示例

获取托管 Kubernetes 群集可用的升级版本

az aks get-upgrades --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks get-versions

编辑

获取可用于创建托管 Kubernetes 群集的版本。

az aks get-versions --location

示例

获取可用于创建托管 Kubernetes 群集的版本

az aks get-versions --location westus2

必需参数

--location -l

Location. az account list-locations 中的值。可以使用 az configure --defaults location=<location> 配置默认位置。

全局参数

--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 aks get-versions (aks-preview 扩展)

获取可用于创建托管 Kubernetes 群集的版本。

az aks get-versions --location

示例

获取可用于创建托管 Kubernetes 群集的版本

az aks get-versions --location westus2

必需参数

--location -l

Location. az account list-locations 中的值。可以使用 az configure --defaults location=<location> 配置默认位置。

全局参数

--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 aks install-cli

编辑

下载并安装 Kubernetes 命令行工具 kubectl。下载并安装 kubelogin，这是实现 Azure 身份验证的客户端 go 凭据（exec）插件。

az aks install-cli [--base-src-url]
                   [--client-version]
                   [--install-location]
                   [--kubelogin-base-src-url]
                   [--kubelogin-install-location]
                   [--kubelogin-version]

可选参数

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

--base-src-url

kubectl 版本的基本下载源 URL。

--client-version

要安装的 kubectl 版本。

属性	值
默认值:	latest

--install-location

安装 kubectl 的路径。注意：路径应包含二进制文件名。

属性	值
默认值:	~\.azure-kubectl\kubectl.exe

--kubelogin-base-src-url -l

kubelogin 版本的基本下载源 URL。

--kubelogin-install-location

安装 kubelogin 的路径。注意：路径应包含二进制文件名。

属性	值
默认值:	~\.azure-kubelogin\kubelogin.exe

--kubelogin-version

要安装的 kubelogin 版本。

属性	值
默认值:	latest

全局参数

--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 aks kanalyze

完成 kollect 后显示 Kubernetes 群集的诊断结果。

az aks kanalyze --name
                --resource-group

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks kollect

收集 Kubernetes 群集的诊断信息。

收集 Kubernetes 群集的诊断信息，并将其存储在指定的存储帐户中。可以通过三种方式提供存储帐户：存储帐户名称和具有写入权限的共享访问签名。资源 ID 到你拥有的存储帐户。托管群集的诊断设置中的存储帐户。

az aks kollect --name
               --resource-group
               [--container-logs]
               [--kube-objects]
               [--node-logs]
               [--node-logs-windows]
               [--sas-token]
               [--storage-account]

示例

使用存储帐户名称和具有写入权限的共享访问签名令牌

az aks kollect -g MyResourceGroup -n MyManagedCluster --storage-account MyStorageAccount --sas-token "MySasToken"

使用你拥有的存储帐户资源的资源 ID。

az aks kollect -g MyResourceGroup -n MyManagedCluster --storage-account "MyStoreageAccountResourceId"

在托管群集的诊断设置中使用存储帐户。

az aks kollect -g MyResourceGroup -n MyManagedCluster

自定义要收集的容器日志。

az aks kollect -g MyResourceGroup -n MyManagedCluster --container-logs "mynamespace1/mypod1 myns2"

自定义要收集的 kubernetes 对象。

az aks kollect -g MyResourceGroup -n MyManagedCluster --kube-objects "mynamespace1/service myns2/deployment/deployment1"

自定义要收集的节点日志文件。

az aks kollect -g MyResourceGroup -n MyManagedCluster --node-logs "/var/log/azure-vnet.log /var/log/azure-vnet-ipam.log"

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--container-logs

要收集的容器日志的列表。

要收集的容器日志的列表。其值可以是命名空间中的所有容器，例如 kube-system 或命名空间中的特定容器，例如 kube-system/tunnelfront。

--kube-objects

要描述的 kubernetes 对象列表。

要描述的 kubernetes 对象列表。其值可以是命名空间中某个类型的所有对象，例如 kube-system/pod，也可以是命名空间中类型的特定对象，例如 kube-system/deployment/tunnelfront。

--node-logs

要为 Linux 节点收集的节点日志列表。例如，/var/log/cloud-init.log。

--node-logs-windows

要为 Windows 节点收集的节点日志列表。例如，C：\AzureData\CustomDataSetupScript.log。

--sas-token

具有存储帐户可写权限的 SAS 令牌。

--storage-account

用于保存诊断信息的存储帐户的名称或 ID。

全局参数

--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 aks list

编辑

列出托管 Kubernetes 群集。

az aks list [--resource-group]

可选参数

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

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks list (aks-preview 扩展)

列出托管 Kubernetes 群集。

az aks list [--resource-group]

可选参数

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

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks operation-abort

编辑

中止托管群集上的上次运行操作。

az aks operation-abort --name
                       --resource-group
                       [--no-wait]

示例

托管群集上的中止操作

az aks operation-abort -g myResourceGroup -n myAKSCluster

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks operation-abort (aks-preview 扩展)

中止托管群集上的上次运行操作。

az aks operation-abort --name
                       --resource-group
                       [--aks-custom-headers]
                       [--no-wait]

示例

托管群集上的中止操作

az aks operation-abort -g myResourceGroup -n myAKSCluster

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--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 aks remove-dev-spaces

编辑

已放弃

此命令已弃用，将在将来的版本中删除。

从托管 Kubernetes 群集中删除 Azure Dev Spaces。

az aks remove-dev-spaces --name
                         --resource-group
                         [--yes]

示例

从托管 Kubernetes 群集中删除 Azure Dev Spaces。

az aks remove-dev-spaces -g my-aks-group -n my-aks

在不提示的情况下从托管 Kubernetes 群集中删除 Azure Dev Spaces。

az aks remove-dev-spaces -g my-aks-group -n my-aks --yes

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--yes -y

不要提示确认。

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

编辑

轮换托管 Kubernetes 群集上的证书和密钥。

在群集证书轮换期间，Kubernetes 将不可用。

az aks rotate-certs --name
                    --resource-group
                    [--no-wait]
                    [--yes]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--no-wait

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

属性	值
默认值:	False

--yes -y

不要提示确认。

属性	值
默认值:	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 aks rotate-certs (aks-preview 扩展)

轮换托管 Kubernetes 群集上的证书和密钥。

在群集证书轮换期间，Kubernetes 将不可用。

az aks rotate-certs --name
                    --resource-group
                    [--no-wait]
                    [--yes]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--no-wait

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

属性	值
默认值:	False

--yes -y

不要提示确认。

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

编辑

缩放托管 Kubernetes 群集中的节点池。

az aks scale --name
             --node-count
             --resource-group
             [--no-wait]
             [--nodepool-name]

示例

缩放托管 Kubernetes 群集中的节点池。 (autogenerated)

az aks scale --name MyManagedCluster --node-count 3 --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--node-count -c

Kubernetes 节点池中的节点数。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--no-wait

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

属性	值
默认值:	False

--nodepool-name

节点池名称，最多 12 个字母数字字符。

全局参数

--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 aks scale (aks-preview 扩展)

缩放托管 Kubernetes 群集中的节点池。

az aks scale --name
             --node-count
             --resource-group
             [--aks-custom-headers]
             [--no-wait]
             [--nodepool-name]

必需参数

--name -n

托管群集的名称。

--node-count -c

Kubernetes 节点池中的节点数。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--no-wait

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

属性	值
默认值:	False

--nodepool-name

节点池名称，最多包含 12 个字母数字字符。

全局参数

--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 aks show

编辑

显示托管 Kubernetes 群集的详细信息。

az aks show --name
            --resource-group

示例

显示托管 Kubernetes 群集的详细信息

az aks show --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 aks show (aks-preview 扩展)

显示托管 Kubernetes 群集的详细信息。

az aks show --name
            --resource-group
            [--aks-custom-headers]

示例

显示托管 Kubernetes 群集的详细信息

az aks show -g MyResourceGroup -n MyManagedCluster

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

全局参数

--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 aks start

编辑

启动以前停止的托管群集。

有关启动群集的更多详细信息，请参阅 starting a cluster <https://docs.microsoft.com/azure/aks/start-stop-cluster>_。

az aks start --name
             --resource-group
             [--no-wait]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks start (aks-preview 扩展)

启动以前停止的托管群集。

有关启动群集的更多详细信息，请参阅 starting a cluster <https://docs.microsoft.com/azure/aks/start-stop-cluster>_。

az aks start --name
             --resource-group
             [--no-wait]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks stop

编辑

停止托管群集。

这只能在 Azure 虚拟机规模集支持的群集上执行。停止群集会完全停止控制平面和代理节点，同时保持所有对象和群集状态。群集在停止时不会产生费用。有关停止群集的更多详细信息，请参阅 stopping a cluster <https://free.blessedness.top/azure/aks/start-stop-cluster>_。

az aks stop --name
            --resource-group
            [--no-wait]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks stop (aks-preview 扩展)

停止托管群集。

这只能在 Azure 虚拟机规模集支持的群集上执行。停止群集会完全停止控制平面和代理节点，同时保持所有对象和群集状态。群集在停止时不会产生费用。有关停止群集的更多详细信息，请参阅 stopping a cluster <https://docs.microsoft.com/azure/aks/start-stop-cluster>_。

az aks stop --name
            --resource-group
            [--no-wait]

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--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 aks update

编辑

更新托管 Kubernetes 群集。在没有可选参数的情况下调用时，会尝试将群集移动到其目标状态，而无需更改当前群集配置。这可用于移出非成功状态。

az aks update --name
              --resource-group
              [--aad-admin-group-object-ids]
              [--aad-tenant-id]
              [--aks-custom-headers]
              [--api-server-authorized-ip-ranges]
              [--apiserver-subnet-id]
              [--assign-identity]
              [--assign-kubelet-identity]
              [--assignee-principal-type]
              [--attach-acr]
              [--auto-upgrade-channel {node-image, none, patch, rapid, stable}]
              [--azure-container-storage-nodepools]
              [--azure-keyvault-kms-key-id]
              [--azure-keyvault-kms-key-vault-network-access {Private, Public}]
              [--azure-keyvault-kms-key-vault-resource-id]
              [--azure-monitor-workspace-resource-id]
              [--bootstrap-artifact-source {Cache, Direct}]
              [--bootstrap-container-registry-resource-id]
              [--ca-certs --custom-ca-trust-certificates]
              [--ca-profile --cluster-autoscaler-profile]
              [--container-storage-version {1, 2}]
              [--defender-config]
              [--detach-acr]
              [--disable-acns]
              [--disable-acns-observability]
              [--disable-acns-security]
              [--disable-ahub]
              [--disable-ai-toolchain-operator]
              [--disable-azure-container-storage]
              [--disable-azure-keyvault-kms]
              [--disable-azure-monitor-metrics]
              [--disable-azure-rbac]
              [--disable-blob-driver]
              [--disable-cluster-autoscaler]
              [--disable-cost-analysis]
              [--disable-defender]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-force-upgrade]
              [--disable-image-cleaner]
              [--disable-keda]
              [--disable-local-accounts]
              [--disable-private-cluster]
              [--disable-public-fqdn]
              [--disable-run-command]
              [--disable-secret-rotation]
              [--disable-snapshot-controller]
              [--disable-static-egress-gateway]
              [--disable-vpa]
              [--disable-windows-gmsa]
              [--disable-workload-identity]
              [--enable-aad]
              [--enable-acns]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-azure-container-storage]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-defender]
              [--enable-disk-driver]
              [--enable-file-driver]
              [--enable-force-upgrade]
              [--enable-image-cleaner]
              [--enable-keda]
              [--enable-local-accounts]
              [--enable-managed-identity]
              [--enable-oidc-issuer]
              [--enable-private-cluster]
              [--enable-public-fqdn]
              [--enable-run-command]
              [--enable-secret-rotation]
              [--enable-snapshot-controller]
              [--enable-static-egress-gateway]
              [--enable-vpa]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--ephemeral-disk-nvme-perf-tier {Basic, Premium, Standard}]
              [--ephemeral-disk-volume-type {EphemeralVolumeOnly, PersistentVolumeWithAnnotation}]
              [--gmsa-dns-server]
              [--gmsa-root-domain-name]
              [--grafana-resource-id]
              [--http-proxy-config]
              [--if-match]
              [--if-none-match]
              [--image-cleaner-interval-hours]
              [--ip-families]
              [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
              [--ksm-metric-annotations-allow-list]
              [--ksm-metric-labels-allow-list]
              [--load-balancer-backend-pool-type {nodeIP, nodeIPConfiguration}]
              [--load-balancer-idle-timeout]
              [--load-balancer-managed-outbound-ip-count]
              [--load-balancer-managed-outbound-ipv6-count]
              [--load-balancer-outbound-ip-prefixes]
              [--load-balancer-outbound-ips]
              [--load-balancer-outbound-ports]
              [--load-balancer-sku {standard}]
              [--max-count]
              [--migrate-vmas-to-vms]
              [--min-count]
              [--nat-gateway-idle-timeout]
              [--nat-gateway-managed-outbound-ip-count]
              [--network-dataplane {azure, cilium}]
              [--network-plugin {azure, kubenet, none}]
              [--network-plugin-mode]
              [--network-policy {azure, calico, cilium, none}]
              [--no-wait]
              [--node-os-upgrade-channel]
              [--node-provisioning-default-pools {Auto, None}]
              [--node-provisioning-mode {Auto, Manual}]
              [--nodepool-labels]
              [--nodepool-taints]
              [--nrg-lockdown-restriction-level {ReadOnly, Unrestricted}]
              [--outbound-type {loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--private-dns-zone]
              [--rotation-poll-interval]
              [--sku {automatic, base}]
              [--storage-pool-name]
              [--storage-pool-option {NVMe, Temp, all}]
              [--storage-pool-size]
              [--storage-pool-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
              [--tags]
              [--tier {free, premium, standard}]
              [--update-cluster-autoscaler]
              [--upgrade-override-until]
              [--windows-admin-password]
              [--yes]

示例

将群集协调回其当前状态。

az aks update -g MyResourceGroup -n MyManagedCluster

使用标准 SKU 负载均衡器更新 kubernetes 群集，以便为负载均衡器出站连接使用情况使用两个 AKS 创建的 IP。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2

使用标准 SKU 负载均衡器更新 kubernetes 群集，以便为负载均衡器出站连接使用情况使用提供的公共 IP。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ips <ip-resource-id-1,ip-resource-id-2>

使用标准 SKU 负载均衡器更新 Kubernetes 群集，其中两个出站 AKS 托管 IP 的空闲流超时为 5 分钟，每个计算机分配了 8000 个端口

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2 --load-balancer-idle-timeout 5 --load-balancer-outbound-ports 8000

使用标准 SKU 负载均衡器更新 kubernetes 群集，以使用负载均衡器出站连接使用情况提供的公共 IP 前缀。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ip-prefixes <ip-prefix-resource-id-1,ip-prefix-resource-id-2>

使用两个出站 AKS 托管 IP 更新 managedNATGateway 出站类型的 kubernetes 群集，空闲流超时为 4 分钟

az aks update -g MyResourceGroup -n MyManagedCluster --nat-gateway-managed-outbound-ip-count 2 --nat-gateway-idle-timeout 4

按名称“acrName”将 AKS 群集附加到 ACR

az aks update -g MyResourceGroup -n MyManagedCluster --attach-acr acrName

使用授权的 apiserver ip 范围更新 kubernetes 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 193.168.1.0/24,194.168.1.0/24

禁用 kubernetes 群集的授权 apiserver IP 范围功能。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges ""

将 kubernetes 群集中的 apiserver 流量限制为代理池节点。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 0.0.0.0/32

使用租户 ID 或管理员组对象 ID 更新 AKS 托管的 AAD 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

将 AKS AAD 集成群集或非 AAD 群集迁移到 AKS 托管的 AAD 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-aad --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

为 Kubernetes 群集启用 Azure 混合用户权益壮举。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-ahub

禁用 Kubernetes 群集的 Azure 混合用户权益壮举。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-ahub

更新 kubernetes 群集的 Windows 密码

az aks update -g MyResourceGroup -n MyManagedCLuster --windows-admin-password "Repl@cePassw0rd12345678"

更新群集以在控制平面中使用系统分配的托管标识。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-managed-identity

更新群集以在控制平面中使用用户分配的托管标识。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-managed-identity --assign-identity <user_assigned_identity_resource_id>

更新非托管 AAD AKS 群集以使用 Azure RBAC

az aks update -g MyResourceGroup -n MyManagedCluster --enable-aad --enable-azure-rbac

更新托管 AAD AKS 群集以使用 Azure RBAC

az aks update -g MyResourceGroup -n MyManagedCluster --enable-azure-rbac

在托管 AAD AKS 群集中禁用 Azure RBAC

az aks update -g MyResourceGroup -n MyManagedCluster --disable-azure-rbac

更新 kubernetes 群集的标记

az aks update -g MyResourceGroup -n MyManagedCLuster --tags "foo=bar" "baz=qux"

使用自定义标头更新 kubernetes 群集

az aks update -g MyResourceGroup -n MyManagedCluster --aks-custom-headers WindowsContainerRuntime=containerd,AKSHTTPCustomFeatures=Microsoft.ContainerService/CustomNodeConfigPreview

为 Kubernetes 群集启用 Windows gmsa，并在群集使用的 vnet 中设置 DNS 服务器。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-windows-gmsa

为 Kubernetes 群集启用 Windows gmsa，而无需在群集使用的 vnet 中设置 DNS 服务器。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-windows-gmsa --gmsa-dns-server "10.240.0.4" --gmsa-root-domain-name "contoso.com"

禁用 Kubernetes 群集的 Windows gmsa。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-windows-gmsa

为现有 kubernetes 群集启用 KEDA 工作负荷自动缩放程序。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-keda

为现有 kubernetes 群集禁用 KEDA 工作负荷自动缩放程序。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-keda

为现有 kubernetes 群集启用 VPA（垂直 Pod 自动缩放程序）。

az aks update -g MyResourceGroup -n MyManagedCLuster --enable-vpa

为现有 Kubernetes 群集禁用 VPA（垂直 Pod 自动缩放程序）。

az aks update -g MyResourceGroup -n MyManagedCLuster --disable-vpa

更新 kubernetes 群集以使用自动节点预配。

az aks update -g MyResourceGroup -n MyManagedCluster --node-provisioning-mode Auto

更新 kubernetes 群集以使用没有默认池的自动节点预配模式。

az aks update -g MyResourceGroup -n MyManagedCluster --node-provisioning-mode Auto --node-provisioning-default-pools None

将负载均衡器 SKU 升级到标准

az aks update --load-balancer-sku standard -g MyResourceGroup -n MyManagedCluster

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aad-admin-group-object-ids

将设置为群集管理员的 aad 组对象 ID 的逗号分隔列表。

--aad-tenant-id

Azure Active Directory 租户的 ID。

--aks-custom-headers

用于指定自定义标头的逗号分隔键值对。

--api-server-authorized-ip-ranges

已授权 API 服务器 IP 范围的逗号分隔列表。设置为“”，以允许以前受限群集上的所有流量。设置为 0.0.0.0/32，将 apiserver 流量限制到节点池。

--apiserver-subnet-id

要向其分配控制平面 apiserver pod 的现有 VNet 中的子网 ID（需要 --enable-apiserver-vnet-integration）。

--assign-identity

指定用于管理群集资源组的现有用户分配标识。

--assign-kubelet-identity

将群集的 kubelet 标识更新为现有用户分配的标识。请注意，此操作将重新创建群集中的所有代理节点。

--assignee-principal-type -t

将此参数与 --attach-acr 结合使用，在 ACR 角色分配中显式设置主体类型。这有助于通过确保应用正确的主体类型来避免与 RBAC 相关的错误。有效值为“User”、“Group”或“ServicePrincipal”。

--attach-acr

向名称或资源 ID 指定的 ACR 授予“acrpull”角色分配。

--auto-upgrade-channel

指定自动升级的升级通道。

属性	值
接受的值:	node-image, none, patch, rapid, stable

--azure-container-storage-nodepools

定义逗号分隔的 nodepool 列表以安装 Azure 容器存储。

--azure-keyvault-kms-key-id

Azure Key Vault 密钥的标识符。

--azure-keyvault-kms-key-vault-network-access

Azure 密钥库的网络访问。

允许的值为“Public”、“Private”。如果未设置，则默认键入“Public”。要求使用 --azure-keyvault-kms-key-id。

属性	值
接受的值:	Private, Public

--azure-keyvault-kms-key-vault-resource-id

Azure 密钥库的资源 ID。

--azure-monitor-workspace-resource-id

Azure Monitor 工作区的资源 ID。

--bootstrap-artifact-source

启动群集时配置项目源。

项目包括加载项映像。使用“Direct”从 MCR 下载项目，将项目“缓存”下载到Azure 容器注册表。

属性	值
接受的值:	Cache, Direct

--bootstrap-container-registry-resource-id

配置容器注册表资源 ID。必须使用“缓存”作为启动项目源。

--ca-certs --custom-ca-trust-certificates

包含最多 10 个空白行分隔证书的文件的路径。仅对 Linux 节点有效。

这些证书由自定义 CA 信任功能使用，并将添加到节点的信任存储中。

--ca-profile --cluster-autoscaler-profile

用于配置群集自动缩放程序的键=值对的逗号分隔列表。传递空字符串以清除配置文件。

--container-storage-version

设置 Azure 容器存储版本，默认情况下将安装最新版本。

属性	值
接受的值:	1, 2

--defender-config

包含 Microsoft Defender 配置文件配置的 JSON 文件的路径。

--detach-acr

禁用按名称或资源 ID 指定的 ACR 的“acrpull”角色分配。

--disable-acns

禁用群集上的所有高级网络功能。

--disable-acns-observability

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络可观测性功能。

--disable-acns-security

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络安全功能。

--disable-ahub

禁用群集的 Azure 混合用户权益（AHUB）功能。

属性	值
默认值:	False

--disable-ai-toolchain-operator

禁用 AI 工具链运算符。

属性	值
默认值:	False

--disable-azure-container-storage

禁用 Azure 容器存储或任何一种存储池类型。可用作标志（默认值为 True）或存储池类型值：azureDisk、ephemeralDisk、elasticSan、all（禁用所有存储池）。

--disable-azure-keyvault-kms

禁用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--disable-azure-monitor-metrics

禁用 Azure Monitor 指标配置文件。这将删除与群集关联的所有 DCRA、数据流为 prometheus-stream 的所有链接 DCR 以及此 AKS 群集的加载项创建的录制规则组。

属性	值
默认值:	False

--disable-azure-rbac

禁用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--disable-blob-driver

禁用 AzureBlob CSI 驱动程序。

--disable-cluster-autoscaler -d

禁用群集自动缩放程序。

属性	值
默认值:	False

--disable-cost-analysis

禁用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。

属性	值
默认值:	False

--disable-defender

禁用 Defender 配置文件。

属性	值
默认值:	False

--disable-disk-driver

禁用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--disable-file-driver

禁用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--disable-force-upgrade

禁用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--disable-image-cleaner

禁用 ImageCleaner 服务。

属性	值
默认值:	False

--disable-keda

禁用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--disable-local-accounts

如果设置为 true，则会为此群集禁用静态凭据。

属性	值
默认值:	False

--disable-private-cluster

为 apiserver vnet 集成群集禁用专用群集。

属性	值
默认值:	False

--disable-public-fqdn

禁用专用群集的公共 fqdn 功能。

属性	值
默认值:	False

--disable-run-command

禁用群集的“运行”命令功能。

属性	值
默认值:	False

--disable-secret-rotation

禁用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--disable-snapshot-controller

禁用 CSI 快照控制器。

属性	值
默认值:	False

--disable-static-egress-gateway

禁用群集的静态出口网关加载项。

属性	值
默认值:	False

--disable-vpa

禁用群集的垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--disable-windows-gmsa

在群集上禁用 Windows gmsa。

属性	值
默认值:	False

--disable-workload-identity

禁用工作负荷标识加载项。

属性	值
默认值:	False

--enable-aad

为群集启用托管 AAD 功能。

属性	值
默认值:	False

--enable-acns

在群集上启用高级网络功能。启用此操作会产生额外的费用。对于非 cilium 群集，acns 安全性默认处于禁用状态，直到收到进一步通知。

--enable-ahub

为群集启用 Azure 混合用户权益（AHUB）功能。

属性	值
默认值:	False

--enable-ai-toolchain-operator

向群集启用 AI 工具链操作员。

属性	值
默认值:	False

--enable-apiserver-vnet-integration

启用用户 vnet 与控制平面 apiserver Pod 的集成。

属性	值
默认值:	False

--enable-azure-container-storage

启用 Azure 容器存储。可用作标志（默认值为 True）或存储池类型值：（azureDisk、ephemeralDisk、elasticSan）。

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--enable-azure-monitor-metrics

使用用于 Prometheus 集成的 Azure Monitor 托管服务启用 kubernetes 群集。

属性	值
默认值:	False

--enable-azure-rbac

启用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler -e

启用群集自动缩放程序。

属性	值
默认值:	False

--enable-cost-analysis

启用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。有关详细信息，请参阅 aka.ms/aks/docs/cost-analysis。

属性	值
默认值:	False

--enable-defender

启用 Microsoft Defender 安全配置文件。

属性	值
默认值:	False

--enable-disk-driver

启用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--enable-file-driver

启用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--enable-force-upgrade

启用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--enable-image-cleaner

启用 ImageCleaner 服务。

属性	值
默认值:	False

--enable-keda

启用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--enable-local-accounts

如果设置为 true，则会为此群集启用静态凭据。

属性	值
默认值:	False

--enable-managed-identity

更新当前群集以使用托管标识管理群集资源组。

属性	值
默认值:	False

--enable-oidc-issuer

启用 OIDC 颁发者。

属性	值
默认值:	False

--enable-private-cluster

为 apiserver vnet 集成群集启用专用群集。

属性	值
默认值:	False

--enable-public-fqdn

为专用群集启用公共 fqdn 功能。

属性	值
默认值:	False

--enable-run-command

为群集启用“运行”命令功能。

属性	值
默认值:	False

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-snapshot-controller

启用快照控制器。

属性	值
默认值:	False

--enable-static-egress-gateway

启用群集的静态出口网关加载项。

属性	值
默认值:	False

--enable-vpa

为群集启用垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--enable-windows-gmsa

在群集上启用 Windows gmsa。

属性	值
默认值:	False

--enable-windows-recording-rules

启用 Azure Monitor 指标加载项时启用 Windows 录制规则。

属性	值
默认值:	False

--enable-workload-identity

启用工作负荷标识加载项。

属性	值
默认值:	False

--ephemeral-disk-nvme-perf-tier

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	Basic, Premium, Standard

--ephemeral-disk-volume-type

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	EphemeralVolumeOnly, PersistentVolumeWithAnnotation

--gmsa-dns-server

为群集上的 Windows gmsa 指定 DNS 服务器。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gmsa-root-domain-name

为群集上的 Windows gmsa 指定根域名。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--grafana-resource-id

Azure 托管 Grafana 工作区的资源 ID。

--http-proxy-config

此群集的 HTTP 代理配置。

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--image-cleaner-interval-hours

ImageCleaner 扫描间隔。

--ip-families

用于群集网络的 IP 版本的逗号分隔列表。

每个 IP 版本应采用 IPvN 格式。例如，IPv4。

--k8s-support-plan

从“KubernetesOfficial”或“AKSLongTermSupport”中进行选择，并使用“AKSLongTermSupport”获得 1 个额外的 CVE 修补程序。

属性	值
接受的值:	AKSLongTermSupport, KubernetesOfficial

--ksm-metric-annotations-allow-list

--ksm-metric-labels-allow-list

--load-balancer-backend-pool-type

负载均衡器后端池类型。

属性	值
接受的值:	nodeIP, nodeIPConfiguration

--load-balancer-idle-timeout

负载均衡器空闲超时（以分钟为单位）。

负载均衡器出站流的所需空闲超时，默认值为 30 分钟。请在 [4， 100] 范围内指定一个值。

--load-balancer-managed-outbound-ip-count

负载均衡器托管的出站 IP 计数。

负载均衡器出站连接的托管出站 IP 的所需数量。仅适用于标准 SKU 负载均衡器群集。如果新值大于原始值，则会创建新的其他出站 IP。如果该值小于原始值，将删除现有的出站 IP，并且出站连接可能会由于配置更新而失败。

--load-balancer-managed-outbound-ipv6-count

负载均衡器管理的出站 IPv6 IP 计数。

负载均衡器出站连接的托管出站 IPv6 IP 的所需数量。仅适用于双堆栈（--ip 系列 IPv4，IPv6）。

--load-balancer-outbound-ip-prefixes

负载均衡器出站 IP 前缀资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 前缀资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ips

负载均衡器出站 IP 资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ports

负载均衡器出站分配端口。

负载均衡器后端池中每个 VM 所需的出站端口数。默认情况下，设置为 0，它使用基于 VM 数的默认分配。

--load-balancer-sku

Azure 负载均衡器群集的 SKU 选择。仅接受标准。

升级到 AKS 群集的标准 Azure 负载均衡器 SKU。

属性	值
接受的值:	standard

--max-count

指定了“--enable-cluster-autoscaler”时用于自动缩放程序的最大节点计数。请在 [1， 1000] 范围内指定值。

--migrate-vmas-to-vms

将具有 VMAS 节点池的群集迁移到 VMS 节点池。

属性	值
默认值:	False

--min-count

指定“--enable-cluster-autoscaler”时用于自动缩放程序的最小节点计数。请在 [1， 1000] 范围内指定值。

--nat-gateway-idle-timeout

NAT 网关空闲超时（以分钟为单位）。

NAT 网关出站流的所需空闲超时，默认值为 4 分钟。请在 [4， 120] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--nat-gateway-managed-outbound-ip-count

NAT 网关托管出站 IP 计数。

NAT 网关出站连接的托管出站 IP 数。请在 [1， 16] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--network-dataplane

要使用的网络数据平面。

Kubernetes 群集中使用的网络数据平面。指定“azure”以使用 Azure 数据平面（默认）或“cilium”来启用 Cilium 数据平面。

属性	值
接受的值:	azure, cilium

--network-plugin

要使用的 Kubernetes 网络插件。

指定“azure”以及 --network-plugin-mode=overlay 以更新群集以使用 Azure CNI 覆盖。有关详细信息，请参阅 https://aka.ms/aks/azure-cni-overlay。

属性	值
接受的值:	azure, kubenet, none

--network-plugin-mode

更新网络插件的模式，以迁移到其他 Pod 网络设置。

--network-policy

更新网络策略引擎。

Azure 提供了三个用于强制实施网络策略的网络策略引擎。可以指定以下值：

Azure 网络策略管理器的“azure”
由 Cilium 提供支持的 Azure CNI 的“cilium”
Tigera 创立的开源网络和网络安全解决方案的“calico”
“none”用于卸载网络策略引擎（Azure 网络策略管理器或 Calico）。默认为“none”（网络策略已禁用）。

属性	值
接受的值:	azure, calico, cilium, none

--no-wait

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

属性	值
默认值:	False

--node-os-upgrade-channel

更新节点上 OS 的方式。可以是 NodeImage、None、SecurityPatch 或非托管。

--node-provisioning-default-pools

预览

为节点预置配置的默认 Karpenter NodePools 集。有效值为“Auto”和“None”。

属性	值
接受的值:	Auto, None

--node-provisioning-mode

预览

设置群集的节点预配模式。有效值为“Auto”和“Manual”。有关“自动”模式的详细信息，请参阅 aka.ms/aks/nap。

属性	值
接受的值:	Auto, Manual

--nodepool-labels

所有节点池的节点标签。请参阅 https://aka.ms/node-labels 标签语法。

--nodepool-taints

所有节点池的节点排斥。

--nrg-lockdown-restriction-level

托管节点资源组的限制级别。

群集的托管节点资源组上允许的权限限制级别、支持的值是“不受限制”和“ReadOnly”（建议的 ReadOnly）。

属性	值
接受的值:	ReadOnly, Unrestricted

--outbound-type

如何为群集配置出站流量。

此选项将更改在 AKS 群集中管理出站连接的方式。可用选项包括 loadbalancer、managedNATGateway、userAssignedNATGateway、userDefinedRouting 和 none。对于自定义 vnet，支持 loadbalancer、userAssignedNATGateway 和 userDefinedRouting。支持 aks 托管 vnet、loadbalancer、managedNATGateway 和 userDefinedRouting。

属性	值
接受的值:	loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting

--pod-cidr

更新群集的 Pod CIDR。将群集从 Azure CNI 更新到 Azure CNI 覆盖时使用。

--private-dns-zone

专用群集的专用 DNS 区域模式。

仅允许将专用 DNS 区域从 byo/system 模式更改为非专用群集。其他人被拒绝。

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--sku

指定托管群集的 SKU 名称。使用“--sku 基础”可启用基本托管群集。使用“--sku 自动”可启用自动托管群集。

属性	值
接受的值:	automatic, base

--storage-pool-name

为 Azure 容器存储设置存储池名称。

--storage-pool-option

为 Azure 容器存储设置临时磁盘存储池选项。

属性	值
接受的值:	NVMe, Temp, all

--storage-pool-size

为 Azure 容器存储设置存储池大小。

--storage-pool-sku

为 Azure 容器存储设置 Azure 磁盘类型存储池 SKU。

属性	值
接受的值:	PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

托管群集的标记。将标记由云提供商管理的托管群集实例和所有资源。

--tier

指定托管群集的 SKU 层。 “层标准”支持具有财务支持的 SLA 的标准托管群集服务。 “层免费”将标准托管群集更改为免费群集。

属性	值
接受的值:	free, premium, standard

--update-cluster-autoscaler -u

更新群集自动缩放程序的最小计数或最大计数。

属性	值
默认值:	False

--upgrade-override-until

直到群集 upgradeSettings 重写生效为止。它需要采用在接下来的 30 天内的有效日期/时间格式。例如，2023-04-01T13：00：00Z。请注意，如果 --force-upgrade 设置为 true，并且未设置 --upgrade-override-until，则默认情况下，它将从现在起设置为 3 天。

--windows-admin-password

用于 Windows 节点 VM 的用户帐户密码。

--yes -y

不要提示确认。

属性	值
默认值:	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 aks update (aks-preview 扩展)

更新托管 Kubernetes 群集的属性。

更新托管 Kubernetes 群集的属性。例如，可用于启用/禁用群集自动缩放程序。在没有可选参数的情况下调用时，会尝试将群集移动到其目标状态，而无需更改当前群集配置。这可用于移出非成功状态。

az aks update --name
              --resource-group
              [--aad-admin-group-object-ids]
              [--aad-tenant-id]
              [--acns-advanced-networkpolicies {FQDN, L7, None}]
              [--acns-datapath-acceleration-mode {BpfVeth, None}]
              [--acns-transit-encryption-type {None, WireGuard}]
              [--aks-custom-headers]
              [--ampls-resource-id]
              [--api-server-authorized-ip-ranges]
              [--apiserver-subnet-id]
              [--assign-identity]
              [--assign-kubelet-identity]
              [--attach-acr]
              [--auto-upgrade-channel {node-image, none, patch, rapid, stable}]
              [--azure-container-storage-nodepools]
              [--azure-keyvault-kms-key-id]
              [--azure-keyvault-kms-key-vault-network-access {Private, Public}]
              [--azure-keyvault-kms-key-vault-resource-id]
              [--azure-monitor-workspace-resource-id]
              [--bootstrap-artifact-source {Cache, Direct}]
              [--bootstrap-container-registry-resource-id]
              [--ca-certs --custom-ca-trust-certificates]
              [--ca-profile --cluster-autoscaler-profile]
              [--cluster-service-load-balancer-health-probe-mode {Servicenodeport, Shared}]
              [--cluster-snapshot-id]
              [--container-storage-version {1, 2}]
              [--data-collection-settings]
              [--defender-config]
              [--detach-acr]
              [--disable-acns]
              [--disable-acns-observability]
              [--disable-acns-security]
              [--disable-ahub]
              [--disable-ai-toolchain-operator]
              [--disable-azure-container-storage]
              [--disable-azure-keyvault-kms]
              [--disable-azure-monitor-app-monitoring]
              [--disable-azure-monitor-logs]
              [--disable-azure-monitor-metrics]
              [--disable-azure-rbac]
              [--disable-blob-driver]
              [--disable-cluster-autoscaler]
              [--disable-cost-analysis]
              [--disable-defender]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-force-upgrade]
              [--disable-gateway-api]
              [--disable-http-proxy]
              [--disable-image-cleaner]
              [--disable-image-integrity]
              [--disable-imds-restriction]
              [--disable-keda]
              [--disable-local-accounts]
              [--disable-opentelemetry-logs]
              [--disable-opentelemetry-metrics]
              [--disable-optimized-addon-scaling]
              [--disable-pod-identity]
              [--disable-private-cluster]
              [--disable-public-fqdn]
              [--disable-retina-flow-logs]
              [--disable-run-command]
              [--disable-secret-rotation]
              [--disable-snapshot-controller]
              [--disable-static-egress-gateway]
              [--disable-upstream-kubescheduler-user-configuration]
              [--disable-vpa]
              [--disable-workload-identity]
              [--disk-driver-version {v1, v2}]
              [--enable-aad]
              [--enable-acns]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-azure-container-storage]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-app-monitoring]
              [--enable-azure-monitor-logs]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-defender]
              [--enable-disk-driver]
              [--enable-file-driver]
              [--enable-force-upgrade]
              [--enable-gateway-api]
              [--enable-high-log-scale-mode {false, true}]
              [--enable-http-proxy]
              [--enable-image-cleaner]
              [--enable-image-integrity]
              [--enable-imds-restriction]
              [--enable-keda]
              [--enable-local-accounts]
              [--enable-managed-identity]
              [--enable-msi-auth-for-monitoring {false, true}]
              [--enable-oidc-issuer]
              [--enable-opentelemetry-logs]
              [--enable-opentelemetry-metrics]
              [--enable-optimized-addon-scaling]
              [--enable-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--enable-private-cluster]
              [--enable-public-fqdn]
              [--enable-retina-flow-logs]
              [--enable-run-command]
              [--enable-secret-rotation]
              [--enable-snapshot-controller]
              [--enable-static-egress-gateway]
              [--enable-syslog {false, true}]
              [--enable-upstream-kubescheduler-user-configuration]
              [--enable-vpa]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--ephemeral-disk-nvme-perf-tier {Basic, Premium, Standard}]
              [--ephemeral-disk-volume-type {EphemeralVolumeOnly, PersistentVolumeWithAnnotation}]
              [--gmsa-dns-server]
              [--gmsa-root-domain-name]
              [--grafana-resource-id]
              [--http-proxy-config]
              [--if-match]
              [--if-none-match]
              [--image-cleaner-interval-hours]
              [--ip-families]
              [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
              [--kms-infrastructure-encryption {Disabled, Enabled}]
              [--ksm-metric-annotations-allow-list]
              [--ksm-metric-labels-allow-list]
              [--kube-proxy-config]
              [--load-balancer-backend-pool-type]
              [--load-balancer-idle-timeout]
              [--load-balancer-managed-outbound-ip-count]
              [--load-balancer-managed-outbound-ipv6-count]
              [--load-balancer-outbound-ip-prefixes]
              [--load-balancer-outbound-ips]
              [--load-balancer-outbound-ports]
              [--load-balancer-sku {standard}]
              [--max-count]
              [--migrate-vmas-to-vms]
              [--min-count]
              [--nat-gateway-idle-timeout]
              [--nat-gateway-managed-outbound-ip-count]
              [--network-dataplane {azure, cilium}]
              [--network-plugin {azure, kubenet, none}]
              [--network-plugin-mode]
              [--network-policy]
              [--no-wait]
              [--node-init-taints --nodepool-initialization-taints]
              [--node-os-upgrade-channel {NodeImage, None, SecurityPatch, Unmanaged}]
              [--node-provisioning-default-pools {Auto, None}]
              [--node-provisioning-mode {Auto, Manual}]
              [--nodepool-labels]
              [--nodepool-taints]
              [--nrg-lockdown-restriction-level {ReadOnly, Unrestricted}]
              [--opentelemetry-logs-port]
              [--opentelemetry-metrics-port]
              [--outbound-type {block, loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--private-dns-zone]
              [--rotation-poll-interval]
              [--safeguards-excluded-ns]
              [--safeguards-level {Enforcement, Off, Warning}]
              [--safeguards-version]
              [--sku {automatic, base}]
              [--ssh-key-value]
              [--storage-pool-name]
              [--storage-pool-option {NVMe, Temp, all}]
              [--storage-pool-size]
              [--storage-pool-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
              [--tags]
              [--tier {free, premium, standard}]
              [--update-cluster-autoscaler]
              [--upgrade-override-until]
              [--windows-admin-password]
              [--workspace-resource-id]
              [--yes]

示例

将群集协调回其当前状态。

az aks update -g MyResourceGroup -n MyManagedCluster

在节点计数范围内启用群集自动缩放程序 [1,5]

az aks update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n MyManagedCluster

为现有群集禁用群集自动缩放程序

az aks update --disable-cluster-autoscaler -g MyResourceGroup -n MyManagedCluster

更新群集自动缩放程序的最小计数或最大计数。

az aks update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n MyManagedCluster

将负载均衡器 SKU 升级到标准

az aks update --load-balancer-sku standard -g MyResourceGroup -n MyManagedCluster

使用标准 SKU 负载均衡器更新 kubernetes 群集，以便为负载均衡器出站连接使用情况使用两个 AKS 创建的 IP。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2

使用标准 SKU 负载均衡器更新 kubernetes 群集，以便为负载均衡器出站连接使用情况使用提供的公共 IP。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ips <ip-resource-id-1,ip-resource-id-2>

使用标准 SKU 负载均衡器更新 kubernetes 群集，以使用负载均衡器出站连接使用情况提供的公共 IP 前缀。

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-outbound-ip-prefixes <ip-prefix-resource-id-1,ip-prefix-resource-id-2>

使用新的出站类型更新 kubernetes 群集

az aks update -g MyResourceGroup -n MyManagedCluster --outbound-type managedNATGateway

使用两个出站 AKS 托管 IP 更新 kubernetes 群集，空闲流超时为 5 分钟，每个计算机分配了 8000 个端口

az aks update -g MyResourceGroup -n MyManagedCluster --load-balancer-managed-outbound-ip-count 2 --load-balancer-idle-timeout 5 --load-balancer-outbound-ports 8000

使用两个出站 AKS 托管 IP 更新 managedNATGateway 出站类型的 kubernetes 群集，空闲流超时为 4 分钟

az aks update -g MyResourceGroup -n MyManagedCluster --nat-gateway-managed-outbound-ip-count 2 --nat-gateway-idle-timeout 4

使用授权的 apiserver ip 范围更新 kubernetes 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 193.168.1.0/24,194.168.1.0/24

禁用 kubernetes 群集的授权 apiserver IP 范围功能。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges ""

将 kubernetes 群集中的 apiserver 流量限制为代理池节点。

az aks update -g MyResourceGroup -n MyManagedCluster --api-server-authorized-ip-ranges 0.0.0.0/32

使用租户 ID 或管理员组对象 ID 更新 AKS 托管的 AAD 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

将 AKS AAD 集成群集或非 AAD 群集迁移到 AKS 托管的 AAD 群集。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-aad --aad-admin-group-object-ids <id-1,id-2> --aad-tenant-id <id>

为 Kubernetes 群集启用 Azure 混合用户权益壮举。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-ahub

禁用 Kubernetes 群集的 Azure 混合用户权益壮举。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-ahub

更新群集以在控制平面中使用系统分配的托管标识。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-managed-identity

更新群集以在控制平面中使用用户分配的托管标识。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-managed-identity --assign-identity <user_assigned_identity_resource_id>

启用 Pod 标识加载项。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-pod-identity

禁用 Pod 标识加载项。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-pod-identity

更新 kubernetes 群集的标记

az aks update -g MyResourceGroup -n MyManagedCLuster --tags "foo=bar" "baz=qux"

更新 kubernetes 群集的 Windows 密码

az aks update -g MyResourceGroup -n MyManagedCLuster --windows-admin-password "Repl@cePassw0rd12345678"

更新托管 AAD AKS 群集以使用 Azure RBAC

az aks update -g MyResourceGroup -n MyManagedCluster --enable-azure-rbac

在托管 AAD AKS 群集中禁用 Azure RBAC

az aks update -g MyResourceGroup -n MyManagedCluster --disable-azure-rbac

为 Kubernetes 群集启用 Windows gmsa，并在群集使用的 vnet 中设置 DNS 服务器。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-windows-gmsa

为 Kubernetes 群集启用 Windows gmsa，而无需在群集使用的 vnet 中设置 DNS 服务器。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-windows-gmsa --gmsa-dns-server "10.240.0.4" --gmsa-root-domain-name "contoso.com"

将现有托管群集更新为托管群集快照。

az aks update -g MyResourceGroup -n MyManagedCluster --cluster-snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/managedclustersnapshots/mysnapshot1"

更新 kubernetes 群集，将安全措施设置为“警告”。假设 Azure Policy 加载项已启用

az aks update -g MyResourceGroup -n MyManagedCluster --safeguards-level Warning

更新 kubernetes 群集，并将安全措施设置为“警告”，并排除某些命名空间。假设 Azure Policy 加载项已启用

az aks update -g MyResourceGroup -n MyManagedCluster --safeguards-level Warning --safeguards-excluded-ns ns1,ns2

为 kubernetes 群集启用 Azure Monitor 日志

az aks update -g MyResourceGroup -n MyManagedCluster --enable-azure-monitor-logs

禁用 Kubernetes 群集的 Azure Monitor 日志

az aks update -g MyResourceGroup -n MyManagedCluster --disable-azure-monitor-logs

更新 kubernetes 群集以清除从安全措施中排除的任何命名空间。假设 Azure Policy 加载项已启用

az aks update -g MyResourceGroup -n MyManagedCluster --safeguards-excluded-ns ""

更新 kubernetes 群集，以从标准发布通道启用网关 API CRD 的托管安装。

az aks update -g MyResourceGroup -n MyManagedCluster --enable-gateway-api

更新 kubernetes 群集以禁用网关 API CRD 的托管安装。

az aks update -g MyResourceGroup -n MyManagedCluster --disable-gateway-api

在现有群集上启用 OpenTelemetry 指标集合

az aks update -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-metrics

在现有群集上启用 OpenTelemetry 日志收集

az aks update -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-logs

使用自定义端口配置 OpenTelemetry 指标

az aks update -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-metrics --opentelemetry-metrics-port 8888

使用自定义端口配置 OpenTelemetry 日志

az aks update -g MyResourceGroup -n MyManagedCluster --enable-opentelemetry-logs --opentelemetry-logs-port 4317

在现有群集上禁用 OpenTelemetry 指标集合

az aks update -g MyResourceGroup -n MyManagedCluster --disable-opentelemetry-metrics

在现有群集上禁用 OpenTelemetry 日志收集

az aks update -g MyResourceGroup -n MyManagedCluster --disable-opentelemetry-logs

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aad-admin-group-object-ids

将设置为群集管理员的 aad 组对象 ID 的逗号分隔列表。

--aad-tenant-id

Azure Active Directory 租户的 ID。

--acns-advanced-networkpolicies

预览

用于在使用“--enable-acns”启用高级网络功能时，在群集上启用高级网络策略（None、FQDN 或 L7）。

属性	值
接受的值:	FQDN, L7, None

--acns-datapath-acceleration-mode

预览

用于在使用“--enable-acns”启用高级网络功能时在群集上设置加速模式（无或 BpfVeth）。

属性	值
接受的值:	BpfVeth, None

--acns-transit-encryption-type

预览

指定 ACNS 的传输加密类型。可用值为“None”和“WireGuard”。

属性	值
接受的值:	None, WireGuard

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--ampls-resource-id

预览

用于监视加载项的 Azure Monitor 专用链接范围的资源 ID。

--api-server-authorized-ip-ranges

已授权 API 服务器 IP 范围的逗号分隔列表。设置为“”，以允许以前受限群集上的所有流量。设置为 0.0.0.0/32，将 apiserver 流量限制到节点池。

--apiserver-subnet-id

预览

要向其分配控制平面 apiserver pod 的现有 VNet 中的子网 ID（需要 --enable-apiserver-vnet-integration）。

--assign-identity

指定用于管理群集资源组的现有用户分配标识。

--assign-kubelet-identity

将群集的 kubelet 标识更新为现有用户分配的标识。请注意，此操作将重新创建群集中的所有代理节点。

--attach-acr

向名称或资源 ID 指定的 ACR 授予“acrpull”角色分配。

--auto-upgrade-channel

指定自动升级的升级通道。它可以快速、稳定、修补、节点映像或无，无表示禁用自动升级。

属性	值
接受的值:	node-image, none, patch, rapid, stable

--azure-container-storage-nodepools

定义逗号分隔的 nodepool 列表以安装 Azure 容器存储。

--azure-keyvault-kms-key-id

Azure Key Vault 密钥的标识符。

--azure-keyvault-kms-key-vault-network-access

Azure 密钥库的网络访问。

允许的值为“Public”、“Private”。如果未设置，则默认键入“Public”。要求使用 --azure-keyvault-kms-key-id。

属性	值
接受的值:	Private, Public

--azure-keyvault-kms-key-vault-resource-id

Azure 密钥库的资源 ID。

--azure-monitor-workspace-resource-id

Azure Monitor 工作区的资源 ID。

--bootstrap-artifact-source

预览

启动群集时配置项目源。

项目包括加载项映像。使用“Direct”从 MCR 下载项目，将项目“缓存”下载到Azure 容器注册表。

属性	值
接受的值:	Cache, Direct

--bootstrap-container-registry-resource-id

预览

配置容器注册表资源 ID。必须使用“缓存”作为启动项目源。

--ca-certs --custom-ca-trust-certificates

预览

包含最多 10 个空白行分隔证书的文件的路径。仅适用于 Linux 节点。

这些证书由自定义 CA 信任功能使用，并将添加到节点的信任存储中。

--ca-profile --cluster-autoscaler-profile

用于配置群集自动缩放程序的键=值对的空间分隔列表。传递空字符串以清除配置文件。

--cluster-service-load-balancer-health-probe-mode

预览

设置群集服务运行状况探测模式。

设置群集服务运行状况探测模式。默认值为“Servicenodeport”。

属性	值
接受的值:	Servicenodeport, Shared

--cluster-snapshot-id

预览

源群集快照 ID 用于更新现有群集。

--container-storage-version

设置 Azure 容器存储版本，默认情况下将安装最新版本。

属性	值
接受的值:	1, 2

--data-collection-settings

预览

包含监视加载项数据收集设置的 JSON 文件的路径。

--defender-config

包含 Microsoft Defender 配置文件配置的 JSON 文件的路径。

--detach-acr

禁用按名称或资源 ID 指定的 ACR 的“acrpull”角色分配。

--disable-acns

禁用群集上的所有高级网络功能。

--disable-acns-observability

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络可观测性功能。

--disable-acns-security

用于在使用“--enable-acns”启用高级网络功能时禁用群集上的高级网络安全功能。

--disable-ahub

禁用群集的 Azure 混合用户权益（AHUB）功能。

属性	值
默认值:	False

--disable-ai-toolchain-operator

预览

禁用 AI 工具链运算符。

属性	值
默认值:	False

--disable-azure-container-storage

禁用 Azure 容器存储或任何一种存储池类型。可用作标志（默认值为 True）或存储池类型值：azureDisk、ephemeralDisk、elasticSan、all（禁用所有存储池）。

--disable-azure-keyvault-kms

禁用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--disable-azure-monitor-app-monitoring

预览

禁用 Azure Monitor 应用程序监视。

属性	值
默认值:	False

--disable-azure-monitor-logs

禁用群集的 Azure Monitor 日志。

这相当于使用“az aks disable-addons -a monitoring”。禁用群集的 Log Analytics 监视。

属性	值
默认值:	False

--disable-azure-monitor-metrics

禁用 Azure Monitor 指标配置文件。这将删除与群集关联的所有 DCRA、数据流为 prometheus-stream 的所有链接 DCR 以及此 AKS 群集的加载项创建的录制规则组。

属性	值
默认值:	False

--disable-azure-rbac

禁用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--disable-blob-driver

禁用 AzureBlob CSI 驱动程序。

--disable-cluster-autoscaler -d

禁用群集自动缩放程序。

属性	值
默认值:	False

--disable-cost-analysis

禁用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。

属性	值
默认值:	False

--disable-defender

禁用 Defender 配置文件。

属性	值
默认值:	False

--disable-disk-driver

禁用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--disable-file-driver

禁用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--disable-force-upgrade

禁用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--disable-gateway-api

禁用网关 API CRD 的托管安装。

属性	值
默认值:	False

--disable-http-proxy

预览

在群集上禁用 HTTP 代理配置。

属性	值
默认值:	False

--disable-image-cleaner

禁用 ImageCleaner 服务。

属性	值
默认值:	False

--disable-image-integrity

预览

禁用 ImageIntegrity 服务。

属性	值
默认值:	False

--disable-imds-restriction

预览

在群集中禁用 IMDS 限制。群集中的所有 Pod 都可以访问 IMDS。

属性	值
默认值:	False

--disable-keda

预览

禁用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--disable-local-accounts

（预览版）如果设置为 true，则会为此群集禁用静态凭据。

属性	值
默认值:	False

--disable-opentelemetry-logs

预览

禁用 OpenTelemetry 日志收集。

属性	值
默认值:	False

--disable-opentelemetry-metrics

预览

禁用 OpenTelemetry 指标集合。

属性	值
默认值:	False

--disable-optimized-addon-scaling

预览

禁用群集的优化加载项缩放功能。

属性	值
默认值:	False

--disable-pod-identity

（预览）禁用群集的 Pod 标识加载项。

属性	值
默认值:	False

--disable-private-cluster

预览

为 apiserver vnet 集成群集禁用专用群集。

属性	值
默认值:	False

--disable-public-fqdn

禁用专用群集的公共 fqdn 功能。

属性	值
默认值:	False

--disable-retina-flow-logs

在群集上禁用高级网络流日志收集功能。

--disable-run-command

禁用群集的“运行”命令功能。

属性	值
默认值:	False

--disable-secret-rotation

禁用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--disable-snapshot-controller

禁用 CSI 快照控制器。

属性	值
默认值:	False

--disable-static-egress-gateway

预览

禁用群集的静态出口网关加载项。

属性	值
默认值:	False

--disable-upstream-kubescheduler-user-configuration

预览

禁用群集上游 kube-scheduler 的用户定义计划程序配置。

属性	值
默认值:	False

--disable-vpa

预览

禁用群集的垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--disable-workload-identity

（预览）禁用群集的工作负荷标识加载项。

属性	值
默认值:	False

--disk-driver-version

指定 AzureDisk CSI 驱动程序版本。

属性	值
接受的值:	v1, v2

--enable-aad

为群集启用托管 AAD 功能。

属性	值
默认值:	False

--enable-acns

在群集上启用高级网络功能。启用此操作会产生额外的费用。对于非 cilium 群集，acns 安全性默认处于禁用状态，直到收到进一步通知。

--enable-ahub

为群集启用 Azure 混合用户权益（AHUB）功能。

属性	值
默认值:	False

--enable-ai-toolchain-operator

预览

向群集启用 AI 工具链操作员。

属性	值
默认值:	False

--enable-apiserver-vnet-integration

预览

启用用户 vnet 与控制平面 apiserver Pod 的集成。

属性	值
默认值:	False

--enable-azure-container-storage

启用 Azure 容器存储。可用作标志（默认值为 True）或存储池类型值：（azureDisk、ephemeralDisk、elasticSan）。

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

属性	值
默认值:	False

--enable-azure-monitor-app-monitoring

预览

启用 Azure Monitor 应用程序监视。

属性	值
默认值:	False

--enable-azure-monitor-logs

为群集启用 Azure Monitor 日志。

这相当于使用“az aks enable-addons -a monitoring”。为群集启用 Log Analytics 监视。如果存在，请使用 Log Analytics 默认工作区，否则将创建一个工作区。指定“--workspace-resource-id”以使用现有工作区。如果启用了监视加载项 --no-wait 参数将不起作用。

属性	值
默认值:	False

--enable-azure-monitor-metrics

启用 Azure Monitor 指标配置文件。

属性	值
默认值:	False

--enable-azure-rbac

启用 Azure RBAC 以控制群集上的授权检查。

属性	值
默认值:	False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler -e

启用群集自动缩放程序。

属性	值
默认值:	False

--enable-cost-analysis

启用将 Kubernetes 命名空间和部署详细信息导出到Azure 门户中的成本分析视图。有关详细信息，请参阅 aka.ms/aks/docs/cost-analysis。

属性	值
默认值:	False

--enable-defender

启用 Microsoft Defender 安全配置文件。

属性	值
默认值:	False

--enable-disk-driver

启用 AzureDisk CSI 驱动程序。

属性	值
默认值:	False

--enable-file-driver

启用 AzureFile CSI 驱动程序。

属性	值
默认值:	False

--enable-force-upgrade

启用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--enable-gateway-api

从标准发布通道启用网关 API CRD 的托管安装。要求至少启用一个托管网关 API 入口提供程序。

属性	值
默认值:	False

--enable-high-log-scale-mode

预览

为容器日志启用高日志缩放模式。

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

--enable-http-proxy

预览

在群集上启用 HTTP 代理配置。

属性	值
默认值:	False

--enable-image-cleaner

启用 ImageCleaner 服务。

属性	值
默认值:	False

--enable-image-integrity

启用 ImageIntegrity 服务。

属性	值
默认值:	False

--enable-imds-restriction

预览

在群集中启用 IMDS 限制。非 hostNetwork Pod 将无法访问 IMDS。

属性	值
默认值:	False

--enable-keda

预览

启用 KEDA 工作负荷自动缩放程序。

属性	值
默认值:	False

--enable-local-accounts

（预览版）如果设置为 true，则会为此群集启用静态凭据。

属性	值
默认值:	False

--enable-managed-identity

将当前群集更新为托管标识以管理群集资源组。

属性	值
默认值:	False

--enable-msi-auth-for-monitoring

预览

使用群集的分配标识（而不是 Log Analytics 工作区的共享密钥）将监视数据发送到 Log Analytics。

属性	值
接受的值:	false, true

--enable-oidc-issuer

启用 OIDC 颁发者。

属性	值
默认值:	False

--enable-opentelemetry-logs

预览

启用 OpenTelemetry 日志收集。要求启用 Azure Monitor 日志。

属性	值
默认值:	False

--enable-opentelemetry-metrics

预览

启用 OpenTelemetry 指标集合。要求启用 Azure Monitor 指标。

属性	值
默认值:	False

--enable-optimized-addon-scaling

预览

为群集启用优化的加载项缩放功能。

属性	值
默认值:	False

--enable-pod-identity

（预览）为群集启用 Pod 标识加载项。

属性	值
默认值:	False

--enable-pod-identity-with-kubenet

（预览）使用 Kubnet 网络插件为群集启用 Pod 标识加载项。

属性	值
默认值:	False

--enable-private-cluster

预览

为 apiserver vnet 集成群集启用专用群集。

属性	值
默认值:	False

--enable-public-fqdn

为专用群集启用公共 fqdn 功能。

属性	值
默认值:	False

--enable-retina-flow-logs

在群集上启用高级网络流日志收集功能。

--enable-run-command

为群集启用“运行”命令功能。

属性	值
默认值:	False

--enable-secret-rotation

启用机密轮换。与 azure-keyvault-secrets-provider 加载项一起使用。

属性	值
默认值:	False

--enable-snapshot-controller

启用快照控制器。

属性	值
默认值:	False

--enable-static-egress-gateway

预览

启用群集的静态出口网关加载项。

属性	值
默认值:	False

--enable-syslog

预览

为监视加载项启用 syslog 数据收集。

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

--enable-upstream-kubescheduler-user-configuration

预览

为群集上游的 kube-scheduler 启用用户定义的计划程序配置。

属性	值
默认值:	False

--enable-vpa

预览

为群集启用垂直 Pod 自动缩放程序。

属性	值
默认值:	False

--enable-windows-gmsa

在群集上启用 Windows gmsa。

属性	值
默认值:	False

--enable-windows-recording-rules

启用 Azure Monitor 指标加载项时启用 Windows 录制规则。

属性	值
默认值:	False

--enable-workload-identity

（预览）为群集启用工作负荷标识加载项。

属性	值
默认值:	False

--ephemeral-disk-nvme-perf-tier

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	Basic, Premium, Standard

--ephemeral-disk-volume-type

为 Azure 容器存储设置临时磁盘卷类型。

属性	值
接受的值:	EphemeralVolumeOnly, PersistentVolumeWithAnnotation

--gmsa-dns-server

为群集上的 Windows gmsa 指定 DNS 服务器。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--gmsa-root-domain-name

为群集上的 Windows gmsa 指定根域名。

如果在群集使用的 VNET 中设置了 DNS 服务器，则无需设置此项。设置 --enable-windows-gmsa-gmsa 时，必须同时设置 --gmsa-dns-server 和 --gmsa-root-domain-name。

--grafana-resource-id

Azure 托管 Grafana 工作区的资源 ID。

--http-proxy-config

此群集的 HTTP 代理配置。

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--image-cleaner-interval-hours

ImageCleaner 扫描间隔。

--ip-families

用于群集网络的 IP 版本的逗号分隔列表。

每个 IP 版本应采用 IPvN 格式。例如，IPv4。

--k8s-support-plan

从“KubernetesOfficial”或“AKSLongTermSupport”中进行选择，并使用“AKSLongTermSupport”获得 1 个额外的 CVE 修补程序。

属性	值
接受的值:	AKSLongTermSupport, KubernetesOfficial

--kms-infrastructure-encryption

预览

使用服务管理的密钥启用 Kubernetes 资源对象的静态加密。

属性	值
接受的值:	Disabled, Enabled

--ksm-metric-annotations-allow-list

--ksm-metric-labels-allow-list

--kube-proxy-config

此群集的 Kube-proxy 配置。

--load-balancer-backend-pool-type

负载均衡器后端池类型。

负载均衡器后端池类型，支持的值为 nodeIP 和 nodeIPConfiguration。

--load-balancer-idle-timeout

负载均衡器空闲超时（以分钟为单位）。

负载均衡器出站流的所需空闲超时，默认值为 30 分钟。请在 [4， 100] 范围内指定一个值。

--load-balancer-managed-outbound-ip-count

负载均衡器托管的出站 IP 计数。

负载均衡器出站连接的托管出站 IP 的所需数量。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-managed-outbound-ipv6-count

负载均衡器管理的出站 IPv6 IP 计数。

负载均衡器出站连接的托管出站 IPv6 IP 的所需数量。仅适用于双堆栈（--ip 系列 IPv4，IPv6）。

--load-balancer-outbound-ip-prefixes

负载均衡器出站 IP 前缀资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 前缀资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ips

负载均衡器出站 IP 资源 ID。

负载均衡器出站连接的逗号分隔公共 IP 资源 ID。仅适用于标准 SKU 负载均衡器群集。

--load-balancer-outbound-ports

负载均衡器出站分配端口。

负载均衡器后端池中每个 VM 所需的出站端口数。默认情况下，设置为 0，它使用基于 VM 数的默认分配。请在 [0， 64000] 范围内指定一个值为 8 的值。

--load-balancer-sku

Azure 负载均衡器群集的 SKU 选择。仅接受标准。

升级到 AKS 群集的标准 Azure 负载均衡器 SKU。

属性	值
接受的值:	standard

--max-count

指定了“--enable-cluster-autoscaler”时用于自动缩放程序的最大节点计数。请在 [1， 1000] 范围内指定值。

--migrate-vmas-to-vms

预览

将具有 VMAS 节点池的群集迁移到 VMS 节点池。

属性	值
默认值:	False

--min-count

指定“--enable-cluster-autoscaler”时用于自动缩放程序的微型节点计数。请在 [1， 1000] 范围内指定值。

--nat-gateway-idle-timeout

NAT 网关空闲超时（以分钟为单位）。

NAT 网关出站流的所需空闲超时，默认值为 4 分钟。请在 [4， 120] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--nat-gateway-managed-outbound-ip-count

NAT 网关托管出站 IP 计数。

NAT 网关出站连接的托管出站 IP 数。请在 [1， 16] 范围内指定一个值。仅适用于具有 managedNATGateway 出站类型的标准 SKU 负载均衡器群集。

--network-dataplane

要使用的网络数据平面。

Kubernetes 群集中使用的网络数据平面。指定“azure”以使用 Azure 数据平面（默认）或“cilium”来启用 Cilium 数据平面。

属性	值
接受的值:	azure, cilium

--network-plugin

要使用的 Kubernetes 网络插件。

为 VNET 中的可路由 Pod IP 指定“azure”，为具有覆盖网络的不可路由 Pod IP 指定“kubenet”，如果未配置任何网络，则为“none”。

属性	值
接受的值:	azure, kubenet, none

--network-plugin-mode

要使用的网络插件模式。

用于控制网络插件应在其中运行的模式。例如，与 --network-plugin=azure 一起使用的“覆盖”将为群集中的 Pod 使用覆盖网络（非 VNET IP）。

--network-policy

更新网络策略的模式。

为 Azure 网络策略管理器指定“azure”，为由 Cilium 提供支持的 Azure CNI 覆盖层指定“cilium”。默认为“”（网络策略已禁用）。

--no-wait

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

属性	值
默认值:	False

--node-init-taints --nodepool-initialization-taints

预览

群集中所有节点池的节点初始化排斥。

--node-os-upgrade-channel

更新节点上 OS 的方式。可以是 NodeImage、None、SecurityPatch 或非托管。

属性	值
接受的值:	NodeImage, None, SecurityPatch, Unmanaged

--node-provisioning-default-pools

预览

为节点预置配置的默认 Karpenter NodePools 集。有效值为“Auto”和“None”。

属性	值
接受的值:	Auto, None

--node-provisioning-mode

预览

设置群集的节点预配模式。有效值为“Auto”和“Manual”。有关“自动”模式的详细信息，请参阅 aka.ms/aks/nap。

属性	值
接受的值:	Auto, Manual

--nodepool-labels

所有节点池的节点标签。请参阅 https://aka.ms/node-labels 标签语法。

--nodepool-taints

所有节点池的节点排斥。

--nrg-lockdown-restriction-level

托管节点资源的限制级别。

群集的托管节点资源组上允许的权限限制级别、支持的值是“不受限制”和“ReadOnly”（建议的 ReadOnly）。

属性	值
接受的值:	ReadOnly, Unrestricted

--opentelemetry-logs-port

预览

OpenTelemetry 日志收集的端口（如果未指定，将使用默认端口）。

--opentelemetry-metrics-port

预览

OpenTelemetry 指标集合的端口（如果未指定，将使用默认端口）。

--outbound-type

如何为群集配置出站流量。

此选项将更改在 AKS 群集中管理出站连接的方式。可用选项包括 loadbalancer、managedNATGateway、userAssignedNATGateway、userDefinedRouting、none 和 block。对于自定义 vnet，支持 loadbalancer、userAssignedNATGateway 和 userDefinedRouting。支持 aks 托管 vnet、loadbalancer、managedNATGateway 和 userDefinedRouting。

属性	值
接受的值:	block, loadBalancer, managedNATGateway, none, userAssignedNATGateway, userDefinedRouting

--pod-cidr

使用 kubenet 时分配 Pod IP 的 CIDR 表示法 IP 范围。

此范围不得与任何子网 IP 范围重叠。例如，172.244.0.0/16。

--private-dns-zone

预览

专用群集的专用 DNS 区域模式。

--rotation-poll-interval

设置轮询间隔。与 azure-keyvault-secrets-provider 加载项一起使用。

--safeguards-excluded-ns

预览

要从部署安全措施中排除的 Kubernetes 命名空间的逗号分隔列表。使用“”清除以前非空的列表。

--safeguards-level

预览

部署保护级别。接受的值是 [Off， Warning， Enforcement]。要求启用 Azure Policy 加载项。

属性	值
接受的值:	Enforcement, Off, Warning

--safeguards-version

预览

要使用的部署保障版本。默认的“v1.0.0”使用 ListSafeguardsVersions API 发现可用版本。

--sku

指定托管群集的 SKU 名称。 “--sku base”启用基本托管群集。 “--sku 自动”启用自动托管群集。

属性	值
接受的值:	automatic, base

--ssh-key-value

在节点 VM 上安装的、用于 SSH 访问的公钥路径或密钥内容。例如，“ssh-rsa AAAAB...剪断。。。UcyupgH azureuser@linuxvm'。

--storage-pool-name

为 Azure 容器存储设置存储池名称。

--storage-pool-option

为 Azure 容器存储设置临时磁盘存储池选项。

属性	值
接受的值:	NVMe, Temp, all

--storage-pool-size

为 Azure 容器存储设置存储池大小。

--storage-pool-sku

为 Azure 容器存储设置 Azure 磁盘类型存储池 SKU。

属性	值
接受的值:	PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

托管群集的标记。将标记由云提供商管理的托管群集实例和所有资源。

--tier

指定托管群集的 SKU 层。 “层标准”支持具有财务支持的 SLA 的标准托管群集服务。 “层免费”将标准托管群集更改为免费群集。

属性	值
接受的值:	free, premium, standard

--update-cluster-autoscaler -u

更新群集自动缩放程序的最小计数或最大计数。

属性	值
默认值:	False

--upgrade-override-until

预览

--windows-admin-password

用于 Windows 节点 VM 的用户帐户密码。

windows-admin-password 规则： - 最小长度： 14 个字符 - 最大长度： 123 个字符 - 复杂性要求：以下 4 个条件中的 3 个需要满足 * 具有较低字符 * 具有大写字符 * 具有数字 * 具有特殊字符（Regex match [\W_]） - 不允许的值：“abc@123”， “P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password！”、“Password1”、“Password22”、“iloveyou！”参考： https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.management.compute.models.virtualmachinescalesetosprofile.adminpassword?view=azure-dotnet.

--workspace-resource-id

要用于存储监视数据的现有 Log Analytics 工作区的资源 ID。如果未指定，则使用默认的 Log Analytics 工作区（如果存在）否则创建一个。

--yes -y

不要提示确认。

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

编辑

更新托管 Kubernetes 群集（例如服务主体）的凭据。

az aks update-credentials --name
                          --resource-group
                          [--client-secret]
                          [--no-wait]
                          [--reset-service-principal]
                          [--service-principal]

示例

使用新的服务主体更新现有 Kubernetes 群集。

az aks update-credentials -g MyResourceGroup -n MyManagedCluster --reset-service-principal --service-principal MyNewServicePrincipalID --client-secret MyNewServicePrincipalSecret

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--client-secret

与服务主体关联的机密。如果 --service-principal 指定此参数，则需要此参数。

属性	值
Parameter group:	Service Principal Arguments

--no-wait

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

属性	值
默认值:	False

--reset-service-principal

重置托管群集的服务主体。

属性	值
Parameter group:	Service Principal Arguments
默认值:	False

--service-principal

用于对 Azure API 进行身份验证的服务主体。如果 --reset-service-principal 指定此参数，则需要此参数。

属性	值
Parameter group:	Service Principal Arguments

全局参数

--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 aks upgrade

编辑

将托管 Kubernetes 群集升级到较新的版本。

在群集升级期间，Kubernetes 将不可用。

az aks upgrade --name
               --resource-group
               [--control-plane-only]
               [--disable-force-upgrade]
               [--enable-force-upgrade]
               [--if-match]
               [--if-none-match]
               [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
               [--kubernetes-version]
               [--no-wait]
               [--node-image-only]
               [--tier {free, premium, standard}]
               [--upgrade-override-until]
               [--yes]

示例

将托管 Kubernetes 群集升级到较新的版本。 (autogenerated)

az aks upgrade --kubernetes-version 1.12.6 --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--control-plane-only

仅升级群集控制平面。如果未指定，则同时升级控制平面和所有节点池。

属性	值
默认值:	False

--disable-force-upgrade

禁用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--enable-force-upgrade

启用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--k8s-support-plan

从“KubernetesOfficial”或“AKSLongTermSupport”中进行选择，并使用“AKSLongTermSupport”获得 1 个额外的 CVE 修补程序。

属性	值
接受的值:	AKSLongTermSupport, KubernetesOfficial

--kubernetes-version -k

要将群集升级到的 Kubernetes 版本，例如“1.16.9”。

属性	值
值来源:	`az aks get-upgrades`

--no-wait

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

属性	值
默认值:	False

--node-image-only

仅升级代理池的节点映像。

属性	值
默认值:	False

--tier

指定托管群集的 SKU 层。 “层标准”支持具有财务支持的 SLA 的标准托管群集服务。 “层免费”没有经济支持的 SLA。 “--tier premium”是“--k8s-support-plan AKSLongTermSupport”所必需的。

属性	值
接受的值:	free, premium, standard

--upgrade-override-until

直到群集 upgradeSettings 重写生效为止。

它需要采用在接下来的 30 天内的有效日期/时间格式。例如，2023-04-01T13：00：00Z。请注意，如果 --force-upgrade 设置为 true，并且未设置 --upgrade-override-until，则默认情况下，它将从现在起设置为 3 天。

--yes -y

不要提示确认。

属性	值
默认值:	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 aks upgrade (aks-preview 扩展)

将托管 Kubernetes 群集升级到较新的版本。

在群集升级期间，Kubernetes 将不可用。

az aks upgrade --name
               --resource-group
               [--aks-custom-headers]
               [--cluster-snapshot-id]
               [--control-plane-only]
               [--disable-force-upgrade]
               [--enable-force-upgrade]
               [--if-match]
               [--if-none-match]
               [--kubernetes-version]
               [--no-wait]
               [--node-image-only]
               [--upgrade-override-until]
               [--yes]

示例

将现有托管群集升级到托管群集快照。

az aks upgrade -g MyResourceGroup -n MyManagedCluster --cluster-snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/managedclustersnapshots/mysnapshot1"

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--aks-custom-headers

发送自定义标头。指定时，格式应为 Key1=Value1，Key2=Value2。

--cluster-snapshot-id

预览

源群集快照 ID 用于升级现有群集。

--control-plane-only

仅升级群集控制平面。如果未指定，控制平面和所有节点池都将升级。

属性	值
默认值:	False

--disable-force-upgrade

禁用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--enable-force-upgrade

启用 forceUpgrade 群集升级设置替代。

属性	值
默认值:	False

--if-match

如果与该操作匹配，则所提供的值将与托管群集的 ETag 进行比较。如果不匹配，将拒绝请求以防止意外覆盖。创建新群集时，不得指定此项。

--if-none-match

设置为“*”以允许创建新群集，但要防止更新现有群集。将忽略其他值。

--kubernetes-version -k

要将群集升级到的 Kubernetes 版本，例如“1.11.12”。

属性	值
值来源:	`az aks get-upgrades`

--no-wait

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

属性	值
默认值:	False

--node-image-only

仅升级代理池的节点映像。

属性	值
默认值:	False

--upgrade-override-until

直到群集 upgradeSettings 重写生效为止。

--yes -y

不要提示确认。

属性	值
默认值:	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 aks use-dev-spaces

编辑

已放弃

此命令已弃用，将在将来的版本中删除。

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用。

az aks use-dev-spaces --name
                      --resource-group
                      [--endpoint {None, Private, Public}]
                      [--space]
                      [--update]
                      [--yes]

示例

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，以交互方式选择开发空间。

az aks use-dev-spaces -g my-aks-group -n my-aks

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，更新到最新的 Azure Dev Spaces 客户端组件，并选择新的或现有的开发空间“my-space”。

az aks use-dev-spaces -g my-aks-group -n my-aks --update --space my-space

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，选择新的或现有的开发空间“开发/my-space”，而不提示进行确认。

az aks use-dev-spaces -g my-aks-group -n my-aks -s develop/my-space -y

将 Azure Dev Spaces 与专用终结点的托管 Kubernetes 群集配合使用。

az aks use-dev-spaces -g my-aks-group -n my-aks -e private

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--endpoint -e

要用于 Azure Dev Spaces 控制器的终结点类型。有关详细信息，请参阅 https://aka.ms/azds-networking。

属性	值
默认值:	Public
接受的值:	None, Private, Public

--space -s

要选择的新或现有开发空间的名称。默认为交互式选择体验。

--update

更新到最新的 Azure Dev Spaces 客户端组件。

属性	值
默认值:	False

--yes -y

不要提示确认。需要 --space。

属性	值
默认值:	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 aks use-dev-spaces (dev-spaces 扩展)

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用。

az aks use-dev-spaces --name
                      --resource-group
                      [--endpoint {None, Private, Public}]
                      [--space]
                      [--update]
                      [--yes]

示例

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，以交互方式选择开发空间。

az aks use-dev-spaces -g my-aks-group -n my-aks

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，更新到最新的 Azure Dev Spaces 客户端组件，并选择新的或现有的开发空间“my-space”。

az aks use-dev-spaces -g my-aks-group -n my-aks --update --space my-space

将 Azure Dev Spaces 与托管的 Kubernetes 群集配合使用，选择新的或现有的开发空间“开发/my-space”，而不提示进行确认。

az aks use-dev-spaces -g my-aks-group -n my-aks -s develop/my-space -y

将 Azure Dev Spaces 与专用终结点的托管 Kubernetes 群集配合使用。

az aks use-dev-spaces -g my-aks-group -n my-aks -e private

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--endpoint -e

要用于 Azure Dev Spaces 控制器的终结点类型。有关详细信息，请参阅 https://aka.ms/azds-networking。

属性	值
默认值:	Public
接受的值:	None, Private, Public

--space -s

要选择的新或现有开发空间的名称。默认为交互式选择体验。

--update

更新到最新的 Azure Dev Spaces 客户端组件。

属性	值
默认值:	False

--yes -y

不要提示确认。需要 --space。

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

编辑

等待托管 Kubernetes 群集达到所需状态。

如果群集上的操作中断或已启动 --no-wait，请使用此命令等待它完成。

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

示例

等待群集升级，每分钟轮询最多 30 分钟。

az aks wait -g MyResourceGroup -n MyManagedCluster --updated --interval 60 --timeout 1800

等待托管 Kubernetes 群集达到所需状态（自动生成）

az aks wait --created --interval 60 --name MyManagedCluster --resource-group MyResourceGroup --timeout 1800

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--created

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--custom

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

属性	值
Parameter group:	Wait Condition Arguments

--deleted

等到删除为止。

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--exists

等待资源存在。

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--interval

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	30

--timeout

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	3600

--updated

等到 provisioningState 更新为“Succeeded”。

属性	值
Parameter group:	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 aks wait (aks-preview 扩展)

等待托管 Kubernetes 群集达到所需状态。

如果群集上的操作中断或已启动 --no-wait，请使用此命令等待它完成。

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

示例

等待群集升级，每分钟轮询最多 30 分钟。

az aks wait -g MyResourceGroup -n MyManagedCluster --updated --interval 60 --timeout 1800

等待托管 Kubernetes 群集达到所需状态（自动生成）

az aks wait --created --interval 60 --name MyManagedCluster --resource-group MyResourceGroup --timeout 1800

必需参数

--name -n

托管群集的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

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

--created

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--custom

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

属性	值
Parameter group:	Wait Condition Arguments

--deleted

等到删除为止。

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--exists

等待资源存在。

属性	值
Parameter group:	Wait Condition Arguments
默认值:	False

--interval

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	30

--timeout

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

属性	值
Parameter group:	Wait Condition Arguments
默认值:	3600

--updated

等到 provisioningState 更新为“Succeeded”。

属性	值
Parameter group:	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

反馈

此页面是否有帮助？