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.37.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 Azure Cloud Shell unter Nutzung der Bash-Umgebung.

    Starten von Cloud Shell in einem neuen Fenster

  • Wenn Sie möchten, können Sie auch die Azure CLI installieren, um CLI-Verweisbefehle auszuführen.

    • 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. Weitere Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
    • Installieren Sie die Azure CLI-Erweiterungen bei der ersten Verwendung, 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-Befehlszeilenschnittstelle Azure PowerShell
Ressourcengruppe erstellen az group create --name <ResourceGroupName> --location eastus New-AzResourceGroup -Name <ResourceGroupName> -Location eastus
Erstellen eines Azure-Speicherkontos az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location eastus -SkuName Standard_LRS -Kind StorageV2

Weitere Informationen