Erste Schritte mit der Azure CLI

  • Artikel

Willkommen bei der Azure-Befehlszeilenschnittstelle (CLI) Dieser Artikel bietet eine Einführung in die CLI und unterstützt Sie beim Ausführen allgemeiner Aufgaben.

Installieren oder Ausführen in Azure Cloud Shell

Am einfachsten erfahren Sie, wie Sie die Azure CLI verwenden können, indem Sie eine Bash-Umgebung in Azure Cloud Shell über Ihren Browser ausführen. Informationen zu Cloud Shell finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

Wenn Sie bereit sind, die Azure CLI zu installieren, lesen Sie die Installationsanweisungen für Windows, Linux, macOS und Docker-Container. Installieren Sie die klassische Azure CLI, wenn Sie das klassische Azure-Bereitstellungsmodell verwenden.

Überprüfen Sie Ihre Version, indem Sie diese ausführen az --version. Azure Cloud Shell verfügt immer über die neueste Version der vorinstallierten Azure CLI.

az version

Anmelden bei der Azure CLI

Bevor Sie Azure CLI-Befehle mit einer lokalen Installation verwenden, müssen Sie sich mithilfe von az login anmelden.

  1. Führen Sie den Befehl az login aus.

    az login

    Wenn die Azure CLI Ihren Standardbrowser öffnen kann, wird der Autorisierungscodeflow initiiert und der Standardbrowser geöffnet, um eine Azure-Anmeldeseite zu laden.

    Andernfalls wird der Gerätecodeflow initiiert, und Sie werden angewiesen, die Browserseite https://aka.ms/devicelogin zu öffnen. Geben Sie dann den Code ein, der auf Ihrem Terminal angezeigt wird.

    Falls kein Webbrowser verfügbar ist oder er nicht geöffnet werden kann, können Sie den Gerätecodefluss mit az login --use-device-code erzwingen.

  2. Melden Sie sich im Browser mit Ihren Anmeldeinformationen an.

Nach der Anmeldung erhalten Sie eine Liste der Abonnements, die Ihrem Azure-Konto zugeordnet sind. Die Abonnementinformationen mit isDefault: true ist das momentan aktivierte Abonnement nach der Anmeldung. Um ein anderes Abonnement auszuwählen, verwenden Sie den Befehl "az account set " mit der Abonnement-ID des gewünschten Kontos. Weitere Informationen zur Abonnementauswahl finden Sie unter Verwalten von Azure-Abonnements.

Es gibt auch Wege, wie Sie sich nicht interaktiv anmelden können. Diese werden unter Anmelden mit der Azure CLI ausführlich beschrieben.

Suchen nach 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 . Verwenden Sie den folgenden Befehl, um beispielsweise nach Befehlsnamen zu suchen, die vm enthalten:

    az find vm

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

    az vm --help

    Nachfolgend sehen Sie eine Beispielausgabe mit ausgelassenen Zeilen aus Platzgründen:

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

    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

    Dient auch zum Abrufen von --help Parameterlisten und Befehlsbeispielen für einen Verweisbefehl.

    az vm create --help

    Nachfolgend sehen Sie eine Beispielausgabe mit ausgelassenen Zeilen aus Platzgründen:

    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 A-zu-Z-Referenzindex , der alle Befehlsgruppen alphabetisch auflistet.

Suchen von veröffentlichten Beispielen und Artikeln

Wenn Sie die Azure CLI-Syntax lieber erlernen möchten, indem Sie getestete veröffentlichte Beispiele anzeigen, gibt es zwei Indizes von Artikelinhalten:

Verwenden der Registerkartenabschluss

Die CLI verfügt über einen vollständigen Tabstopp für Befehle in einer Bash-Umgebung. Informationen zum Aktivieren des Abschlusses der Registerkarte in einer PowerShell-Umgebung finden Sie unter "Aktivieren des Tabstoppabschlusses" in PowerShell.

Berücksichtigen von global verfügbaren Argumenten

Es gibt einige Argumente, die für die meisten Befehle verfügbar sind.

  • --help gibt CLI-Referenzinformationen zu Befehlen und ihren Argumenten zurück und führt verfügbare Untergruppen und Befehle auf.

  • --output ändert das Ausgabeformat. Verfügbare Ausgabeformate: json, jsonc (farbiger JSON-Code), tsv (per Tabulator getrennte Werte), table (für Menschen lesbare ASCII-Tabellen) und yaml. Die CLI gibt standardmäßig json aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformate für die Azure CLI.

  • --query verwendet die JMESPath-Abfragesprache zum Filtern der von Azure-Diensten zurückgegebenen Ausgabe. Weitere Informationen zu Abfragen finden Sie unter Abfragen von Befehlsergebnissen mit der Azure CLI und im JMESPath-Tutorial.

  • --verbose gibt Informationen zu Ressourcen, die in Azure während eines Vorgangs erstellt werden, und andere nützliche Informationen aus.

  • --debug gibt noch mehr Informationen zu CLI-Vorgängen aus, die zum Debuggen verwendet werden. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag --debug generierte Ausgabe bereit. Sie kann z. B. verwendet werden, um die REST-API zu identifizieren, unter der der ausgeführte Befehl aufgerufen wird, und die antwort, die vom Dienst empfangen wurde.

  • --subscription ist der Name oder die ID eines Abonnements. Weitere Informationen zum Festlegen Ihres Standardabonnements finden Sie unter Verwalten von Azure-Abonnements mit der Azure CLI.

  • --only-show-errors unterdrückt Warnungen in der Befehlsausgabe und zeigt nur Fehler an.

Verwenden des interaktiven Modus

Die CLI bietet einen interaktiven Modus, der automatisch Hilfeinformationen anzeigt und die Auswahl von Unterbefehlen vereinfacht. Sie wechseln mit dem Befehl az interactive in den interaktiven Modus.

az interactive

Weitere Informationen zum interaktiven Modus finden Sie unter Ausführen der Azure CLI im interaktiven Modus.

Darüber hinaus gibt es ein Visual Studio Code-Plug-In, das eine interaktive Benutzeroberfläche bereitstellt. Diese bietet unter anderem Funktionen wie AutoVervollständigen und die Anzeigen von Informationen beim Daraufzeigen.

Lernen Sie Die Grundlagen der Azure CLI mit Schnellstarts und Lernprogrammen kennen

Um zu erfahren, wie Sie die Azure CLI verwenden, probieren Sie unser Onboarding-Lernprogramm aus, in dem Sie die folgenden Fähigkeiten beim Arbeiten mit Azure Storage lernen:

Hinweis

In Skripts und auf der Microsoft-Dokumentationswebsite werden Azure CLI-Beispiele für die Bash-Shell geschrieben. Die meisten einzeiligen Beispiele werden auf jeder Plattform ausgeführt. Längere Beispiele, die Zeilenfortsetzungen (\), variable Zuordnungen oder Anführungszeichen enthalten, müssen geändert werden, um in anderen Shells zu arbeiten, einschließlich PowerShell. Weitere Informationen zu Syntaxunterschieden zwischen Umgebungen finden Sie unter "Informationen zu Syntaxunterschieden zwischen Bash, PowerShell und Cmd".

Feedback senden

Ihr Feedback zur CLI hilft uns dabei, Verbesserungen vorzunehmen und Fehler zu beheben. Sie können ein Problem auf GitHub melden oder mit den integrierten Features der CLI und dem Befehl az feedback allgemeines Feedback hinterlassen.

az feedback

Siehe auch