Installieren der Azure CLI unter macOS

Das Azure Command-Line Interface (CLI) ist ein plattformübergreifendes Befehlszeilentool, das lokal auf macOS-Computern installiert werden kann. Sie können die Azure CLI verwenden, um eine Verbindung mit Azure herzustellen und administrative Befehle in Azure-Ressourcen mithilfe interaktiver Eingabeaufforderungen oder eines Skripts auszuführen.

Installieren Sie für die macOS-Plattform die Azure CLI mit homebrew-Paket-Manager. Mit Homebrew können Sie Ihre CLI-Installation ganz einfach auf dem neuesten Stand halten. Das CLI-Paket wurde ab der macOS-Version 10.9 getestet.

Die aktuelle Version der Azure CLI ist 2.70.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und zu sehen, ob ein Update erforderlich ist.

Installieren mit Homebrew

Homebrew ist die einfachste Möglichkeit zum Verwalten der CLI-Installation. Homebrew bietet praktische Optionen zum Installieren, Aktualisieren und Deinstallieren. Falls Homebrew auf Ihrem System nicht verfügbar ist, installieren Sie Homebrew unter [diesem Link](https://docs.brew.sh/Installation.html), bevor Sie fortfahren.

Sie können die Azure CLI auf macOS installieren, indem Sie die Brew-Repositoryinformationen aktualisieren und dann den install-Befehl ausführen.

brew update && brew install azure-cli

Problembehandlung

In diesem Abschnitt finden Sie einige allgemeine Fehler, die zu Problemen bei der Homebrew-basierten CLI-Installation führen können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.

Vervollständigung funktioniert nicht

Die Homebrew-Formel der Azure CLI installiert eine Vervollständigungsdatei namens az im von Homebrew verwalteten Vervollständigungsverzeichnis (Standardspeicherort ist /usr/local/etc/bash_completion.d/). Befolgen Sie um die Vervollständigung zu aktivieren Homebrews Anweisungen hier.

Fügen Sie für Zsh die folgenden zwei Zeilen am Ende Ihrer .zshrc Datei hinzu, speichern Sie Ihr Zsh-Profil und laden Sie es anschließend neu.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Python und installierte Pakete können nicht gefunden werden.

Bei der Installation von Homebrew weichen die Versionen unter Umständen geringfügig voneinander ab, oder es liegt ein anderes Problem vor. Die CLI verwendet keine virtuelle Python-Umgebung und ist daher von der Ermittlung der installierten Python-Version abhängig. Sie können das Problem möglicherweise beheben, indem Sie die python@3.10-Abhängigkeit installieren und über Homebrew neu verlinken.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

CLI-Version 1.x wird installiert.

Die Installation einer veralteten Version kann auf einen veralteten Homebrew-Cache zurückzuführen sein. Befolgen Sie die Aktualisierungsanleitung.

Der Proxy blockiert die Verbindung.

Möglicherweise können Sie keine Ressourcen von Homebrew abrufen, wenn Sie das Programm nicht korrekt zur Verwendung Ihres Proxys konfiguriert haben. Befolgen Sie die Anweisungen zur Proxykonfiguration für Homebrew.

Zum Abrufen der Bottle-Ressourcen von Homebrew muss Ihr Proxy HTTPS-Verbindungen mit den folgenden Adressen zulassen:

• https://formulae.brew.sh
• https://homebrew.bintray.com

Aktualisieren

Die CLI wird regelmäßig mit Fehlerbehebungen, Verbesserungen, neuen Features und Vorschaufunktionen aktualisiert. Ein neues Release ist ungefähr alle drei Wochen verfügbar.

Ab der Version 2.11.0 enthält die Azure CLI einen integrierten Befehl, um ein Update auf die neueste Version durchzuführen.

az upgrade

Mit diesem Befehl werden standardmäßig auch alle installierten Erweiterungen aktualisiert. Weitere az upgrade-Optionen finden Sie auf der Referenzseite für Befehle. Für Azure CLI-Versionen vor 2.11.0 aktualisieren Sie die Version, indem Sie das Tool wie unter Installieren der Azure CLI beschrieben neu installieren.

Sie können Ihre lokalen Homebrew-Repository-Informationen auch aktualisieren und anschließend das azure-cli-Paket aktualisieren.

brew update && brew upgrade azure-cli

Deinstallieren

Es tut uns leid, dass Sie sich dazu entschieden haben, die Azure CLI zu deinstallieren. Verwenden Sie vor der Deinstallation den az feedback-Befehl, um uns mitzuteilen, was verbessert oder behoben werden könnte. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI. Falls Sie einen Fehler gefunden haben, wären wir Ihnen dankbar, wenn Sie ein GitHub-Issue melden.

Verwenden Sie Homebrew, um das azure-cli Paket zu deinstallieren.

brew uninstall azure-cli

Daten entfernen

Wenn Sie nicht planen, die Azure CLI neu zu installieren, entfernen Sie die zugehörigen Daten.

rm -rf ~/.azure

Andere Installationsmethoden

Falls Sie die Azure-Befehlszeilenschnittstelle in Ihrer Umgebung nicht mithilfe von Homebrew installieren können, können Sie die manuelle Anleitung für Linux verwenden. Dieser Prozess ist offiziell nicht mit macOS kompatibel. Es empfiehlt sich immer, einen Paket-Manager wie Homebrew zu verwenden. Verwenden Sie die manuelle Installationsmethode nur, wenn keine andere Option zur Verfügung steht.

Anweisungen zur manuellen Installation finden Sie unter Manuelles Installieren der Azure CLI unter Linux.

Nächste Schritte

Machen Sie sich nach der Installation der Azure-Befehlszeilenschnittstelle unter macOS kurz mit den Features sowie mit häufig verwendeten Befehlen vertraut.