Delen via


Werken met globale parameters in Azure CLI

Wanneer u met de Azure CLI-referentieopdrachten werkt, zijn er argumenten beschikbaar voor de meeste opdrachten. Deze argumenten worden 'globale parameters' genoemd, omdat ze gebruikelijk zijn voor bijna alle Azure CLI-referentieopdrachten.

--help globale parameter

Gebruik de --help algemene parameter om informatie over een referentiegroep of opdracht op te halen. Met de --help parameter worden azure CLI-referentiegegevens weergegeven in uw console, inclusief beschikbare subgroep- en parameterlijsten.

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

De volgende console-uitvoer die hier wordt weergegeven, bevat velden die zijn weggelaten om kort te zijn:

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 globale parameter

Meer informatie over logboekregistratie vindt u in meer informatie over logboekregistratie door de --verbose globale parameter toe te voegen aan uw referentieopdracht. Uitgebreide uitvoer is handig wanneer u probeert te begrijpen waarom bepaalde opdrachten langer duren dan andere.

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

De volgende console-uitvoer die hier wordt weergegeven, bevat velden die zijn weggelaten om kort te zijn, maar let op de aanvullende informatie over de uitvoeringstijd.

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

--debug globale parameter

Als de extra details van de --verbose parameter niet voldoende zijn en u het hele logboek wilt weergeven, gebruikt u de --debug globale parameter. Geef ook de uitvoer op die --debug wordt gegenereerd bij het indienen van een foutenrapport.

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

De volgende console-uitvoer die hier wordt weergegeven, bevat velden die zijn weggelaten om kort te zijn:


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 globale parameter

Verwijder tijdens het foutopsporingsproces de waarschuwingen die worden geretourneerd door een verwijzingsopdracht met behulp van de --only-show-errors globale parameter.

az interactive 

Uitvoerconsole:

**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 globale parameter

U kunt de --subscription globale parameter gebruiken om een specifiek abonnement voor een opdracht in te stellen. In het volgende voorbeeld wordt het actieve abonnement gewijzigd met behulp van de abonnements-id:

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

--output globale parameter

Als u de uitvoer van een opdracht in een specifieke indeling wilt weergeven, geeft u de --output globale parameter op. In dit voorbeeld wordt de uitvoer weergegeven als een tabel:

Notitie

De geaccepteerde waarden voor uitvoer zijn: json, jsonc, none, table, tsv, yaml en yamlc. De standaarduitvoerwaarde is json.

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

Uitvoerconsole:

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

Zie Uitvoerindelingen voor Azure CLI-opdrachten voor meer informatie over de verschillende uitvoerindelingen.

--query globale parameter

Soms kan de uitvoerconsole uitgebreide hoeveelheden informatie weergeven die u moet filteren. Gebruik hiervoor de --query globale parameter om een JMESPath-query uit te voeren op de resultaten van opdrachten. JMESPath is een querytaal voor JSON, waarmee u gegevens uit De Azure CLI-uitvoer kunt selecteren en wijzigen.

In dit voorbeeld worden de openbare SSH-sleutels geretourneerd die zijn gemachtigd om verbinding te maken met de virtuele machine door het volgende toe te voegen --query:

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

Uitvoerconsole:

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

Zie De uitvoer van azure CLI-opdrachten opvragen met behulp van een JMESPath-query voor meer informatie over het uitvoeren van query's voor opdrachtuitvoer.

Zie ook