Was ist die Azure CLI?
Die Azure-Befehlszeilenschnittstelle (Azure CLI) ist ein plattformübergreifendes Befehlszeilentool, über das Sie eine Verbindung mit Azure herstellen und Verwaltungsbefehle für Azure-Ressourcen ausführen können. Das Tool ermöglicht die Ausführung von Befehlen über ein Terminal, indem interaktive Befehlszeilenaufforderungen oder ein Skript verwendet werden.
Bei der interaktiven Nutzung starten Sie zunächst eine Shell, z. B. „cmd.exe“ unter Windows oder „Bash“ unter Linux oder macOS, und führen dann über die Eingabeaufforderung der Shell einen Befehl aus. Um sich wiederholende Aufgaben zu automatisieren, stellen Sie die CLI-Befehle mit der Syntax Ihrer ausgewählten Shell in einem Shellskript zusammen und führen das Skript anschließend aus.
Sie können die Azure CLI lokal auf Linux-, Macintosh- oder Windows-Computern installieren. Alternativ können Sie sie auch mit einem Browser über Azure Cloud Shell nutzen oder aus einem Docker-Container ausführen.
Aktuelle Version
Die aktuelle Version der Azure CLI ist 2.46.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.
Datensammlung
Die Azure CLI sammelt standardmäßig Telemetriedaten. Microsoft aggregiert gesammelte Daten, um Verwendungsmuster zu identifizieren, allgemeine Probleme zu ermitteln und die Benutzerfreundlichkeit der Azure CLI zu verbessern. Die Microsoft Azure CLI sammelt keine privaten oder personenbezogenen Daten. Die Nutzungsdaten tragen beispielsweise dazu bei, Probleme zu identifizieren (z. B. Befehle mit mäßigem Erfolg) und unsere Arbeit zu priorisieren.
Wir schätzen die Erkenntnisse, die uns diese Daten liefern, wissen aber auch, dass nicht jeder Nutzungsdaten senden möchte. Sie können die Datensammlung mit dem Befehl az config set core.collect_telemetry=false deaktivieren. Weitere Informationen finden Sie bei Bedarf auch in unseren Datenschutzbestimmungen.
Vorbereiten der Umgebung
Bevor Sie Azure CLI-Befehle ausführen können, müssen Sie Ihre Umgebung einrichten.
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Beispiele für die Azure-Befehlszeilenschnittstelle
Dieser Artikel enthält verschiedene Azure CLI-Beispiele für die folgenden Bereiche:
- Abonnementsyntax
- Syntax für Rollenzuweisung
- PowerShell-Syntax
Beispiel für Abonnementsyntax
Die Syntax der Azure CLI basiert auf dem folgenden einfachen Muster: reference name - command - parameter - parameter value. Der Wechsel zwischen Abonnements ist ein Beispiel für eine häufig anfallende Aufgabe. Hier ist die entsprechende Syntax angegeben:
az account set --subscription "my subscription name"
Das ist ziemlich einfach, oder? Weitere Informationen zur Verwendung der Azure CLI für Abonnements und die Erstellung von Verwaltungsgruppen finden Sie im Artikel zum Verwalten von Abonnements mit der Azure CLI.
Beispiel für die Syntax für eine Rollenzuweisung
Die Azure CLI wird auch häufig für die Verwaltung von Rollenzuweisungen genutzt.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Ein ausführliches Tutorial zur Verwaltung von Dienstprinzipalen und Rollenzuweisungen finden Sie unter Erstellen eines Azure-Dienstprinzipals mit der Azure CLI.
Vergleich mit der PowerShell-Syntax
Unter Auswählen des richtigen Befehlszeilentools ist der Unterschied zwischen tools und environments beschrieben. Der Schwerpunkt liegt hierbei auf der Azure CLI und auf Azure PowerShell. Darüber hinaus enthält der Artikel auch viele direkte Gegenüberstellungen von Befehlen. Zwei Beispiele:
| Get-Help | Azure CLI | Azure PowerShell |
|---|---|---|
| Ressourcengruppe erstellen | az group create --name <Ressourcengruppenname> --location eastus | New-AzResourceGroup -Name <Ressourcengruppenname> -Location eastus |
| Erstellen eines Azure-Speicherkontos | az storage account create --name <Speicherkontoname> --resource-group <Ressourcengruppenname> --location eastus --sku Standard_LRS --kind StorageV2 | New-AzStorageAccount -Name <Speicherkontoname> -ResourceGroupName <Ressourcengruppenname> -Location eastus -SkuName Standard_LRS -Kind StorageV2 |