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

az aks

参考

注意

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

管理 Azure Kubernetes 服务。

命令

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

az aks browse

编辑

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

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

示例

在 Web 浏览器中显示 Kubernetes 群集的仪表板。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--disable-browser

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

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

默认值: False

--listen-address

仪表板的侦听地址。

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

默认值: 127.0.0.1

--listen-port

仪表板的侦听端口。

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

默认值: 8001

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks browse (aks-preview 扩展)

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

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

示例

在 Web 浏览器中显示 Kubernetes 群集的仪表板。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--disable-browser

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

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

默认值: False

--listen-address

仪表板的侦听地址。

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

默认值: 127.0.0.1

--listen-port

仪表板的侦听端口。

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

默认值: 8001

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--node-name

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks create

编辑

新建托管 Kubernetes 群集。

az aks create --name
              --resource-group
              [--aad-admin-group-object-ids]
              [--aad-client-app-id]
              [--aad-server-app-id]
              [--aad-server-app-secret]
              [--aad-tenant-id]
              [--aci-subnet-name]
              [--admin-username]
              [--aks-custom-headers]
              [--ampls-resource-id]
              [--api-server-authorized-ip-ranges]
              [--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]
              [--ca-profile]
              [--client-secret]
              [--crg-id]
              [--data-collection-settings]
              [--defender-config]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-local-accounts]
              [--disable-public-fqdn]
              [--disable-rbac]
              [--disable-snapshot-controller]
              [--dns-name-prefix]
              [--dns-service-ip]
              [--docker-bridge-address]
              [--edge-zone]
              [--enable-aad]
              [--enable-addons]
              [--enable-ahub]
              [--enable-app-routing]
              [--enable-asm]
              [--enable-azure-container-storage {azureDisk, elasticSan, ephemeralDisk}]
              [--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-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]
              [--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]
              [--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-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]
              [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu}]
              [--outbound-type {loadBalancer, managedNATGateway, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--pod-cidrs]
              [--pod-subnet-id]
              [--ppg]
              [--private-dns-zone]
              [--revision]
              [--rotation-poll-interval]
              [--service-cidr]
              [--service-cidrs]
              [--service-principal]
              [--skip-subnet-role-assignment]
              [--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}]
              [--uptime-sla]
              [--vm-set-type]
              [--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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--aad-admin-group-object-ids

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

--aad-client-app-id

已放弃

选项“--aad-client-app-id”已弃用，将在将来的版本中删除。

类型为“Native”的 Azure Active Directory 客户端应用程序的 ID。此应用程序用于通过 kubectl 进行用户登录。

--aad-client-app-id 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--aad-server-app-id

已放弃

选项“--aad-server-app-id”已弃用，将在将来的版本中删除。

类型为“Web 应用/API”的 Azure Active Directory 服务器应用程序的 ID。此应用程序表示托管群集的 apiserver（服务器应用程序）。

--aad-server-app-id 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--aad-server-app-secret

已放弃

选项“--aad-server-app-secret”已弃用，将在将来的版本中删除。

Azure Active Directory 服务器应用程序的机密。

--aad-server-app-secret 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--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 流量限制到节点池。

--appgw-id

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

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-watch-namespace

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

--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 密钥库密钥的标识符。

--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。

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

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

--client-secret

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

--crg-id

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

--data-collection-settings

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

--defender-config

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

--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-snapshot-controller

禁用 CSI 快照控制器。

默认值: False

--dns-name-prefix -p

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

--dns-service-ip

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

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

--docker-bridge-address

已放弃

选项“--docker-bridge-address”已弃用，将在将来的版本中删除。

使用标准 CIDR 表示法为 Docker 桥指定 IP 地址和 netmask。

此地址不得位于任何子网 IP 范围或 Kubernetes 服务地址范围中。例如，172.17.0.1/16。

--edge-zone

边缘区域的名称。

--enable-aad

为群集启用托管 AAD 功能。

默认值: False

--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-app-routing

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

默认值: False

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

启用 Azure 服务网格加载项。

--enable-azure-container-storage

启用 Azure 容器存储并定义存储池类型。

接受的值: azureDisk, elasticSan, ephemeralDisk

--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, true

默认值: False

--enable-image-cleaner

启用 ImageCleaner 服务。

默认值: False

--enable-keda

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

默认值: False

--enable-managed-identity

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

--enable-msi-auth-for-monitoring

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

接受的值: false, true

默认值: True

--enable-node-public-ip

启用 VMSS 节点公共 IP。

默认值: False

--enable-oidc-issuer

启用 OIDC 颁发者。

默认值: False

--enable-private-cluster

启用专用群集。

默认值: False

--enable-secret-rotation

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

默认值: False

--enable-secure-boot

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

默认值: False

--enable-sgxquotehelper

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

默认值: False

--enable-syslog

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

接受的值: false, true

默认值: False

--enable-ultra-ssd

启用 UltraSSD，默认值为 false。

默认值: 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 公钥和私钥文件（如果缺少）。密钥将存储在 ~/.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 代理配置。

--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。

--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”。默认值为“kubenet”。

接受的值: azure, kubenet, none

--network-plugin-mode

要使用的网络插件模式。

用于控制网络插件应在其中运行的模式。例如，与 --network-plugin=azure 一起使用的“覆盖”将为群集中的 Pod 使用覆盖网络（非 VNET 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-public-ip-prefix-id

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

--node-public-ip-tags

节点公共 IP 的 ipTag。

--node-resource-group

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

--node-vm-size -s

要创建为 Kubernetes 节点的虚拟机的大小。

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

所有节点池的节点排斥。

--os-sku

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

接受的值: AzureLinux, CBLMariner, Mariner, Ubuntu

--outbound-type

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

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

接受的值: loadBalancer, managedNATGateway, userAssignedNATGateway, userDefinedRouting

--pod-cidr

CIDR 表示法 IP 范围，使用 kubenet 时从其中分配 Pod IP。

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

--pod-cidrs

CIDR 表示法 IP 范围的逗号分隔列表，在使用 kubenet 时，从中分配 Pod IP。

每个范围不得与任何子网 IP 范围重叠。例如，“172.244.0.0/16，fd0：abcd：：/64”。

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

CIDR 表示法 IP 范围，从其中分配服务群集 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

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

--uptime-sla

已放弃

选项“--uptime-sla”已弃用，将在将来的版本中删除。

--uptime-sla 已弃用。请改用“层标准”。

默认值: False

--vm-set-type

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

--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/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/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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks create (aks-preview 扩展)

新建托管 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 {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]
              [--ca-profile]
              [--client-secret]
              [--cluster-service-load-balancer-health-probe-mode {Servicenodeport, Shared}]
              [--cluster-snapshot-id]
              [--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-snapshot-controller]
              [--disk-driver-version {v1, v2}]
              [--dns-name-prefix]
              [--dns-service-ip]
              [--dns-zone-resource-id]
              [--dns-zone-resource-ids]
              [--docker-bridge-address]
              [--edge-zone]
              [--enable-aad]
              [--enable-acns]
              [--enable-addon-autoscaling]
              [--enable-addons]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-app-routing]
              [--enable-asm]
              [--enable-azure-container-storage {azureDisk, elasticSan, ephemeralDisk}]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-app-monitoring]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-azuremonitormetrics]
              [--enable-blob-driver]
              [--enable-cilium-dataplane]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-custom-ca-trust]
              [--enable-defender]
              [--enable-encryption-at-host]
              [--enable-fips-image]
              [--enable-high-log-scale-mode {false, true}]
              [--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-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--enable-pod-security-policy]
              [--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]
              [--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]
              [--node-os-upgrade-channel {NodeImage, None, SecurityPatch, Unmanaged}]
              [--node-osdisk-diskencryptionset-id]
              [--node-osdisk-size]
              [--node-osdisk-type {Ephemeral, Managed}]
              [--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, CBLMariner, Mariner, Ubuntu}]
              [--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

创建启用了自定义 CA 信任的 kubernetes 群集。

az aks create -g MyResourceGroup -n MyManagedCluster --enable-custom-ca-trust

创建一个 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

创建具有 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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

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

发送自定义标头。指定时，格式应为 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 加载项一起使用。

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-watch-namespace

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

--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 密钥库密钥的标识符。

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

Azure 密钥库的网络访问。

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

接受的值: Private, Public

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

默认值: Direct

--bootstrap-container-registry-resource-id

预览

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

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

预览

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

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

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

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

--client-secret

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

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

预览

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

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

接受的值: Servicenodeport, Shared

--cluster-snapshot-id

预览

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

--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-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-id

已放弃

选项“--dns-zone-resource-id”已弃用，将在将来的版本中删除。请改用“--dns-zone-resource-ids”。

要用于web_application_routing加载项的 DNS 区域资源的资源 ID。

--dns-zone-resource-ids

预览

要用于web_application_routing加载项的 DNS 区域资源的资源 ID 的逗号分隔列表。

--docker-bridge-address

已放弃

选项“--docker-bridge-address”已弃用，将在将来的版本中删除。

使用标准 CIDR 表示法为 Docker 桥指定 IP 地址和 netmask。

此地址不得位于任何子网 IP 范围或 Kubernetes 服务地址范围中。例如，172.17.0.1/16。

--edge-zone

边缘区域的名称。

--enable-aad

为群集启用托管 AAD 功能。

默认值: False

--enable-acns

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

--enable-addon-autoscaling

预览

为群集启用加载项自动缩放。

默认值: False

--enable-addons -a

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

这些加载项可用：

http_application_routing：使用自动公共 DNS 名称创建配置入口。
监视：启用 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：启用 Web 应用程序路由加载项（预览版）。指定“--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 容器存储并定义存储池类型。

接受的值: azureDisk, elasticSan, ephemeralDisk

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

默认值: False

--enable-azure-monitor-app-monitoring

预览

启用 Azure Monitor 应用程序监视。

默认值: False

--enable-azure-monitor-metrics

启用 Azure Monitor 指标配置文件。

默认值: False

--enable-azure-rbac

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

默认值: False

--enable-azuremonitormetrics

已放弃

选项“--enable-azuremonitormetrics”已弃用，将在将来的版本中删除。请改用“--enable-azure-monitor-metrics”。

启用 Azure Monitor 指标配置文件。

默认值: False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cilium-dataplane

预览已放弃

选项“--enable-cilium-dataplane”已弃用，将在将来的版本中删除。请改用“--network-dataplane”。

使用 Cilium 作为 Kubernetes 群集的网络数据平面。

与“azure”网络插件一起使用。需要 --pod-subnet-id 或 --network-plugin-mode=overlay。此标志已弃用，转而支持 --network-dataplane=cilium。

默认值: False

--enable-cluster-autoscaler

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

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

默认值: False

--enable-cost-analysis

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

默认值: False

--enable-custom-ca-trust

在代理节点池上启用自定义 CA 信任。

默认值: False

--enable-defender

启用 Microsoft Defender 安全配置文件。

默认值: False

--enable-encryption-at-host

在代理节点池上启用 EncryptionAtHost。

默认值: False

--enable-fips-image

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

默认值: False

--enable-high-log-scale-mode

预览

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

接受的值: false, true

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

接受的值: false, true

默认值: True

--enable-node-public-ip

启用 VMSS 节点公共 IP。

默认值: False

--enable-oidc-issuer

启用 OIDC 颁发者。

默认值: False

--enable-pod-identity

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

默认值: False

--enable-pod-identity-with-kubenet

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

默认值: False

--enable-pod-security-policy

已放弃

选项“--enable-pod-security-policy”已弃用，将在将来的版本中删除。

启用 Pod 安全策略。

--enable-pod-security-policy 已弃用。有关详细信息，请参阅https://aka.ms/aks/psp。

默认值: False

--enable-private-cluster

启用专用群集。

默认值: False

--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, true

默认值: False

--enable-ultra-ssd

在代理节点池上启用 UltraSSD。

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

--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-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 节点的虚拟机的大小。

--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 或 CBLMariner。

接受的值: AzureLinux, CBLMariner, Mariner, Ubuntu

--outbound-type

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

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

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

--pod-cidr

CIDR 表示法 IP 范围，使用 kubenet 时从其中分配 Pod IP。

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

--pod-cidrs

使用 kubenet 时，CIDR 表示法 IP 范围的逗号分隔列表。

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

--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 区域模式。 “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

CIDR 表示法 IP 范围，从其中分配服务群集 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 访问。

接受的值: disabled, localuser

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

接受的值: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi

默认值: OCIContainer

--workspace-resource-id

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

--yes -y

不提示确认。

默认值: False

--zones -z

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks delete

编辑

删除托管的 Kubernetes 群集。

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

示例

删除托管的 Kubernetes 群集。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--no-wait

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

默认值: False

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks delete (aks-preview 扩展)

删除托管的 Kubernetes 群集。

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

示例

删除托管的 Kubernetes 群集。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--if-match

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

--ignore-pod-disruption-budget

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

--no-wait

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

默认值: False

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks disable-addons

编辑

禁用 Kubernetes 加载项。

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

示例

禁用 Kubernetes 加载项。（自动生成）

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks disable-addons (aks-preview 扩展)

禁用 Kubernetes 加载项。

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

示例

禁用 Kubernetes 加载项。（自动生成）

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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 加载项。（自动生成）

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> 配置默认组。

可选参数

--ampls-resource-id

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

--appgw-id

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

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-watch-namespace

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

--data-collection-settings

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

--enable-high-log-scale-mode

预览

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

接受的值: false, true

默认值: False

--enable-msi-auth-for-monitoring

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

接受的值: false, true

默认值: True

--enable-secret-rotation

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

默认值: False

--enable-sgxquotehelper

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

默认值: False

--enable-syslog

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

接受的值: false, true

默认值: False

--no-wait

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

默认值: False

--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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 - 启用 Web 应用程序路由加载项（预览版）。指定“--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-subnet-prefix]
                     [--appgw-watch-namespace]
                     [--data-collection-settings]
                     [--dns-zone-resource-id]
                     [--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 加载项。（自动生成）

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> 配置默认组。

可选参数

--aks-custom-headers

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

--ampls-resource-id

预览

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

--appgw-id

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

--appgw-name

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

--appgw-subnet-cidr

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

--appgw-subnet-id

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

--appgw-subnet-prefix

已放弃

参数“appgw_subnet_prefix”已弃用，将在将来的版本中删除。请改用“--appgw-subnet-cidr”。

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

--appgw-watch-namespace

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

--data-collection-settings

预览

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

--dns-zone-resource-id

已放弃

选项“--dns-zone-resource-id”已弃用，将在将来的版本中删除。请改用“--dns-zone-resource-ids”。

要用于web_application_routing加载项的 DNS 区域资源的资源 ID。

--dns-zone-resource-ids

预览

要用于web_application_routing加载项的 DNS 区域资源的资源 ID 的逗号分隔列表。

--enable-high-log-scale-mode

预览

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

接受的值: false, true

默认值: False

--enable-msi-auth-for-monitoring

预览

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

接受的值: false, true

默认值: True

--enable-secret-rotation

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

默认值: False

--enable-sgxquotehelper

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

默认值: False

--enable-syslog

预览

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

接受的值: false, true

默认值: False

--no-wait

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

默认值: False

--rotation-poll-interval

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

--subnet-name -s

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

--workspace-resource-id

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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 群集的访问凭据。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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 群集的访问凭据。（自动生成）

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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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]

可选参数

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks kanalyze

完成 kollect 后显示 Kubernetes 群集的诊断结果。

az aks kanalyze --name
                --resource-group

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks list

编辑

列出托管 Kubernetes 群集。

az aks list [--resource-group]

可选参数

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks list (aks-preview 扩展)

列出托管 Kubernetes 群集。

az aks list [--resource-group]

可选参数

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--aks-custom-headers

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

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks scale

编辑

缩放托管 Kubernetes 群集中的节点池。

az aks scale --name
             --node-count
             --resource-group
             [--no-wait]
             [--nodepool-name]

示例

缩放托管 Kubernetes 群集中的节点池。（自动生成）

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

--nodepool-name

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--aks-custom-headers

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

--no-wait

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

默认值: False

--nodepool-name

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--aks-custom-headers

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks stop

编辑

停止托管群集。

这只能在 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> 配置默认组。

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks stop (aks-preview 扩展)

停止托管群集。

az aks stop --name
            --resource-group
            [--no-wait]

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--no-wait

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

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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]
              [--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]
              [--ca-profile]
              [--defender-config]
              [--detach-acr]
              [--disable-ahub]
              [--disable-azure-container-storage {all, azureDisk, elasticSan, ephemeralDisk}]
              [--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-public-fqdn]
              [--disable-secret-rotation]
              [--disable-snapshot-controller]
              [--disable-vpa]
              [--disable-windows-gmsa]
              [--disable-workload-identity]
              [--enable-aad]
              [--enable-ahub]
              [--enable-azure-container-storage {azureDisk, elasticSan, ephemeralDisk}]
              [--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-public-fqdn]
              [--enable-secret-rotation]
              [--enable-snapshot-controller]
              [--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]
              [--image-cleaner-interval-hours]
              [--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]
              [--max-count]
              [--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-uptime-sla]
              [--no-wait]
              [--node-os-upgrade-channel]
              [--nodepool-labels]
              [--nodepool-taints]
              [--outbound-type {loadBalancer, managedNATGateway, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--private-dns-zone]
              [--rotation-poll-interval]
              [--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]
              [--uptime-sla]
              [--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

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--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 流量限制到节点池。

--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 密钥库密钥的标识符。

--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。

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

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

--defender-config

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

--detach-acr

禁用按名称或资源 ID 指定的 ACR 的“acrpull”角色分配。

--disable-ahub

禁用群集的 Azure 混合用户权益（AHUB）功能。

默认值: False

--disable-azure-container-storage

禁用 Azure 容器存储或任何一种存储池类型。

接受的值: all, azureDisk, elasticSan, ephemeralDisk

--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-public-fqdn

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

默认值: False

--disable-secret-rotation

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

默认值: False

--disable-snapshot-controller

禁用 CSI 快照控制器。

默认值: False

--disable-vpa

禁用群集的垂直 Pod 自动缩放程序。

默认值: False

--disable-windows-gmsa

在群集上禁用 Windows gmsa。

默认值: False

--disable-workload-identity

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

默认值: False

--enable-aad

为群集启用托管 AAD 功能。

默认值: False

--enable-ahub

为群集启用 Azure 混合用户权益（AHUB）功能。

默认值: False

--enable-azure-container-storage

启用 Azure 容器存储并定义存储池类型。

接受的值: azureDisk, elasticSan, ephemeralDisk

--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-public-fqdn

为专用群集启用公共 fqdn 功能。

默认值: False

--enable-secret-rotation

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

默认值: False

--enable-snapshot-controller

启用快照控制器。

默认值: 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 代理配置。

--image-cleaner-interval-hours

ImageCleaner 扫描间隔。

--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 数的默认分配。

--max-count

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

--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-uptime-sla

已放弃

选项“--no-uptime-sla”已弃用，将在将来的版本中删除。

将标准托管群集更改为免费群集。 --no-uptime-sla 已弃用。请改用“--tier free”。

默认值: False

--no-wait

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

默认值: False

--node-os-upgrade-channel

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

--nodepool-labels

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

--nodepool-taints

所有节点池的节点排斥。

--outbound-type

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

此选项将更改在 AKS 群集中管理出站连接的方式。可用选项包括 loadbalancer、managedNATGateway、userAssignedNATGateway、userDefinedRouting。对于自定义 vnet，支持 loadbalancer、userAssignedNATGateway 和 userDefinedRouting。支持 aks 托管 vnet、loadbalancer、managedNATGateway 和 userDefinedRouting。

接受的值: loadBalancer, managedNATGateway, userAssignedNATGateway, userDefinedRouting

--pod-cidr

更新群集的 Pod CIDR。将群集从 Azure CNI 更新到 Azure CNI 覆盖时使用。

--private-dns-zone

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

仅允许将专用 DNS 区域从 byo/system 模式更改为非专用群集。其他人被拒绝。

--rotation-poll-interval

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

--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 天。

--uptime-sla

已放弃

选项“--uptime-sla”已弃用，将在将来的版本中删除。

使用经济支持的 SLA 启用标准托管群集服务。 --uptime-sla 已弃用。请改用“层标准”。

默认值: False

--windows-admin-password

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

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks update (aks-preview 扩展)

更新托管 Kubernetes 群集的属性。

更新托管 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]
              [--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]
              [--ca-profile]
              [--cluster-service-load-balancer-health-probe-mode {Servicenodeport, Shared}]
              [--cluster-snapshot-id]
              [--defender-config]
              [--detach-acr]
              [--disable-acns]
              [--disable-acns-observability]
              [--disable-acns-security]
              [--disable-addon-autoscaling]
              [--disable-ahub]
              [--disable-ai-toolchain-operator]
              [--disable-azure-container-storage {all, azureDisk, elasticSan, ephemeralDisk}]
              [--disable-azure-keyvault-kms]
              [--disable-azure-monitor-app-monitoring]
              [--disable-azure-monitor-metrics]
              [--disable-azure-rbac]
              [--disable-azuremonitormetrics]
              [--disable-blob-driver]
              [--disable-cluster-autoscaler]
              [--disable-cost-analysis]
              [--disable-defender]
              [--disable-disk-driver]
              [--disable-file-driver]
              [--disable-force-upgrade]
              [--disable-image-cleaner]
              [--disable-image-integrity]
              [--disable-imds-restriction]
              [--disable-keda]
              [--disable-local-accounts]
              [--disable-pod-identity]
              [--disable-pod-security-policy]
              [--disable-private-cluster]
              [--disable-public-fqdn]
              [--disable-secret-rotation]
              [--disable-snapshot-controller]
              [--disable-static-egress-gateway]
              [--disable-vpa]
              [--disable-workload-identity]
              [--disk-driver-version {v1, v2}]
              [--enable-aad]
              [--enable-acns]
              [--enable-addon-autoscaling]
              [--enable-ahub]
              [--enable-ai-toolchain-operator]
              [--enable-apiserver-vnet-integration]
              [--enable-azure-container-storage {azureDisk, elasticSan, ephemeralDisk}]
              [--enable-azure-keyvault-kms]
              [--enable-azure-monitor-app-monitoring]
              [--enable-azure-monitor-metrics]
              [--enable-azure-rbac]
              [--enable-azuremonitormetrics]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-defender]
              [--enable-disk-driver]
              [--enable-file-driver]
              [--enable-force-upgrade]
              [--enable-image-cleaner]
              [--enable-image-integrity]
              [--enable-imds-restriction]
              [--enable-keda]
              [--enable-local-accounts]
              [--enable-managed-identity]
              [--enable-oidc-issuer]
              [--enable-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--enable-pod-security-policy]
              [--enable-private-cluster]
              [--enable-public-fqdn]
              [--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]
              [--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]
              [--max-count]
              [--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]
              [--node-os-upgrade-channel {NodeImage, None, SecurityPatch, Unmanaged}]
              [--node-provisioning-mode {Auto, Manual}]
              [--nodepool-labels]
              [--nodepool-taints]
              [--nrg-lockdown-restriction-level {ReadOnly, Unrestricted}]
              [--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]
              [--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

禁用 Pod 安全策略。

az aks update --disable-pod-security-policy -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 Policy 加载项已启用

az aks update -g MyResourceGroup -n MyManagedCluster --safeguards-excluded-ns ""

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--aad-admin-group-object-ids

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

--aad-tenant-id

Azure Active Directory 租户的 ID。

--aks-custom-headers

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

--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 密钥库密钥的标识符。

--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 信任。

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

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

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

预览

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

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

接受的值: Servicenodeport, Shared

--cluster-snapshot-id

预览

源群集快照 ID 用于更新现有群集。

--defender-config

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

--detach-acr

禁用按名称或资源 ID 指定的 ACR 的“acrpull”角色分配。

--disable-acns

禁用群集上的所有高级网络功能。

--disable-acns-observability

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

--disable-acns-security

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

--disable-addon-autoscaling

预览

禁用群集的加载项自动缩放。

默认值: False

--disable-ahub

禁用群集的 Azure 混合用户权益（AHUB）功能。

默认值: False

--disable-ai-toolchain-operator

预览

禁用 AI 工具链运算符。

默认值: False

--disable-azure-container-storage

禁用 Azure 容器存储或任何一种存储池类型。

接受的值: all, azureDisk, elasticSan, ephemeralDisk

--disable-azure-keyvault-kms

禁用 Azure KeyVault 密钥管理服务。

默认值: False

--disable-azure-monitor-app-monitoring

预览

禁用 Azure Monitor 应用程序监视。

默认值: False

--disable-azure-monitor-metrics

禁用 Azure Monitor 指标配置文件。这将删除与群集关联的所有 DCRA、数据流为 prometheus-stream 的所有链接 DCR 以及此 AKS 群集的加载项创建的录制规则组。

默认值: False

--disable-azure-rbac

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

默认值: False

--disable-azuremonitormetrics

已放弃

选项“--disable-azuremonitormetrics”已弃用，将在将来的版本中删除。请改用“--disable-azure-monitor-metrics”。

禁用 Azure Monitor 指标配置文件。这将删除与群集关联的所有 DCRA、数据流为 prometheus-stream 的所有链接 DCR 以及此 AKS 群集的加载项创建的录制规则组。

默认值: 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-image-integrity

预览

禁用 ImageIntegrity 服务。

默认值: False

--disable-imds-restriction

预览

在群集中禁用 IMDS 限制。群集中的所有 Pod 都可以访问 IMDS。

默认值: False

--disable-keda

预览

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

默认值: False

--disable-local-accounts

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

默认值: False

--disable-pod-identity

（预览）禁用群集的 Pod 标识加载项。

默认值: False

--disable-pod-security-policy

预览

禁用 Pod 安全策略。

PodSecurityPolicy 已弃用。有关详细信息，请参阅https://aka.ms/aks/psp。

默认值: False

--disable-private-cluster

预览

为 apiserver vnet 集成群集禁用专用群集。

默认值: False

--disable-public-fqdn

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

默认值: False

--disable-secret-rotation

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

默认值: False

--disable-snapshot-controller

禁用 CSI 快照控制器。

默认值: False

--disable-static-egress-gateway

预览

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

默认值: 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-addon-autoscaling

预览

为群集启用加载项自动缩放。

默认值: False

--enable-ahub

为群集启用 Azure 混合用户权益（AHUB）功能。

默认值: False

--enable-ai-toolchain-operator

预览

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

默认值: False

--enable-apiserver-vnet-integration

预览

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

默认值: False

--enable-azure-container-storage

启用 Azure 容器存储并定义存储池类型。

接受的值: azureDisk, elasticSan, ephemeralDisk

--enable-azure-keyvault-kms

启用 Azure KeyVault 密钥管理服务。

默认值: False

--enable-azure-monitor-app-monitoring

预览

启用 Azure Monitor 应用程序监视。

默认值: False

--enable-azure-monitor-metrics

启用 Azure Monitor 指标配置文件。

默认值: False

--enable-azure-rbac

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

默认值: False

--enable-azuremonitormetrics

已放弃

选项“--enable-azuremonitormetrics”已弃用，将在将来的版本中删除。请改用“--enable-azure-monitor-metrics”。

启用 Azure Monitor 指标配置文件。

默认值: 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-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-oidc-issuer

启用 OIDC 颁发者。

默认值: False

--enable-pod-identity

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

默认值: False

--enable-pod-identity-with-kubenet

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

默认值: False

--enable-pod-security-policy

已放弃

选项“--enable-pod-security-policy”已弃用，将在将来的版本中删除。

启用 Pod 安全策略。

--enable-pod-security-policy 已弃用。有关详细信息，请参阅https://aka.ms/aks/psp。

默认值: False

--enable-private-cluster

预览

为 apiserver vnet 集成群集启用专用群集。

默认值: False

--enable-public-fqdn

为专用群集启用公共 fqdn 功能。

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

--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 的值。

--max-count

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

--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-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 和 block。对于自定义 vnet，支持 loadbalancer、userAssignedNATGateway 和 userDefinedRouting。支持 aks 托管 vnet、loadbalancer、managedNATGateway 和 userDefinedRouting。

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

--pod-cidr

CIDR 表示法 IP 范围，使用 kubenet 时从其中分配 Pod 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.

--yes -y

不提示确认。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks update-credentials

编辑

更新托管 Kubernetes 群集（例如服务主体）的凭据。

az aks update-credentials --name
                          --resource-group
                          [--aad-client-app-id]
                          [--aad-server-app-id]
                          [--aad-server-app-secret]
                          [--aad-tenant-id]
                          [--client-secret]
                          [--no-wait]
                          [--reset-aad]
                          [--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> 配置默认组。

可选参数

--aad-client-app-id

已放弃

选项“--aad-client-app-id”已弃用，将在将来的版本中删除。

Azure Active Directory 客户端应用程序的 ID。如果 --reset-aad 指定此参数，则需要此参数。

--aad-client-app-id 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--aad-server-app-id

已放弃

选项“--aad-server-app-id”已弃用，将在将来的版本中删除。

Azure Active Directory 服务器应用程序的 ID。如果 --reset-aad 指定此参数，则需要此参数。

--aad-server-app-id 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--aad-server-app-secret

已放弃

选项“--aad-server-app-secret”已弃用，将在将来的版本中删除。

Azure Active Directory 服务器应用程序的机密。如果 --reset-aad 指定此参数，则需要此参数。

--aad-server-app-secret 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

--aad-tenant-id

已放弃

选项“--aad-tenant-id”已弃用，将在将来的版本中删除。

与 Azure Active Directory 关联的租户 ID。

--client-secret

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

--no-wait

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

默认值: False

--reset-aad

已放弃

选项“--reset-aad”已弃用，将在将来的版本中删除。

重置托管群集的 Azure Active Directory 配置。

--reset-aad 已弃用。有关详细信息，请参阅https://aka.ms/aks/aad-legacy。

默认值: False

--reset-service-principal

重置托管群集的服务主体。

默认值: False

--service-principal

用于对 Azure API 进行身份验证的服务主体。如果 --reset-service-principal 指定此参数，则需要此参数。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az aks upgrade

编辑

将托管 Kubernetes 群集升级到较新的版本。

在群集升级期间，Kubernetes 将不可用。

az aks upgrade --name
               --resource-group
               [--control-plane-only]
               [--disable-force-upgrade]
               [--enable-force-upgrade]
               [--k8s-support-plan {AKSLongTermSupport, KubernetesOfficial}]
               [--kubernetes-version]
               [--no-wait]
               [--node-image-only]
               [--tier {free, premium, standard}]
               [--upgrade-override-until]
               [--yes]

示例

将托管 Kubernetes 群集升级到较新的版本。（自动生成）

az aks upgrade --kubernetes-version 1.12.6 --name MyManagedCluster --resource-group MyResourceGroup

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--control-plane-only

仅升级群集控制平面。如果未指定，则同时升级控制平面和所有节点池。

默认值: False

--disable-force-upgrade

禁用 forceUpgrade 群集升级设置替代。

默认值: False

--enable-force-upgrade

启用 forceUpgrade 群集升级设置替代。

默认值: False

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

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

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--endpoint -e

要用于 Azure Dev Spaces 控制器的终结点类型。有关详细信息，请参阅https://aka.ms/azds-networking。

接受的值: None, Private, Public

默认值: Public

--space -s

要选择的新或现有开发空间的名称。默认为交互式选择体验。

--update

更新到最新的 Azure Dev Spaces 客户端组件。

默认值: False

--yes -y

不提示确认。需要 --space。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--endpoint -e

要用于 Azure Dev Spaces 控制器的终结点类型。有关详细信息，请参阅https://aka.ms/azds-networking。

接受的值: None, Private, Public

默认值: Public

--space -s

要选择的新或现有开发空间的名称。默认为交互式选择体验。

--update

更新到最新的 Azure Dev Spaces 客户端组件。

默认值: False

--yes -y

不提示确认。需要 --space。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--created

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

默认值: False

--custom

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

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--interval

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

默认值: 30

--timeout

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

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

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> 配置默认组。

可选参数

--created

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

默认值: False

--custom

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

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--interval

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

默认值: 30

--timeout

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

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: False

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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