Come usare i parametri globali nell'interfaccia della riga di comando di Azure
Quando si lavora con i comandi di riferimento dell'interfaccia della riga di comando di Azure, sono disponibili argomenti per la maggior parte dei comandi. Questi argomenti sono denominati "parametri globali", perché sono comuni a quasi tutti i comandi di riferimento dell'interfaccia della riga di comando di Azure.
--help parametro globale
Per ottenere informazioni su un gruppo o un comando di riferimento, usare il --help parametro globale. Il parametro visualizza le informazioni di riferimento dell'interfaccia --help della riga di comando di Azure nella console, inclusi gli elenchi di sottogruppi e parametri disponibili.
az group create --name myResourceGroup --location eastus --help
L'output della console seguente illustrato di seguito contiene campi omessi per brevità:
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 parametro globale
Per altre informazioni dettagliate sulla registrazione, aggiungere il --verbose parametro globale al comando di riferimento. L'output dettagliato è utile quando si tenta di capire perché alcuni comandi richiedono più tempo rispetto ad altri per l'esecuzione.
az group create --name myResourceGroup --location eastus --verbose
L'output della console seguente illustrato di seguito contiene campi omessi per brevità, ma si notino le informazioni aggiuntive sul tempo di esecuzione.
{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)
--debug parametro globale
Se i dettagli aggiuntivi del --verbose parametro non sono sufficienti e si vuole visualizzare l'intero log, usare il --debug parametro globale. Specificare anche l'output generato quando --debug si invia un report di bug.
az group create --name myrResourceGroup --location eastus --debug
L'output della console seguente illustrato di seguito contiene campi omessi per brevità:
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 parametro globale
Durante il processo di debug, rimuovere gli avvisi restituiti da un comando di riferimento usando il --only-show-errors parametro globale .
az interactive
Console di output:
**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 parametro globale
È possibile usare il --subscription parametro globale per impostare una sottoscrizione specifica per un comando. L'esempio seguente modifica la sottoscrizione attiva usando l'ID sottoscrizione:
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--output parametro globale
Per visualizzare l'output di un comando in un formato specifico, specificare il --output parametro globale. In questo esempio l'output viene visualizzato come tabella:
Nota
I valori accettati per l'output sono: json, jsonc, none, table, tsv, yaml e yamlc. Il valore di output predefinito è json.
az vm list --resource-group myResourceGroup --output table
Console di output:
Name ResourceGroup Location
------ --------------- ----------
myVm myResourceGroup eastus
Per altre informazioni sui diversi formati di output, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.
--query parametro globale
In alcuni casi la console di output potrebbe visualizzare numerose quantità di informazioni che è necessario filtrare. A tale scopo, usare il --query parametro globale per eseguire una query JMESPath sui risultati dei comandi. JMESPath è un linguaggio di query per JSON, che consente di selezionare e modificare i dati dall'output dell'interfaccia della riga di comando di Azure.
Questo esempio restituisce le chiavi pubbliche SSH autorizzate a connettersi alla macchina virtuale aggiungendo --query:
az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"
Console di output:
[
{
"keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
"path": "/home/yourName/.ssh/authorized_keys"
}
]
Per altre informazioni sull'esecuzione di query sull'output dei comandi, vedere Come eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure usando una query JMESPath.
