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

az hybridaks

注意

此参考是 Azure CLI（版本 2.32.0 或更高版本）的混合扩展的一部分。 该扩展将在首次运行 az hybridaks 命令时自动安装。 详细了解扩展。

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

管理已预配的混合群集。

命令

名称	说明	类型	状态
az hybridaks create	创建混合 AKS 预配群集。	分机	预览
az hybridaks delete	删除混合 AKS 预配的群集。	扩展	预览版
az hybridaks get-upgrades	获取可用于混合 AKS 预配群集的升级版本。	分机	预览
az hybridaks list	列出资源组或订阅中的混合 AKS 预配群集。	分机	预览版
az hybridaks nodepool	管理混合预配群集中的节点池。	分机	预览
az hybridaks nodepool add	在混合 AKS 预配的群集中添加节点池。	分机	预览
az hybridaks nodepool delete	删除混合 AKS 预配群集中的节点池。	扩展	预览
az hybridaks nodepool list	列出混合 AKS 预配群集中的所有节点池。	分机	预览
az hybridaks nodepool scale	缩放混合 AKS 预配群集中的节点池。	分机	预览
az hybridaks nodepool show	获取混合 AKS 预配群集中的节点池。	分机	预览
az hybridaks notice	将 NOTICE 文件输出到用户指定的文件路径。	分机	预览
az hybridaks proxy	获取对连接的混合 AKS 预配群集的访问权限。	分机	预览
az hybridaks show	获取混合 AKS 预配的群集。	分机	预览
az hybridaks update	汇报混合 AKS 预配的群集。	分机	预览
az hybridaks upgrade	升级混合 AKS 预配的群集。	扩展	预览版
az hybridaks vnet	管理混合网络的虚拟网络。	分机	预览版
az hybridaks vnet create	创建混合 AKS 虚拟网络。	扩展	预览
az hybridaks vnet delete	删除混合 AKS 虚拟网络。	扩展	预览
az hybridaks vnet list	按资源组或订阅列出混合 AKS 虚拟网络。	分机	预览
az hybridaks vnet show	获取混合 AKS 虚拟网络。	分机	预览版

az hybridaks create

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

创建混合 AKS 预配群集。

az hybridaks create --custom-location
                    --name
                    --resource-group
                    [--aad-admin-group-object-ids]
                    [--addon]
                    [--arc-agent-auto-upgrade]
                    [--arc-agent-version]
                    [--control-plane-count]
                    [--control-plane-ip]
                    [--control-plane-vm-size]
                    [--generate-ssh-keys]
                    [--kubernetes-version]
                    [--load-balancer-count]
                    [--load-balancer-sku]
                    [--load-balancer-vm-size]
                    [--location]
                    [--no-ssh-key]
                    [--no-wait]
                    [--node-count]
                    [--node-vm-size]
                    [--pod-cidr]
                    [--service-cidr]
                    [--ssh-key-value]
                    [--tags]
                    [--vnet-ids]
                    [--zones]

示例

PutProvisionedCluster

az hybridaks create -g sample-rg --custom-location sample-cl -n sample-hybridakscluster --vnet-id vnet1

必需参数

--custom-location

用于预配群集的自定义位置的名称或 ID。

--name -n

预配群集的名称。

--resource-group -g

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

可选参数

--aad-admin-group-object-ids -i

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

--addon -a

启用加载项。 可以通过指定此标志来添加多个加载项。 用法：--addon name=addon-name [config_key=config_value ...]。

--arc-agent-auto-upgrade

Arc 代理自动升级。

默认值: Enabled

--arc-agent-version

Arc 代理版本。

--control-plane-count

控制平面节点数。

--control-plane-ip

控制平面的 API 服务器 IP 地址。

--control-plane-vm-size

控制平面的 VM 大小。

--generate-ssh-keys

如果不存在，请生成 ssh 密钥对。

默认值: False

--kubernetes-version -k

预配群集的 kubernetes 版本。

--load-balancer-count

负载均衡器节点数。

--load-balancer-sku

负载均衡器的类型。 选项：“unstacked-haproxy” |“stacked-kube-vip” |“stacked-metallb” |“非托管”。

--load-balancer-vm-size

负载均衡器的 VM 大小。

--location -l

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

--no-ssh-key -x

请勿使用注入任何公钥。

默认值: False

--no-wait

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

默认值: False

--node-count -c

在 nodepool 中创建的节点数。

--node-vm-size

节点池中节点的 VM 大小。

--pod-cidr

CIDR 表示法 IP 范围，从中分配 Pod IP。

--service-cidr

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

--ssh-key-value

要注入控制平面的 ssh 公钥的路径。

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

--tags

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

--vnet-ids

HybridAKS VNet 的 ARM 资源 ID。

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除混合 AKS 预配的群集。

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

示例

DeleteProvisionedCluster

az hybridaks delete --name "sample-hybridakscluster" --resource-group "sample-rg"

必需参数

--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 hybridaks get-upgrades

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取可用于混合 AKS 预配群集的升级版本。

az hybridaks get-upgrades --name
                          --resource-group

示例

获取可用于混合 AKS 预配群集的升级版本

az hybridaks get-upgrades --name "samplecluster" --resource-group "sample-rg"

必需参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出资源组或订阅中的混合 AKS 预配群集。

az hybridaks list [--resource-group]

示例

ListProvisionedClusterByResourceGroup

az hybridaks list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az hybridaks list

可选参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

将 NOTICE 文件输出到用户指定的文件路径。

az hybridaks notice --output-filepath

示例

GetNoticeFile

az hybridaks notice --output-filepath "./Notice"

必需参数

--output-filepath

通知文件的输出文件路径。

全局参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取对连接的混合 AKS 预配群集的访问权限。

az hybridaks proxy [--file]
                   [--ids]
                   [--kube-context]
                   [--name]
                   [--port]
                   [--resource-group]
                   [--subscription]
                   [--token]

示例

获取对连接的 kubernetes 群集的访问权限。

az hybridaks proxy -n clusterName -g resourceGroupName

使用自定义端口访问连接的 kubernetes 群集

az hybridaks proxy -n clusterName -g resourceGroupName --port portValue

使用服务帐户令牌访问连接的 kubernetes 群集

az hybridaks proxy -n clusterName -g resourceGroupName --token tokenValue

通过指定自定义 kubeconfig 位置获取对连接的 kubernetes 群集的访问权限

az hybridaks proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

通过指定自定义上下文获取对连接的 kubernetes 群集的访问权限

az hybridaks proxy -n clusterName -g resourceGroupName --kube-context contextName

可选参数

--file -f

要更新的 Kubernetes 配置文件。 如果未提供，请更新文件“~/.kube/config”。 改用“-”将 YAML 打印为 stdout。

默认值: ~\.kube\config

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--kube-context

如果指定，请覆盖默认上下文名称。

--name -n

混合 AKS 预配群集的名称。

--port

用于访问连接的群集的端口。

默认值: 47013

--resource-group -g

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

--subscription

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

--token

用于向 kubernetes 群集进行身份验证的服务帐户令牌。

全局参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取混合 AKS 预配的群集。

az hybridaks show --name
                  --resource-group

示例

GetProvisionedCluster

az hybridaks show --name "sample-hybridakscluster" --resource-group "sample-rg"

必需参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

汇报混合 AKS 预配的群集。

az hybridaks update --name
                    --resource-group
                    [--aad-admin-group-object-ids]
                    [--tags]

示例

UpdateProvisionedCluster

az hybridaks update --tags additionalProperties="sample" --name "sample-hybridakscluster" --resource-group "sample-rg"

必需参数

--name -n

预配群集的名称。

--resource-group -g

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

可选参数

--aad-admin-group-object-ids -i

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

--tags

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

全局参数

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

预览

命令组“hybridaks”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

升级混合 AKS 预配的群集。

az hybridaks upgrade --name
                     --resource-group
                     [--kubernetes-version]
                     [--no-wait]
                     [--node-image-only]
                     [--yes]

示例

UpgradeProvisionedCluster

az hybridaks upgrade --name "sample-hybridakscluster" --resource-group "sample-rg" --kubernetes-version v1.22.2

UpgradeProvisionedClusterNodeImage

az hybridaks upgrade --name "sample-hybridakscluster" --resource-group "sample-rg" --node-image-only

必需参数

--name -n

预配群集的名称。

--resource-group -g

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

可选参数

--kubernetes-version -k

预配群集的 kubernetes 版本。

--no-wait

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

默认值: False

--node-image-only

仅升级节点映像的标志。

默认值: False

--yes

用于禁用确认提示的标志。

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