az k8s-extension

Hinweis

Diese Referenz ist Teil der k8s-Erweiterung Erweiterung für die Azure CLI (Version 2.51.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az k8s-extension Befehl 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.	Erweiterung	GA
az k8s-extension delete	Löschen Sie eine Kubernetes-Erweiterung.	Erweiterung	GA
az k8s-extension extension-types	Befehle zum Ermitteln von Kubernetes-Erweiterungstypen.	Erweiterung	Vorschau
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.	Erweiterung	Vorschau
az k8s-extension extension-types list-by-location	Auflisten der verfügbaren Clustererweiterungstypen in einer Region.	Erweiterung	Vorschau
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.	Erweiterung	Vorschau
az k8s-extension extension-types list-versions-by-location	Listet die verfügbaren Versionen für eine Clustererweiterungstypversion in einer Region auf.	Erweiterung	Vorschau
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.	Erweiterung	Vorschau
az k8s-extension extension-types show-by-location	Eigenschaften für einen Clustererweiterungstyp in einem Bereich anzeigen.	Erweiterung	Vorschau
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.	Erweiterung	Vorschau
az k8s-extension extension-types show-version-by-location	Eigenschaften anzeigen, die einer Clustererweiterungstypversion in einer Region zugeordnet sind.	Erweiterung	Vorschau
az k8s-extension list	Kubernetes-Erweiterungen auflisten.	Erweiterung	GA
az k8s-extension show	Zeigen Sie eine Kubernetes-Erweiterung an.	Erweiterung	GA
az k8s-extension update	Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.	Erweiterung	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 {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

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.

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

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

Automatisches Aktualisieren der Nebenversion der Erweiterungsinstanz

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.

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

JSON-Dateipfad für Konfigurationseinstellungen.

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

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

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

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

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

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

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

--no-wait

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

Standardwert: False

--plan-name

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

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

--plan-publisher

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

--release-namespace

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

--release-train

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

--scope

Geben Sie den Erweiterungsbereich an.

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.

Globale Parameter

--debug

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

Standardwert: json

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

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

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

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

Standardwert: False

--no-wait

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

Standardwert: False

--yes -y

Bestätigungsaufforderungen ignorieren.

Standardwert: False

Globale Parameter

--debug

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

Standardwert: json

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

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]

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.

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

Standardwert: json

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

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]

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.

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

Standardwert: json

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

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 {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

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.

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

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

Automatisches Aktualisieren der Nebenversion der Erweiterungsinstanz

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.

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

JSON-Dateipfad für Konfigurationseinstellungen.

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

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

JSON-Dateipfad für konfigurationsgeschützte Einstellungen.

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

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

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

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

--no-wait

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

Standardwert: False

--release-train

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

--version

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

--yes -y

Bestätigungsaufforderungen ignorieren.

Standardwert: False

Globale Parameter

--debug

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

Standardwert: json

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