Übersicht: Azure CLI-Terminologie und Supportebenen
Artikel
In diesem Artikel wird die Azure CLI-Terminologie erläutert. Es gibt Syntaxkomponenten, Verweistypen und Status.
Komponenten der Azure CLI-Syntax
Die Azure CLI-Syntax ist eine Kombination aus Gruppen, Verweisen, Befehlen und Parametern. Der gesamte Verweisbefehl wird häufig als Befehl bezeichnet.
Eine Referenzuntergruppe kann mehrere Ebenen haben, etwa az network application-gateway private-link ip-config add.
Verweisgruppe
Untergruppe 1
Untergruppe 2
Untergruppe 3
Get-Help
Netzwerk
application-gateway
private-link
ip-config
add
Eine vollständige Liste der Referenzbefehle finden Sie in der Referenzliste A bis Z.
Was ist ein Verweistyp?
Azure CLI-Befehle sind entweder Teil des zentralen Azure CLI-Diensts oder eine Erweiterung. Erweiterungen sind optionale Add-Ons. Der Verweistyp bestimmt den Releaseplan, den Status und die Installationsmethode wie hier beschrieben:
Begriff
Core
Durchwahl
Referenzen
Teil des primären Azure CLI-Diensts
Optionale Verweisbefehle, die installiert werden müssen
Kann GA (allgemein verfügbar), Vorschau oder veraltet sein
Kann auch GA, Vorschau oder veraltet sein
Führen Sie zum Abrufen einer Liste mit Befehlsgruppen az aus. Verwenden Sie die Befehle az extension list-available --output table, um eine Liste der Erweiterungen anzuzeigen.
Azure CLI
# Get list of all command groups
az
# Get list of extensionsaz extension list-available --output table
Core
Azure CLI-Verweise, die als ständiger Teil der CLI veröffentlicht wurden, werden als Kernverweise bezeichnet. Alle Kernverweise werden zusammen mit der Azure CLI installiert, und Sie können keine Teilmenge von Verweisen auswählen. Wenn Sie die CLI über Azure Cloud Shell ausführen, sind die Kernverweise immer auf dem neuesten Stand.
Durchwahl
Erweiterungen werden nicht zusammen mit der CLI bereitgestellt, können aber als CLI-Befehle ausgeführt werden. Einige Erweiterungen sind fester Bestandteil der Azure CLI, aber oft erhalten Sie mit einer Erweiterung Zugriff auf eine Vorschau und experimentelle Befehle. Eine einzelne Referenzgruppe wie etwa az iot hub kann sowohl Kern- als auch Erweiterungsbefehle enthalten. Zwei Beispiele:
Vollständiger Verweisbefehl
Kern
Erweiterung
az iot hub list
ja
az iot hub job list
ja
Sie werden bei der ersten Verwendung einer Erweiterung zur Installation aufgefordert. Sie können eine Erweiterung auch installieren, indem Sie den Befehl az extension add ausführen.
Unabhängig vom Referenztyp fallen Azure CLI-Verweise in drei Statuskategorien: GA (Allgemein verfügbar), öffentliche Vorschau oder veraltet. Es ist der Referenzbefehlsstatus (nicht typ), der die Stabilität bestimmt.
Warnungen, die angeben, dass die öffentliche Vorschau oder veraltet ist, sind Teil der Azure CLI-Befehlsausgabe und sollten erwartet werden.
Die meisten Befehle und Parameter für einen einzelnen Verweis haben einen einzelnen Status, aber nicht immer. Eine GA-Referenz, die erstellt wird, um weitere Befehle anzubieten, können sowohl GA- als auch Vorschaureferenzbefehle enthalten. Darüber hinaus kann ein einzelner Befehl über Parameter verfügen, die in unterschiedliche Statuskategorien fallen. Dies ist der Fall, wenn neue Parameter hinzugefügt werden, um den Funktionsumfang zu erweitern. Die folgende Tabelle enthält Beispiele für Verweise mit verschiedenen Statuswerten:
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.
Feedback zu Azure CLI
Azure CLI ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben:
Lernen Sie die grundlegenden Konzepte von Infrastructure-as-Code kennen, erkunden Sie die wichtigsten Unterschiede zwischen der Azure-Befehlszeilenschnittstelle (Azure Command Line Interface, Azure CLI), Azure PowerShell, Bicep und Terraform, und entscheiden Sie, welche Befehlszeilentools die Anforderungen Ihrer Organisation am besten erfüllen.
