az k8s-extension

Hinweis

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. Weitere Informationen zu 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.

Durchwahl Allgemein verfügbar
az k8s-extension delete

Löschen Sie eine Kubernetes-Erweiterung.

Durchwahl Allgemein verfügbar
az k8s-extension extension-types

Befehle zum Ermitteln von Kubernetes-Erweiterungstypen.

Durchwahl Vorschau
az k8s-extension extension-types list

Auflisten der verfügbaren Clustererweiterungstypen für einen vorhandenen Cluster.

Durchwahl Vorschau und veraltet
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.

Durchwahl Vorschau
az k8s-extension extension-types list-by-location

Auflisten der verfügbaren Clustererweiterungstypen in einer Region.

Durchwahl Vorschau
az k8s-extension extension-types list-versions

Auflisten der verfügbaren Versionen für einen Clustererweiterungstyp für einen bestimmten Cluster.

Durchwahl Vorschau und veraltet
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.

Durchwahl Vorschau
az k8s-extension extension-types list-versions-by-location

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

Durchwahl Vorschau
az k8s-extension extension-types show

Dient zum Abrufen von Eigenschaften für einen Clustererweiterungstyp in einem Bereich.

Durchwahl Vorschau und veraltet
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.

Durchwahl Vorschau
az k8s-extension extension-types show-by-location

Eigenschaften für einen Clustererweiterungstyp in einem Bereich anzeigen.

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

Durchwahl Vorschau
az k8s-extension extension-types show-version-by-location

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

Durchwahl Vorschau
az k8s-extension list

Kubernetes-Erweiterungen auflisten.

Durchwahl Allgemein verfügbar
az k8s-extension show

Zeigen Sie eine Kubernetes-Erweiterung an.

Durchwahl Allgemein verfügbar
az k8s-extension update

Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.

Durchwahl Allgemein verfügbar

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. Weitere 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 verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster 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 Upgrade 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

Configuration Einstellungen as key=value pair. 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

Configuration Protected Einstellungen as key=value pair. 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".

Configuration Einstellungen as key=value pair. 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".

Configuration Protected Einstellungen as key=value pair. 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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster 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

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--yes -y

Bestätigungsaufforderungen ignorieren.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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. Weitere 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 verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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. Weitere 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 verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az k8s-extension update

Aktualisieren sie veränderbare Eigenschaften einer Kubernetes-Erweiterung.

Informationen zum Aktualisieren auf Config Einstellungen und ConfigProtected Einstellungen 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. Weitere 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 verwaltete AKS-Cluster oder Arc-Anwendung oder bereitgestellte Cluster 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 Upgrade 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

Configuration Einstellungen as key=value pair. 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

Configuration Protected Einstellungen as key=value pair. 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".

Configuration Einstellungen as key=value pair. 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".

Configuration Protected Einstellungen as key=value pair. 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

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--release-train

Geben Sie den Release-Zug 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.