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

az aks

注意

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

管理 Azure Kubernetes 服务。

命令

名称	说明	类型	状态
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 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	设置 GitHub OIDC 并生成 GitHub 工作流，以便自动生成并部署到 AKS。	扩展	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-os-options	获取可用于创建托管 Kubernetes 群集的 OS 选项。	扩展	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-egress-gateway	禁用 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-egress-gateway	启用 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 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 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	用于管理 nodepool 快照的命令。	核心和扩展	GA
az aks nodepool snapshot create	创建 nodepool 快照。	核心	GA
az aks nodepool snapshot create (aks-preview 扩展)	创建 nodepool 快照。	扩展	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	更新节点池快照上的标记。	核心	GA
az aks nodepool snapshot update (aks-preview 扩展)	更新节点池快照上的标记。	扩展	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-abort	中止托管群集上的上次运行操作。	核心	GA
az aks operation-abort (aks-preview 扩展)	中止托管群集上的上次运行操作。	扩展	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	用于管理 nodepool 快照的命令。	核心和扩展	已放弃
az aks snapshot create	创建 nodepool 快照。	核心	已放弃
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-tenant-id]
              [--aci-subnet-name]
              [--admin-username]
              [--aks-custom-headers]
              [--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]
              [--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-defender]
              [--enable-encryption-at-host]
              [--enable-fips-image]
              [--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-sgxquotehelper]
              [--enable-syslog {false, true}]
              [--enable-ultra-ssd]
              [--enable-vpa]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--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, 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}]
              [--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

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

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

创建具有默认 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-tenant-id

Azure Active Directory 租户的 ID。

--aci-subnet-name

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

--admin-username -u

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

默认值: azureuser

--aks-custom-headers

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

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

--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”来配置数据收集设置（如果启用了监视加载项 --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-defender

启用 Microsoft Defender 安全配置文件。

默认值: False

--enable-encryption-at-host

启用 EncryptionAtHost，默认值为 false。

默认值: False

--enable-fips-image

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

默认值: False

--enable-image-cleaner

启用 ImageCleaner 服务。

默认值: False

--enable-keda

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

默认值: False

--enable-managed-identity

使用系统分配的托管标识来管理群集资源组。

默认值: True

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

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

默认值: False

--enable-syslog

预览

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

接受的值: false, true

默认值: False

--enable-ultra-ssd

启用 UltraSSD，默认值为 false。

默认值: False

--enable-vpa

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

默认值: False

--enable-windows-gmsa

启用 Windows gmsa。

默认值: False

--enable-windows-recording-rules

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

默认值: False

--enable-workload-identity

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

默认值: False

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

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

要使用的 Kubernetes 网络策略。

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

--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, 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 进行身份验证的服务主体。

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

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

--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]
              [--api-server-authorized-ip-ranges]
              [--apiserver-subnet-id]
              [--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-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-ids]
              [--edge-zone]
              [--enable-aad]
              [--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-metrics]
              [--enable-azure-rbac]
              [--enable-blob-driver]
              [--enable-cluster-autoscaler]
              [--enable-cost-analysis]
              [--enable-custom-ca-trust]
              [--enable-defender]
              [--enable-encryption-at-host]
              [--enable-fips-image]
              [--enable-image-cleaner]
              [--enable-image-integrity]
              [--enable-keda]
              [--enable-managed-identity]
              [--enable-msi-auth-for-monitoring {false, true}]
              [--enable-network-observability]
              [--enable-node-public-ip]
              [--enable-node-restriction]
              [--enable-oidc-issuer]
              [--enable-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--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]
              [--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]
              [--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 {loadBalancer, managedNATGateway, 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]
              [--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

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

必需参数

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

--api-server-authorized-ip-ranges

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

--apiserver-subnet-id

预览

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

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

预览

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

--edge-zone

边缘区域的名称。

--enable-aad

为群集启用托管 AAD 功能。

默认值: False

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

启用 Azure Monitor 指标配置文件。

默认值: False

--enable-azure-rbac

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

默认值: False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler

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

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

默认值: False

--enable-cost-analysis

预览

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

默认值: False

--enable-custom-ca-trust

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

默认值: False

--enable-defender

启用 Microsoft Defender 安全配置文件。

默认值: False

--enable-encryption-at-host

在代理节点池上启用 EncryptionAtHost。

默认值: False

--enable-fips-image

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

默认值: False

--enable-image-cleaner

启用 ImageCleaner 服务。

默认值: False

--enable-image-integrity

启用 ImageIntegrity 服务。

默认值: False

--enable-keda

预览

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

默认值: False

--enable-managed-identity

使用托管标识管理群集资源组。 默认值为 true，可以显式指定“--client-id”和“--secret”以禁用托管标识。

默认值: True

--enable-msi-auth-for-monitoring

预览

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

接受的值: false, true

默认值: True

--enable-network-observability

预览

在群集上启用网络可观测性。

--enable-node-public-ip

启用 VMSS 节点公共 IP。

默认值: False

--enable-node-restriction

预览

为群集启用节点限制。

默认值: False

--enable-oidc-issuer

启用 OIDC 颁发者。

默认值: False

--enable-pod-identity

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

默认值: False

--enable-pod-identity-with-kubenet

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

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

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

--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 代理配置。

--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=[]”。

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

位置。 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 之间进行选择。 如果未设置，则默认为 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

使用 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”使用 List保险箱guardsVersions 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

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

--ssh-access

预览

为此群集中的所有节点池配置 SSH 设置。 使用“disabled”禁用 SSH 访问，使用“localuser”通过私钥启用 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（预览版）。

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

可选参数

--ignore-pod-disruption-budget

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

--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 --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
                     [--appgw-id]
                     [--appgw-name]
                     [--appgw-subnet-cidr]
                     [--appgw-subnet-id]
                     [--appgw-watch-namespace]
                     [--data-collection-settings]
                     [--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> 配置默认组。

可选参数

--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-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]
                     [--appgw-id]
                     [--appgw-name]
                     [--appgw-subnet-cidr]
                     [--appgw-subnet-id]
                     [--appgw-watch-namespace]
                     [--data-collection-settings]
                     [--dns-zone-resource-ids]
                     [--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。

--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 应监视的命名空间。 可以是单个字符串值，也可以是命名空间的逗号分隔列表。 与 ingress-azure 加载项一起使用。

--data-collection-settings

预览

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

--dns-zone-resource-ids

预览

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

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

获取可用于创建托管 Kubernetes 群集的 OS 选项。

az aks get-os-options --location

示例

获取可用于创建托管 Kubernetes 群集的 OS 选项

az aks get-os-options --location westus2

必需参数

--location -l

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

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

位置。 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 扩展)

停止托管群集。

这只能在 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 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-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-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]
              [--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]
              [--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]
              [--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-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-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

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

将在资源标签指标中使用的其他 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=[]”。

--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 负载均衡器群集。 如果新值大于原始值，则会创建新的其他出站 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”，为由 Cilium 提供支持的 Azure CNI 指定“cilium”。 默认为“”（网络策略已禁用）。

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

在群集升级之前设置替代生效。 它需要采用在接下来的 30 天内的有效日期/时间格式。 例如，2023-04-01T13：00：00Z。 请注意，如果 --force-upgrade 设置为 true，并且未设置 --upgrade-override-until，则默认情况下，它将从现在起设置为 3 天。

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

--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-addon-autoscaling]
              [--disable-ahub]
              [--disable-ai-toolchain-operator]
              [--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-image-integrity]
              [--disable-keda]
              [--disable-local-accounts]
              [--disable-network-observability]
              [--disable-node-restriction]
              [--disable-pod-identity]
              [--disable-pod-security-policy]
              [--disable-private-cluster]
              [--disable-public-fqdn]
              [--disable-secret-rotation]
              [--disable-snapshot-controller]
              [--disable-vpa]
              [--disable-workload-identity]
              [--disk-driver-version {v1, v2}]
              [--enable-aad]
              [--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-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-image-integrity]
              [--enable-keda]
              [--enable-local-accounts]
              [--enable-managed-identity]
              [--enable-network-observability]
              [--enable-node-restriction]
              [--enable-oidc-issuer]
              [--enable-pod-identity]
              [--enable-pod-identity-with-kubenet]
              [--enable-private-cluster]
              [--enable-public-fqdn]
              [--enable-secret-rotation]
              [--enable-snapshot-controller]
              [--enable-vpa]
              [--enable-windows-gmsa]
              [--enable-windows-recording-rules]
              [--enable-workload-identity]
              [--gmsa-dns-server]
              [--gmsa-root-domain-name]
              [--grafana-resource-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]
              [--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 {loadBalancer, managedNATGateway, userAssignedNATGateway, userDefinedRouting}]
              [--pod-cidr]
              [--private-dns-zone]
              [--rotation-poll-interval]
              [--safeguards-excluded-ns]
              [--safeguards-level {Enforcement, Off, Warning}]
              [--safeguards-version]
              [--sku {automatic, base}]
              [--ssh-access {disabled, localuser}]
              [--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 集成群集或非 AAAAD 群集迁移到 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-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-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-image-integrity

预览

禁用 ImageIntegrity 服务。

默认值: False

--disable-keda

预览

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

默认值: False

--disable-local-accounts

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

默认值: False

--disable-network-observability

预览

在群集上禁用网络可观测性。

--disable-node-restriction

预览

在群集上禁用节点限制选项。

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

预览

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

默认值: False

--disable-workload-identity

（预览）禁用群集的工作负荷标识加载项。

默认值: False

--disk-driver-version

指定 AzureDisk CSI 驱动程序版本。

接受的值: v1, v2

--enable-aad

为群集启用托管 AAD 功能。

默认值: False

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

启用 Azure Monitor 指标配置文件。

默认值: False

--enable-azure-rbac

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

默认值: False

--enable-blob-driver

启用 AzureBlob CSI 驱动程序。

--enable-cluster-autoscaler -e

启用群集自动缩放程序。

默认值: False

--enable-cost-analysis

预览

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

默认值: False

--enable-defender

启用 Microsoft Defender 安全配置文件。

默认值: False

--enable-disk-driver

启用 AzureDisk CSI 驱动程序。

默认值: False

--enable-file-driver

启用 AzureFile CSI 驱动程序。

默认值: False

--enable-force-upgrade

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

默认值: False

--enable-image-cleaner

启用 ImageCleaner 服务。

默认值: False

--enable-image-integrity

启用 ImageIntegrity 服务。

默认值: False

--enable-keda

预览

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

默认值: False

--enable-local-accounts

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

默认值: False

--enable-managed-identity

将当前群集更新为托管标识以管理群集资源组。

默认值: False

--enable-network-observability

预览

在群集上启用网络可观测性。

--enable-node-restriction

预览

在群集上启用节点限制选项。

默认值: False

--enable-oidc-issuer

启用 OIDC 颁发者。

默认值: False

--enable-pod-identity

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

默认值: False

--enable-pod-identity-with-kubenet

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

默认值: False

--enable-private-cluster

预览

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

默认值: False

--enable-public-fqdn

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

默认值: False

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

--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 扫描间隔。

--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=[]”。

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

接受的值: loadBalancer, managedNATGateway, 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”使用 List保险箱guardsVersions API 发现可用版本。

--sku

预览

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

接受的值: automatic, base

--ssh-access

预览

更新此群集中所有节点池的 SSH 设置。 使用“disabled”禁用 SSH 访问，使用“localuser”通过私钥启用 SSH 访问。

接受的值: disabled, localuser

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

预览

在群集升级之前设置替代生效。 它需要采用在接下来的 30 天内的有效日期/时间格式。 例如，2023-04-01T13：00：00Z。 请注意，如果 --force-upgrade 设置为 true，并且未设置 --upgrade-override-until，则默认情况下，它将从现在起设置为 3 天。

--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
                          [--client-secret]
                          [--no-wait]
                          [--reset-service-principal]
                          [--service-principal]

示例

使用新的服务主体更新现有 Kubernetes 群集。

az aks update-credentials -g MyResourceGroup -n MyManagedCluster --reset-service-principal --service-principal MyNewServicePrincipalID --client-secret MyNewServicePrincipalSecret

必需参数

--name -n

托管群集的名称。

--resource-group -g

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

可选参数

--client-secret

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

--no-wait

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

默认值: 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]
               [--kubernetes-version]
               [--no-wait]
               [--node-image-only]
               [--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

--kubernetes-version -k

要将群集升级到的 Kubernetes 版本，例如“1.16.9”。

值来自: `az aks get-upgrades`

--no-wait

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

默认值: False

--node-image-only

仅升级代理池的节点映像。

默认值: False

--upgrade-override-until

在群集升级之前设置替代生效。

它需要采用在接下来的 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]
               [--kubernetes-version]
               [--no-wait]
               [--node-image-only]
               [--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

--kubernetes-version -k

要将群集升级到的 Kubernetes 版本，例如“1.11.12”。

值来自: `az aks get-upgrades`

--no-wait

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

默认值: False

--node-image-only

仅升级代理池的节点映像。

默认值: 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 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 获取完整的调试日志。