Share via

Mengonfigurasi pengaturan global Azure PowerShell

  • Artikel

Azure PowerShell mendukung beberapa pengaturan global seperti menonaktifkan melanggar pesan peringatan perubahan. Sebelum modul Az PowerShell versi 9, tidak ada cara terpusat atau terperinci untuk mengonfigurasi pengaturan global untuk Azure PowerShell.

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 hanya efektif dalam cakupan tertentu. Nilai yang valid untuk parameter Cakupan adalah:

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

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

Untuk menonaktifkan pesan peringatan perubahan pemutusan 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.

Langganan default

Secara default, saat Anda mengautentikasi ke Azure, semua langganan yang dapat Anda akses diambil. Langganan pertama yang dikembalikan oleh Azure digunakan kecuali Anda menentukan langganan dengan Connect-AzAccount. Perilaku ini bisa berbahaya, misalnya jika langganan pertama yang dikembalikan adalah lingkungan produksi.

Untuk mengonfigurasi langganan default, Anda menggunakan Update-AzConfig cmdlet dengan parameter DefaultSubscriptionForLogin 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.

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

Identifikasi wilayah Azure

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.

Menonaktifkan pesan rekomendasi wilayah

Dalam contoh berikut, Update-AzConfig cmdlet digunakan untuk menonaktifkan pesan rekomendasi wilayah:

Update-AzConfig -DisplayRegionIdentified $false

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

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