共用方式為

az connectedk8s

  • 參考

注意

此參考是 Azure CLI connectedk8s 延伸模組的一部分（2.70.0 版或更高版本）。 當您第一次執行 az connectedk8s 命令時，擴充功能會自動安裝。 深入瞭解擴充功能。

管理已連線 Kubernetes 叢集的命令。

命令

名稱 Description 類型 狀態
az connectedk8s connect

將連線的 kubernetes 叢集上線至 Azure。

 外延 加語
az connectedk8s delete

刪除已連線的 kubernetes 叢集以及連線的叢集代理程式。

 外延 加語
az connectedk8s disable-features

停用連線叢集上的選擇性功能。

 外延 預覽
az connectedk8s enable-features

啟用連線叢集上的選擇性功能。

 外延 預覽
az connectedk8s list

列出已連線的 kubernetes 叢集。

 外延 加語
az connectedk8s proxy

取得已連線 Kubernetes 叢集的存取權。

 外延 加語
az connectedk8s show

顯示已連線 Kubernetes 叢集的詳細數據。

 外延 加語
az connectedk8s troubleshoot

在已啟用Arc的 Kubernetes 叢集上執行診斷檢查。

 外延 預覽
az connectedk8s update

更新 Arc 上線 Kubernetes 叢集的屬性。

 外延 加語
az connectedk8s upgrade

以不可部分完成的方式將上架代理程序升級至特定版本，或預設為最新版本。

 外延 加語

az connectedk8s connect

將連線的 kubernetes 叢集上線至 Azure。

要上線為已連線叢集的 Kubernetes 叢集必須是 kubeconfig 中的預設叢集。 執行 kubectl config get-contexts 以確認目標內容名稱。 然後執行 kubectl config use-context target-cluster-name，將默認內容設定為正確的叢集。

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config]
                        [--config-protected]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {false, true}]
                        [--gateway-resource-id]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

範例

使用預設 kube 組態和 kube 內容將連線的 kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName

使用預設 kube 組態和 kube 內容將連線的 kubernetes 叢集上線，並停用自動升級 Arc 代理程式。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

藉由指定 kubeconfig 和 kubecontext，將聯機的 kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

藉由指定 HTTPs Proxy、HTTP Proxy、無 Proxy 設定，將聯機的 kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

藉由指定 HTTPs Proxy、HTTP Proxy，沒有具有憑證設定的 Proxy，將連線的 kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

透過指定私人鏈接參數，將連線的 kubernetes 叢集上線，並啟用私人連結功能。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

使用自訂上線逾時將連線的 kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

使用 oidc 簽發者和已啟用工作負載身分識別 Webhook 的連線 Kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

使用公用雲端叢集的自我裝載簽發者 URL，將已啟用 oidc 簽發者的連線 Kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

使用已啟用 Azure 閘道功能的連線 Kubernetes 叢集上線。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

必要參數

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

--azure-hybrid-benefit

啟用/停用 Azure Hybrid Benefit 功能的旗標。

接受的值: False, NotApplicable, True
--config --configuration-settings
預覽

組態設定為key=value pair。 針對每個設定重複參數。 請勿將此值用於秘密，因為此值會在響應中傳回。

--config-protected --config-protected-settings
預覽

將受保護的設定設定設定為key=value組。 針對每個設定重複參數。 只有索引鍵會在響應中傳回，值不是。

--container-log-path

覆寫預設容器記錄路徑，以啟用 Fluent-bit 記錄。

--correlation-id

用來在內部追蹤叢集上線來源的 GUID。 除非建議，否則請勿修改。

--custom-ca-cert --proxy-cert

Proxy 或自定義證書頒發機構單位之憑證檔案的路徑。

--custom-locations-oid

「自定義位置」應用程式的 OID。

--disable-auto-upgrade

停用自動升級Arc代理程式的旗標。

預設值: False
--distribution

將在此連線叢集上執行的 Kubernetes 散發套件。

接受的值: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg
預設值: generic
--distribution-version

已連線叢集的 Kubernetes 散發版本。

--enable-oidc-issuer
預覽

啟用建立用於工作負載身分識別同盟的 OIDC 簽發者 URL。

接受的值: false, true
預設值: False
--enable-private-link
預覽

在連線的叢集資源上啟用/停用私人連結支援的旗標。 允許的值：false、true。

接受的值: false, true
--enable-wi --enable-workload-identity
預覽

啟用工作負載身分識別 Webhook。

接受的值: false, true
預設值: False
--gateway-resource-id
預覽

Arc 閘道資源的 ArmID。

--infrastructure

此連線叢集所代表 Kubernetes 叢集的基礎結構將會在其中執行。

接受的值: LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server
預設值: generic
--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--location -l

位置。 來自的值：az account list-locations。 您可以使用 az configure --defaults location=<location>來設定預設位置。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--onboarding-timeout

在 kubernetes 叢集上安裝 Arc 代理程式 Pod 所需的時間（以秒為單位）。 如果您的叢集上的硬體/網路條件約束需要更多時間才能安裝arc-agent Pod，請覆寫此值。

預設值: 1200
--pls-arm-id --private-link-scope-resource-id
預覽

與此連線叢集相關聯之私人連結範圍資源的 ARM 資源識別碼。

--proxy-http

要使用的 Http Proxy URL。

--proxy-https

要使用的 Https Proxy URL。

--proxy-skip-range

不應該使用 Proxy 的 URL/CIDR 清單。

--self-hosted-issuer
預覽

公用雲端叢集的自我裝載簽發者 URL - AKS、GKE、EKS。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s delete

刪除已連線的 kubernetes 叢集以及連線的叢集代理程式。

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

範例

使用預設 kubeconfig 和 kubecontext 刪除已連線的 kubernetes 叢集和已連線的叢集代理程式。

az connectedk8s delete -g resourceGroupName -n connectedClusterName

藉由指定 kubeconfig 和 kubecontext 來刪除已連線的叢集代理程式，以刪除已連線的 kubernetes 叢集。

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

選擇性參數

--force

強制刪除以從叢集移除所有 azure-arc 資源。

預設值: False
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--name -n

已連線叢集的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s disable-features

預覽

此命令處於預覽狀態，且正在開發中。 參考和支持層級：https://aka.ms/CLI_refstatus

停用連線叢集上的選擇性功能。

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

範例

停用 azure-rbac 功能。

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

停用多個功能。

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

必要參數

--features

您要停用的功能空間分隔清單。

接受的值: azure-rbac, cluster-connect, custom-locations

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s enable-features

預覽

此命令處於預覽狀態，且正在開發中。 參考和支持層級：https://aka.ms/CLI_refstatus

啟用連線叢集上的選擇性功能。

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

範例

啟用 Cluster-Connect 功能。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

啟用 Azure RBAC 功能。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

啟用多個功能。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

必要參數

--features

您要啟用的功能空間分隔清單。

接受的值: azure-rbac, cluster-connect, custom-locations

選擇性參數

--custom-locations-oid

「自定義位置」應用程式的 OID。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--skip-azure-rbac-list

使用者名稱/電子郵件/oid 名稱的逗號分隔清單。 這些使用者將會略過 Azure RBAC。 指定啟用 azure-rbac 時。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數
--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s list

列出已連線的 kubernetes 叢集。

az connectedk8s list [--resource-group]

範例

列出資源群組中的所有已連線 Kubernetes 叢集。

az connectedk8s list -g resourceGroupName --subscription subscriptionName

列出訂用帳戶中的所有已連線 Kubernetes 叢集。

az connectedk8s list --subscription subscriptionName

選擇性參數

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s proxy

取得已連線 Kubernetes 叢集的存取權。

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

範例

取得已連線 Kubernetes 叢集的存取權。

az connectedk8s proxy -n clusterName -g resourceGroupName

使用自定義埠存取已連線的 kubernetes 叢集

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

使用服務帳戶令牌取得已連線 Kubernetes 叢集的存取權

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

藉由指定自定義 kubeconfig 位置，取得已連線 Kubernetes 叢集的存取權

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

藉由指定自定義內容來取得已連線 Kubernetes 叢集的存取權

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

選擇性參數

--file -f

要更新的 Kubernetes 組態檔。 如果未提供，請更新檔案 '~/.kube/config'。 請改用 『-』 列印 YAML 至 stdout。

預設值: ~\.kube\config
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-context

如果指定，請覆寫預設內容名稱。

--name -n

已連線叢集的名稱。

--port

用於存取已連線叢集的埠。

預設值: 47011
--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s show

顯示已連線 Kubernetes 叢集的詳細數據。

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

範例

顯示已連線 Kubernetes 叢集的詳細數據

az connectedk8s show -g resourceGroupName -n connectedClusterName

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

全域參數
--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s troubleshoot

預覽

此命令處於預覽狀態，且正在開發中。 參考和支持層級：https://aka.ms/CLI_refstatus

在已啟用Arc的 Kubernetes 叢集上執行診斷檢查。

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

範例

在已啟用Arc的 Kubernetes 叢集上執行診斷檢查。

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

必要參數

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubeconfig 內容。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s update

更新 Arc 上線 Kubernetes 叢集的屬性。

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--config]
                       [--config-protected]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi {false, true}]
                       [--gateway-resource-id]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

範例

更新代理程式的 Proxy 值

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

停用代理程式的 Proxy 設定

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

停用代理程式的自動升級

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

使用已啟用 oidc 簽發者和工作負載身分識別 Webhook 更新連線的 kubernetes 叢集。

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

使用公用雲端叢集的自我裝載簽發者 URL，以啟用 oidc 簽發者的連線 Kubernetes 叢集進行更新。

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

停用已連線 Kubernetes 叢集上的工作負載身分識別 Webhook。

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

使用已啟用 Azure 閘道功能更新已連線的 kubernetes 叢集。

az connectedk8s update -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

停用已連線 Kubernetes 叢集上的 Azure 閘道功能。

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-gateway

選擇性參數

--auto-upgrade

啟用/停用Arc代理程式的自動升級旗標。 根據預設，會自動升級代理程式。

接受的值: false, true
--azure-hybrid-benefit

啟用/停用 Azure Hybrid Benefit 功能的旗標。

接受的值: False, NotApplicable, True
--config --configuration-settings
預覽

組態設定為key=value pair。 針對每個設定重複參數。 請勿將此值用於秘密，因為此值會在響應中傳回。

--config-protected --config-protected-settings
預覽

將受保護的設定設定設定為key=value組。 針對每個設定重複參數。 只有索引鍵會在響應中傳回，值不是。

--container-log-path

覆寫預設容器記錄路徑，以啟用 Fluent-bit 記錄。

--custom-ca-cert --proxy-cert

Proxy 或自定義證書頒發機構單位之憑證檔案的路徑。

--disable-gateway
預覽

停用 Arc 閘道的旗標。

接受的值: false, true
預設值: False
--disable-proxy

停用代理程式的 Proxy 設定。

預設值: False
--disable-wi --disable-workload-identity
預覽

停用工作負載身分識別 Webhook。

接受的值: false, true
--distribution

將在此連線叢集上執行的 Kubernetes 散發套件。

接受的值: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg
--distribution-version

已連線叢集的 Kubernetes 散發版本。

--enable-oidc-issuer
預覽

啟用建立用於工作負載身分識別同盟的 OIDC 簽發者 URL。

接受的值: false, true
--enable-wi --enable-workload-identity
預覽

啟用工作負載身分識別 Webhook。

接受的值: false, true
--gateway-resource-id
預覽

Arc 閘道資源的 ArmID。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--name -n

已連線叢集的名稱。

--proxy-http

要使用的 Http Proxy URL。

--proxy-https

要使用的 Https Proxy URL。

--proxy-skip-range

不應該使用 Proxy 的 URL/CIDR 清單。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--self-hosted-issuer
預覽

公用雲端叢集的自我裝載簽發者 URL - AKS、GKE、EKS。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。

az connectedk8s upgrade

以不可部分完成的方式將上架代理程序升級至特定版本，或預設為最新版本。

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

範例

將代理程序升級至最新版本

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

將代理程序升級至特定版本

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

使用自定義升級逾時升級代理程式。

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

選擇性參數

--agent-version

要更新 Helm 圖表的代理程式版本。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--kube-config

kube 組態檔的路徑。

--kube-context

目前電腦的 Kubconfig 內容。

--name -n

已連線叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--skip-ssl-verification

略過任何叢集連線的SSL驗證。

預設值: False
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--upgrade-timeout

在 kubernetes 叢集上升級 arc-agent Pod 所需的時間（以秒為單位）。 如果您的叢集上的硬體/網路條件約束需要更多時間來升級arc-agent Pod，請覆寫此值。

預設值: 600
全域參數
--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 針對完整偵錯記錄使用 --debug。