Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Azure Command-Line Interface (CLI) ist ein plattformübergreifendes Befehlszeilentool zum Herstellen einer Verbindung mit Azure und Ausführen von administrativen Befehlen für Azure Ressourcen. Das Tool ermöglicht die Ausführung von Befehlen über ein Terminal, indem interaktive Befehlszeilenaufforderungen oder ein Skript verwendet werden.
Für die interaktive Verwendung starten Sie zunächst eine Shell wie cmd.exe auf Windows oder Bash unter Linux oder macOS, und geben Sie dann an der Shell-Eingabeaufforderung 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 das Azure CLI lokal auf Linux-, macOS- oder Windows-Computern installieren. Sie kann auch über den Azure Cloud Shell aus einem Browser verwendet oder in einem Docker-Container ausgeführt werden.
Aktuelle Version
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.
Authentifizierung
Azure CLI unterstützt mehrere Authentifizierungsmethoden. Ausführliche Informationen zur Authentifizierung für Azure aus dem Azure CLI finden Sie unter Sign in with Azure CLI.
Referenzdesign für Befehle
Die Syntax der Azure CLI folgt einem einfachen reference name - command - parameter - parameter value Muster. Der Wechsel zwischen Abonnements ist ein Beispiel für eine häufig anfallende Aufgabe. Verwenden Sie hierfür die folgende Syntax:
az account set --subscription "my subscription name"
Eine weitere häufige Verwendung der Azure CLI ist das Verwalten von Rollenzuweisungen.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Weitere Informationen zum Verwalten von Abonnements finden Sie unter Manage-Abonnements mit Azure CLI. Unter Erstellen eines Azure Dienstprinzipals mit dem Azure CLI finden Sie ein ausführliches Lernprogramm zum Verwalten von Dienstprinzipalen und Rollenzuweisungen.
Vergleich mit der PowerShell-Syntax
Wählen Sie das richtige Befehlszeilentool erläutert den Unterschied zwischen tools und environments mit einem Schwerpunkt auf den Azure CLI und Azure PowerShell. Darüber hinaus enthält der Artikel auch viele direkte Gegenüberstellungen von Befehlen. Zwei Beispiele:
| Befehl | Azure CLI | Azure PowerShell |
|---|---|---|
| Ressourcengruppe erstellen | az group create --name <Ressourcengruppenname> --location eastus | New-AzResourceGroup -Name <Ressourcengruppenname> -Location eastus |
| Erstellen eines Azure Storage-Kontos | 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 |
Informationen zu Azure CLI Syntaxvergleichen zwischen Bash- und PowerShell-Umgebungen finden Sie unter Learn Azure CLI Syntaxunterschiede in Bash, PowerShell und Cmd.
Ausgabeformate
Die Azure CLI verwendet JSON als Standardausgabeformat, bietet jedoch andere Formate wie in Output-Formaten für Azure CLI Befehle beschrieben. Verwenden Sie den Parameter --output, um Azure CLI Befehlsergebnisse zu formatieren. Ein Beispiel:
az account list --output table
Legen Sie die Standardausgabe fest, indem Sie die Konfigurationseigenschaft output festlegen, wie in Azure CLI configuration beschrieben.
az config set core.output=jsonc
Datenerfassung
Azure CLI erfasst Telemetriedaten standardmäßig. Microsoft aggregiert gesammelte Daten, um Nutzungsmuster zu identifizieren, um häufige Probleme zu identifizieren und die Erfahrung von Azure CLI zu verbessern. Microsoft Azure CLI sammelt keine privaten oder persönlichen 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.
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
