Installieren des Azure CLI auf Windows

Die Azure Command-Line Interface (CLI) ist ein plattformübergreifendes Befehlszeilentool, das lokal auf Windows Computern installiert werden kann. Sie können die Azure CLI für Windows verwenden, um eine Verbindung mit Azure herzustellen und administrative Befehle für Azure Ressourcen auszuführen. Die Azure CLI können auch über den Azure Cloud Shell aus einem Browser 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.exe) ermöglicht. Wenn Sie eine Installation für Windows Subsystem for Linux (WSL) durchführen, stehen Pakete für Ihre Linux-Verteilung zur Verfügung. 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 des Azure CLI ist 2.84.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

MSI- und ZIP-Installationspakete werden verwendet, um die Azure CLI auf 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.

winget install --exact --id Microsoft.AzureCLI

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

$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

$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

Azure CLI ausführen

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 PowerShell oder der 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 Sign into Azure with Azure CLI.

az login

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

az account show

Problembehandlung bei der Installation

Im Folgenden finden Sie einige häufige Probleme beim Installieren des Azure CLI auf Windows. Wenn hier ein Problem nicht behandelt wird, fileieren Sie ein Problem bei 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 Bereich Settings > Network & Internet > Proxy 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.

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

Lange Antwortzeiten

Siehe Migrieren zu 64-Bit-Azure CLI

Tab-Vervollständigung in PowerShell aktivieren

Die Tab-Vervollständigung, auch bekannt als "Azure CLI Completers," bietet Vervollständigung von Eingaben, um Hinweise bereitzustellen, Entdeckungen zu erleichtern und die Eingabe zu beschleunigen. Befehlsnamen, Befehlsgruppennamen, Parameter und bestimmte Parameterwerte können durch Drücken der TAB-TASTE automatisch in die Befehlszeile eingefügt werden.

Die Tab-Vervollständigung ist standardmäßig in Azure Cloud Shell und in den meisten Linux-Distributionen aktiviert. Mit Azure CLI Version 2.49 können Sie die Tab-Vervollständigung für die Azure CLI in PowerShell aktivieren. Folgen Sie diesen Schritten:

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 So erstellen Sie Ihr Profil und Profile und Ausführungsrichtlinien.

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.

Aktualisieren der Azure CLI

Ab Version 2.11.0 stellt die Azure CLI einen In-Tool-Befehl zum Aktualisieren auf die neueste Version bereit.

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. Aktualisieren Sie für Azure CLI Versionen vor 2.11.0, indem Sie es neu installieren, wie in Installieren Sie den Azure CLI beschrieben.

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

Migrieren zu 64-Bit-Azure CLI

Ab 2.51.0 stellt Azure CLI auch eine 64-Bit-MSI bereit, 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:

1. Überprüfen Sie Ihre aktuelle Azure CLI Version und installierte Erweiterungen, indem Sie az --version ausführen.
2. 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.
3. 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.
4. Installieren Sie Erweiterungen, indem Sie az extension add --name <extension> --version <version> ausführen. Wenn Sie Erweiterungen nicht manuell erneut installieren möchten, werden Sie von der Azure CLI aufgefordert, 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 entschließen, die Azure CLI zu deinstallieren, tut es uns leid, Sie gehen zu sehen. 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. Wenn Sie einen Fehler gefunden haben, würden wir es schätzen, wenn Sie ein GitHub Problem fileieren.

Sie deinstallieren die Azure CLI aus der Liste Windows "Apps und Features". So deinstallieren Sie:

Geben Sie einmal auf diesem Bildschirm Azure CLI in die Suchleiste des Programms ein. Das zu deinstallierende Programm wird als Microsoft CLI 2.0 für Azure aufgeführt. Wählen Sie diese Anwendung und dann die Schaltfläche Uninstall aus.

Daten entfernen

Wenn Sie nicht beabsichtigen, Azure CLI neu zu installieren, entfernen Sie dessen 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 auf Windows installiert haben, erfahren Sie mehr über die verschiedenen Möglichkeiten zum Anmelden.