Die Azure CLI (Azure Command-Line Interface, Azure-Befehlszeilenschnittstelle) ist ein plattformübergreifendes Befehlszeilentool, das lokal auf Windows Computern installiert werden kann. Sie können mithilfe der Azure CLI für Windows eine Verbindung mit Azure herstellen und Verwaltungsbefehle für Azure-Ressourcen ausführen. Alternativ können Sie die Azure CLI für Windows auch mit einem Browser über Azure Cloud Shell nutzen oder aus einem Docker-Container ausführen.
Für Windows wird die Azure CLI über ein MSI- oder ZIP-Paket installiert, das Ihnen zugriff auf die CLI über die Windows-Eingabeaufforderung (CMD) oder PowerShell ermöglicht.
Bei der Installation für ein Windows-Subsystem für Linux (WSL) sind Pakete für Ihre Linux-Distribution verfügbar. Die Liste der unterstützten Paket-Manager bzw. Informationen zur manuellen Installation unter WSL finden Sie auf der Hauptseite für die Installation.
Die aktuelle Version der Azure CLI ist 2.69.0. Informationen zur neuesten Version finden Sie in den Versionshinweisen. Führen Sie az version aus, um Ihre installierte Version zu ermitteln und festzustellen, ob Sie die CLI aktualisieren müssen.
Installieren oder Aktualisieren
Die MSI- und ZIP-Verteilung kann zum Installieren oder Aktualisieren der Azure CLI unter Windows verwendet werden. Sie müssen aktuelle Versionen nicht deinstallieren, bevor Sie das MSI-Installationsprogramm verwenden, da mit der MSI-Datei vorhandene Versionen aktualisiert werden.
Wichtig
Nach Abschluss der Installation müssen Sie alle aktiven Terminalfenster schließen und erneut öffnen, um die Azure CLI verwenden zu können.
WinGet (Windows-Paket-Manager)
Verwenden Sie WinGet, Microsoft Package Manager für Windows, um Updates für Azure CLI zu installieren und zu verwalten. Winget installiert standardmäßig die 64-Bit-Azure CLI auf 64-Bit-Betriebssystemen.
Hinweis
WinGet ist standardmäßig in Windows 11 und modernen Versionen von Windows 10 verfügbar. winget kann jedoch nicht in älteren Versionen von Windows installiert werden. Informationen zur Installation finden Sie in der winget-Dokumentation.
PowerShell
winget install --exact --id Microsoft.AzureCLI
Mit der Option --exact soll sichergestellt werden, dass das offizielle Azure CLI-Paket installiert ist. Dieser Befehl installiert standardmäßig die neueste Version. Fügen Sie zum Angeben einer Version --version <version> mit der gewünschten Version zum Befehl hinzu. Hier ist ein Beispiel:
Laden Sie die aktuelle Version der Azure CLI herunter, und installieren Sie sie. Wenn das Installationsprogramm fragt, ob Änderungen am Computer vorgenommen werden dürfen, wählen Sie „Ja“ aus.
Wenn Sie zuvor die Azure CLI installiert haben, überschreibt die Ausführung der 32-Bit- oder 64-Bit-MSI-Datei eine vorhandene Installation.
Bestimmte Version
Wenn Sie es vorziehen, können Sie eine bestimmte Version von Azure CLI unter Verwendung einer URL herunterladen.
Um das MSI-Installationsprogramm für eine bestimmte Version herunterzuladen, ändern Sie das Versionssegment in die URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 Bit) oder https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 Bit).
Wenn Sie beispielsweise die 32-Bit-MSI-Datei der Azure CLI-Version 2.51.0 installieren möchten, lautet Ihre URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Die entsprechende 64-Bit-Installation wäre https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.
Dadurch wird das aktuelle 32-Bit-Installationsprogramm für die Azure CLI für Windows heruntergeladen und installiert. Wenn Sie eine 64-Bit-Installation bevorzugen, ändern Sie die URL in https://aka.ms/installazurecliwindowsx64. Wenn die Azure CLI bereits installiert ist, überschreibt das Installationsprogramm die vorhandene Version.
Um eine bestimmte Version zu installieren, ersetzen Sie das argument -Uri durch die im nächsten Abschnitt beschriebene URL. Hier sehen Sie ein Beispiel für die Verwendung des 32-Bit-Installationsprogramms der Azure CLI-Version 2.51.0 in PowerShell:
Um das MSI-Installationsprogramm für eine bestimmte Version herunterzuladen, ändern Sie das Versionssegment in die URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 Bit) oder https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 Bit).
Wenn Sie beispielsweise die 32-Bit-MSI-Datei der Azure CLI-Version 2.51.0 installieren möchten, lautet Ihre URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Die entsprechende 64-Bit-Installation wäre https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.
Obwohl der Großteil der Azure CLI-Dokumentation in einer Bash-Shell geschrieben und getestet wird, können Sie die Azure CLI auch mithilfe der PowerShell installieren und ausführen. Es gibt feine Syntaxunterschiede zwischen Bash und PowerShell. Lesen Sie diese Artikel, um Skriptfehler zu vermeiden:
Bei der Ausführung der Azure CLI in PowerShell gibt es auch Unterschiede bei der Fehlerbehandlung und die Möglichkeit, die Tabulatorvervollständigung zu aktivieren. Weitere Informationen finden Sie in folgenden Artikeln:
Dieses Paket befindet sich derzeit in der Vorschauversion.
Sie können das ZIP-Paket verwenden, um die Azure CLI unter Windows zu installieren. Dieses Paket ist nützlich, wenn Sie nicht über Administratorrechte verfügen.
Entpacken Sie das Paket in einen Ordner, und rufen Sie dann mit Cmd oder PowerShell die Azure CLI auf, indem Sie folgendes ausführen <unzipped folder path>\bin\az.cmd.
Wenn Sie den az Befehl direkt ausführen möchten, führen Sie die folgenden Schritte aus, um die Azure CLI zu Ihrer PATH Umgebungsvariable hinzuzufügen.
Öffnen Sie das Startmenü, und suchen Sie nach environment variables. Klicken Sie auf die Edit the system environment variables.
Klicken Sie auf die Schaltfläche Environment Variables....
Wählen Sie im User varibles for <username> Feld die Schaltfläche aus Path , und klicken Sie auf die Edit... Schaltfläche.
Klicken Sie auf die New Schaltfläche, und fügen Sie sie <unzipped folder path>\bin der Liste hinzu.
Starten Sie das Terminal neu. Sie sollten jetzt Befehle ausführen az können.
Wenn Sie es vorziehen, können Sie eine bestimmte Version von Azure CLI unter Verwendung einer URL herunterladen.
Um das ZIP-Paket für eine bestimmte Version herunterzuladen, ändern Sie das Versionssegment in der URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.
Um beispielsweise die 64-Bit-ZIP-Datei von Azure CLI, Version 2.57.0, zu installieren, wäre https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zipIhre URL .
Verfügbare Azure CLI-Versionen finden Sie unter Versionshinweise für die Azure CLI. Das ZIP-Paket ist ab Version 2.57.0 verfügbar. Nur 64-Bit ist verfügbar.
Ausführen der Azure CLI
Schließen Sie nach der Installation alle aktiven Terminalfenster, und öffnen Sie es erneut. Führen Sie die Azure CLI mit dem Befehl az entweder über die Windows-Eingabeaufforderung oder PowerShell aus. Ein häufiger erster Schritt besteht darin, Ihr aktives Abonnement zu überprüfen.
Azure CLI
az account show
Problembehandlung bei der Installation
In diesem Abschnitt finden Sie einige allgemeine Probleme, die bei der Installation der Azure CLI unter Windows auftreten können. Falls ein Problem auftritt, das hier nicht behandelt wird, melden Sie es auf GitHub.
PATH-Variable nicht festgelegt
Die häufigste Ursache für dieses Problem ist, dass das aktive Terminalfenster nach der Installation nicht neu gestartet wurde. Schließen Sie alle aktiven Terminalfenster, und öffnen Sie es erneut.
Der Proxy blockiert die Verbindung.
Wenn Sie das MSI-Installationsprogramm nicht herunterladen können, da Ihr Proxy die Verbindung blockiert, stellen Sie sicher, dass Sie den Proxy richtig konfiguriert haben. Für Windows 10 werden diese Einstellungen im Bereich Settings > Network & Internet > Proxy verwaltet. Wenden Sie sich an Ihren Systemadministrator, um Informationen zu den erforderlichen Einstellungen zu erhalten oder wenn Ihr Computer ggf. konfigurationsverwaltet ist oder ein erweitertes Setup erfordert.
Wichtig
Diese Einstellungen sind auch erforderlich, damit Sie mit der CLI sowohl über PowerShell als auch über die Eingabeaufforderung auf Azure-Dienste zugreifen können. Führen Sie dazu in PowerShell den folgenden Befehl aus:
Aktivieren der Vervollständigung per TAB-TASTE in PowerShell
Die Vervollständigung per TAB-TASTE, auch bekannt als „ Azure CLI-Vervollständigung“, erreicht die Vervollständigung der Eingaben durch das Bereitstellen von Hinweisen, das Aktivieren von Ermittlungen und das Beschleunigen der Eingabe. Befehlsnamen, Befehlsgruppennamen, Parameter und bestimmte Parameterwerte können durch Drücken der TAB-TASTE automatisch in die Befehlszeile eingefügt werden.
Die Vervollständigung per TAB-TASTE ist in Azure Cloud Shell und in den meisten Linux-Distributionen standardmäßig aktiviert. Ab Azure CLI Version 2.49 können Sie die Vervollständigung per TAB-TASTE für die Azure CLI in PowerShell aktivieren. Führen Sie folgende Schritte aus:
Erstellen oder bearbeiten Sie das in der Variablen $PROFILE gespeicherte Profil. Die einfachste Möglichkeit ist die Ausführung von notepad $PROFILE in PowerShell. Weitere Informationen finden Sie unter Erstellen Ihres Profils und Profile und Ausführungsrichtlinie.
Fügen Sie Ihrem PowerShell-Profil den folgenden Code hinzu:
Um alle verfügbaren Optionen im Menü anzuzeigen, fügen Sie Ihrem PowerShell-Profil Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete hinzu.
Aktualisieren der Azure-Befehlszeilenschnittstelle
Ab Version 2.11.0 enthält die Azure CLI einen internen Befehl, um ein Update auf die neueste Version durchzuführen.
Azure CLI
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 müssen Sie das Tool wie unter Installieren der Azure CLI beschrieben neu installieren, um es zu aktualisieren.
Wenn Sie die ZIP-Verteilung verwenden, löschen Sie den alten Installationsordner, und extrahieren Sie die neue Version an denselben Speicherort.
Migrieren zur 64-Bit-Version der Azure CLI
Ab Version 2.51.0 ist für die Azure CLI auch eine 64-Bit-MSI-Version verfügbar, die für eine bessere Leistung empfohlen wird.
Befolgen Sie diese Schritte, um zur 64-Bit-Version der Azure CLI zu migrieren:
Überprüfen Sie Ihre aktuelle CLI-Version und die installierten Erweiterungen, indem Sie az --version ausführen.
Erweiterungen müssen neu installiert werden. Es wird empfohlen, eine Sicherung des aktuellen Erweiterungsordners %userprofile%\.azure\cliextensions anzulegen, indem Sie ihn umbenennen, falls Sie zur 32-Bit-Version zurückwechseln möchten. Dieser Ordner wird automatisch erstellt, wenn Sie eine Erweiterung neu installieren.
Laden Sie das neueste 64-Bit-Installationsprogramm herunter, und installieren Sie es, wie unter Installieren oder Aktualisieren beschrieben. Die 32-Bit-MSI-Version wird automatisch deinstalliert.
Installieren Sie Erweiterungen, indem Sie az extension add --name <extension> --version <version> ausführen. Wenn Sie Erweiterungen nicht manuell neu installieren möchten, werden Sie bei der ersten Verwendung der Azure CLI aufgefordert, eine Erweiterung zu installieren. Weitere Informationen zum Installieren von Erweiterungen finden Sie unter Installieren und Verwalten von Erweiterungen.
Wenn nach der Migration Probleme auftreten, können Sie die 64-Bit-Version deinstallieren und die 32-Bit-MSI-Datei erneut installieren. Wenn Sie eine Sicherung Ihres 32-Bit-Erweiterungsordners angelegt haben, stellen Sie Ihren Erweiterungsordner nach der Änderung durch Umbenennen wieder her.
Deinstallieren
Es tut uns leid, wenn Sie die Azure CLI deinstallieren möchten. Verwenden Sie vor der Deinstallation den az feedback-Befehl, um uns mitzuteilen, was verbessert oder behoben werden sollte. Unser Ziel ist eine fehlerfreie und benutzerfreundliche Azure CLI. Falls ein Fehler aufgetreten ist, wären wir Ihnen dankbar, wenn Sie ein GitHub-Problem melden.
Sie deinstallieren die Azure-Befehlszeilenschnittstelle über die Liste „Apps und Features“ in Windows. Gehen Sie zum Deinstallieren wie folgt vor:
Plattform
Instructions
Windows 11
Start > Einstellungen > Apps > Installierte Apps
Windows 10
Starteinstellungen >> Apps > & Features
Windows 8 und Windows 7
Start > Systemsteuerung > Programme > Programm deinstallieren
Geben Sie auf diesem Bildschirm Azure CLI in die Suchleiste des Programms ein. Das Programm zum Deinstallieren wird als Microsoft CLI 2.0 for Azure angezeigt. Wählen Sie diese Anwendung und dann die Schaltfläche Uninstall aus.
Daten entfernen
Wenn Sie nicht planen, die Azure CLI neu zu installieren, entfernen Sie die zugehörigen Daten aus C:\Users\<username>\.azure\msal_token_cache.bin oder C:\Users\<username>\.azure\msal_token_cache.json.
Nächste Schritte
Nachdem Sie die Azure CLI unter Windows installiert haben, erfahren Sie mehr über die verschiedenen Möglichkeiten zum Anmelden.
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Feedback zu Azure CLI
Azure CLI ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben:
Informieren Sie sich über die Schritte zum lokalen Installieren der Azure CLI, Erstellen einer Website und Verwalten von Azure-Ressourcen mithilfe der CLI.
Veranschaulichen Sie wichtige Qualifikationen zum Konfigurieren, Verwalten, Schützen und Verwalten wichtiger professioneller Funktionen in Microsoft Azure.