Erste Schritte mit Azure CLI

2025-05-22

Azure CLI ist ein plattformübergreifendes Tool, das die Verwaltung von Azure-Ressourcen über die Befehlszeile vereinfacht. Optimiert für Automatisierung und Benutzerfreundlichkeit, unterstützt sie interaktive Sitzungen und Skripts mit einfachen Befehlen, die nahtlos in das Azure Resource Manager-Modell integriert werden. Sie können es in Ihrem Browser mit Azure Cloud Shell verwenden oder lokal installieren, um es von Ihrem bevorzugten Terminal zu verwenden.

Installieren oder Ausführen in Azure Cloud Shell

Die einfachste Möglichkeit, Azure CLI zu testen, ist die Azure Cloud Shell, eine browserbasierte Shell ohne Installation erforderlich. Cloud Shell unterstützt Bash und PowerShell und enthält die neueste Version der vorinstallierten Azure CLI.

Informationen zum lokalen Installieren von Azure CLI finden Sie unter Installieren der Azure CLI.

Führen Sie Folgendes aus, um Ihre Version zu überprüfen:

az version

Um mit der Verwendung von Azure CLI mit einer lokalen Installation zu beginnen, melden Sie sich an:

Führen Sie den Befehl az login aus.
```
az login
```
Wenn Azure CLI Ihren Standardbrowser öffnen kann, initiiert sie den Autorisierungscodefluss und öffnet den Standardbrowser, um eine Azure-Anmeldeseite zu laden.

Andernfalls wird der Gerätecode-Flow initiiert, und Sie werden angewiesen, eine Browser-Seite unter https://aka.ms/devicelogin zu öffnen. Geben Sie dann den Code ein, der auf Ihrem Terminal angezeigt wird.

Wenn kein Webbrowser verfügbar ist oder der Webbrowser nicht geöffnet werden kann, können Sie die Authentifizierung mit Gerätecode forcieren az login --use-device-code.
Melden Sie sich im Browser mit Ihren Anmeldeinformationen an.

Von Bedeutung

Ab 2025 erzwingt Microsoft obligatorische MFA für Azure CLI und andere Befehlszeilentools. MFA wirkt sich nur auf die Benutzeridentitäten von Microsoft Entra ID aus. Dies wirkt sich nicht auf Arbeitsauslastungsidentitäten aus, z. B. Dienstprinzipale und verwaltete Identitäten.

Wenn Sie az login mit einer Entra-ID und einem Kennwort zum Authentifizieren eines Skripts oder automatisierten Prozesses verwenden, planen Sie jetzt die Migration zu einer Workload-Identität. Weitere Informationen finden Sie unter "Auswirkungen der mehrstufigen Authentifizierung auf Azure CLI in Automatisierungsszenarien".

Nach der Anmeldung wird eine Liste Ihrer Abonnements angezeigt. Die markierte isDefault: true ist derzeit aktiv. Um zu einem anderen Abonnement zu wechseln, führen Sie Folgendes aus:

az account set --subscription "<subscription-id>"

Weitere Informationen zur Abonnementauswahl finden Sie unter Verwalten von Azure-Abonnements. Erweiterte Anmeldeoptionen finden Sie unter Anmelden mit Azure CLI.

Suchen von Befehlen

Azure CLI-Befehle sind als Befehlsgruppen organisiert. Jede Gruppe stellt einen Bereich eines Azure-Diensts dar. Es gibt zwei Optionen zum Suchen von Befehlsgruppen:

Verwenden Sie den Befehl az find . Um beispielsweise nach Befehlsnamen zu suchen, die enthalten vm, verwenden Sie das folgende Beispiel:
```
az find vm
```

Verwenden Sie das --help Argument, um eine vollständige Liste von Untergruppen innerhalb einer Referenzgruppe abzurufen. Im folgenden Beispiel werden alle Untergruppen für virtuelle Computer zurückgegeben:

az vm --help

Das folgende Beispiel zeigt den relevanten Teil der Ausgabe.

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

Die Hilfeausgabe enthält Untergruppen, Parameter, Authentifizierungsoptionen und Beispiele.

Hier ist ein weiteres Beispiel, das die Azure CLI-Befehle zum Gruppieren virtueller Computer in Verfügbarkeitsgruppen findet, eine Untergruppe von az vm:

az vm availability-set --help

Sie können auch --help verwenden, um Parameterlisten und Befehlsbeispiele für einen Befehl als Referenz abzurufen.

az vm create --help

Hier ist der relevante Abschnitt der Beispielausgabe:

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

Verwenden Sie den Referenzindex , der alle Befehlsgruppen alphabetisch auflistet.

Beispiele und Artikel erkunden

Beispiele für die Verwendung finden Sie unter:

Der Probenindex für Azure CLI-Beispiele nach Thema, Referenzgruppe oder GitHub-Repository.

Der Artikelindex , um ausführliche Anleitungen zu finden. Verwenden Sie Ihre find-Tastenkombinationen, wie Ctrl + F, um schnell die Referenzbefehlsgruppe zu finden, an der Sie interessiert sind. Der Artikelindex az vm sieht beispielsweise wie in der folgenden Tabelle aus:

Referenzuntergruppe	Azure CLI-Artikel, der die Nutzung als Referenz zeigt
az vm	Ausgabeformate für Azure CLI-Befehle
	Verwenden von Variablen in Azure CLI-Befehlen
	Abrufen von VM-Informationen mit Abfragen
	{Weitere Artikel sind hier aufgeführt.}
az vm aem	Neue Version der Azure-VM-Erweiterung für SAP-Lösungen
	Standardversion der Azure-VM-Erweiterung für SAP-Lösungen
az vm-Anwendung	{...}

Tab-Vervollständigung verwenden

Azure CLI unterstützt die Tab-Vervollständigung in Bash. Um die Tab-Vervollständigung in PowerShell zu aktivieren, siehe Tab-Vervollständigung in PowerShell aktivieren.

Globale Argumente verstehen

Zu den meisten Befehlen stehen allgemeine Argumente zur Verfügung:

Streitpunkt	BESCHREIBUNG
`--help`	Befehlsanleitung anzeigen
`--output`	Ausgabeformat ändern: `json`, `jsonc`, `tsv`, , `tableyaml`
`--query`	Filterausgabe mit JMESPath
`--verbose`	Weitere Ausführungsdetails drucken
`--debug`	REST-Aufrufe auf niedriger Ebene zur Fehlersuche anzeigen
`--subscription`	Angeben des Abonnementnamens oder der ID
`--only-show-errors`	Nicht kritische Ausgabe unterdrücken

Weitere Informationen finden Sie unter Ausgabeformate und Abfrageergebnisse.

Verwenden des interaktiven Modus

Interaktiver Modus ausführen mit:

az interactive

Der interaktive Modus startet eine verbesserte Azure CLI-Erfahrung mit Inlinehilfe- und Befehlsvorschlägen. Weitere Informationen finden Sie im interaktiven Modus.

Eine optionale VS Code-Erweiterung bietet ähnliche Funktionen mit Autovervollständigung und Hover-Tipps.

Lernen Sie durch Tutorials und Schnellstarts.

Machen Sie sich mit den Grundlagen der Azure CLI mit dem Onboarding-Lernprogramm vertraut. Hier erfahren Sie, wie Sie:

Hinweis

Azure CLI-Beispiele für Microsoft Learn werden für Bash geschrieben. Einzeiler funktionieren normalerweise shellübergreifend, aber mehrzeilige Skripte erfordern möglicherweise Anpassungen. Weitere Informationen finden Sie unter "Syntaxunterschiede zwischen Bash, PowerShell und Cmd"

Feedback geben

Wir freuen uns über Ihr Feedback. Übermitteln von Problemen auf GitHub oder Ausführen:

az feedback

Freigeben über