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.
Es gibt vier Möglichkeiten zum Installieren der Azure CLI in Windows:
Die aktuelle Version der Azure CLI ist 2.67.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.
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 vonnotepad $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.