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

az akshybrid

注意

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

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

管理预配的群集。

命令

名称	说明	类型	状态
az akshybrid create	创建预配的群集。	分机	预览版
az akshybrid delete	删除预配的群集。	扩展	预览
az akshybrid get-credentials	获取预配群集的本地 kubeconfig。	分机	预览版
az akshybrid get-upgrades	获取可用于预配群集的升级版本。	分机	预览
az akshybrid get-versions	列出指定自定义位置中支持的 Kubernetes 版本。	分机	预览
az akshybrid nodepool	管理预配群集中的节点池。	扩展	预览
az akshybrid nodepool add	在预配的群集中添加节点池。	扩展	预览
az akshybrid nodepool delete	删除预配群集中的节点池。	分机	预览
az akshybrid nodepool list	列出预配群集中的所有节点池。	扩展	预览版
az akshybrid nodepool scale	在预配的群集中缩放节点池。	扩展	预览
az akshybrid nodepool show	获取预配群集中的节点池。	扩展	预览版
az akshybrid notice	将 NOTICE 文件输出到用户指定的文件路径。	扩展	预览
az akshybrid show	获取预配的群集。	扩展	预览
az akshybrid update	汇报预配的群集。	分机	预览版
az akshybrid upgrade	升级预配的群集。	分机	预览版
az akshybrid vmsize	管理 akshybrid 的虚拟机 SKU。	分机	预览版
az akshybrid vmsize list	列出指定自定义位置中支持的虚拟机大小。	扩展	预览
az akshybrid vnet	管理预配群集的虚拟网络。	分机	预览
az akshybrid vnet create	创建虚拟网络。	扩展	预览版
az akshybrid vnet delete	删除虚拟网络。	分机	预览
az akshybrid vnet list	按资源组或订阅列出虚拟网络。	分机	预览
az akshybrid vnet show	获取虚拟网络。	扩展	预览

az akshybrid create

预览

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

创建预配的群集。

az akshybrid create --custom-location
                    --name
                    --resource-group
                    [--aad-admin-group-object-ids]
                    [--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]
                    [--location]
                    [--no-ssh-key]
                    [--no-wait]
                    [--node-count]
                    [--node-vm-size]
                    [--pod-cidr]
                    [--ssh-key-value]
                    [--tags]
                    [--vnet-ids]

示例

PutProvisionedCluster

az akshybrid create -g sample-rg --custom-location sample-cl -n sample-akshybridcluster --vnet-id vnet1

必需参数

--custom-location

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

--name -n

预配群集的名称。

--resource-group -g

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

可选参数

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

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

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

负载均衡器节点数。

--location -l

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

--ssh-key-value

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

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

--tags

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

--vnet-ids

VNet 的 ARM 资源 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 akshybrid delete

预览

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

删除预配的群集。

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

示例

DeleteProvisionedCluster

az akshybrid delete --name "sample-akshybridcluster" --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 akshybrid get-credentials

预览

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

获取预配群集的本地 kubeconfig。

az akshybrid get-credentials --name
                             --resource-group
                             [--admin]
                             [--context]
                             [--file]
                             [--overwrite-existing]

示例

Get管理员Credential

az akshybrid get-credentials --name "sample-akshybridcluster" --resource-group "sample-rg" --admin

GetAADUserCredential

az akshybrid get-credentials --name "sample-akshybridcluster" --resource-group "sample-rg"

必需参数

--name -n

预配群集的名称。

--resource-group -g

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

可选参数

--admin -a

获取群集管理员凭据。

默认值: False

--context

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

--file -f

要更新的 Kubernetes 配置文件。 如果未提供，请更新文件“~/.kube/config”。

默认值: ~\.kube\config

--overwrite-existing

覆盖具有相同名称的任何现有群集条目。

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

预览

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

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

az akshybrid get-upgrades --name
                          --resource-group

示例

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

az akshybrid 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 akshybrid get-versions

预览

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

列出指定自定义位置中支持的 Kubernetes 版本。

az akshybrid get-versions --custom-location
                          --resource-group

示例

VMListSkus

az akshybrid get-versions -g sample-rg --custom-location sample-cl

必需参数

--custom-location

用于显示支持的 k8s 版本的自定义位置的名称。

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

预览

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

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

az akshybrid notice --output-filepath

示例

GetNoticeFile

az akshybrid 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 akshybrid show

预览

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

获取预配的群集。

az akshybrid show --name
                  --resource-group

示例

GetProvisionedCluster

az akshybrid show --name "sample-akshybridcluster" --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 akshybrid update

预览

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

汇报预配的群集。

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

示例

UpdateProvisionedCluster

az akshybrid update --tags additionalProperties="sample" --name "sample-akshybridcluster" --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 akshybrid upgrade

预览

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

升级预配的群集。

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

示例

UpgradeProvisionedCluster

az akshybrid upgrade --name "sample-akshybridcluster" --resource-group "sample-rg" --kubernetes-version v1.22.2

UpgradeProvisionedClusterNodeImage

az akshybrid upgrade --name "sample-akshybridcluster" --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 获取完整的调试日志。