az connectedk8s

Note

Diese Referenz ist Teil der Connectedk8s-Erweiterung für die Azure CLI (Version 2.70.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az connectedk8s-Befehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Befehle zum Verwalten verbundener Kubernetes-Cluster.

Befehle

Name	Beschreibung	Typ	Status
az connectedk8s connect	Onboarding eines verbundenen Kubernetes-Clusters in Azure.	Extension	GA
az connectedk8s delete	Löschen Eines verbundenen Kubernetes-Clusters zusammen mit verbundenen Cluster-Agents.	Extension	GA
az connectedk8s disable-features	Deaktiviert die selektiven Features im verbundenen Cluster.	Extension	Preview
az connectedk8s enable-features	Aktiviert die selektiven Features im verbundenen Cluster.	Extension	Preview
az connectedk8s list	Auflisten verbundener Kubernetes-Cluster.	Extension	GA
az connectedk8s proxy	Erhalten Sie Zugriff auf einen verbundenen Kubernetes-Cluster.	Extension	GA
az connectedk8s show	Zeigen Sie Details eines verbundenen Kubernetes-Clusters an.	Extension	GA
az connectedk8s troubleshoot	Führen Sie Diagnoseprüfungen für einen Arc-aktivierten Kubernetes-Cluster aus.	Extension	Preview
az connectedk8s update	Dient zum Aktualisieren der Eigenschaften des integrierten Kubernetes-Clusters des Arc.	Extension	GA
az connectedk8s upgrade	Atomisch aktualisieren onboarded Agents auf die spezifische Version oder standard auf die neueste Version.	Extension	GA

az connectedk8s connect

Onboarding eines verbundenen Kubernetes-Clusters in Azure.

Der Kubernetes-Cluster, der als verbundener Cluster integriert werden soll, muss der Standardcluster in kubeconfig sein. Führen Sie kubectl config get-contexts aus, um den Zielkontextnamen zu bestätigen. Legen Sie dann den Standardkontext auf den richtigen Cluster fest, indem Sie kubectl config use-context target-cluster-name ausführen.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--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]

Beispiele

Onboarding eines verbundenen Kubernetes-Clusters mit standard kube config and kube context.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Onboarding eines verbundenen Kubernetes-Clusters mit kube-Standardkonfiguration und Kube-Kontext und Deaktivieren des automatischen Upgrades von Arc-Agents.

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

Integrieren Sie einen verbundenen Kubernetes-Cluster, indem Sie kubeconfig und kubecontext angeben.

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

Integrieren Sie einen verbundenen Kubernetes-Cluster, indem Sie den HTTPS-Proxy, http-Proxy, keine Proxyeinstellungen angeben.

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

Integrieren Sie einen verbundenen Kubernetes-Cluster, indem Sie den HTTPS-Proxy, http-Proxy, keinen Proxy mit Zertifikateinstellungen angeben.

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 eines verbundenen Kubernetes-Clusters mit aktivierter privater Linkfunktion, indem Sie private Linkparameter angeben.

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

Onboarding eines verbundenen Kubernetes-Clusters mit benutzerdefiniertem Onboarding-Timeout.

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

Integrieren Sie einen verbundenen Kubernetes-Cluster mit oidc-Aussteller und aktiviertem Workload-Identitätswebhook.

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

Onboarding eines verbundenen Kubernetes-Clusters mit aktiviertem oidc-Aussteller mithilfe einer selbst gehosteten Aussteller-URL für öffentliche Cloudcluster.

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

Onboarding eines verbundenen Kubernetes-Clusters mit aktivierter Azure-Gateway-Funktion.

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

Erforderliche Parameter

--name -n

Der Name des verbundenen Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--azure-hybrid-benefit

Kennzeichnen, um Azure-Hybridvorteil Feature zu aktivieren/deaktivieren.

Eigenschaft	Wert
Zulässige Werte:	False, NotApplicable, True

--config --configuration-settings

Vorschau

Konfigurationseinstellungen als schlüssel=Wertpaar. Wiederholen Sie den Parameter für jede Einstellung. Verwenden Sie dies nicht für geheime Schlüssel, da dieser Wert als Antwort zurückgegeben wird.

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

Vorschau

Konfigurationsgeschützte Einstellungen als Schlüssel=Wertpaar. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.

--container-log-path

Überschreiben Sie den Standardmäßigen Containerprotokollpfad, um die Fluent-Bit-Protokollierung zu aktivieren.

--correlation-id

Eine GUID, die verwendet wird, um die Quelle des Cluster-Onboardings intern nachzuverfolgen. Bitte ändern Sie sie nicht, es sei denn, es wird empfohlen.

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

Pfad zur Zertifikatdatei für Proxy- oder benutzerdefinierte Zertifizierungsstelle.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--custom-locations-oid

OID der App "custom-locations".

--disable-auto-upgrade

Kennzeichnen, um das automatische Upgrade von Arc-Agents zu deaktivieren.

Eigenschaft	Wert
Standardwert:	False

--distribution

Die Kubernetes-Verteilung, die auf diesem verbundenen Cluster ausgeführt wird.

Eigenschaft	Wert
Standardwert:	generic
Zulässige Werte:	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

Die Kubernetes-Verteilungsversion des verbundenen Clusters.

--enable-oidc-issuer

Vorschau

Aktivieren Sie die Erstellung der OIDC-Aussteller-URL, die für den Workload-Identitätsverbund verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments
Standardwert:	False
Zulässige Werte:	false, true

--enable-private-link

Vorschau

Kennzeichnen, um die Unterstützung für private Links in einer verbundenen Clusterressource zu aktivieren/zu deaktivieren. Zulässige Werte: false, true.

Eigenschaft	Wert
Parametergruppe:	PrivateLink Arguments
Zulässige Werte:	false, true

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

Vorschau

Aktivieren Sie den Workload-Identitätswebhook.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments
Standardwert:	False
Zulässige Werte:	false, true

--gateway-resource-id

Vorschau

ArmID der Arc Gateway-Ressource.

Eigenschaft	Wert
Parametergruppe:	Gateway Arguments

--infrastructure

Die Infrastruktur, auf der der Kubernetes-Cluster, der durch diesen verbundenen Cluster dargestellt wird, ausgeführt wird.

Eigenschaft

Wert

Standardwert:

generic

Zulässige Werte:

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

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft	Wert
Parametergruppe:	Timeout Arguments
Standardwert:	False

--onboarding-timeout

Benötigte Zeit (in Sekunden), damit die Arc-Agent-Pods auf dem Kubernetes-Cluster installiert werden. Überschreiben Sie diesen Wert, wenn die Hardware-/Netzwerkeinschränkungen für Ihren Cluster mehr Zeit für die Installation der Arc-Agent-Pods benötigen.

Eigenschaft	Wert
Parametergruppe:	Timeout Arguments
Standardwert:	1200

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

Vorschau

ARM-Ressourcen-ID der Ressource für den privaten Linkbereich, der dieser verbundene Cluster zugeordnet ist.

Eigenschaft	Wert
Parametergruppe:	PrivateLink Arguments

--proxy-http

Http-Proxy-URL, die verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--proxy-https

Https-Proxy-URL, die verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--proxy-skip-range

Liste der URLs/CIDRs, für die kein Proxy verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--self-hosted-issuer

Vorschau

Selbst gehostete Aussteller-URL für öffentliche Cloudcluster – AKS, GKE, EKS.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s delete

Löschen Eines verbundenen Kubernetes-Clusters zusammen mit verbundenen Cluster-Agents.

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

Beispiele

Löschen Sie einen verbundenen Kubernetes-Cluster und verbundene Cluster-Agents mit standard kubeconfig und kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Löschen Sie einen verbundenen Kubernetes-Cluster, indem Sie den Kubeconfig- und Kubecontext für die Löschung verbundener Cluster-Agents angeben.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--force

Erzwingen des Löschens, um alle Azure-Arc-Ressourcen aus dem Cluster zu entfernen.

Eigenschaft	Wert
Standardwert:	False

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft	Wert
Standardwert:	False

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s disable-features

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Deaktiviert die selektiven Features im verbundenen Cluster.

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

Beispiele

Deaktiviert das Azure-rbac-Feature.

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

Deaktivieren Sie mehrere Features.

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

Erforderliche Parameter

--features

Durch Leerzeichen getrennte Liste der Features, die Sie deaktivieren möchten.

Eigenschaft	Wert
Zulässige Werte:	azure-rbac, cluster-connect, custom-locations

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s enable-features

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktiviert die selektiven Features im verbundenen Cluster.

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]

Beispiele

Aktiviert die Clusterverbindungsfunktion.

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

Aktivieren Sie das Azure RBAC-Feature.

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

Aktivieren Sie mehrere Features.

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

Erforderliche Parameter

--features

Durch Leerzeichen getrennte Liste der Features, die Sie aktivieren möchten.

Eigenschaft	Wert
Zulässige Werte:	azure-rbac, cluster-connect, custom-locations

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--custom-locations-oid

OID der App "custom-locations".

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--skip-azure-rbac-list

Kommagetrennte Liste der Namen von Benutzernamen/E-Mail/oid. Azure RBAC wird für diese Benutzer übersprungen. Geben Sie an, wann azure-rbac aktiviert wird.

Eigenschaft	Wert
Parametergruppe:	Azure RBAC Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s list

Auflisten verbundener Kubernetes-Cluster.

az connectedk8s list [--resource-group]

Beispiele

Auflisten aller verbundenen Kubernetes-Cluster in einer Ressourcengruppe.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Alle verbundenen Kubernetes-Cluster in einem Abonnement auflisten.

az connectedk8s list --subscription subscriptionName

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s proxy

Erhalten Sie Zugriff auf einen verbundenen Kubernetes-Cluster.

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

Beispiele

Erhalten Sie Zugriff auf einen verbundenen Kubernetes-Cluster.

az connectedk8s proxy -n clusterName -g resourceGroupName

Zugriff auf einen verbundenen Kubernetes-Cluster mit benutzerdefiniertem Port erhalten

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

Zugriff auf einen verbundenen Kubernetes-Cluster mit Dienstkontotoken abrufen

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

Zugriff auf einen verbundenen Kubernetes-Cluster erhalten, indem Sie den benutzerdefinierten Kubeconfig-Speicherort angeben

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

Zugriff auf einen verbundenen Kubernetes-Cluster erhalten, indem Sie benutzerdefinierten Kontext angeben

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--file -f

Kubernetes-Konfigurationsdatei, die aktualisiert werden soll. Falls nicht angegeben, wird die Datei "~/.kube/config" aktualisiert. Verwenden Sie "-", um YAML stattdessen in Stdout zu drucken.

Eigenschaft	Wert
Standardwert:	~\.kube\config

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-context

Wenn angegeben, überschreiben Sie den Standardkontextnamen.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--port

Port, der für den Zugriff auf den verbundenen Cluster verwendet wird.

Eigenschaft	Wert
Standardwert:	47011

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--token

Dienstkontotoken für die Authentifizierung beim Kubernetes-Cluster.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s show

Zeigen Sie Details eines verbundenen Kubernetes-Clusters an.

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

Beispiele

Anzeigen der Details für einen verbundenen Kubernetes-Cluster

az connectedk8s show -g resourceGroupName -n connectedClusterName

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s troubleshoot

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Führen Sie Diagnoseprüfungen für einen Arc-aktivierten Kubernetes-Cluster aus.

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

Beispiele

Führen Sie Diagnoseprüfungen für einen Arc-aktivierten Kubernetes-Cluster aus.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Erforderliche Parameter

--name -n

Der Name des verbundenen Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubeconfig-Kontext vom aktuellen Computer.

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s update

Dient zum Aktualisieren der Eigenschaften des integrierten Kubernetes-Clusters des Arc.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--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]

Beispiele

Aktualisieren von Proxywerten für die Agents

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

Deaktivieren von Proxyeinstellungen für Agents

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

Automatisches Upgrade von Agents deaktivieren

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

Aktualisieren Sie einen verbundenen Kubernetes-Cluster mit aktiviertem oidc-Aussteller und aktiviertem Workload-Identitätswebhook.

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

Aktualisieren Sie einen verbundenen Kubernetes-Cluster mit aktiviertem oidc-Aussteller mithilfe einer selbst gehosteten Aussteller-URL für öffentliche Cloudcluster.

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

Deaktivieren Sie den Workload-Identitätswebhook in einem verbundenen Kubernetes-Cluster.

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

Aktualisieren Sie einen verbundenen Kubernetes-Cluster mit aktivierter Azure-Gateway-Funktion.

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

Deaktivieren Sie das Azure-Gateway-Feature in einem verbundenen Kubernetes-Cluster.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--auto-upgrade

Kennzeichnen, um das automatische Upgrade von Arc-Agents zu aktivieren/deaktivieren. Standardmäßig ist das automatische Upgrade von Agents aktiviert.

Eigenschaft	Wert
Zulässige Werte:	false, true

--azure-hybrid-benefit

Kennzeichnen, um Azure-Hybridvorteil Feature zu aktivieren/deaktivieren.

Eigenschaft	Wert
Zulässige Werte:	False, NotApplicable, True

--config --configuration-settings

Vorschau

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

Vorschau

Konfigurationsgeschützte Einstellungen als Schlüssel=Wertpaar. Wiederholen Sie den Parameter für jede Einstellung. Nur der Schlüssel wird als Antwort zurückgegeben, der Wert ist nicht.

--container-log-path

Überschreiben Sie den Standardmäßigen Containerprotokollpfad, um die Fluent-Bit-Protokollierung zu aktivieren.

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

Pfad zur Zertifikatdatei für Proxy- oder benutzerdefinierte Zertifizierungsstelle.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--disable-gateway

Vorschau

Kennzeichnen, um Arc Gateway zu deaktivieren.

Eigenschaft	Wert
Parametergruppe:	Gateway Arguments
Standardwert:	False
Zulässige Werte:	false, true

--disable-proxy

Deaktiviert Proxyeinstellungen für Agents.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments
Standardwert:	False

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

Vorschau

Arbeitsauslastungsidentitätswebhook deaktivieren.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments
Zulässige Werte:	false, true

--distribution

Die Kubernetes-Verteilung, die auf diesem verbundenen Cluster ausgeführt wird.

Eigenschaft	Wert
Zulässige Werte:	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

Die Kubernetes-Verteilungsversion des verbundenen Clusters.

--enable-oidc-issuer

Vorschau

Aktivieren Sie die Erstellung der OIDC-Aussteller-URL, die für den Workload-Identitätsverbund verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments
Zulässige Werte:	false, true

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

Vorschau

Aktivieren Sie den Workload-Identitätswebhook.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments
Zulässige Werte:	false, true

--gateway-resource-id

Vorschau

ArmID der Arc Gateway-Ressource.

Eigenschaft	Wert
Parametergruppe:	Gateway Arguments

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--proxy-http

Http-Proxy-URL, die verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--proxy-https

Https-Proxy-URL, die verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--proxy-skip-range

Liste der URLs/CIDRs, für die kein Proxy verwendet werden soll.

Eigenschaft	Wert
Parametergruppe:	Proxy Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--self-hosted-issuer

Vorschau

Selbst gehostete Aussteller-URL für öffentliche Cloudcluster – AKS, GKE, EKS.

Eigenschaft	Wert
Parametergruppe:	Workload Identity Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az connectedk8s upgrade

Atomisch aktualisieren onboarded Agents auf die spezifische Version oder standard auf die neueste Version.

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

Beispiele

Aktualisieren der Agents auf die neueste Version

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Aktualisieren der Agents auf eine bestimmte Version

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

Aktualisieren Sie die Agents mit einem benutzerdefinierten Upgradetimeout.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--agent-version

Version des Agents zum Aktualisieren der Steuerdiagramme auf.

--ids

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--kube-config

Pfad zur Kube-Konfigurationsdatei.

--kube-context

Kubconfig-Kontext vom aktuellen Computer.

--name -n

Der Name des verbundenen Clusters.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--skip-ssl-verification

Überspringen Sie die SSL-Überprüfung für jede Clusterverbindung.

Eigenschaft	Wert
Standardwert:	False

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parametergruppe:	Resource Id Arguments

--upgrade-timeout

Erforderliche Zeit (in Sekunden), damit die Arc-Agent-Pods auf dem Kubernetes-Cluster aktualisiert werden. Überschreiben Sie diesen Wert, wenn die Hardware-/Netzwerkeinschränkungen für Ihren Cluster mehr Zeit für das Upgrade der Arc-Agent-Pods benötigen.

Eigenschaft	Wert
Standardwert:	600

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?

Freigeben über

az connectedk8s

Befehle

az connectedk8s connect

Beispiele

Erforderliche Parameter

Optionale Parameter

az connectedk8s delete

Beispiele

Optionale Parameter

az connectedk8s disable-features

Beispiele

Erforderliche Parameter

Optionale Parameter

az connectedk8s enable-features

Beispiele

Erforderliche Parameter

Optionale Parameter

az connectedk8s list

Beispiele

Optionale Parameter

az connectedk8s proxy

Beispiele

Optionale Parameter

az connectedk8s show

Beispiele

Optionale Parameter

az connectedk8s troubleshoot

Beispiele

Erforderliche Parameter

Optionale Parameter

az connectedk8s update

Beispiele

Optionale Parameter

az connectedk8s upgrade

Beispiele

Optionale Parameter

Feedback