Bagikan melalui

Mengonfigurasi pengaturan global Azure PowerShell

  • Artikel

Azure PowerShell menawarkan berbagai pengaturan global, seperti opsi untuk menonaktifkan melanggar perubahan pesan peringatan. Sebelum modul Az PowerShell versi 9, tidak ada metode terpusat atau terperinci untuk mengonfigurasi pengaturan global ini.

Konfigurasi terpusat

Modul Az PowerShell versi 9 dan yang lebih tinggi menyertakan cmdlet untuk mengelola konfigurasi pengaturan global untuk Azure PowerShell. Cmdlet ini *-AzConfig adalah bagian dari modul Az.Accounts PowerShell:

Pengaturan terperinci

Anda dapat menerapkan pengaturan yang efektif dalam cakupan tertentu. Nilai yang valid untuk parameter Cakupan adalah:

  • Current User: Cakupan default saat menerapkan pengaturan.
  • Process: Pengaturan hanya diterapkan ke sesi PowerShell saat ini.
  • Default: Cakupan baca-saja di mana nilai default tidak berubah.
  • Environment: Cakupan baca-saja di mana nilai dikonfigurasi melalui variabel lingkungan.

Selain cakupan, Anda dapat menerapkan pengaturan ke semua modul Az PowerShell atau hanya satu modul. Dengan menggunakan parameterPpliedsTo, Anda dapat menentukan seberapa luas Anda ingin pengaturan diterapkan. Nilai Az menunjukkan bahwa pengaturan diterapkan ke semua modul yang merupakan bagian dari Azure PowerShell.

Opsi konfigurasi

Ada banyak opsi konfigurasi yang dapat Anda atur dengan *-AzConfig cmdlet. Banyak dari opsi konfigurasi ini ditampilkan di bagian ini. Jalankan perintah berikut untuk melihat daftar lengkap opsi konfigurasi Azure PowerShell yang bisa Anda atur dengan *-AzConfig cmdlet.

Get-AzConfig | Format-List

Meningkatkan pemberitahuan

Pemberitahuan dalam alat untuk peningkatan versi Azure PowerShell adalah fitur yang dirilis dalam modul Az PowerShell versi 10.3.0. Saat versi baru Azure PowerShell tersedia, pemberitahuan peningkatan ditampilkan di sesi PowerShell interaktif Anda.

Untuk menentukan apakah pemberitahuan peningkatan diaktifkan, gunakan Get-AzConfig cmdlet dengan parameter CheckForUpgrade , seperti yang ditunjukkan dalam contoh berikut.

Get-AzConfig -CheckForUpgrade

Untuk mengaktifkan pemberitahuan peningkatan untuk Azure PowerShell, gunakan Update-AzConfig cmdlet dengan parameter CheckForUpgrade dan $true untuk nilainya, seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -CheckForUpgrade $true

Untuk menonaktifkan pemberitahuan peningkatan, gunakan Update-AzConfig cmdlet dengan parameter CheckForUpgrade dan $false untuk nilainya, seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -CheckForUpgrade $false

Langganan default

Secara default, dimulai dengan modul Az PowerShell versi 12.0.0, jika Anda memiliki akses ke beberapa langganan, Anda diminta untuk memilih langganan Azure untuk masuk.

Untuk mencegah diminta untuk memilih langganan setiap kali Anda masuk secara interaktif, gunakan Update-AzConfig cmdlet dengan parameter DefaultSubscriptionForLogin untuk mengatur langganan default Anda, seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Catatan

Tidak bingung dengan langganan konteks default, konfigurasi DefaultSubscriptionForLogin hanya berlaku saat mengautentikasi ke Azure.

Penemuan instans

Pengaturan penemuan instans nonaktifkan dirancang untuk situasi di mana titik akhir metadata tidak dapat diakses, seperti di cloud privat atau lingkungan Azure Stack. Penemuan instans melibatkan pengambilan metadata otoritas dari https://login.microsoft.com/ untuk memvalidasi otoritas. Dengan mengaktifkan pengaturan ini (mengaturnya ke true), Anda menonaktifkan penemuan instans dan validasi otoritas. Oleh karena itu, penting untuk memastikan bahwa host otoritas yang dikonfigurasi valid dan dapat dipercaya.

Untuk menonaktifkan penemuan instans dan validasi otoritas, aktifkan pengaturan ini (atur ke true).

Update-AzConfig -DisableInstanceDiscovery $true

Melanggar mengubah pesan peringatan

Untuk menonaktifkan melanggar mengubah pesan peringatan untuk cmdlet di semua modul Az , gunakan Update-AzConfig cmdlet dengan DisplayBreakingChangeWarning parameter , seperti yang ditunjukkan dalam contoh berikut:

Update-AzConfig -DisplayBreakingChangeWarning $false

Untuk menonaktifkan pesan peringatan perubahan yang melanggar khusus untuk cmdlet dalam modul Az.Compute , gunakan Update-AzConfig cmdlet dengan parameter DisplayBreakingChangeWarning dan AppliesTo seperti yang ditunjukkan dalam contoh berikut:

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

Dalam skenario ini, pesan peringatan perubahan yang melanggar tetap aktif untuk cmdlet di semua modul Az PowerShell kecuali Az.Compute.

Identifikasi wilayah Azure

Pelanggan Azure dapat memilih untuk menyebarkan sumber daya di beberapa wilayah yang berbeda. Terkadang, pelanggan dapat mengurangi biaya dengan memilih wilayah terdekat yang menawarkan layanan yang sama. Jika wilayah terdekat diidentifikasi, pesan menampilkan wilayah yang akan dipilih untuk penyebaran di masa mendatang.

Untuk menonaktifkan pesan rekomendasi wilayah, gunakan Update-AzConfig cmdlet dengan parameter DisplayRegionIdentified , seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -DisplayRegionIdentified $false

Untuk informasi selengkapnya tentang wilayah Azure, lihat Memilih wilayah Azure yang tepat untuk Anda.

Tampilkan peringatan rahasia

Azure PowerShell menampilkan pesan peringatan secara default dimulai dengan versi 12.0.0 untuk membantu Anda melindungi informasi sensitif saat mengidentifikasi rahasia potensial dalam output perintah.

Dalam contoh berikut, Update-AzConfig cmdlet digunakan untuk menonaktifkan pesan peringatan.

Update-AzConfig -DisplaySecretsWarning $false

Survei

Saat menggunakan Azure PowerShell, Anda mungkin diundang untuk berpartisipasi dalam survei untuk memberi tahu kami tentang pengalaman Anda. Meskipun kami menghargai wawasan yang diberikan data ini, kami memahami bahwa tidak semua orang ingin diminta untuk menyelesaikan survei.

Anda dapat menonaktifkan diminta untuk berpartisipasi dalam survei dengan Update-AzConfig cmdlet, seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -DisplaySurveyMessage $false

Kumpulan data

Secara default, cmdlet Azure PowerShell mengirim data telemetri ke Microsoft untuk meningkatkan pengalaman pelanggan. Untuk informasi selengkapnya, lihat pernyataan privasi kami: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Rekaman kesalahan

Secara default, rekaman kesalahan Azure PowerShell ditulis ke $HOME/.Azure/ErrorRecords.

Untuk menonaktifkan rekaman kesalahan persisten, gunakan Update-AzConfig cmdlet dengan parameter EnableErrorRecordsPersistence , seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -EnableErrorRecordsPersistence $false

Pengelola Akun Web (WAM)

Dimulai dengan modul Az PowerShell versi 12.0.0, sistem Windows menggunakan Web Account Manager (WAM), dan sistem Linux dan macOS menggunakan masuk berbasis browser secara default.

Untuk menggunakan masuk berbasis browser pada Windows 10 dan yang lebih baru atau di Windows Server 2019 dan yang lebih baru dengan Az 12.0.0 dan yang lebih tinggi, Anda harus menonaktifkan WAM untuk digunakan dengan Azure PowerShell. Gunakan perintah berikut untuk menonaktifkan WAM dan kembali ke masuk berbasis browser, default sebelum Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Pengalaman masuk baru

Dimulai dengan modul Az PowerShell versi 12.0.0, jika Anda memiliki akses ke beberapa langganan, Anda diminta untuk memilih langganan Azure untuk masuk.

Saat pengalaman masuk baru dinonaktifkan, dan Anda memiliki akses ke beberapa langganan, Anda masuk ke langganan pertama yang dikembalikan Azure kecuali Anda menentukan langganan dengan Connect-AzAccount. Perintah berjalan terhadap langganan ini secara default. Perilaku ini bisa berbahaya, misalnya jika langganan pertama yang dikembalikan adalah lingkungan produksi.

Untuk menonaktifkan pengalaman masuk baru, gunakan Update-AzConfig cmdlet, seperti yang ditunjukkan dalam contoh berikut.

Update-AzConfig -LoginExperienceV2 Off

Mereplikasi pengaturan

Untuk mereplikasi pengaturan Anda dari satu lingkungan ke lingkungan lain, Anda menggunakan Export-AzConfig cmdlet untuk mengekspor pengaturan ke file JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Untuk mengimpor pengaturan Anda, gunakan Import-AzConfig cmdlet dan referensikan file JSON yang diekspor sebelumnya.

Import-AzConfig -Path $HOME\AzConfig.json

Mengosongkan konfigurasi

Untuk mengatur ulang pengaturan konfigurasi satu atau beberapa pengaturan global Azure PowerShell ke default, gunakan Clear-AzConfig cmdlet . Dalam contoh berikut, pengaturan DefaultSubscriptionForLogin dibersihkan.

Clear-AzConfig -DefaultSubscriptionForLogin