Installieren von 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. Homebrew macht es einfach, Ihre Installation der Azure CLI auf dem neuesten Stand zu halten. Das Azure CLI-Paket erfordert macOS 13 oder höher.

Die aktuelle Version des Azure CLI ist 2.86.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und zu überprüfen, ob Sie ein Update benötigen.

Installieren mit Homebrew

Homebrew ist die einfachste Möglichkeit, Ihre Azure CLI-Installation zu verwalten. Homebrew bietet praktische Optionen zum Installieren, Aktualisieren und Deinstallieren. Falls Homebrew auf Ihrem System nicht verfügbar ist, installieren Sie Homebrew, 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

Wenn beim Installieren der Azure CLI über Homebrew ein Problem auftritt, finden Sie hier einige häufige Fehler. Wenn hier ein Problem nicht behandelt wird, fileieren Sie ein Problem bei 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 zum Aktivieren der Vervollständigung diese Anweisungen von Homebrew.

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 oder installierte Pakete konnten nicht gefunden werden.

Während der Homebrew-Installation ist möglicherweise ein Nebenversionskonflikt oder ein anderes Problem aufgetreten. Die Azure CLI verwendet keine virtuelle Python-Umgebung, daher basiert sie darauf, die installierte Python-Version zu finden. 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

Azure CLI Version 1.x ist 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 Ressourcen von Homebrew nicht abrufen, es sei denn, Sie konfigurieren sie für die Verwendung Ihres Proxys. Befolgen Sie die Anweisungen zur Proxykonfiguration für Homebrew.

Um die Flaschenressourcen von Homebrew zu erhalten, muss Ihr Proxy HTTPS-Verbindungen mit den folgenden Adressen zulassen:

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

Aktualisieren

Die Azure CLI wird regelmäßig mit Fehlerbehebungen, Verbesserungen, neuen Features und Vorschaufunktionen aktualisiert. Eine neue Version ist etwa einmal im Monat verfügbar.

Ab Version 2.11.0 stellt die Azure CLI einen In-Tool-Befehl zum Aktualisieren auf die neueste Version bereit.

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. Aktualisieren Sie für Azure CLI Versionen vor 2.11.0, indem Sie es neu installieren, wie in Installieren Sie den Azure CLI beschrieben.

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

brew update && brew upgrade azure-cli

Uninstall

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie zu verlieren. Bevor Sie deinstallieren, verwenden Sie den Befehl az feedback, um uns mitzuteilen, was verbessert oder behoben werden könnte. Unser Ziel ist es, die Azure CLI fehlerfrei und benutzerfreundlicher zu gestalten. Falls ein Fehler aufgetreten ist, wären wir Ihnen dankbar, wenn Sie ein GitHub-Problem melden.

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

brew uninstall azure-cli

Daten entfernen

Wenn Sie nicht beabsichtigen, die Azure CLI neu zu installieren, entfernen Sie dessen 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. Die Verwendung eines Paket-Managers wie Homebrew wird empfohlen. 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

Nachdem Sie die Azure CLI unter macOS installiert haben, machen Sie sich kurz mit den Features und allgemeinen Befehlen vertraut, indem Sie eine kurze Tour unternehmen.