Freigeben über


az extension

Verwalten und Aktualisieren von CLI-Erweiterungen

Befehle

Name Beschreibung Typ Status
az extension add

Fügen Sie eine Erweiterung hinzu.

Core Allgemein verfügbar
az extension list

Auflisten der installierten Erweiterungen.

Core Allgemein verfügbar
az extension list-available

Auflisten öffentlich verfügbarer Erweiterungen.

Core Allgemein verfügbar
az extension list-versions

Auflisten der verfügbaren Versionen für eine Erweiterung.

Core Allgemein verfügbar
az extension remove

Entfernen Sie eine Erweiterung.

Core Allgemein verfügbar
az extension show

Zeigen Sie eine Erweiterung an.

Core Allgemein verfügbar
az extension update

Aktualisieren sie eine Erweiterung.

Core Allgemein verfügbar

az extension add

Fügen Sie eine Erweiterung hinzu.

Informationen zum automatischen Installieren von Erweiterungen finden Sie unter https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Beispiele

Erweiterung nach Name hinzufügen

az extension add --name anextension

Erweiterung von URL hinzufügen

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Erweiterung von einem lokalen Datenträger hinzufügen

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Hinzufügen einer Erweiterung von einem lokalen Datenträger und Verwenden des Pip-Proxys für Abhängigkeiten

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Hinzufügen einer Erweiterung zum Systemverzeichnis

az extension add --name anextension --system

Hinzufügen einer bestimmten Version der Erweiterung

az extension add --name anextension --version 1.0.0

Aktualisieren der Erweiterung, falls bereits installiert

az extension add --upgrade --name anextension

Optionale Parameter

--allow-preview
Als veraltet markiert

Der Standardwert von "---allow-preview" wird in der nächsten Änderungsversion (2.67.0) in "false" von "true" geändert.

Schließen Sie ggf. Vorschaupakete für die Erweiterungsinstallation ein.

Zulässige Werte: false, true
--name -n

Name der Erweiterung.

--pip-extra-index-urls

Durch Leerzeichen getrennte Liste mit zusätzlichen URLs von von Paketindizes, die verwendet werden sollen. Dies sollte auf ein Repository verweisen, das mit PEP 503 konform ist (die einfache Repository-API), oder auf ein lokales Verzeichnis, das im gleichen Format angeordnet ist.

--pip-proxy

Proxy für Pip zur Verwendung für Erweiterungsabhängigkeiten in Form von [user:passwd@]proxy.server:port.

--source -s

Dateipfad oder URL zu einer Erweiterung.

--system

Verwenden Sie ein Systemverzeichnis für die Erweiterung.

Der Standardpfad ist der Ordner "azure-cli-extensions" unter dem CLI-Pfad der Python-Umgebungsbibliothek, der durch umgebungsvariable AZURE_EXTENSION_SYS_DIR konfigurierbar ist. Unter Windows müssen Sie ihre Shell möglicherweise als Administrator öffnen, um mit der richtigen Berechtigung ausgeführt zu werden.

--upgrade

Aktualisieren Sie die Erweiterung, falls bereits installiert, andernfalls installieren Sie einfach die Erweiterung.

--version

Die spezifische Version einer Erweiterung.

Standardwert: latest
--yes -y

Nicht zur Bestätigung auffordern

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

Auflisten der installierten Erweiterungen.

az extension list
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 extension list-available

Auflisten öffentlich verfügbarer Erweiterungen.

az extension list-available [--show-details]

Beispiele

Auflisten aller öffentlich verfügbaren Erweiterungen

az extension list-available

Auflisten von Details zu einer bestimmten Erweiterung

az extension list-available --show-details --query anextension

Optionale Parameter

--show-details -d

Zeigen Sie die Rohdaten aus dem Erweiterungsindex an.

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

Auflisten der verfügbaren Versionen für eine Erweiterung.

az extension list-versions --name

Beispiele

Auflisten der verfügbaren Versionen für eine Erweiterung

az extension list-versions --name anextension

Erforderliche Parameter

--name -n

Name der Erweiterung.

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 extension remove

Entfernen Sie eine Erweiterung.

az extension remove --name

Beispiele

Entfernen Sie eine Erweiterung. (automatisch generiert)

az extension remove --name MyExtension

Erforderliche Parameter

--name -n

Name der Erweiterung.

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

Zeigen Sie eine Erweiterung an.

az extension show --name

Beispiele

Zeigen Sie eine Erweiterung an. (automatisch generiert)

az extension show --name MyExtension

Erforderliche Parameter

--name -n

Name der Erweiterung.

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

Aktualisieren sie eine Erweiterung.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Beispiele

Aktualisieren einer Erweiterung anhand des Namens

az extension update --name anextension

Aktualisieren einer Erweiterung anhand des Namens und Verwenden des Pip-Proxys für Abhängigkeiten

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Erforderliche Parameter

--name -n

Name der Erweiterung.

Optionale Parameter

--allow-preview
Als veraltet markiert

Der Standardwert von "---allow-preview" wird in der nächsten Änderungsversion (2.67.0) in "false" von "true" geändert.

Schließen Sie ggf. Vorschaupakete für die Erweiterungsinstallation ein.

Zulässige Werte: false, true
--pip-extra-index-urls

Durch Leerzeichen getrennte Liste mit zusätzlichen URLs von von Paketindizes, die verwendet werden sollen. Dies sollte auf ein Repository verweisen, das mit PEP 503 konform ist (die einfache Repository-API), oder auf ein lokales Verzeichnis, das im gleichen Format angeordnet ist.

--pip-proxy

Proxy für Pip zur Verwendung für Erweiterungsabhängigkeiten in Form von [user:passwd@]proxy.server:port.

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.