Sdílet prostřednictvím

Práce s globálními parametry v Azure CLI

  • Článek

Při práci s referenčními příkazy Azure CLI jsou pro většinu příkazů k dispozici argumenty. Tyto argumenty se nazývají "globální parametry", protože jsou společné téměř všem referenčním příkazům Azure CLI.

--help globální parametr

Pokud chcete získat informace o referenční skupině nebo příkazu, použijte --help globální parametr. Tento --help parametr zobrazuje referenční informace Azure CLI v konzole, včetně dostupných podskupin a seznamů parametrů.

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

Následující výstup konzoly zde obsahuje pole vynechána pro stručnost:

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 globální parametr

Další podrobné informace o protokolování získáte přidáním globálního parametru do referenčního --verbose příkazu. Podrobný výstup je užitečný při pokusu o pochopení, proč provádění určitých příkazů trvá déle než ostatní.

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

Následující výstup konzoly zde obsahuje pole vynechána pro stručnost, ale poznamenejte si další informace o době provádění.

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

--debug globální parametr

Pokud další podrobnosti z parametru --verbose nestačí a chcete zobrazit celý protokol, použijte --debug globální parametr. Uveďte také výstup vygenerovaný --debug při odesílání zprávy o chybě.

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

Následující výstup konzoly zde obsahuje pole vynechána pro stručnost:


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 globální parametr

Během procesu ladění odeberte upozornění vrácená referenčním příkazem pomocí globálního parametru --only-show-errors .

az interactive

Výstupní konzola:

**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 globální parametr

Globální parametr můžete použít --subscription k nastavení konkrétního předplatného pro příkaz. Následující příklad změní aktivní předplatné pomocí ID předplatného:

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

--output globální parametr

Pokud chcete zobrazit výstup příkazu v určitém formátu, zadejte --output globální parametr. V tomto příkladu se výstup zobrazí jako tabulka:

Poznámka:

Přijaté hodnoty pro výstup jsou: json, jsonc, none, table, tsv, yaml a yamlc. Výchozí výstupní hodnota je json.

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

Výstupní konzola:

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

Další informace o různých formátech výstupu najdete v tématu Formáty výstupu pro příkazy Azure CLI.

--query globální parametr

Někdy může výstupní konzola zobrazovat velké množství informací, které potřebujete filtrovat. Uděláte to tak, že pomocí globálního parametru --query spustíte dotaz JMESPath na výsledky příkazů. JMESPath je dotazovací jazyk pro JSON, který umožňuje vybrat a upravit data z výstupu Azure CLI.

Tento příklad vrátí veřejné klíče SSH autorizované pro připojení k virtuálnímu počítači přidáním --query:

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

Výstupní konzola:

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

Další informace o dotazování výstupu příkazu najdete v tématu Dotazování výstupu příkazu Azure CLI pomocí dotazu JMESPath.

Viz také