Freigeben über


Installieren der Azure CLI unter Windows

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

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.

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.

Ausführen der Azure CLI

Sie können nun mit dem Befehl az über die Windows-Eingabeaufforderung oder PowerShell die Azure CLI ausführen.

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:

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

  2. 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
    }
    
  3. Um alle verfügbaren Optionen im Menü anzuzeigen, fügen Sie Ihrem PowerShell-Profil Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete hinzu.

Problembehandlung

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.

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/

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:

  1. Überprüfen Sie Ihre aktuelle CLI-Version und die installierten Erweiterungen, indem Sie az --version ausführen.
  2. 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.
  3. 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.
  4. 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.

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.

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.