Azure CLI yapılandırması

Azure CLI, günlük kaydı, veri toplama ve varsayılan argüman değerleri gibi ayarlar için kullanıcı yapılandırmasına olanak tanır. CLI, az configbazı varsayılanları yönetmek için bir kolaylık komutu ve aracılığıyla az initetkileşimli bir seçenek sunar. Diğer değerler, bir yapılandırma dosyasında veya ortam değişkenleriyle ayarlanabilir. Bu makale, bu kullanıcı yapılandırma ayarları ve Azure CLI'nın nasıl yapılandırılıp yapılandırılması hakkında daha fazla bilgi sağlar.

CLI tarafından kullanılan yapılandırma değerleri aşağıdaki öncelik sırasına göre, üsttekiler öncelikli olacak şekilde değerlendirilir.

1. Komut satırı parametreleri
2. Ortam değişkenleri
3. veya ile az config ayarlanan yapılandırma dosyasındaki değerler az init

az init kullanarak ayarları yapılandırma

Azure CLI yapılandırmalarını ayarlamanın en kolay yolu etkileşimli az init komutunu kullanmaktır. "Etkileşim" veya "otomasyon" gibi yaygın bir yapılandırma seçin veya tek tek yapılandırmaları gözden geçirmeyi tercih edin. Bu yaklaşımda özellikle yararlı olan, az init bir yapılandırma seçeneğini diğerine tercih etmek istemenize neden olan nedenleri sağlar.

az init

az config kullanarak ayarları yapılandırma

CLI için varsayılanları az config set komutuyla ayarlayabilirsiniz . Bu komut, bağımsız değişken olarak boşlukla ayrılmış çiftler key=value listesini alır. Sağlanan değerler, gerekli bağımsız değişkenler yerine Azure CLI tarafından kullanılır.

Aşağıdaki tablo, kullanılabilir yapılandırma anahtarlarının listesini içerir.

İsim	Açıklama
varsayılan.grup	Tüm komutlar için kullanılacak varsayılan kaynak grubu.
varsayılanlar.konum	Tüm komutlar için kullanılacak varsayılan konum.
defaults.web	az webapp komutları için kullanılacak varsayılan uygulama adı.
defaults.vm	az vm komutları için kullanılacak varsayılan VM adı.
defaults.vmss	Komutlar için az vmss kullanılacak varsayılan sanal makine ölçek kümesi (VMSS) adı.
defaults.acr	az acr komutları için kullanılacak varsayılan kapsayıcı kayıt defteri adı.

Aşağıda, örnek olarak tüm gruplar için varsayılan kaynak grubu ve konumun nasıl ayarlanacağı açıklanmıştır.

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

Aşağıdaki komut, Azure CLI komutlarını yürütürken anket bağlantılarını kapatır:

az config set core.survey_message=no

CLI yapılandırma dosyası

CLI yapılandırma dosyası, CLI davranışının yönetimi için kullanılan diğer ayarları içerir. Yapılandırma dosyasının kendisi şu konumdadır: $AZURE_CONFIG_DIR/config. Varsayılan AZURE_CONFIG_DIR değeri Linux ve macOS’ta $HOME/.azure, Windows’da %USERPROFILE%\.azure şeklindedir.

Yapılandırma dosyaları INI dosya biçiminde yazılır. Bölüm üst bilgileri, dosya biçimini ve ardından anahtar-değer girdilerinin listesini tanımlar.

• Bölüm başlıkları [section-name] olarak yazılır. Bölüm adları büyük/küçük harfe duyarlıdır.
• Girdiler key=value olarak yazılır. Anahtar adları büyük/küçük harfe duyarlı değildir.
• Açıklamalar, # veya ; ile başlayan tüm satırlardır. Satır içi açıklamalara izin verilmez.

Boole'lar büyük/küçük harfe duyarlı değildir. Aşağıdaki değerler boole değerlerini temsil eder:

• Doğru: 1, yes, true, on
• Yanlış: 0, no, false, off

Burada, tüm onay istemlerini devre dışı bırakan ve /var/log/azure dizinine günlük kaydı ayarlayan bir CLI yapılandırma dosyası örneği sağlanmıştır.

[core]
disable_confirm_prompt=Yes

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

Kullanılabilen tüm yapılandırma değerleri ve bunları ne anlama geldiği hakkında ayrıntılı bilgi edinmek için bir sonraki bölüme bakın. INI dosya biçimiyle ilgili tüm ayrıntılar için bkz. INI ile ilgili Python belgeleri.

CLI yapılandırma değerleri ve ortam değişkenleri

Aşağıdaki tablo, bir yapılandırma dosyasına eklenebilecek tüm bölümleri ve seçenek adlarını içerir. Bunlara karşılık gelen ortam değişkenleri, tamamı büyük harf olacak şekilde AZURE_{section}_{name} olarak ayarlanır. Örneğin, output için core varsayılan değeri değişkende AZURE_CORE_OUTPUT ayarlanır, storage_account için batchai varsayılan değeri değişkende AZURE_BATCHAI_STORAGE_ACCOUNT ayarlanır ve varsayılan location değişkende AZURE_DEFAULTS_LOCATION ayarlanır.

Varsayılan bir değer sağladığınızda bu bağımsız değişken artık herhangi bir komut için gerekli olmaz. Bunun yerine varsayılan değer kullanılır.

Bölüm	İsim	Türü	Açıklama
çekirdek	çıktı	String	Varsayılan çıkış biçimi. İzin verilen değerler: json (varsayılan), jsonc, yaml, yamlc, table, tsv, none. Daha fazla bilgi için bkz . Azure CLI komutları için çıkış biçimleri.
	onay istemini devre dışı bırak	Boolean	Onay istemlerini açın/kapatın.
	görüntüleme_bölgesi_tespit edildi	Boolean	Azure müşterileri birçok farklı bölgede kaynak dağıtmayı seçebilir. Bazı durumlarda müşteriler, aynı hizmetleri sunan yakın bölgeleri seçerek maliyetleri düşürebilir. Yakınlardaki bir bölge tanımlanırsa, gelecekteki dağıtımlar için seçilecek bölge bir ileti görüntülenir. Bu ayar, iletinin görüntülenip görüntülenmediğini denetler.
	collect_telemetry	Boolean	Microsoft’un CLI kullanımıyla ilgili anonim veriler toplamasına izin verin. Gizlilik bilgileri için bkz . Azure CLI MIT lisansı.
	sadece_hataları_göster	Boolean	Yalnızca komut çağırma sırasında hataları göster. Başka bir deyişle, yalnızca hatalar öğesine stderryazılır. Önizleme, kullanım dışı ve deneysel komutlardan gelen uyarıları gizler. Parametresine sahip --only-show-errors tek tek komutlar için de kullanılabilir.
	Windows'ta aracıyı etkinleştir	Boolean	Komutuyla Azure'da kimlik doğrulaması yapmak için Web Hesabı Yöneticisi'ni az login (WAM) kullanın.
	Giriş Deneyimi v2	Boolean	Abonelik seçiciyi az login açın/kapatın.
	renk yok	Boolean	Rengi devre dışı bırakın. Başlangıçta renkli iletiler , DEBUGINFO ve WARNINGön eklerine eklenirERROR. Bu boole değeri, terminalin renginin yeniden yönlendirmeden sonra stdout geri dönememe sorununu atlar.
Istemci	gizli bilgileri gösterme uyarısı	Boolean	Hassas bilgi çıkışı için uyarıyı açın/kapatın.
günlük tutmak	günlüğü_etkinleştir_dosyası	Boolean	Günlük kaydını açın/kapatın.
	log_dir	String	Günlüklerin yazılacağı dizin. Varsayılan olarak bu ${AZURE_CONFIG_DIR}/logs* değerine ayarlanır.
Varsayılan	grup	String	Tüm komutlar için kullanılacak varsayılan kaynak grubu.
	konum	String	Tüm komutlar için kullanılacak varsayılan konum.
	ağ	String	az webapp komutları için kullanılacak varsayılan uygulama adı.
	Vm	String	az vm komutları için kullanılacak varsayılan VM adı.
	vmss	String	Komutlar için az vmss kullanılacak varsayılan sanal makine ölçek kümesi (VMSS) adı.
	acr	String	az acr komutları için kullanılacak varsayılan kapsayıcı kayıt defteri adı.
depolama	hesap	String	Veri düzlemi komutları için kullanılacak varsayılan depolama hesabı adı (örneğin, içindeki mystorageaccounthttps://mystorageaccount.blob.core.windows.net).az storageaz storage container list
	anahtar	String	Veri düzlemi komutları için az storage kullanılacak varsayılan erişim anahtarı.
	SAS belirteci	String	Veri düzlemi komutları için az storage kullanılacak varsayılan SAS belirteci.
	bağlantı_dizesi	String	Veri düzlemi komutları için az storage kullanılacak varsayılan bağlantı dizesi.
batchai	depolama hesabı	String	az batchai komutları için kullanılacak varsayılan depolama hesabı.
	storage_key	String	az batchai komutları için kullanılacak varsayılan depolama anahtarı.
toplu iş	hesap	String	az batch komutları için kullanılacak varsayılan Azure Batch hesap adı.
	erişim anahtarı	String	az batch komutları için kullanılacak varsayılan erişim anahtarı. Yalnızca aad yetkilendirmesiyle kullanılır.
	uç nokta	String	az batch komutları için bağlanılacak varsayılan uç nokta.
	kimlik_dogrulama_modu	String	az batch komutları için kullanılacak yetkilendirme modu. İzin verilen değerler: shared_key, aad.
bulut	isim	String	Tüm az komutlar için varsayılan bulut. İzin verilen değerler: AzureCloud (varsayılan), AzureChinaCloud, AzureUSGovernment. Bulutları değiştirmek için komutunu kullanabilirsiniz az cloud set -–name . Örnek için bkz . Azure CLI ile Bulutları Yönetme.
uzantı	dinamik_yükleme_kullan	String	Bir komutu çalıştırırken henüz eklenmediyse uzantıyı yükleyin. İzin verilen değerler: no (varsayılan), yes_prompt, yes_without_prompt.
	dinamik yükleme sonrası çalıştır	Boolean	Bir uzantı için dinamik olarak yüklendiğinde komutunu çalıştırmaya devam edin. Varsayılan False değeridir.
	index_url	String	index.json biçiminden sonra özel uzantı dizin dosyasının URL'si. Belirtildikten sonra yürütülürken az extension add --name <extension-name> , eklenecek uzantıyı bulmak için bu dosya kullanılır.

Uyarı

Yapılandırma dosyanızda başka değerler de görebilirsiniz, ancak bunlar dahil olmak üzere az configdoğrudan CLI komutları aracılığıyla yönetilir. Daha önce tabloda listelenenler, kendi değiştirmeniz gereken tek değerlerdir.