Så här arbetar du med globala parametrar i Azure CLI
När du arbetar med Azure CLI-referenskommandona finns det argument som är tillgängliga för de flesta kommandon. Dessa argument kallas "globala parametrar", eftersom de är gemensamma för nästan alla Azure CLI-referenskommandon.
--help global parameter
Om du vill få information om en referensgrupp eller ett kommando använder du den --help globala parametern. Parametern --help visar Referensinformation för Azure CLI i konsolen, inklusive tillgängliga undergrupper och parameterlistor.
az group create --name myResourceGroup --location eastus --help
Följande konsolutdata som visas här innehåller fält som utelämnats för korthet:
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 global parameter
Läs mer detaljerad information om loggning genom att lägga till den --verbose globala parametern i referenskommandot. Utförliga utdata är användbara när du försöker förstå varför vissa kommandon tar längre tid än andra att köra.
az group create --name myResourceGroup --location eastus --verbose
Följande konsolutdata som visas här innehåller fält som utelämnats för korthet, men observera ytterligare information om körningstiden.
{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)
--debug global parameter
Om den extra informationen från parametern --verbose inte räcker och du vill visa hela loggen använder du den --debug globala parametern. Ange även utdata som genereras med --debug när du skickar en felrapport.
az group create --name myrResourceGroup --location eastus --debug
Följande konsolutdata som visas här innehåller fält som utelämnats för korthet:
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 global parameter
Under felsökningsprocessen tar du bort varningarna som returneras av ett referenskommando med hjälp av den --only-show-errors globala parametern.
az interactive
Utdatakonsol:
**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 global parameter
Du kan använda den --subscription globala parametern för att ange en specifik prenumeration för ett kommando. I följande exempel ändras den aktiva prenumerationen med hjälp av prenumerations-ID:t:
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--output global parameter
Om du vill visa utdata för ett kommando i ett specifikt format anger du den --output globala parametern. I det här exemplet visas utdata som en tabell:
Kommentar
De godkända värdena för utdata är: json, jsonc, none, table, tsv, yaml och yamlc. Standardutdatavärdet är json.
az vm list --resource-group myResourceGroup --output table
Utdatakonsol:
Name ResourceGroup Location
------ --------------- ----------
myVm myResourceGroup eastus
Mer information om de olika utdataformaten finns i Utdataformat för Azure CLI-kommandon.
--query global parameter
Det finns tillfällen då utdatakonsolen kan visa omfattande mängder information som du behöver filtrera igenom. Det gör du genom att använda den --query globala parametern för att köra en JMESPath-fråga på resultatet av kommandon. JMESPath är ett frågespråk för JSON, vilket ger dig möjlighet att välja och ändra data från Azure CLI-utdata.
Det här exemplet returnerar de offentliga SSH-nycklar som har behörighet att ansluta till den virtuella datorn genom att lägga till --query:
az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"
Utdatakonsol:
[
{
"keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
"path": "/home/yourName/.ssh/authorized_keys"
}
]
Mer information om hur du frågar efter kommandoutdata finns i Köra frågor mot Azure CLI-kommandoutdata med hjälp av en JMESPath-fråga.
