Freigeben über


az k8s-extension

Note

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

Befehle zum Verwalten von Kubernetes-Erweiterungen.

Befehle

Name Beschreibung Typ Status
az k8s-extension create

Erstellen Sie eine Kubernetes-Clustererweiterung, einschließlich des Kaufs eines Erweiterungsangebots von Azure Marketplace (nur AKS). Weitere Informationen zum Erstellen einer Erweiterung oder zum Kauf eines Erweiterungsangebots finden Sie im Beispiel am Ende.

Extension GA
az k8s-extension delete

Löschen Sie eine Kubernetes-Erweiterung.

Extension GA
az k8s-extension extension-types

Befehle zum Ermitteln von Kubernetes-Erweiterungstypen.

Extension Preview
az k8s-extension extension-types list-by-cluster

Auflisten der verfügbaren Clustererweiterungstypen für einen vorhandenen Cluster. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters.

Extension Preview
az k8s-extension extension-types list-by-location

Auflisten der verfügbaren Clustererweiterungstypen in einer Region.

Extension Preview
az k8s-extension extension-types list-versions-by-cluster

Auflisten der verfügbaren Versionen für einen Clustererweiterungstyp für einen bestimmten Cluster. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters.

Extension Preview
az k8s-extension extension-types list-versions-by-location

Listet die verfügbaren Versionen für eine Clustererweiterungstypversion in einer Region auf.

Extension Preview
az k8s-extension extension-types show-by-cluster

Eigenschaften für einen Clustererweiterungstyp für einen vorhandenen Cluster anzeigen. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters.

Extension Preview
az k8s-extension extension-types show-by-location

Eigenschaften für einen Clustererweiterungstyp in einem Bereich anzeigen.

Extension Preview
az k8s-extension extension-types show-version-by-cluster

Eigenschaften anzeigen, die einer Clustererweiterungstypversion für einen vorhandenen Cluster zugeordnet sind. Zu den Eigenschaften, die zum Filtern verwendet werden, gehören der Typ des Clusters (verwaltet, verbunden usw.), die Kubernetes-Version, der Speicherort des Clusters.

Extension Preview
az k8s-extension extension-types show-version-by-location

Eigenschaften anzeigen, die einer Clustererweiterungstypversion in einer Region zugeordnet sind.

Extension Preview
az k8s-extension list

Kubernetes-Erweiterungen auflisten.

Extension GA
az k8s-extension show

Zeigen Sie eine Kubernetes-Erweiterung an.

Extension GA
az k8s-extension troubleshoot

Führen Sie Diagnoseprüfungen für eine Kubernetes-Erweiterung durch.

Extension Preview
az k8s-extension update

Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.

Extension GA

az k8s-extension create

Erstellen Sie eine Kubernetes-Clustererweiterung, einschließlich des Kaufs eines Erweiterungsangebots von Azure Marketplace (nur AKS). Weitere Informationen zum Erstellen einer Erweiterung oder zum Kauf eines Erweiterungsangebots finden Sie im Beispiel am Ende.

Erstellen Sie eine Kubernetes-Erweiterung. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Zusätzliche Informationen finden Sie unter http://aka.ms/clisecrets.

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

Beispiele

Erstellen einer Kubernetes-Erweiterung

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

Erstellen einer Kubernetes Marketplace-Erweiterung

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

Erforderliche Parameter

--cluster-name -c

Name des Kubernetes-Clusters

--cluster-type -t

Geben Sie Arc-Cluster oder AKS-verwaltete Cluster oder Arc Appliances oder provisionedClusters an.

Eigenschaft Wert
Zulässige Werte: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Name des Erweiterungstyps

--name -n

Name der Erweiterungsinstanz

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

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

Automatisches Aktualisieren der Nebenversion der Erweiterungsinstanz

Eigenschaft Wert
Parametergruppe: Version Arguments
Zulässige Werte: false, true
--cluster-resource-provider --cluster-rp

Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).

--config --configuration-settings

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-file --config-settings-file

JSON-Dateipfad für Konfigurationseinstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-protected --config-protected-settings

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-protected-file --config-protected-settings-file

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-settings
Als veraltet markiert

Option "--config-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--configuration-settings".

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-protected-settings
Als veraltet markiert

Option "--configuration-protected-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-settings".

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-protected-settings-file
Als veraltet markiert

Option "--configuration-protected-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-file".

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-settings-file
Als veraltet markiert

Option "--configuration-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-settings-file".

JSON-Dateipfad für Konfigurationseinstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--no-wait

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

Eigenschaft Wert
Standardwert: False
--plan-name

Der Planname verweist auf die Plan-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird.

Eigenschaft Wert
Parametergruppe: Marketplace Arguments
--plan-product

Das Planprodukt verweist auf die Produkt-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird. Ein Beispiel hierfür ist der Name des verwendeten ISV-Angebots.

Eigenschaft Wert
Parametergruppe: Marketplace Arguments
--plan-publisher

Der Planherausgeber verweist auf die Herausgeber-ID der Erweiterung, die vom Marketplace-Portal unter Nutzungsinformationen + Support übernommen wird.

Eigenschaft Wert
Parametergruppe: Marketplace Arguments
--release-namespace

Geben Sie den Namespace an, um die Erweiterungsversion zu installieren.

--release-train

Geben Sie den Release Train für den Erweiterungstyp an.

Eigenschaft Wert
Parametergruppe: Version Arguments
--scope

Geben Sie den Erweiterungsbereich an.

Eigenschaft Wert
Zulässige Werte: cluster, namespace
--target-namespace

Geben Sie den Zielnamespace an, der für die Erweiterungsinstanz installiert werden soll. Dieser Parameter ist erforderlich, wenn der Erweiterungsbereich auf "namespace" festgelegt ist.

--version

Geben Sie die version an, die für die Erweiterungsinstanz installiert werden soll, wenn --auto-upgrade-minor-version nicht aktiviert ist.

Eigenschaft Wert
Parametergruppe: Version 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/.

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

Löschen Sie eine Kubernetes-Erweiterung.

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

Beispiele

Löschen einer vorhandenen Kubernetes-Erweiterung

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

Erforderliche Parameter

--cluster-name -c

Name des Kubernetes-Clusters

--cluster-type -t

Geben Sie Arc-Cluster oder AKS-verwaltete Cluster oder Arc Appliances oder provisionedClusters an.

Eigenschaft Wert
Zulässige Werte: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Name der Erweiterungsinstanz

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

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

Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).

--force

Geben Sie an, ob das Löschen der Erweiterung aus dem Cluster erzwungen werden soll.

Eigenschaft Wert
Standardwert: False
--no-wait

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

Eigenschaft Wert
Standardwert: False
--yes -y

Bestätigungsaufforderungen ignorieren.

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

Kubernetes-Erweiterungen auflisten.

Listet alle Kubernetes-Erweiterungen in einem Cluster auf, einschließlich ihrer Eigenschaften. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Zusätzliche Informationen finden Sie unter http://aka.ms/clisecrets.

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

Beispiele

Auflisten aller Kubernetes-Erweiterungen auf einem Cluster

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

Erforderliche Parameter

--cluster-name -c

Name des Kubernetes-Clusters

--cluster-type -t

Geben Sie Arc-Cluster oder AKS-verwaltete Cluster oder Arc Appliances oder provisionedClusters an.

Eigenschaft Wert
Zulässige Werte: appliances, connectedClusters, managedClusters, provisionedClusters
--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.

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

Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).

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

Zeigen Sie eine Kubernetes-Erweiterung an.

Zeigen Sie eine Kubernetes-Erweiterung einschließlich der zugehörigen Eigenschaften an. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Zusätzliche Informationen finden Sie unter http://aka.ms/clisecrets.

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

Beispiele

Details einer Kubernetes-Erweiterung anzeigen

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

Erforderliche Parameter

--cluster-name -c

Name des Kubernetes-Clusters

--cluster-type -t

Geben Sie Arc-Cluster oder AKS-verwaltete Cluster oder Arc Appliances oder provisionedClusters an.

Eigenschaft Wert
Zulässige Werte: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Name der Erweiterungsinstanz

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

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

Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).

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 k8s-extension 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 eine Kubernetes-Erweiterung durch.

Dieser Befehl wird verwendet, um probleme mit einer Kubernetes-Erweiterung zu beheben. Es sammelt Protokolle und andere Informationen, die verwendet werden können, um Probleme mit der Erweiterung zu diagnostizieren.

az k8s-extension troubleshoot --name
                              --namespace-list
                              [--kube-config]
                              [--kube-context]
                              [--skip-ssl-verification]

Beispiele

Problembehandlung bei einer Kubernetes-Erweiterung

az k8s-extension troubleshoot --name extension-name --namespace-list "namespace1,namespace2"

Erforderliche Parameter

--name -n

Name der Kubernetes-Erweiterung.

--namespace-list

Durch Trennzeichen getrennte Liste von Namespaces zur Problembehandlung.

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. Wenn nicht angegeben, wird die Standardkonfigurationsdatei kube verwendet.

--kube-context

Kubeconfig-Kontext vom aktuellen Computer. Wenn nicht angegeben, wird der aktuelle Kontext aus der Kube-Konfigurationsdatei verwendet.

--skip-ssl-verification

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

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

Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.

Informationen zum Update auf ConfigSettings und ConfigProtectedSettings finden Sie in der Dokumentation des Clustererweiterungsdiensts, um die Aktualisierung dieser Eigenschaften zu überprüfen, bevor diese Eigenschaften aktualisiert werden. Die Ausgabe enthält geheime Schlüssel, die Sie schützen müssen. Achten Sie darauf, dass Sie diese geheimen Schlüssel nicht in die Quellcodeverwaltung einschließen. Stellen Sie außerdem sicher, dass in den Protokollen Ihres Befehls oder Skripts keine geheimen Schlüssel vorhanden sind. Zusätzliche Informationen finden Sie unter http://aka.ms/clisecrets.

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

Beispiele

Aktualisieren einer Kubernetes-Erweiterung

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

Erforderliche Parameter

--cluster-name -c

Name des Kubernetes-Clusters

--cluster-type -t

Geben Sie Arc-Cluster oder AKS-verwaltete Cluster oder Arc Appliances oder provisionedClusters an.

Eigenschaft Wert
Zulässige Werte: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Name der Erweiterungsinstanz

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

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

Automatisches Aktualisieren der Nebenversion der Erweiterungsinstanz

Eigenschaft Wert
Parametergruppe: Version Arguments
Zulässige Werte: false, true
--cluster-resource-provider --cluster-rp

Name des Clusterressourcenanbieters für diesen clusterType (erforderlich für provisionedClusters).

--config --configuration-settings

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-file --config-settings-file

JSON-Dateipfad für Konfigurationseinstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-protected --config-protected-settings

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-protected-file --config-protected-settings-file

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--config-settings
Als veraltet markiert

Option "--config-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--configuration-settings".

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-protected-settings
Als veraltet markiert

Option "--configuration-protected-settings" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-settings".

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.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-protected-settings-file
Als veraltet markiert

Option "--configuration-protected-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-protected-file".

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--configuration-settings-file
Als veraltet markiert

Option "--configuration-settings-file" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--config-settings-file".

JSON-Dateipfad für Konfigurationseinstellungen.

Eigenschaft Wert
Parametergruppe: Configuration Arguments
--no-wait

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

Eigenschaft Wert
Standardwert: False
--release-train

Geben Sie den Release Train für den Erweiterungstyp an.

Eigenschaft Wert
Parametergruppe: Version Arguments
--version

Geben Sie die version an, die für die Erweiterungsinstanz installiert werden soll, wenn --auto-upgrade-minor-version nicht aktiviert ist.

Eigenschaft Wert
Parametergruppe: Version Arguments
--yes -y

Bestätigungsaufforderungen ignorieren.

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