Freigeben über

Funktionsweise mit globalen Parametern in Azure CLI

  • Artikel

Wenn Sie mit den Azure CLI-Referenzbefehlen arbeiten, gibt es Argumente, die für die meisten Befehle verfügbar sind. Diese Argumente werden als "globale Parameter" bezeichnet, da sie fast allen Azure CLI-Referenzbefehlen gemeinsam sind.

--help Globaler Parameter

Verwenden Sie den --help globalen Parameter, um Informationen zu einer Referenzgruppe oder einem Befehl abzurufen. Der --help Parameter zeigt Azure CLI-Referenzinformationen in Ihrer Konsole an, einschließlich verfügbarer Untergruppen- und Parameterlisten.

az group create --name myResourceGroup --location eastus --help

Die folgende hier gezeigte Konsolenausgabe enthält Felder, die aus Platzgründen weggelassen werden:

Command
    az group create : Create a new resource group.

Arguments
    --location -l                 [Required] : Location. Values from: `az account list-locations`.
                                               You can configure the default location using `az
                                               configure --defaults location=<location>`.
    --name --resource-group -g -n [Required] : Name of the new resource group.
    --managed-by                             : The ID of the resource that manages this resource
                                               group.
    --tags                                   : Space-separated tags: key[=value] [key[=value] ...].
                                               Use "" to clear existing tags.

Global Arguments
    --debug                                  : Increase logging verbosity to show all debug logs.
    --help -h                                : Show this help message and exit.
    --only-show-errors                       : Only show errors, suppressing warnings.

Examples
    Create a new resource group in the West US region.
        az group create -l westus -n MyResourceGroup

--verbose Globaler Parameter

Erfahren Sie ausführlichere Details zur Protokollierung, indem Sie dem Verweisbefehl den --verbose globalen Parameter hinzufügen. Ausführliche Ausgabe ist hilfreich, wenn Sie versuchen, zu verstehen, warum bestimmte Befehle länger dauern, als andere ausgeführt werden.

az group create --name myResourceGroup --location eastus --verbose

Die folgende Hier gezeigte Konsolenausgabe enthält Felder, die aus Platzgründen weggelassen werden, beachten Sie jedoch die zusätzlichen Informationen zur Ausführungszeit.

{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)

--debug Globaler Parameter

Wenn die zusätzlichen Details des --verbose Parameters nicht ausreichen und Sie das gesamte Protokoll anzeigen möchten, verwenden Sie den --debug globalen Parameter. Stellen Sie außerdem die ausgabe bereit, die beim Übermitteln eines Fehlerberichts generiert wurde --debug .

az group create --name myrResourceGroup --location eastus --debug

Die folgende hier gezeigte Konsolenausgabe enthält Felder, die aus Platzgründen weggelassen werden:


cli.knack.cli: Command arguments: ['group', 'create', '--name', 'myResourceGroup', '--location', 'eastus', '--debug']
cli.knack.cli: __init__ debug log:
[...]
cli.knack.cli: Event: CommandInvoker.OnTransformResult [<function _resource_group_transform at 0x000001D9B72123B0>, <function _x509_from_base64_to_hex_transform at 0x000001D9B7212440>]
cli.knack.cli: Event: CommandInvoker.OnFilterResult []
{...}
[...]
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.

--only-show-errors Globaler Parameter

Entfernen Sie während des Debuggingvorgangs die Warnungen, die von einem Verweisbefehl mithilfe des --only-show-errors globalen Parameters zurückgegeben werden.

az interactive

Ausgabekonsole:

**This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus**

Any comments or concerns? You can use the 'feedback' command! We would greatly appreciate it.

A new Recommender is added which can make the completion ability more intelligent and provide the scenario completion!
If you want to disable this feature, you can use 'az config set interactive.enable_recommender=False' to disable it.

A command preload mechanism was added to prevent lagging and command run errors.
You can skip preloading in a single pass by CTRL+C or turn it off by setting 'az config set interactive.enable_preloading=False'

Loading command table... Expected time around 1 minute.

--subscription Globaler Parameter

Sie können den --subscription globalen Parameter verwenden, um ein bestimmtes Abonnement für einen Befehl festzulegen. Im folgenden Beispiel wird das aktive Abonnement mithilfe der Abonnement-ID geändert:

az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

--output Globaler Parameter

Geben Sie den --output globalen Parameter an, um die Ausgabe eines Befehls in einem bestimmten Format anzuzeigen. In diesem Beispiel wird die Ausgabe als Tabelle angezeigt:

Hinweis

Die akzeptierten Werte für die Ausgabe sind: json, jsonc, none, table, tsv, yaml und yamlc. Der Standardausgabewert ist json.

az vm list --resource-group myResourceGroup --output table

Ausgabekonsole:

Name    ResourceGroup    Location
------  ---------------  ----------
myVm    myResourceGroup  eastus

Weitere Informationen zu den verschiedenen Ausgabeformaten finden Sie unter Ausgabeformate für Azure CLI-Befehle.

--query Globaler Parameter

Es gibt Zeiten, in denen die Ausgabekonsole umfangreiche Mengen an Informationen anzeigt, die Sie filtern müssen. Verwenden Sie dazu den --query globalen Parameter, um eine JMESPath-Abfrage für die Ergebnisse von Befehlen auszuführen. JMESPath ist eine Abfragesprache für JSON, mit der Sie Daten aus der Azure CLI-Ausgabe auswählen und ändern können.

In diesem Beispiel werden die öffentlichen SSH-Schlüssel zurückgegeben, die zum Herstellen einer Verbindung mit dem virtuellen Computer autorisiert sind, indem Folgendes hinzugefügt --querywird:

 az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"

Ausgabekonsole:

[
  {
    "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
    "path": "/home/daphnema/.ssh/authorized_keys"
  }
]

Weitere Informationen zum Abfragen der Befehlsausgabe finden Sie unter Abfragen der Azure CLI-Befehlsausgabe mithilfe einer JMESPath-Abfrage.

Weitere Informationen