Dela via

Så här arbetar du med globala parametrar i Azure CLI

När du arbetar med Azure CLI-referenskommandona finns det argument 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 globalparameter

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 specifika kommandon tar längre tid att köra än andra.

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. Observera ytterligare information om exekveringstid dock.

{...}
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 också de 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:

Anmärkning

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, där du kan 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.

Se även

  • Last updated on