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. Für das Azure CLI-Paket ist macOS 13 oder höher erforderlich.

Die aktuelle Version des Azure CLI ist 2.84.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 unter macOS installieren, indem Sie Die Informationen zum Brew-Repository aktualisieren und dann den Befehl install 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 von Azure CLI installiert eine Abschlussdatei namens az im Verzeichnis "Homebrew-managed completions" (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 nutzt keine virtuelle Python-Umgebung, sondern ist darauf angewiesen, 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

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

Deinstallieren

Wenn Sie sich entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

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

brew uninstall azure-cli

Daten entfernen

Wenn Sie die Azure CLI nicht erneut installieren möchten, entfernen Sie dessen Daten.

rm -rf ~/.azure

Andere Installationsmethoden

Wenn Sie homebrew nicht verwenden können, um die Azure CLI in Ihrer Umgebung zu installieren, ist es möglich, die manuellen Anweisungen für Linux zu 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 Install Azure CLI unter Linux manuell.

Nächste Schritte

Nachdem Sie die Azure CLI unter macOS installiert haben, machen Sie eine kurze Erkundungstour durch die Funktionen und gängigen Befehle.