Installieren der Azure CLI unter Windows

2025-05-22

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. Die Azure CLI kann auch über einen Browser über die Azure Cloud Shell verwendet oder in einem Docker-Container ausgeführt werden.

Für Windows wird die Azure CLI über ein MSI- oder ZIP-Paket installiert, das Ihnen Zugriff auf die Azure CLI über PowerShell oder die Windows-Eingabeaufforderung (cmd.exeWindows Command Prompt) 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.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 oder Aktualisieren

Die MSI- und ZIP-Distribution-Pakete werden verwendet, um die Azure CLI unter Windows zu installieren oder zu aktualisieren. Sie müssen aktuelle Versionen nicht deinstallieren, bevor Sie das MSI-Installationsprogramm verwenden, da mit der MSI-Datei vorhandene Versionen aktualisiert werden.

Von Bedeutung

Nach Abschluss der Installation müssen Sie ein aktives Terminalfenster schließen und erneut öffnen, um die Azure CLI zu verwenden.

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. Es kann jedoch möglicherweise nicht in älteren Versionen von Windows installiert werden. Informationen zur Installation finden Sie in der winget-Dokumentation.

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. Ein Beispiel:

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

Microsoft Installer (MSI)

Neueste Version

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.

Neuste MSI der Azure CLI (32-Bit)

Aktuelles MSI der Azure CLI (64-Bit)

Wenn Sie die Azure CLI bereits zuvor installiert haben, wird durch die Ausführung der 32-Bit- oder 64-Bit-MSI-Datei eine vorhandene Installation überschrieben.

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.

Verfügbare Azure CLI-Versionen finden Sie unter Versionshinweise für die Azure CLI. Die 64-Bit-MSI-Datei ist ab Version 2.51.0 verfügbar.

Microsoft Installer (MSI) mit PowerShell

Um die Azure CLI mithilfe der PowerShell zu installieren, starten Sie die PowerShell als Administrator, und führen Sie den folgenden Befehl aus:

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.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:

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

Bestimmte Version

Verfügbare Azure CLI-Versionen finden Sie unter Versionshinweise für die Azure CLI. Die 64-Bit-MSI-Datei ist ab Version 2.51.0 verfügbar.

Syntaxunterschiede zwischen Bash und PowerShell

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:

Überlegungen zum Ausführen der Azure CLI in einer PowerShell-Skriptsprache
Verwenden von Anführungszeichen in Azure CLI-Parametern
Vergleich der Syntax von Bash, PowerShell und Cmd.exe in Erfahren Sie die Azure CLI-Syntaxunterschiede in Bash, PowerShell und Cmd

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 den folgenden Artikeln:

ZIP-Paket

Von Bedeutung

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 Edit the system environment variables.
Klicken Sie auf die Schaltfläche Environment Variables....
Im User variables for <username> Feld wählen Sie Path aus und klicken Sie auf die Edit... Schaltfläche.
Klicken Sie auf die New-Schaltfläche und fügen Sie <unzipped folder path>\bin der Liste hinzu.
Starten Sie das Terminal neu. Sie sollten jetzt az Befehle ausführen können.

Neueste Version

Neueste ZIP-Datei der Azure CLI (64-Bit)

Bestimmte Version

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 Ihre URL https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

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 az Befehl entweder über PowerShell oder die Windows-Eingabeaufforderung aus.

Bevor Sie Azure CLI-Befehle ausführen können, müssen Sie sich bei Azure anmelden. Um sich interaktiv anzumelden, verwenden Sie az login. Informationen zur Authentifizierung finden Sie unter Anmelden bei Azure mit Azure CLI.

az login

Ein häufiger erster Schritt besteht darin, Ihr aktives Abonnement zu überprüfen.

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 wird. 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 Ihr Proxy konfiguriert ist. Für Windows 11 werden diese Einstellungen im Settings > Network & Internet > Proxy Bereich verwaltet. Wenden Sie sich an Ihren Systemadministrator, um die erforderlichen Einstellungen zu erhalten oder in Situationen, in denen Ihr Rechner möglicherweise einer Konfigurationsverwaltung unterliegt oder eine erweiterte Einrichtung erfordert.

Von Bedeutung

Diese Einstellungen sind auch erforderlich, um über PowerShell oder die Eingabeaufforderung auf Azure-Dienste mit der Azure CLI zugreifen zu können. In PowerShell führen Sie diese Konfiguration mit dem folgenden Befehl aus:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Um die MSI-Datei abzurufen, muss Ihr Proxy HTTPS-Verbindungen mit den folgenden Adressen zulassen:

https://aka.ms/
https://azcliprod.blob.core.windows.net/

Weitere Informationen finden Sie unter "Arbeiten hinter einem Proxy " im Azure CLI-Handbuch zur Problembehandlung.

Lange Antwortzeiten

Siehe Migrieren zur 64-Bit-Azure CLI

Tab-Vervollständigung in PowerShell aktivieren

Die Tab-Vervollständigung, auch bekannt als „Azure CLI-Komplettierungen“, erlaubt die Vervollständigung von Eingaben, indem sie Hinweise bereitstellt, schnellere Entdeckung ermöglicht und die Eingabe beschleunigt. 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 Version 2.49 der Azure CLI können Sie die Tab-Vervollständigung in PowerShell aktivieren. Folgen Sie diesen Schritten:

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:

Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

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.

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.

Wenn Sie die ZIP-Verteilung verwenden, entfernen Sie den alten Installationsordner, und extrahieren Sie die neue Version an denselben Speicherort.

Migrieren zur 64-Bit-Version der Azure CLI

Ab 2.51.0 bietet Azure CLI auch eine 64-Bit-MSI-Version, die für eine bessere Leistung empfohlen wird.

Führen Sie die folgenden Schritte aus, um zur 64-Bit-Version von Azure CLI zu migrieren:

Überprüfen Sie Ihre aktuelle Azure CLI-Version und installierte Erweiterungen, indem Sie diese ausführen az --version.
Erweiterungen erfordern eine Neuinstallation. Sichern Sie den aktuellen Erweiterungsordner %userprofile%\.azure\cliextensions , indem Sie ihn umbenennen, falls Sie sich entschließen, zur 32-Bit-Version zurückzukehren. 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-Datei wird automatisch deinstalliert.
Installieren Sie Erweiterungen, indem Sie az extension add --name <extension> --version <version> ausführen. Wenn Sie Erweiterungen nicht manuell erneut installieren möchten, fordert Sie die Azure CLI auf, eine Erweiterung bei der ersten Verwendung 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 neu installieren. Wenn Sie eine Sicherung Ihres 32-Bit-Erweiterungsordners vorgenommen haben, stellen Sie den Erweiterungsordner nach der Änderung wieder her oder benennen diesen um.

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.

Sie deinstallieren die Azure-Befehlszeilenschnittstelle über die Liste „Apps und Features“ in Windows. So deinstallieren Sie:

Plattform	Anweisungen
Windows 11	Start > Einstellungen > Apps > Installierte Apps
Windows 10	Start > Einstellungen > Apps > Apps und 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 nun die Azure CLI unter Windows installiert haben, erfahren Sie mehr über die verschiedenen Möglichkeiten zum Anmelden.

Anmelden mit der Azure CLI

Teilen über

Installieren der Azure CLI unter Windows

Installieren oder Aktualisieren

WinGet (Windows-Paket-Manager)

Microsoft Installer (MSI)

Neueste Version

Bestimmte Version

Microsoft Installer (MSI) mit PowerShell

Bestimmte Version

Syntaxunterschiede zwischen Bash und PowerShell

ZIP-Paket

Neueste Version

Bestimmte Version

Ausführen der Azure CLI

Problembehandlung bei der Installation

PATH-Variable nicht festgelegt

Der Proxy blockiert die Verbindung.

Lange Antwortzeiten

Tab-Vervollständigung in PowerShell aktivieren

Aktualisieren der Azure-Befehlszeilenschnittstelle

Migrieren zur 64-Bit-Version der Azure CLI

Deinstallieren

Daten entfernen

Nächste Schritte

Feedback

Zusätzliche Ressourcen