Installieren der Azure CLI unter Windows

Artikel
08/19/2024

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

winget install -e --id Microsoft.AzureCLI

Mit der Option -e 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 -v <version> mit der gewünschten Version zum Befehl hinzu. Hier ist ein Beispiel:

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Microsoft Installer (MSI)

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

Neueste MSI der Azure CLI (32-Bit)

Neueste MSI der Azure CLI (64-Bit)

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.

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
Vergleichen der Syntax von Bash, PowerShell und Cmd.exe in Learn 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 folgenden Artikeln:

ZIP-Paket

Wichtig

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.

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

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:

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

Zum Abrufen der MSI 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

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:

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

Anmelden mit der Azure CLI

Freigeben über

Installieren der Azure CLI unter Windows

Installieren oder Aktualisieren

WinGet (Windows-Paket-Manager)

Microsoft Installer (MSI)

Aktuelle Version

Bestimmte Version

Microsoft Installer (MSI) mit PowerShell

Bestimmte Version

Syntaxunterschiede zwischen Bash und PowerShell

ZIP-Paket

Aktuelle Version

Bestimmte Version

Ausführen der Azure CLI

Problembehandlung bei der Installation

PATH-Variable nicht festgelegt

Der Proxy blockiert die Verbindung.

Lange Antwortzeiten

Aktivieren der Vervollständigung per TAB-TASTE in PowerShell

Aktualisieren der Azure-Befehlszeilenschnittstelle

Migrieren zur 64-Bit-Version der Azure CLI

Deinstallieren

Daten entfernen

Nächste Schritte

Zusätzliche Ressourcen