Konfigurasi CLI Azure

Azure CLI memungkinkan konfigurasi pengguna untuk pengaturan seperti pengelogan, pengumpulan data, dan nilai argumen default. CLI menawarkan perintah kenyamanan untuk mengelola beberapa default, az config, dan opsi interaktif melalui az init. Nilai lain dapat diatur dalam file konfigurasi atau dengan variabel lingkungan. Artikel ini menyediakan informasi lebih lanjut tentang pengaturan konfigurasi pengguna ini dan cara mengonfigurasi Azure CLI.

Nilai konfigurasi yang dipakai oleh CLI dievaluasi menurut urutan prioritas berikut, dengan item yang lebih tinggi dalam daftar diutamakan.

1. Parameter untuk baris perintah
2. Variabel lingkungan
3. Nilai dalam file konfigurasi yang diatur dengan az config atau az init

Mengonfigurasi pengaturan menggunakan az init

Cara term mudah untuk mengatur konfigurasi Azure CLI adalah dengan menggunakan perintah az init interaktif. Pilih konfigurasi umum seperti "interaksi" atau "otomatisasi," atau pilih untuk menelusuri konfigurasi individual. Apa yang sangat membantu dengan pendekatan ini adalah az init memberikan alasan mengapa Anda mungkin ingin memilih satu opsi konfigurasi di atas yang lain.

az init

Konfigurasikan pengaturan menggunakan az config

Anda dapat mengatur default untuk CLI dengan perintah az config set . Perintah ini mengambil daftar key=value pasangan yang dipisahkan spasi sebagai argumen. Nilai yang disediakan digunakan oleh Azure CLI sebagai ganti argumen yang diperlukan.

Tabel berikut berisi daftar kunci konfigurasi yang tersedia.

Nama	Deskripsi
defaults.group	Grup sumber daya default yang akan digunakan untuk semua perintah.
defaults.location	Lokasi default yang digunakan untuk semua perintah.
defaults.web	Nama aplikasi default yang akan digunakan untuk az webapp perintah.
defaults.vm	Nama VM default yang akan digunakan untuk az vm perintah.
defaults.vmss	Nama set skala komputer virtual (VMSS) default yang akan digunakan untuk az vmss perintah.
defaults.acr	Nama registri kontainer default yang akan digunakan untuk az acr perintah.

Sebagai contoh, berikut adalah cara Anda mengatur grup sumber daya default dan lokasi untuk semua perintah.

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

Perintah berikut menonaktifkan tautan survei saat menjalankan perintah Azure CLI:

az config set core.survey_message=no

File konfigurasi CLI

File konfigurasi CLI berisi pengaturan lain yang digunakan untuk mengelola perilaku CLI. File konfigurasinya terletak di $AZURE_CONFIG_DIR/config. Nilai default AZURE_CONFIG_DIR adalah $HOME/.azure di Linux dan macOS, dan %USERPROFILE%\.azure di Windows.

File konfigurasi ditulis dalam format file INI. Header bagian menentukan format file, diikuti dengan daftar entri nilai kunci.

• Judul bagian dituliskan sebagai [section-name]. Nama bagian sensitif terhadap huruf besar/kecil.
• Entri ditulis sebagai key=value. Nama kunci tidak sensitif terhadap huruf besar/kecil.
• Komentar adalah baris apa pun yang dimulai dengan # atau ;. Komentar sebaris tidak diperbolehkan.

Boolean tidak membedakan antara huruf besar dan kecil. Nilai berikut mewakili boolean:

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

Berikut adalah contoh file konfigurasi CLI yang menonaktifkan perintah konfirmasi dan menyiapkan pengelogan ke /var/log/azure direktori.

[core]
disable_confirm_prompt=Yes

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

Lihat bagian berikutnya untuk detail tentang semua nilai konfigurasi yang tersedia dan apa artinya. Untuk detail lengkap tentang format file INI, lihat dokumentasi Python di INI.

Nilai konfigurasi CLI dan variabel lingkungan

Tabel berikut berisi semua bagian dan nama opsi yang dapat ditempatkan dalam file konfigurasi. Variabel lingkungan yang sesuai diatur sebagai AZURE_{section}_{name}, dalam huruf kapital semua. Misalnya, output default untuk core diatur dalam AZURE_CORE_OUTPUT variabel, storage_account default untuk batchai diatur dalam AZURE_BATCHAI_STORAGE_ACCOUNT variabel, dan default location diatur dalam AZURE_DEFAULTS_LOCATION variabel.

Saat Anda memberikan nilai default, argumen tersebut tidak lagi diperlukan oleh perintah apa pun. Sebagai gantinya, nilai default digunakan.

Bagian	Nama	Tipe	Deskripsi
inti	keluaran	benang	Format keluaran bawaan. Nilai yang diizinkan: json (default), jsonc, , yamlyamlc, table, tsv, none. Untuk informasi selengkapnya, lihat Format output untuk perintah Azure CLI.
	disable_confirm_prompt	Boolean	Aktifkan/nonaktifkan perintah konfirmasi.
	region_tampilan_teridentifikasi	Boolean	Pelanggan Azure dapat memilih untuk menyebarkan sumber daya di berbagai wilayah. Dalam beberapa kasus, pelanggan mungkin dapat mengurangi biaya dengan memilih wilayah terdekat yang menawarkan layanan yang sama. Jika wilayah terdekat diidentifikasi, pesan akan menampilkan wilayah yang akan dipilih untuk penyebaran di masa mendatang. Pengaturan ini mengontrol apakah pesan ditampilkan.
	kumpulkan_telemetri	Boolean	Izinkan Microsoft mengumpulkan data anonim tentang penggunaan CLI. Untuk informasi privasi, lihat lisensi Azure CLI MIT.
	hanya_menampilkan_kesalahan	Boolean	Hanya tampilkan kesalahan ketika memanggil perintah. Dengan kata lain, hanya kesalahan yang ditulis ke stderr. Ini mengabaikan peringatan dari perintah pratinjau, tidak digunakan lagi, dan eksperimental. Ini juga tersedia untuk perintah individual dengan --only-show-errors parameter .
	aktifkan broker pada Windows	Boolean	Gunakan Web Account Manager (WAM) untuk mengautentikasi ke Azure melalui az login perintah .
	login_experience_v2	Boolean	Aktifkan/nonaktifkan pemilih az login langganan.
	tanpa warna	Boolean	Nonaktifkan warna. Pesan berwarna asli diawali dengan DEBUG, , INFOWARNING dan ERROR. Boolean ini mengatasi masalah pustaka pihak ketiga di mana warna terminal tidak dapat kembali setelah pengalihan stdout.
Klien	tampilkan_peringatan_rahasia	Boolean	Aktifkan/nonaktifkan peringatan untuk output informasi sensitif.
Penebangan	aktifkan_berkas_log	Boolean	Aktifkan/nonaktifkan pengelogan.
	log_dir	benang	Direktori untuk menulis log. Secara default nilai ini adalah ${AZURE_CONFIG_DIR}/logs*.
Default	grup	benang	Grup sumber daya default yang akan digunakan untuk semua perintah.
	lokasi	benang	Lokasi default yang digunakan untuk semua perintah.
	situs web	benang	Nama aplikasi default yang akan digunakan untuk az webapp perintah.
	Vm	benang	Nama VM default yang akan digunakan untuk az vm perintah.
	vmss	benang	Nama set skala komputer virtual (VMSS) default yang akan digunakan untuk az vmss perintah.
	acr	benang	Nama registri kontainer default yang akan digunakan untuk az acr perintah.
penyimpanan	akun	benang	Nama akun penyimpanan default (misalnya, mystorageaccount di https://mystorageaccount.blob.core.windows.net) yang digunakan untuk perintah data-plane az storage (misalnya, az storage container list).
	kunci	benang	Kunci akses default yang digunakan untuk az storage perintah bidang data.
	sas_token	benang	Token SAS yang digunakan secara default untuk perintah data-plane az storage.
	String_koneksi	benang	String koneksi default yang digunakan untuk az storage perintah data-plane.
batchai	akun penyimpanan	benang	Akun penyimpanan default yang digunakan untuk az batchai perintah.
	kunci_penyimpanan	benang	Kunci penyimpanan default yang digunakan untuk az batchai perintah.
Batch	akun	benang	Nama akun Azure Batch bawaan yang akan digunakan untuk perintah az batch.
	kunci_akses	benang	Kunci akses default yang akan digunakan untuk az batch perintah. Hanya digunakan dengan aad otorisasi.
	Titik akhir	benang	Titik akhir default untuk menyambungkan perintah az batch.
	mode_otorisasi	benang	Mode otorisasi yang digunakan untuk az batch perintah. Nilai yang diizinkan: shared_key, aad.
awan	Nama	benang	Cloud bawaan untuk semua perintah az. Nilai yang diizinkan: AzureCloud (default), AzureChinaCloud, AzureUSGovernment. Untuk mengubah awan, Anda dapat menggunakan perintah az cloud set -–name. Misalnya, lihat Mengelola Cloud dengan Azure CLI.
Ekstensi	gunakan_penginstalan_dinamis	benang	Instal ekstensi jika belum ditambahkan saat menjalankan perintah dari ekstensi tersebut. Nilai yang diizinkan: no (default), yes_prompt, yes_without_prompt.
	jalankan_setelah_pemasangan_dinamis	Boolean	Lanjutkan menjalankan perintah saat ekstensi diinstal secara dinamis untuknya. Defaultnya adalah False.
	index_url	benang	URL file indeks ekstensi privat yang mengikuti format dalam index.json. Setelah ditentukan, eksekusi az extension add --name <extension-name> menggunakan file tersebut untuk menemukan ekstensi yang akan ditambahkan.

Nota

Anda mungkin melihat nilai lain dalam file konfigurasi Anda, tetapi ini dikelola langsung melalui perintah CLI, termasuk az config. Nilai yang tercantum dalam tabel sebelumnya adalah satu-satunya nilai yang harus Anda ubah sendiri.