Konfigurace Azure CLI

Azure CLI umožňuje konfiguraci uživatele pro nastavení, jako je protokolování, shromažďování dat a výchozí hodnoty argumentů. Rozhraní příkazového řádku nabízí příkaz pro usnadnění správy některých výchozích hodnot az configa interaktivní možnost prostřednictvím az init. Jiné hodnoty je možné nastavit v konfiguračním souboru nebo pomocí proměnných prostředí. Tento článek obsahuje další informace o těchto nastaveních konfigurace uživatele a o tom, jak nakonfigurovat Azure CLI.

Hodnoty konfigurace používané rozhraním příkazového řádku se vyhodnocují v následující posloupnosti priorit, kdy položky výše v seznamu mají přednost.

1. Parametry příkazového řádku
2. Proměnné prostředí
3. Hodnoty v konfiguračním souboru nastavené pomocí az config nebo az init

Konfigurace nastavení pomocí az init

Nejjednodušší způsob, jak nastavit konfigurace Azure CLI, je použít interaktivní příkaz az init . Zvolte společnou konfiguraci, například "interakce" nebo "automatizace", nebo se rozhodnete projít jednotlivé konfigurace. To, co je zvlášť užitečné při tomto přístupu, je az init důvod, proč byste mohli chtít zvolit jednu možnost konfigurace nad jinou.

az init

Konfigurace nastavení pomocí az config

Výchozí hodnoty pro rozhraní příkazového řádku můžete nastavit pomocí příkazu az config set . Tento příkaz přebírá jako argument seznam dvojic oddělených key=value mezerami. Zadané hodnoty používají Azure CLI místo povinných argumentů.

Následující tabulka obsahuje seznam dostupných konfiguračních klíčů.

Název	Popis
výchozí.skupina	Výchozí skupina prostředků, která se má použít pro všechny příkazy.
výchozí.umístění	Výchozí umístění, které se má použít pro všechny příkazy.
defaults.web	Výchozí název aplikace, který se má použít pro az webapp příkazy.
defaults.vm	Výchozí název virtuálního počítače, který se má použít pro az vm příkazy.
defaults.vmss	Výchozí název škálovací sady virtuálních počítačů (VMSS), který se má použít pro az vmss příkazy.
defaults.acr	Výchozí název registru kontejneru, který se má použít pro az acr příkazy.

Zde je příklad, jak nastavit výchozí skupinu prostředků a umístění pro všechny příkazy.

az config set defaults.location=westus2 defaults.group=MyResourceGroup

Následující příkaz vypne odkazy na průzkum při provádění příkazů Azure CLI:

az config set core.survey_message=no

Konfigurační soubor CLI

Konfigurační soubor rozhraní příkazového řádku obsahuje další nastavení, která se používají ke správě chování rozhraní příkazového řádku. Samotný konfigurační soubor je umístěný v $AZURE_CONFIG_DIR/config. Výchozí hodnota pro AZURE_CONFIG_DIR je $HOME/.azure v Linuxu a macOS a %USERPROFILE%\.azure ve Windows.

Konfigurační soubory se zapisují ve formátu souboru INI. Hlavičky oddílu definují formát souboru následovaný seznamem položek klíč-hodnota.

• Hlavičky oddílu se zapisují jako [section-name]. Názvy oddílů jsou citlivé na velikost písmen.
• Položky jsou zapsány jako key=value. V názvech klíčů se nerozlišuje malá a velká písmena.
• Komentáře jsou všechny řádky, které začínají # nebo ;. Vložené komentáře nejsou povolené.

Logické hodnoty jsou vůči malým a velkým písmenům necitlivé. Následující hodnoty představují logické hodnoty:

• True: 1, yes, true, on
• False: 0, no, false, off

Tady je příklad konfiguračního souboru rozhraní příkazového řádku, který zakáže všechny výzvy k potvrzení a nastaví protokolování do /var/log/azure adresáře.

[core]
disable_confirm_prompt=Yes

[logging]
enable_log_file=yes
log_dir=/var/log/azure

Podrobnosti o všech dostupných hodnotách konfigurace a jejich významu najdete v další části. Úplné podrobnosti o formátu souboru INI najdete v dokumentaci Pythonu k INI.

Konfigurační hodnoty rozhraní příkazové řádky a proměnné prostředí

Následující tabulka obsahuje všechny části a názvy možností, které lze umístit do konfiguračního souboru. Jejich odpovídající proměnné prostředí jsou nastaveny jako AZURE_{section}_{name}, ve všech velkých písmenech. Například výchozí hodnota output pro core je nastavena v proměnné AZURE_CORE_OUTPUT, výchozí hodnota storage_account pro batchai je nastavena v proměnné AZURE_BATCHAI_STORAGE_ACCOUNT, a výchozí hodnota location je nastavena v proměnné AZURE_DEFAULTS_LOCATION.

Pokud zadáte výchozí hodnotu, už tento argument nevyžaduje žádný příkaz. Místo toho se použije výchozí hodnota.

Oddíl	Název	Typ	Popis
jádro	výstup	řetězec	Výchozí výstupní formát. Povolené hodnoty: json (výchozí), jsonc, yaml, yamlc, table, tsv. none Další informace najdete v tématu Formáty výstupu pro příkazy Azure CLI.
	zakázat_potvrzovací_výzvu	Boolean	Zapněte nebo vypněte výzvy k potvrzení.
	zobrazený_region_identifikován	Boolean	Zákazníci Azure se můžou rozhodnout nasadit prostředky v mnoha různých oblastech. V některých případech můžou zákazníci snížit náklady výběrem blízkých oblastí nabízejících stejné služby. Pokud je identifikována okolní oblast, zobrazí se zpráva s informací o oblasti, kterou lze vybrat pro budoucí nasazení. Toto nastavení určuje, jestli se zobrazí zpráva.
	shromažďovat telemetrii	Boolean	Povolit Microsoftu shromažďovat anonymní data o používání rozhraní příkazového řádku. Informace o ochraně osobních údajů najdete v licenci Azure CLI MIT.
	zobrazit_pouze_chyby	Boolean	Zobrazí se pouze chyby při vyvolání příkazu. Jinými slovy, pouze chyby jsou zapsány do stderr. Potlačuje upozornění z příkazů v náhledu, zastaralých a experimentálních. Je také k dispozici pro jednotlivé příkazy s parametrem --only-show-errors .
	povolit_zprostředkovatele_na_windows	Boolean	Pomocí správce webových účtů (WAM) se pomocí příkazu ověřte v Azure az login .
	login_experience_v2	Boolean	Zapněte nebo vypněte selektor předplatného az login .
	bez barvy	Boolean	Vypnout barvu. Původně barevné zprávy mají předponu DEBUG, INFOWARNING a ERROR. Tato logická hodnota obchází problém knihovny třetí strany, kde se barva terminálu po přesměrování nemůže vrátit zpět stdout .
klienti	zobrazit varování o tajemstvích	Boolean	Zapněte nebo vypněte upozornění pro výstup citlivých informací.
protokolování	povolit_soubors_logem	Boolean	Zapněte nebo vypněte protokolování.
	adresář_protokolů	řetězec	Adresář, do kterého se zapisují protokoly. Ve výchozím nastavení touto hodnotou je ${AZURE_CONFIG_DIR}/logs*.
výchozí hodnoty	skupina	řetězec	Výchozí skupina prostředků, která se má použít pro všechny příkazy.
	místo	řetězec	Výchozí umístění, které se má použít pro všechny příkazy.
	web	řetězec	Výchozí název aplikace, který se má použít pro az webapp příkazy.
	Vm	řetězec	Výchozí název virtuálního počítače, který se má použít pro az vm příkazy.
	vmss	řetězec	Výchozí název škálovací sady virtuálních počítačů (VMSS), který se má použít pro az vmss příkazy.
	acr	řetězec	Výchozí název registru kontejneru, který se má použít pro az acr příkazy.
skladování	účet	řetězec	Výchozí název účtu úložiště (například mystorageaccount v https://mystorageaccount.blob.core.windows.net) pro az storage příkazy na úrovni dat (například az storage container list).
	klíč	řetězec	Výchozí přístupový klíč, který se má použít pro az storage příkazy roviny dat.
	sas_token	řetězec	Výchozí token SAS, který se má použít pro az storage příkazy na datové úrovni.
	řetězec_připojení	řetězec	Výchozí připojovací řetězec, který se má použít pro az storage příkazy datové vrstvy.
batchai	úložný účet	řetězec	Výchozí účet úložiště, který se má použít pro az batchai příkazy.
	úložný_klíč	řetězec	Výchozí klíč úložiště, který se má použít pro az batchai příkazy.
dávka	účet	řetězec	Výchozí název účtu Azure Batch, který se má použít pro az batch příkazy.
	přístupový klíč	řetězec	Výchozí přístupový klíč, který se má použít pro az batch příkazy. Používá se pouze s aad autorizací.
	koncový bod	řetězec	Výchozí koncový bod pro spojení s příkazy az batch.
	režim ověřování	řetězec	Režim autorizace, který se má použít pro az batch příkazy. Povolené hodnoty: shared_key, aad.
cloud	název	řetězec	Výchozí cloud pro všechny az příkazy. Povolené hodnoty: AzureCloud (výchozí), AzureChinaCloud, AzureUSGovernment. Chcete-li změnit cloudy, můžete použít tento příkaz: az cloud set -–name. Příklad najdete v tématu Správa cloudů pomocí Azure CLI.
prodloužení	použijte_dynamickou_instalaci	řetězec	Nainstalujte rozšíření, pokud ještě není přidáno, když z něj spustíte příkaz. Povolené hodnoty: no (výchozí), yes_prompt, yes_without_prompt.
	spusť_po_dynamické_instalaci	Boolean	Pokračujte spuštěním příkazu, když je pro něj dynamicky nainstalované rozšíření. Výchozí hodnota je False.
	adresa_indexu	řetězec	Adresa URL indexového souboru privátní přípony za formátem v index.json. Jakmile je specifikováno, spuštěním az extension add --name <extension-name> použije tento soubor k nalezení přípony, kterou lze přidat.

Poznámka:

V konfiguračním souboru se můžou zobrazit další hodnoty, ale ty se spravují přímo pomocí příkazů rozhraní příkazového řádku, včetně az config. Ty, které jsou uvedené v tabulce dříve, jsou jediné hodnoty, které byste měli změnit sami.