Verwalten von Azure CLI-Erweiterungen: Installieren, Aktualisieren und Entfernen

Die Azure CLI umfasst eine Funktion zum Laden von Erweiterungen. Bei Erweiterungen für die Azure CLI handelt es sich um Python-Wheels, die nicht zusammen mit der CLI bereitgestellt, aber als CLI-Befehle ausgeführt werden. Mit Erweiterungen erhalten Sie Zugriff auf experimentelle Befehle und Vorabversionen von Befehlen und können eigene CLIs schreiben. Dieser Artikel behandelt die Verwaltung von Erweiterungen und enthält Antworten auf allgemeine Fragen zu ihrer Verwendung.

Suchen nach Erweiterungen

Verwenden Sie den Befehl az extension list-available, um die von Microsoft bereitgestellten und verwalteten Azure CLI-Erweiterungen anzuzeigen.

az extension list-available --output table

Auf der Dokumentationswebsite wird darüber hinaus eine Liste der Erweiterungen bereitgestellt.

So installieren Sie Erweiterungen

Manuelles Installieren von Erweiterungen

Nachdem Sie eine zu installierende Erweiterung gefunden haben, verwenden Sie az extension add, um sie zu installieren. Wenn die Erweiterung in der Ausgabe von az extension list-availableangezeigt wird, können Sie sie anhand des Namens installieren.

az extension add --name <extension-name>

Wenn die Erweiterung von einer externen Ressource stammt oder Sie über einen direkten Link dafür verfügen, geben Sie die Quell-URL oder den lokalen Pfad an. Die Erweiterung muss eine kompilierte Python-Wheeldatei sein.

az extension add --source <URL-or-path>

Sie können auch einen privaten Erweiterungsindex basierend auf dem Format von index.json erstellen und dann die von der Azure CLI verwendete URL für den Erweiterungsindex entsprechend angeben (ab Version 2.20.0). Anschließend können Sie die Erweiterung nach Namen aus dem privaten Erweiterungsindex installieren.

az config set extension.index_url=<URL>
az extension add --name <extension-name>

Nachdem Sie eine Erweiterung installiert haben, wird sie unter dem Wert der $AZURE_EXTENSION_DIR Shellvariable angezeigt. Wenn diese Variable nicht festgelegt ist, befindet sich der Standardspeicherort unter Linux sowie macOS bei $HOME/.azure/cliextensions und unter Windows bei %USERPROFILE%\.azure\cliextensions.

Automatisches Installieren von Erweiterungen

Wenn Sie einen nicht installierten Erweiterungsbefehl ausführen, kann die Azure CLI ab der Version 2.10.0 den auszuführenden Befehl erkennen und die Erweiterung automatisch für Sie installieren. Dieses Feature, das als dynamische Installation bezeichnet wird, ist standardmäßig aktiviert, beginnend mit Version 2.12.0. Für frühere unterstützte Versionen können Sie es auch über die Konfiguration aktivieren.

az config set extension.use_dynamic_install=yes_prompt

Verwenden Sie den folgenden Konfigurationsbefehl, um die dynamische Installation ohne Aufforderung zu aktivieren:

az config set extension.use_dynamic_install=yes_without_prompt

Verwenden Sie den folgenden Konfigurationsbefehl, um die dynamische Installation zu deaktivieren und zum Standardverhalten zurückzukehren: Ist die Erweiterung nicht installiert, gibt der Erweiterungsbefehl einen 'Befehl nicht gefunden'-Fehler zurück.

az config set extension.use_dynamic_install=no

Standardmäßig läuft ein Erweiterungsbefehl, der eine dynamische Installation erfordert, nach der Installation der Erweiterung weiter. Sie können dieses Standardverhalten so ändern, dass der Befehl ohne eine erneute Ausführung beendet wird. Legen Sie hierzu die Eigenschaft run_after_dynamic_install auf no fest.

az config set extension.run_after_dynamic_install=no

Wie man Erweiterungen aktualisiert

Wenn Sie eine Erweiterung nach Namen installieren, aktualisieren Sie sie mithilfe von az extension update.

az extension update --name <extension-name>

Andernfalls kann eine Erweiterung anhand der Quelle gemäß den Anweisungen unter Installieren von Erweiterungen aktualisiert werden.

Wenn Sie die CLI nicht verwenden können, um einen Erweiterungsnamen aufzulösen, deinstallieren Sie die Erweiterung, und versuchen Sie, sie erneut zu installieren. Die Erweiterung kann auch Teil der Basis-CLI sein. Aktualisieren Sie die CLI, wie unter "Installieren der Azure CLI " beschrieben, und überprüfen Sie, ob die Befehle der Erweiterung verfügbar sind.

Wie man Erweiterungen deinstalliert

Wenn Sie eine Erweiterung nicht mehr benötigen, entfernen Sie sie mit az extension remove.

az extension remove --name <extension-name>

Sie können eine Erweiterung auch entfernen, indem Sie sie am Installationsspeicherort manuell löschen. Die Shellvariable $AZURE_EXTENSION_DIR legt fest, welche Module installiert werden. Wenn diese Variable nicht festgelegt ist, befindet sich der Wert standardmäßig unter $HOME/.azure/cliextensions (Linux und macOS) bzw. %USERPROFILE%\.azure\cliextensions (Windows).

rm -rf $AZURE_EXTENSION_DIR/<extension-name>

Häufig gestellte Fragen

Hier sind einige Antworten auf andere häufig gestellte Fragen zu CLI-Erweiterungen aufgeführt.

Welche Dateiformate sind für die Installation zulässig?

Derzeit können nur kompilierte Python-Wheels als Erweiterungen installiert werden.

Können Erweiterungen vorhandene Befehle ersetzen?

Ja. Erweiterungen können vorhandene Befehle ersetzen, aber die CLI gibt eine Warnung aus, bevor ein ersetzter Befehl ausgeführt wird.

Woran erkenne ich, dass es sich bei einer Erweiterung um eine Vorabversion handelt?

Anhand der Dokumentation und der Versionsverwaltung können Sie erkennen, ob es sich bei einer Erweiterung um eine Vorabversion handelt. Microsoft veröffentlicht häufig Vorschaubefehle als CLI-Erweiterungen, damit sie später ggf. in das CLI-Hauptprodukt aufgenommen werden können. Wenn Befehle aus Erweiterungen verschoben werden, muss die alte Erweiterung deinstalliert werden.

Können Erweiterungen voneinander abhängig sein?

Nein. Da die CLI keine Ladereihenfolge garantiert, werden Abhängigkeiten möglicherweise nicht erfüllt. Das Entfernen einer Erweiterung wirkt sich nicht auf andere Erweiterungen aus.

Werden Erweiterungen zusammen mit der CLI aktualisiert?

Nein. Erweiterungen müssen separat aktualisiert werden, wie unter Aktualisieren von Erweiterungen beschrieben.

Wie entwickeln Sie Ihre eigene Erweiterung?

Sehen Sie sich das offizielle Repository an, wenn Sie weitere Unterstützung benötigen. Azure/azure-cli-extensions