Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 mencakup 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 sah 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 AppliesTo parameter, Anda dapat menentukan seberapa luas pengaturan tersebut 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 dapat Anda atur dengan cmdlet *-AzConfig.
Get-AzConfig | Format-List
Meningkatkan pemberitahuan
Pemberitahuan dalam alat untuk peningkatan versi Azure PowerShell adalah fitur yang dirilis di 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 cmdlet Update-AzConfig 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 bawaan
Secara default, dimulai dengan Az modul 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>
Note
Jangan keliru dengan berlangganan konteks default, konfigurasi DefaultSubscriptionForLogin berlaku hanya saat mengautentikasi ke Azure.
Penemuan Instansi
Pengaturan penonaktifan penemuan instans dirancang untuk situasi di mana endpoint metadata tidak dapat diakses, seperti dalam lingkungan cloud privat atau Azure Stack. Penemuan instance 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, hidupkan pengaturan ini (atur nilainya ke true).
Update-AzConfig -DisableInstanceDiscovery $true
Melanggar mengubah pesan peringatan
Untuk menonaktifkan pesan peringatan perubahan yang merusak untuk cmdlet di semua modul Az, gunakan cmdlet Update-AzConfig dengan parameter DisplayBreakingChangeWarning, seperti yang ditunjukkan dalam contoh berikut:
Update-AzConfig -DisplayBreakingChangeWarning $false
Untuk menonaktifkan pesan peringatan perubahan yang mengganggu kompatibilitas khusus untuk cmdlet dalam modul Az.Compute, gunakan cmdlet Update-AzConfig dengan parameter DisplayBreakingChangeWarning dan AppliesTo seperti yang ditunjukkan dalam contoh berikut:
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute
Dalam skenario ini, pesan peringatan perubahan kritis tetap aktif untuk cmdlet di semua modul Az PowerShell kecuali Az.Compute.
identifikasi wilayah Azure
Azure pelanggan 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
Pengumpulan 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 login berbasis browser di Windows 10 dan versi lebih baru atau di Server Windows 2019 dan versi lebih baru dengan Az 12.0.0 dan versi lebih tinggi, Anda harus menonaktifkan WAM untuk Azure PowerShell. Gunakan perintah berikut untuk menonaktifkan WAM dan kembali ke autentikasi masuk berbasis browser, yang merupakan pengaturan default sebelum Az 12.0.0.
Update-AzConfig -EnableLoginByWam $false
Pengalaman masuk baru
Dimulai dengan Az modul 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, kecuali Anda menentukan langganan dengan Connect-AzAccount, Anda akan masuk ke langganan pertama yang ditampilkan oleh Azure. Perintah dijalankan terhadap langganan ini secara bawaan. 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
Membersihkan konfigurasi
Untuk mengatur ulang pengaturan konfigurasi satu atau beberapa pengaturan global Azure PowerShell ke default, gunakan cmdlet Clear-AzConfig. Dalam contoh berikut, pengaturan DefaultSubscriptionForLogin dibersihkan.
Clear-AzConfig -DefaultSubscriptionForLogin
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Azure PowerShell