Az Azure CLI konfigurálása

Az Azure CLI lehetővé teszi a felhasználói konfigurációt olyan beállításokhoz, mint a naplózás, az adatgyűjtés és az alapértelmezett argumentumértékek. A parancssori felület egy egyszerű parancsot kínál néhány alapértelmezett beállítás kezeléséhez, az configés egy interaktív lehetőséget is.az init Más értékek konfigurációs fájlban vagy környezeti változókkal is beállíthatók. Ez a cikk további információkat tartalmaz ezekről a felhasználói konfigurációs beállításokról, valamint az Azure CLI konfigurálásáról.

A parancssori felület által használt konfigurációs értékek kiértékelése a következő sorrendben történik, és a lista magasabb elemei elsőbbséget élveznek.

1. Parancssori paraméterek
2. Környezeti változók
3. A konfigurációs fájlban lévő értékek az config vagy az init-el vannak beállítva.

Beállítások konfigurálása az init használatával

Az Azure CLI-konfigurációk beállításának legegyszerűbb módja az interaktív az init parancs használata. Válasszon ki egy gyakori konfigurációt, például az "interakciót" vagy az "automatizálást", vagy válasszon egyéni konfigurációkat. Ami különösen hasznos ebben a megközelítésben, az, hogy a az init okokat ad arra, miért érdemes egy konfigurációs lehetőséget választani a másikkal szemben.

az init

Beállítások konfigurálása az az config használatával

A parancssori felület alapértelmezett beállításai az az config set paranccsal állíthatók be . Ez a parancs argumentumként a párok szóközzel elválasztott listáját key=value veszi fel. A megadott értékeket az Azure CLI használja a szükséges argumentumok helyett.

Az alábbi táblázat az elérhető konfigurációs kulcsok listáját tartalmazza.

Név	Leírás
alapértelmezések.csoport	Az összes parancshoz használandó alapértelmezett erőforráscsoport.
alapértelmezett.hely	Az összes parancs alapértelmezett helye.
alapértelmezések.web	A parancsokhoz az webapp használandó alapértelmezett alkalmazásnév.
defaults.vm	A az vm parancsokhoz használatos alapértelmezett virtuális gép neve.
defaults.vmss	Használható alapértelmezett virtuális gép-méretezési csoport (VMSS) neve a az vmss parancsokhoz.
defaults.acr	A parancsokhoz használandó alapértelmezett tárolóregisztráció neve.

Példaként az alábbi módon állíthatja be az összes parancs alapértelmezett erőforráscsoportját és helyét.

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

Az alábbi parancs kikapcsolja a felmérési hivatkozásokat az Azure CLI-parancsok végrehajtása közben:

az config set core.survey_message=no

Parancssori felület konfigurációs fájlja

A parancssori felület konfigurációs fájlja más beállításokat is tartalmaz, amelyek a parancssori felület viselkedésének kezelésére szolgálnak. Maga a konfigurációs fájl itt található: $AZURE_CONFIG_DIR/config. Az AZURE_CONFIG_DIR alapértelmezett értéke a Linux és macOS rendszereken $HOME/.azure, a Windows rendszeren pedig %USERPROFILE%\.azure.

A konfigurációs fájlok INI-fájlformátumban vannak megírva. A szakaszfejlécek határozzák meg a fájlformátumot, majd a kulcs-érték bejegyzések listáját.

• A szakaszfejlécek a következőképpen vannak megírva [section-name]: . A szakasznevek megkülönböztetik a kis- és nagybetűket.
• A bejegyzések így vannak írva: key=value. A kulcsnevek nem megkülönböztetik a kis- és nagybetűket.
• Azok a sorok minősülnek megjegyzésnek, amelyek #-vel vagy ;-vel kezdődnek. Beágyazott megjegyzések nem engedélyezettek.

A logikai értékek nem érzékenyek a kis- és nagybetűkre. A következő értékek logikai értékeket jelölnek:

• Igaz: 1, yes, true, on
• Hamis: 0, no, false, off

Íme egy példa egy cli-konfigurációs fájlra, amely letiltja a megerősítési kéréseket, és beállítja a /var/log/azure címtárba való naplózást.

[core]
disable_confirm_prompt=Yes

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

A következő szakaszban az összes elérhető konfigurációs értékről és azok jelentéseiről olvashat. Az INI-fájlformátum részletes leírását az INI Python-dokumentációjában találja.

CLI-konfigurációs értékek és környezeti változók

Az alábbi táblázat tartalmazza a konfigurációs fájlban elhelyezhető összes szakaszt és beállításnevet. A megfelelő környezeti változók nagybetűvel vannak beállítva AZURE_{section}_{name}. Például, a output alapértelmezett értéke a core a AZURE_CORE_OUTPUT változóban van beállítva, a storage_account alapértelmezett értéke batchai a AZURE_BATCHAI_STORAGE_ACCOUNT változóban van beállítva, és az alapértelmezett location a AZURE_DEFAULTS_LOCATION változóban van beállítva.

Ha alapértelmezett értéket ad meg, a parancs már nem követeli meg ezt az argumentumot. Ehelyett a rendszer az alapértelmezett értéket használja.

Szakasz	Név	típus	Leírás
mag	kimenet	szál/zsinór	Az alapértelmezett kimeneti formátum. Engedélyezett értékek: json (alapértelmezett), jsonc, yaml, yamlc, table, tsv. none További információkért tekintse meg az Azure CLI-parancsok kimeneti formátumait.
	megerősítési felugró ablak letiltása	Boolean	A megerősítési kérések be- és kikapcsolása.
	kijelző_régió_azonosítva	Boolean	Az Azure-ügyfelek számos különböző régióban helyezhetnek üzembe erőforrásokat. Bizonyos esetekben előfordulhat, hogy az ügyfelek csökkenthetik a költségeket az azonos szolgáltatásokat kínáló közeli régiók kiválasztásával. Ha egy közeli régiót azonosít, egy üzenet jelenik meg a jövőbeli üzembe helyezéshez kiválasztandó régióról. Ez a beállítás szabályozza, hogy megjelenik-e az üzenet.
	adatgyűjtés_telemetria	Boolean	Lehetővé teszi, hogy a Microsoft névtelen adatokat gyűjtsön a parancssori felület használatával kapcsolatban. Az adatvédelmi információkért tekintse meg az Azure CLI MIT-licencet.
	csak_hiba_megjelenítése	Boolean	Csak a parancshívás során jelenítse meg a hibákat. Más szóval, csak a hibák íródnak a stderr fájlba. Letiltja a figyelmeztetéseket az előzetes verzióból, az elavult és a kísérleti parancsokból. A --only-show-errors paraméter egyéni parancsokhoz is elérhető.
	a_broker_engedélyezése_windows-on	Boolean	A Web Account Manager (WAM) használatával hitelesítheti magát az Azure-ban a az login parancson keresztül.
	bejelentkezési_élmény_v2	Boolean	Kapcsolja be/ki az az login előfizetés-választót.
	nincs_szín	Boolean	Tiltsa le a színt. Az eredetileg színes üzenetek előtagjaiként a DEBUG, INFO, WARNING és ERROR szerepelnek. Ez a logikai érték megkerüli annak a harmadik féltől származó kódtárnak a problémáját, ahol a terminál színe nem tud visszaállni egy stdout átirányítás után.
Ügyfelek	titkok_megjelenítés_figyelmeztetés	Boolean	Kapcsolja be/ki a bizalmas információk kimenetére vonatkozó figyelmeztetést.
naplózás	naplófájl engedélyezése	Boolean	Kapcsolja be/ki a naplózást.
	log_dir	szál/zsinór	A naplókat írni kívánt könyvtár. Alapértelmezés szerint ez az érték: ${AZURE_CONFIG_DIR}/logs*.
Alapértelmezett	csoport	szál/zsinór	Az összes parancshoz használandó alapértelmezett erőforráscsoport.
	helyszín	szál/zsinór	Az összes parancs alapértelmezett helye.
	világháló	szál/zsinór	A parancsokhoz az webapp használandó alapértelmezett alkalmazásnév.
	Vm	szál/zsinór	A az vm parancsokhoz használatos alapértelmezett virtuális gép neve.
	virtuálisgép-méretaránykészletek	szál/zsinór	Használható alapértelmezett virtuális gép-méretezési csoport (VMSS) neve a az vmss parancsokhoz.
	ACR	szál/zsinór	A parancsokhoz használandó alapértelmezett tárolóregisztráció neve.
raktározás	számla	szál/zsinór	A tárolási fiók alapértelmezett neve (például mystorageaccount in https://mystorageaccount.blob.core.windows.net) az adatsík-parancsok használatához az storage (például az storage container list).
	kulcs	szál/zsinór	Az adatsíkos parancsokhoz az storage használandó alapértelmezett hozzáférési kulcs.
	sas_token	szál/zsinór	Az adatsík-parancsokhoz az storage használandó alapértelmezett SAS-jogkivonat.
	kapcsolati karakterlánc	szál/zsinór	Az adatsík-parancsokhoz az storage használandó alapértelmezett kapcsolati karakterlánc.
batchai	tároló_fiók	szál/zsinór	az batchai parancsokhoz használandó alapértelmezett tárfiók.
	tárolási_kulcs	szál/zsinór	A az batchai parancsokhoz használandó alapértelmezett tárkulcs.
tétel	számla	szál/zsinór	A parancsokhoz az batch használandó alapértelmezett Azure Batch-fióknév.
	hozzáférési_kulcs	szál/zsinór	A parancsokhoz használatos alapértelmezett hozzáférési kulcs. Csak engedélyezéssel aad használható.
	végpont	szál/zsinór	A az batch parancsokhoz való alapértelmezett csatlakozási végpont.
	hitelesítési mód	szál/zsinór	A az batch parancsokhoz használatos engedélyezési mód. Engedélyezett értékek: shared_key, aad.
felhő	név	szál/zsinór	Az összes az parancs alapértelmezett felhője. Engedélyezett értékek: AzureCloud (alapértelmezett), AzureChinaCloud, AzureUSGovernment. A felhők módosításához használja a az cloud set -–name parancsot. Példa: Felhők kezelése az Azure CLI-vel.
kiterjesztés	dinamikus_telepítés_használata	szál/zsinór	Telepítsen egy bővítményt, ha egy parancs futtatásakor még nincs hozzáadva. Engedélyezett értékek: no (alapértelmezett), yes_prompt, yes_without_prompt.
	futtatás dinamikus telepítés után	Boolean	Futtassa tovább a parancsot, ha egy bővítmény dinamikusan van telepítve hozzá. Az alapértelmezett érték False.
	index_url	szál/zsinór	A privát bővítmény indexfájljának URL-címe a index.jsonformátumot követve. Miután megadta, a az extension add --name <extension-name> végrehajtás a fájl használatával keresi meg a hozzáadni kívánt bővítményt.

Megjegyzés:

Előfordulhat, hogy más értékek is megjelennek a konfigurációs fájlban, de ezek kezelése közvetlenül parancssori felületi parancsokkal történik, például az config. A táblázatban korábban felsorolt értékek az egyetlenek, amelyeket módosítania kell.