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. 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 der Azure CLI ist 2.75.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. 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 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 und installierte Pakete können 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.

Von Bedeutung

Wenn Sie sich hinter einem Proxy befinden, müssen HTTP_PROXY und HTTPS_PROXY festgelegt werden, damit eine Verbindung zu Azure-Diensten mit der Azure CLI hergestellt werden kann. Wenn Sie keine grundlegende Authentifizierung verwenden, sollten Sie diese Variablen in Ihrer .bashrc Datei exportieren. Berücksichtigen Sie dabei immer die Sicherheitsrichtlinien Ihres Unternehmens und die Anforderungen Ihres Systemadministrators.

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

Aktualisierung

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 enthält die Azure CLI einen internen 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

Wenn Sie sich entscheiden, die Azure CLI zu deinstallieren, tut es uns leid, Sie verlieren zu müssen. 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 nun die Azure CLI unter macOS installiert haben, machen Sie einen kurzen Überblick über die Features und gängigen Befehle.

Erste Schritte mit Azure CLI