Konfigurace Azure CLI

Azure CLI umožňuje uživatelské konfigurace různých 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. Další hodnoty se dají nastavit v konfiguračním souboru nebo prostřednictvím 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 vyhodnotí v následujícím pořadí. Položky, které jsou na seznamu výš, mají vyšší prioritu.

1. Parametry příkazového řádku
2. Proměnné prostředí
3. Hodnoty v konfiguračním souboru nastaveném az configaz 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
defaults.group	Výchozí skupina prostředků pro všechny příkazy
defaults.location	Výchozí skupina umístění pro všechny příkazy
defaults.web	Výchozí název aplikace pro příkazy az webapp
defaults.vm	Výchozí název virtuálního počítače pro příkazy az vm
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 pro příkazy az acr

Tady je příklad, jak byste mohli 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 output.show_survey_link=no

Konfigurační soubor CLI

Konfigurační soubor rozhraní příkazového řádku obsahuje další nastavení, která se používají pro správu 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 jsou napsané ve formátu souborů INI. Hlavičky oddílu definují formát souboru následovaný seznamem položek klíč-hodnota.

• Záhlaví oddílu se zapisují jako [section-name]. V názvech oddílů se rozlišují velká a malá písmena.
• Položky se zapisují jako key=value. V názvech klíčů se nerozlišuje malá a velká písmena.
• Komentář je každý řádek, který začíná # nebo ;. Vložené komentáře nejsou povolené.

Logické hodnoty nerozlišují malá a velká písmena. 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ý zakazuje zobrazování výzev k potvrzení a nastavuje protokolování do adresáře /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

Podrobné informace o všech dostupných konfiguračních hodnotách a jejich významu najdete v následujícím oddílu. Všechny podrobnosti o formátu souborů INI najdete v dokumentaci k Pythonu věnované INI.

Proměnné prostředí a hodnoty konfigurace rozhraní příkazového řádku

Následující tabulka obsahuje názvy všech oddílů a možností, které je možné umístit mohou do konfiguračního souboru. Odpovídající proměnné prostředí jsou nastavené jako AZURE_{section}_{name} (všechna písmena velká). Například output výchozí hodnota core pro je nastavena v AZURE_CORE_OUTPUT proměnné, storage_account výchozí hodnota batchai pro je nastavena v AZURE_BATCHAI_STORAGE_ACCOUNT proměnné a výchozí location je nastavena AZURE_DEFAULTS_LOCATION v proměnné.

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

Sekce	Name	Typ	Popis
core	output	string	Výchozí formát výstupu. 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.
	disable_confirm_prompt	boolean	Umožňuje vypnout nebo zapnout výzvy k potvrzení.
	display_region_identified	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 identifikovaná okolní oblast, zobrazí se ve zprávě zpráva, která se má vybrat pro budoucí nasazení. Toto nastavení určuje, jestli se zobrazí zpráva.
	collect_telemetry	boolean	Umožňuje Microsoftu shromažďovat anonymní informace o používání rozhraní příkazového řádku. Informace o ochraně osobních údajů najdete v licenci Azure CLI MIT.
	only_show_errors	boolean	Zobrazí se pouze chyby při vyvolání příkazu. Jinými slovy, pouze chyby jsou zapsány do stderr. Potlačí upozornění z náhledu, zastaralého a experimentálního příkazu. Je také k dispozici pro jednotlivé příkazy s parametrem --only-show-errors .
	enable_broker_on_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 .
	no_color	boolean	Zakažte 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 .
Klienty	show_secrets_warning	boolean	Zapněte nebo vypněte upozornění pro výstup citlivých informací.
logging	enable_log_file	boolean	Umožňuje vypnout nebo zapnout protokolování.
	log_dir	string	Adresář, do kterého se zapisují protokoly. Ve výchozím nastavení touto hodnotou je ${AZURE_CONFIG_DIR}/logs*.
Výchozí	skupina	string	Výchozí skupina prostředků pro všechny příkazy
	location	string	Výchozí skupina umístění pro všechny příkazy
	web	string	Výchozí název aplikace pro příkazy az webapp
	vm	string	Výchozí název virtuálního počítače pro příkazy az vm
	vmss	string	Výchozí název škálovací sady virtuálních počítačů (VMSS), který se má použít pro az vmss příkazy.
	acr	string	Výchozí název registru kontejneru pro příkazy az acr
storage	account	string	Výchozí název účtu úložiště (například mystorageaccount in https://mystorageaccount.blob.core.windows.net) pro az storage příkazy roviny dat (například az storage container list).
	klíč	string	Výchozí přístupový klíč, který se má použít pro az storage příkazy roviny dat.
	sas_token	string	Výchozí token SAS, který se má použít pro az storage příkazy roviny dat.
	connection_string	string	Výchozí připojovací řetězec použít pro az storage příkazy roviny dat.
batchai	storage_account	string	Výchozí účet úložiště pro příkazy az batchai
	storage_key	string	Výchozí klíč úložiště pro příkazy az batchai
batch	account	string	Výchozí účet Azure Batch pro příkazy az batch
	access_key	string	Výchozí přístupový klíč pro příkazy az batch. Používá se jenom pro autorizaci aad.
	endpoint	string	Výchozí koncový bod pro připojení pro příkazy az batch
	auth_mode	string	Výchozí režim autorizace pro příkazy az batch. Povolené hodnoty: shared_key, aad.
Cloud	name	string	Výchozí cloud pro všechny az příkazy. Povolené hodnoty: AzureCloud (výchozí), AzureChinaCloud, AzureUSGovernment. Pokud chcete změnit cloudy, můžete použít az cloud set –name tento příkaz. Příklad najdete v tématu Správa cloudů pomocí Azure CLI.
Rozšíření	use_dynamic_install	string	Pokud se rozšíření ještě nepřidá, nainstalujte ho při spuštění příkazu z něj. Povolené hodnoty: no (výchozí), yes_prompt, yes_without_prompt.
	run_after_dynamic_install	boolean	Pokračujte spuštěním příkazu, když je pro něj dynamicky nainstalované rozšíření. Výchozí hodnota je False.
	index_url	string	Adresa URL souboru indexu privátní přípony za formátem v index.json. Po zadání se spuštěním az extension add --name <extension-name> tohoto souboru najde přípona, kterou chcete přidat.

Poznámka:

V konfiguračním souboru se mohou zobrazovat i jiné hodnoty, ale ty se spravují přímo prostřednictvím 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.