az connectedk8s

Note

Referensi ini adalah bagian dari ekstensi connectedk8s untuk Azure CLI (versi 2.70.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az connectedk8s . Pelajari selengkapnya tentang ekstensi.

Perintah untuk mengelola kluster kubernetes yang terhubung.

Perintah

Nama	Deskripsi	Jenis	Status
az connectedk8s connect	Onboarding kluster kubernetes yang terhubung ke azure.	Extension	GA
az connectedk8s delete	Hapus kluster kubernetes yang terhubung bersama dengan agen kluster yang terhubung.	Extension	GA
az connectedk8s disable-features	Menonaktifkan fitur selektif pada kluster yang terhubung.	Extension	Preview
az connectedk8s enable-features	Mengaktifkan fitur selektif pada kluster yang terhubung.	Extension	Preview
az connectedk8s list	Mencantumkan kluster kubernetes yang terhubung.	Extension	GA
az connectedk8s proxy	Dapatkan akses ke kluster kubernetes yang terhubung.	Extension	GA
az connectedk8s show	Tampilkan detail kluster kubernetes yang terhubung.	Extension	GA
az connectedk8s troubleshoot	Lakukan pemeriksaan diagnostik pada kluster Kube yang diaktifkan Arc.	Extension	Preview
az connectedk8s update	Perbarui properti kluster kubernetes onboarding arc.	Extension	GA
az connectedk8s upgrade	Tingkatkan agen onboarding secara atomik ke versi tertentu atau default ke versi terbaru.	Extension	GA

az connectedk8s connect

Onboarding kluster kubernetes yang terhubung ke azure.

Kluster Kubernetes yang akan di-onboarding sebagai kluster yang terhubung harus merupakan kluster default dalam kubeconfig. Jalankan kubectl config get-contexts untuk mengonfirmasi nama konteks target. Kemudian atur konteks default ke kluster yang tepat dengan menjalankan kubectl config use-context target-cluster-name.

az connectedk8s connect --name
                        --resource-group
                        [--acquire-policy-token]
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--change-reference]
                        [--config --configuration-settings]
                        [--config-protected --config-protected-settings]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert --proxy-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 --enable-workload-identity {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 --private-link-scope-resource-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Contoh

Onboarding kluster kubernetes yang terhubung dengan konfigurasi kube default dan konteks kube.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Onboarding kluster kubernetes yang terhubung dengan konfigurasi kube default dan konteks kube dan menonaktifkan peningkatan otomatis agen arc.

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

Onboarding kluster kubernetes yang terhubung dengan menentukan kubeconfig dan kubecontext.

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

Onboarding kluster kubernetes yang terhubung dengan menentukan proksi https, proksi http, tidak ada pengaturan proksi.

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

Onboarding kluster kubernetes yang terhubung dengan menentukan proksi https, proksi http, tanpa proksi dengan pengaturan sertifikasi.

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

Onboarding kluster kubernetes yang terhubung dengan fitur tautan privat diaktifkan dengan menentukan parameter tautan privat.

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

Onboarding kluster kubernetes yang terhubung dengan batas waktu onboarding kustom.

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

Onboarding kluster kubernetes yang terhubung dengan penerbit oidc dan webhook identitas beban kerja diaktifkan.

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

Onboarding kluster kubernetes yang terhubung dengan penerbit oidc diaktifkan menggunakan url penerbit yang dihost sendiri untuk kluster cloud publik.

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

Onboarding kluster kubernetes yang terhubung dengan fitur gateway azure diaktifkan.

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

Parameter yang Diperlukan

--name -n

Nama kluster yang terhubung.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--azure-hybrid-benefit

Bendera untuk mengaktifkan/menonaktifkan fitur Azure Hybrid Benefit.

Properti	Nilai
Nilai yang diterima:	False, NotApplicable, True

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--config --configuration-settings

Pratinjau

Pengaturan Konfigurasi sebagai pasangan kunci=nilai. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

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

Pratinjau

Pengaturan Terproteksi Konfigurasi sebagai pasangan kunci=nilai. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--container-log-path

Ambil alih jalur log kontainer default untuk mengaktifkan pengelogan fluent-bit.

--correlation-id

Panduan yang digunakan untuk melacak sumber onboarding kluster secara internal. Jangan ubah kecuali disarankan.

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

Jalur ke file sertifikat untuk proksi atau Otoritas Sertifikat kustom.

Properti	Nilai
Grup parameter:	Proxy Arguments

--custom-locations-oid

OID aplikasi 'lokasi kustom'.

--disable-auto-upgrade

Bendera untuk menonaktifkan peningkatan otomatis agen arc.

Properti	Nilai
Nilai default:	False

--distribution

Distribusi Kubernetes yang akan berjalan pada kluster yang terhubung ini.

Properti	Nilai
Nilai default:	generic
Nilai yang diterima:	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

Versi distribusi Kubernetes dari kluster yang terhubung.

--enable-oidc-issuer

Pratinjau

Aktifkan pembuatan url penerbit OIDC yang digunakan untuk federasi identitas beban kerja.

Properti	Nilai
Grup parameter:	Workload Identity Arguments
Nilai default:	False
Nilai yang diterima:	false, true

--enable-private-link

Pratinjau

Bendera untuk mengaktifkan/menonaktifkan dukungan tautan privat pada sumber daya kluster yang terhubung. Nilai yang diizinkan: false, true.

Properti	Nilai
Grup parameter:	PrivateLink Arguments
Nilai yang diterima:	false, true

--enable-wi --enable-workload-identity

Pratinjau

Aktifkan webhook identitas beban kerja.

Properti	Nilai
Grup parameter:	Workload Identity Arguments
Nilai default:	False
Nilai yang diterima:	false, true

--gateway-resource-id

Pratinjau

ArmID sumber daya Gateway Arc.

Properti	Nilai
Grup parameter:	Gateway Arguments

--infrastructure

Infrastruktur tempat kluster Kubernetes yang diwakili oleh kluster yang terhubung ini akan berjalan.

Properti	Nilai
Nilai default:	generic
Nilai yang diterima:	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

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--location -l

Location. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Properti	Nilai
Grup parameter:	Timeout Arguments
Nilai default:	False

--onboarding-timeout

Waktu yang diperlukan (dalam detik) agar pod arc-agent diinstal pada kluster kubernetes. Ambil alih nilai ini jika batasan perangkat keras/jaringan pada kluster Anda memerlukan lebih banyak waktu untuk menginstal pod arc-agent.

Properti	Nilai
Grup parameter:	Timeout Arguments
Nilai default:	1200

--pls-arm-id --private-link-scope-resource-id

Pratinjau

Id sumber daya ARM dari sumber daya cakupan tautan privat tempat kluster yang terhubung ini dikaitkan.

Properti	Nilai
Grup parameter:	PrivateLink Arguments

--proxy-http

URL proksi http yang akan digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--proxy-https

URL proksi https yang akan digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--proxy-skip-range

Daftar URL/CIDR yang proksinya tidak boleh digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--self-hosted-issuer

Pratinjau

Url penerbit yang dihost sendiri untuk kluster cloud publik - AKS, GKE, EKS.

Properti	Nilai
Grup parameter:	Workload Identity Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--yes -y

Jangan meminta konfirmasi.

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s delete

Hapus kluster kubernetes yang terhubung bersama dengan agen kluster yang terhubung.

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

Contoh

Hapus kluster kubernetes yang terhubung dan agen kluster yang terhubung dengan kubeconfig dan kubecontext default.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Hapus kluster kubernetes yang terhubung dengan menentukan kubeconfig dan kubecontext untuk penghapusan agen kluster yang terhubung.

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--force

Paksa hapus untuk menghapus semua sumber daya azure-arc dari kluster.

Properti	Nilai
Nilai default:	False

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Properti	Nilai
Nilai default:	False

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--yes -y

Jangan meminta konfirmasi.

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s disable-features

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Menonaktifkan fitur selektif pada kluster yang terhubung.

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

Contoh

Menonaktifkan fitur azure-rbac.

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

Nonaktifkan beberapa fitur.

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

Parameter yang Diperlukan

--features

Daftar fitur yang dipisahkan spasi yang ingin Anda nonaktifkan.

Properti	Nilai
Nilai yang diterima:	azure-rbac, cluster-connect, custom-locations

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--yes -y

Jangan meminta konfirmasi.

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s enable-features

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mengaktifkan fitur selektif pada kluster yang terhubung.

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

Contoh

Mengaktifkan fitur Cluster-Connect.

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

Aktifkan fitur RBAC Azure.

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

Aktifkan beberapa fitur.

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

Parameter yang Diperlukan

--features

Daftar fitur yang dipisahkan spasi yang ingin Anda aktifkan.

Properti	Nilai
Nilai yang diterima:	azure-rbac, cluster-connect, custom-locations

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--custom-locations-oid

OID aplikasi 'lokasi kustom'.

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--skip-azure-rbac-list

Daftar nama nama pengguna/email/oid yang dipisahkan koma. Azure RBAC akan dilewati untuk pengguna ini. Tentukan saat mengaktifkan azure-rbac.

Properti	Nilai
Grup parameter:	Azure RBAC Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s list

Mencantumkan kluster kubernetes yang terhubung.

az connectedk8s list [--resource-group]

Contoh

Cantumkan semua kluster kubernetes yang terhubung dalam grup sumber daya.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Cantumkan semua kluster kubernetes yang terhubung dalam langganan.

az connectedk8s list --subscription subscriptionName

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s proxy

Dapatkan akses ke kluster kubernetes yang terhubung.

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

Contoh

Dapatkan akses ke kluster kubernetes yang terhubung.

az connectedk8s proxy -n clusterName -g resourceGroupName

Mendapatkan akses ke kluster kubernetes yang terhubung dengan port kustom

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

Mendapatkan akses ke kluster kubernetes yang terhubung dengan token akun layanan

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

Dapatkan akses ke kluster kubernetes yang terhubung dengan menentukan lokasi kubeconfig kustom

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

Mendapatkan akses ke kluster kubernetes yang terhubung dengan menentukan konteks kustom

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--file -f

File konfigurasi Kubernetes untuk diperbarui. Jika tidak disediakan, perbarui file '~/.kube/config'. Gunakan '-' untuk mencetak YAML ke stdout sebagai gantinya.

Properti	Nilai
Nilai default:	~\.kube\config

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-context

Jika ditentukan, timpa nama konteks default.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--port

Port yang digunakan untuk mengakses kluster yang terhubung.

Properti	Nilai
Nilai default:	47011

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--token

Token akun layanan yang digunakan untuk mengautentikasi ke kluster kubernetes.

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s show

Tampilkan detail kluster kubernetes yang terhubung.

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

Contoh

Tampilkan detail untuk kluster kubernetes yang terhubung

az connectedk8s show -g resourceGroupName -n connectedClusterName

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s troubleshoot

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Lakukan pemeriksaan diagnostik pada kluster Kube yang diaktifkan Arc.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--acquire-policy-token]
                             [--change-reference]
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

Contoh

Lakukan pemeriksaan diagnostik pada kluster Kube yang diaktifkan Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Parameter yang Diperlukan

--name -n

Nama kluster yang terhubung.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubeconfig dari komputer saat ini.

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s update

Perbarui properti kluster kubernetes onboarding arc.

az connectedk8s update [--acquire-policy-token]
                       [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--change-reference]
                       [--config --configuration-settings]
                       [--config-protected --config-protected-settings]
                       [--container-log-path]
                       [--custom-ca-cert --proxy-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi --disable-workload-identity {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 --enable-workload-identity {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]

Contoh

Memperbarui nilai proksi untuk agen

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

Menonaktifkan pengaturan proksi untuk agen

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

Menonaktifkan peningkatan otomatis agen

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

Perbarui kluster kubernetes yang terhubung dengan pengeluar sertifikat oidc dan webhook identitas beban kerja diaktifkan.

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

Perbarui kluster kubernetes yang terhubung dengan penerbit oidc diaktifkan menggunakan url penerbit yang dihost sendiri untuk kluster cloud publik.

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

Nonaktifkan webhook identitas beban kerja pada kluster kubernetes yang terhubung.

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

Perbarui kluster kubernetes yang terhubung dengan fitur gateway azure diaktifkan.

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

Nonaktifkan fitur gateway azure pada kluster kubernetes yang terhubung.

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--auto-upgrade

Bendera untuk mengaktifkan/menonaktifkan peningkatan otomatis agen arc. Secara default, peningkatan otomatis agen diaktifkan.

Properti	Nilai
Nilai yang diterima:	false, true

--azure-hybrid-benefit

Bendera untuk mengaktifkan/menonaktifkan fitur Azure Hybrid Benefit.

Properti	Nilai
Nilai yang diterima:	False, NotApplicable, True

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--config --configuration-settings

Pratinjau

Pengaturan Konfigurasi sebagai pasangan kunci=nilai. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

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

Pratinjau

Pengaturan Terproteksi Konfigurasi sebagai pasangan kunci=nilai. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--container-log-path

Ambil alih jalur log kontainer default untuk mengaktifkan pengelogan fluent-bit.

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

Jalur ke file sertifikat untuk proksi atau Otoritas Sertifikat kustom.

Properti	Nilai
Grup parameter:	Proxy Arguments

--disable-gateway

Pratinjau

Bendera untuk menonaktifkan Gateway Arc.

Properti	Nilai
Grup parameter:	Gateway Arguments
Nilai default:	False
Nilai yang diterima:	false, true

--disable-proxy

Menonaktifkan pengaturan proksi untuk agen.

Properti	Nilai
Grup parameter:	Proxy Arguments
Nilai default:	False

--disable-wi --disable-workload-identity

Pratinjau

Nonaktifkan webhook identitas beban kerja.

Properti	Nilai
Grup parameter:	Workload Identity Arguments
Nilai yang diterima:	false, true

--distribution

Distribusi Kubernetes yang akan berjalan pada kluster yang terhubung ini.

Properti	Nilai
Nilai yang diterima:	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

Versi distribusi Kubernetes dari kluster yang terhubung.

--enable-oidc-issuer

Pratinjau

Aktifkan pembuatan url penerbit OIDC yang digunakan untuk federasi identitas beban kerja.

Properti	Nilai
Grup parameter:	Workload Identity Arguments
Nilai yang diterima:	false, true

--enable-wi --enable-workload-identity

Pratinjau

Aktifkan webhook identitas beban kerja.

Properti	Nilai
Grup parameter:	Workload Identity Arguments
Nilai yang diterima:	false, true

--gateway-resource-id

Pratinjau

ArmID sumber daya Gateway Arc.

Properti	Nilai
Grup parameter:	Gateway Arguments

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--proxy-http

URL proksi http yang akan digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--proxy-https

URL proksi https yang akan digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--proxy-skip-range

Daftar URL/CIDR yang proksinya tidak boleh digunakan.

Properti	Nilai
Grup parameter:	Proxy Arguments

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--self-hosted-issuer

Pratinjau

Url penerbit yang dihost sendiri untuk kluster cloud publik - AKS, GKE, EKS.

Properti	Nilai
Grup parameter:	Workload Identity Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--yes -y

Jangan meminta konfirmasi.

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az connectedk8s upgrade

Tingkatkan agen onboarding secara atomik ke versi tertentu atau default ke versi terbaru.

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

Contoh

Meningkatkan agen ke versi terbaru

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Meningkatkan agen ke versi tertentu

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

Tingkatkan agen dengan batas waktu peningkatan kustom.

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--agent-version

Versi agen untuk memperbarui bagan helm.

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--ids

Satu atau beberapa ID sumber daya (dibatasi spasi). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--kube-config

Jalur ke file konfigurasi kube.

--kube-context

Konteks Kubconfig dari komputer saat ini.

--name -n

Nama kluster yang terhubung.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--skip-ssl-verification

Lewati verifikasi SSL untuk koneksi kluster apa pun.

Properti	Nilai
Nilai default:	False

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Properti	Nilai
Grup parameter:	Resource Id Arguments

--upgrade-timeout

Waktu yang diperlukan (dalam detik) agar pod arc-agent ditingkatkan pada kluster kubernetes. Ambil alih nilai ini jika batasan perangkat keras/jaringan pada kluster Anda memerlukan lebih banyak waktu untuk meningkatkan pod agen busur.

Properti	Nilai
Nilai default:	600

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False