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

az k8s-extension

参考

注意

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

用于管理 Kubernetes 扩展的命令。

命令

名称	说明	类型	状态
az k8s-extension create	创建 Kubernetes 群集扩展，包括从 Azure 市场（仅限 AKS）购买扩展产品/服务。请参阅末尾的示例，了解如何创建扩展或购买扩展产品/服务。	分机	GA
az k8s-extension delete	删除 Kubernetes 扩展。	分机	GA
az k8s-extension extension-types	用于发现 Kubernetes 扩展类型的命令。	分机	预览
az k8s-extension extension-types list	列出现有群集的可用群集扩展类型。	扩展	预览和弃用
az k8s-extension extension-types list-by-cluster	列出现有群集的可用群集扩展类型。用于筛选的属性包括群集的类型（托管、连接等）、kubernetes 版本、群集位置。	分机	预览
az k8s-extension extension-types list-by-location	列出区域中的可用群集扩展类型。	分机	预览版
az k8s-extension extension-types list-versions	列出给定群集的群集扩展类型的可用版本。	分机	预览和弃用
az k8s-extension extension-types list-versions-by-cluster	列出给定群集的群集扩展类型的可用版本。用于筛选的属性包括群集的类型（托管、连接等）、kubernetes 版本、群集位置。	扩展	预览
az k8s-extension extension-types list-versions-by-location	列出区域中群集扩展类型版本的可用版本。	分机	预览版
az k8s-extension extension-types show	获取区域中群集扩展类型的属性。	扩展	预览和弃用
az k8s-extension extension-types show-by-cluster	显示现有群集的群集扩展类型的属性。用于筛选的属性包括群集的类型（托管、连接等）、kubernetes 版本、群集位置。	扩展	预览
az k8s-extension extension-types show-by-location	显示区域中群集扩展类型的属性。	分机	预览
az k8s-extension extension-types show-version-by-cluster	显示与现有群集的群集扩展类型版本关联的属性。用于筛选的属性包括群集的类型（托管、连接等）、kubernetes 版本、群集位置。	扩展	预览
az k8s-extension extension-types show-version-by-location	显示与区域中的群集扩展类型版本关联的属性。	分机	预览
az k8s-extension list	列出 Kubernetes 扩展。	分机	GA
az k8s-extension show	显示 Kubernetes 扩展。	分机	GA
az k8s-extension update	更新 Kubernetes 扩展的可变属性。	分机	GA

az k8s-extension create

创建 Kubernetes 群集扩展，包括从 Azure 市场（仅限 AKS）购买扩展产品/服务。请参阅末尾的示例，了解如何创建扩展或购买扩展产品/服务。

创建 Kubernetes 扩展。输出包含必须保护的机密。请确保在源代码管理中不包含这些机密。此外，请验证命令或脚本的日志中是否存在任何机密。有关附加信息，请参阅 http://aka.ms/clisecrets。

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

示例

创建 Kubernetes 扩展

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

创建 Kubernetes 市场扩展

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774

必需参数

--cluster-name -c

Kubernetes 群集的名称。

--cluster-type -t

指定 Arc 群集或 AKS 托管群集或 Arc 设备或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters

--extension-type

扩展类型的名称。

--name -n

扩展实例的名称。

--resource-group -g

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

可选参数

--auto-upgrade --auto-upgrade-minor-version

自动升级扩展实例的次要版本。

接受的值: false, true

--cluster-resource-provider --cluster-rp

此 clusterType 的群集资源提供程序名称（provisionedClusters 必需）。

--config --configuration-settings

配置设置作为 key=value 对。对每个设置重复参数。不要将此值用于机密，因为此值在响应中返回。

--config-file --config-settings-file

配置设置的 JSON 文件路径。

--config-protected --config-protected-settings

配置受保护的设置作为 key=value 对。对每个设置重复参数。仅响应中返回键，该值不返回。

--config-protected-file --config-protected-settings-file

受配置保护的设置的 JSON 文件路径。

--config-settings

已放弃

选项“--config-settings”已弃用，将在将来的版本中删除。请改用“--configuration-settings”。

配置设置作为 key=value 对。对每个设置重复参数。不要将此值用于机密，因为此值在响应中返回。

--configuration-protected-settings

已放弃

选项“--configuration-protected-settings”已弃用，将在将来的版本中删除。请改用“--config-protected-settings”。

配置受保护的设置作为 key=value 对。对每个设置重复参数。仅响应中返回键，该值不返回。

--configuration-protected-settings-file

已放弃

选项“--configuration-protected-settings-file”已弃用，将在将来的版本中删除。请改用“--config-protected-file”。

受配置保护的设置的 JSON 文件路径。

--configuration-settings-file

已放弃

选项“--configuration-settings-file”已弃用，将在将来的版本中删除。请改用“--config-settings-file”。

配置设置的 JSON 文件路径。

--no-wait

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

默认值: False

--plan-name

计划名称指的是在使用情况信息 + 支持下从市场门户获取的扩展的计划 ID。

--plan-product

计划产品指的是在“使用情况信息 + 支持”下从市场门户获取的扩展的产品 ID。使用的 ISV 产品/服务的名称就是这方面的一个示例。

--plan-publisher

计划发布者指的是在使用情况信息 + 支持下从市场门户获取的扩展的发布者 ID。

--release-namespace

指定要安装扩展版本的命名空间。

--release-train

指定扩展类型的发布训练。

--scope

指定扩展范围。

接受的值: cluster, namespace

--target-namespace

指定要为扩展实例安装的目标命名空间。如果扩展范围设置为“namespace”，则需要此参数。

--version

如果未启用 --auto-upgrade-minor-version，请指定要为扩展实例安装的版本。

全局参数

--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 k8s-extension delete

删除 Kubernetes 扩展。

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

示例

删除现有的 Kubernetes 扩展

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

必需参数

--cluster-name -c

Kubernetes 群集的名称。

--cluster-type -t

指定 Arc 群集或 AKS 托管群集或 Arc 设备或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

扩展实例的名称。

--resource-group -g

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

可选参数

--cluster-resource-provider --cluster-rp

此 clusterType 的群集资源提供程序名称（provisionedClusters 必需）。

--force

指定是否强制从群集中删除扩展。

默认值: False

--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 k8s-extension list

列出 Kubernetes 扩展。

列出群集中的所有 Kubernetes 扩展，包括其属性。输出包含必须保护的机密。请确保在源代码管理中不包含这些机密。此外，请验证命令或脚本的日志中是否存在任何机密。有关附加信息，请参阅 http://aka.ms/clisecrets。

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

示例

列出群集上的所有 Kubernetes 扩展

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

必需参数

--cluster-name -c

Kubernetes 群集的名称。

--cluster-type -t

指定 Arc 群集或 AKS 托管群集或 Arc 设备或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters

--resource-group -g

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

可选参数

--cluster-resource-provider --cluster-rp

此 clusterType 的群集资源提供程序名称（provisionedClusters 必需）。

全局参数

--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 k8s-extension show

显示 Kubernetes 扩展。

显示 Kubernetes 扩展，包括其属性。输出包含必须保护的机密。请确保在源代码管理中不包含这些机密。此外，请验证命令或脚本的日志中是否存在任何机密。有关附加信息，请参阅 http://aka.ms/clisecrets。

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

示例

显示 Kubernetes 扩展的详细信息

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

必需参数

--cluster-name -c

Kubernetes 群集的名称。

--cluster-type -t

指定 Arc 群集或 AKS 托管群集或 Arc 设备或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

扩展实例的名称。

--resource-group -g

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

可选参数

--cluster-resource-provider --cluster-rp

此 clusterType 的群集资源提供程序名称（provisionedClusters 必需）。

全局参数

--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 k8s-extension update

更新 Kubernetes 扩展的可变属性。

有关 Config设置和 ConfigProtected 的更新设置，请参阅群集扩展服务的文档，以便在更新这些属性之前检查更新这些属性。输出包含必须保护的机密。请确保在源代码管理中不包含这些机密。此外，请验证命令或脚本的日志中是否存在任何机密。有关附加信息，请参阅 http://aka.ms/clisecrets。

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

示例

更新 Kubernetes 扩展

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

必需参数

--cluster-name -c

Kubernetes 群集的名称。

--cluster-type -t

指定 Arc 群集或 AKS 托管群集或 Arc 设备或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

扩展实例的名称。

--resource-group -g

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

可选参数

--auto-upgrade --auto-upgrade-minor-version

自动升级扩展实例的次要版本。

接受的值: false, true

--cluster-resource-provider --cluster-rp

此 clusterType 的群集资源提供程序名称（provisionedClusters 必需）。

--config --configuration-settings

配置设置作为 key=value 对。对每个设置重复参数。不要将此值用于机密，因为此值在响应中返回。

--config-file --config-settings-file

配置设置的 JSON 文件路径。

--config-protected --config-protected-settings

配置受保护的设置作为 key=value 对。对每个设置重复参数。仅响应中返回键，该值不返回。

--config-protected-file --config-protected-settings-file

受配置保护的设置的 JSON 文件路径。

--config-settings

已放弃

选项“--config-settings”已弃用，将在将来的版本中删除。请改用“--configuration-settings”。

配置设置作为 key=value 对。对每个设置重复参数。不要将此值用于机密，因为此值在响应中返回。

--configuration-protected-settings

已放弃

选项“--configuration-protected-settings”已弃用，将在将来的版本中删除。请改用“--config-protected-settings”。

配置受保护的设置作为 key=value 对。对每个设置重复参数。仅响应中返回键，该值不返回。

--configuration-protected-settings-file

已放弃

选项“--configuration-protected-settings-file”已弃用，将在将来的版本中删除。请改用“--config-protected-file”。

受配置保护的设置的 JSON 文件路径。

--configuration-settings-file

已放弃

选项“--configuration-settings-file”已弃用，将在将来的版本中删除。请改用“--config-settings-file”。

配置设置的 JSON 文件路径。

--no-wait

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

默认值: False

--release-train

指定扩展类型的发布训练。

--version

如果未启用 --auto-upgrade-minor-version，请指定要为扩展实例安装的版本。

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

命令

az k8s-extension create

示例

必需参数

可选参数

az k8s-extension delete

示例

必需参数

可选参数

az k8s-extension list

示例

必需参数

可选参数

az k8s-extension show

示例

必需参数

可选参数

az k8s-extension update

示例

必需参数

可选参数

其他资源