Update-AzConfig

Memperbarui konfigurasi Azure PowerShell.

Sintaks

Update-AzConfig
      [-AppliesTo <String>]
      [-Scope <ConfigScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-CheckForUpgrade <Boolean>]
      [-DefaultSubscriptionForLogin <String>]
      [-DisableErrorRecordsPersistence <Boolean>]
      [-DisableInstanceDiscovery <Boolean>]
      [-DisplayBreakingChangeWarning <Boolean>]
      [-DisplayRegionIdentified <Boolean>]
      [-DisplaySurveyMessage <Boolean>]
      [-EnableDataCollection <Boolean>]
      [-EnableLoginByWam <Boolean>]
      [<CommonParameters>]

Deskripsi

Memperbarui konfigurasi Azure PowerShell. Bergantung pada konfigurasi mana yang akan diperbarui, Anda dapat menentukan cakupan tempat konfigurasi dipertahankan dan modul atau cmdlet mana yang diterapkannya.

Catatan

Disarankan untuk memperbarui konfigurasi dalam beberapa proses PowerShell. Lakukan dalam satu proses, atau pastikan pembaruan berada di cakupan Proses (-Scope Process) untuk menghindari efek samping yang tidak terduga.

Contoh

Contoh 1

Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"

Key                         Value                Applies To Scope       Help Message
---                         -----                ---------- -----       ------------
DefaultSubscriptionForLogin Name of subscription Az         CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…

Mengatur konfigurasi "DefaultSubscriptionForLogin" sebagai "Nama langganan". Ketika Connect-AzAccount langganan yang ditentukan akan dipilih sebagai langganan default.

Contoh 2

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"

Key                          Value Applies To  Scope       Help Message
---                          ----- ----------  -----       ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…

Mengatur konfigurasi "DisplayBreakingChangeWarnings" sebagai "$false" untuk modul "Az.KeyVault". Ini mencegah semua pesan peringatan untuk perubahan mencolok yang akan datang dalam modul Az.KeyVault diminta.

Contoh 3

Update-AzConfig -EnableDataCollection $true

Key                  Value Applies To Scope       Help Message
---                  ----- ---------- -----       ------------
EnableDataCollection True  Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the customer experi…

Mengatur konfigurasi "EnableDataCollection" sebagai "$true". Ini memungkinkan pengiriman data telemetri. Pengaturan konfigurasi ini setara dengan Enable-AzDataCollection dan Disable-AzDataCollection.

Contoh 4

Update-AzConfig -DisplaySecretsWarning $true

Key                   Value Applies To Scope       Help Message
---                   ----- ---------- -----       ------------
DisplaySecretsWarning True  Az         CurrentUser When enabled, a warning message for secrets redaction will be displ…

Mengatur konfigurasi "DisplaySecretsWarning" sebagai "$true". Ini memungkinkan deteksi rahasia selama eksekusi cmdlet dan menampilkan pesan peringatan jika ada rahasia yang ditemukan dalam output.

Parameter

-AppliesTo

Menentukan bagian mana dari Azure PowerShell yang diterapkan konfigurasi. Kemungkinan nilai adalah:

  • "Az": konfigurasi berlaku untuk semua modul dan cmdlet Azure PowerShell.
  • Nama modul: konfigurasi berlaku untuk modul Azure PowerShell tertentu. Misalnya, "Az.Storage".
  • Nama cmdlet: konfigurasi berlaku untuk cmdlet tertentu dari Azure PowerShell. Misalnya, "Get-AzKeyVault". Jika tidak ditentukan, saat mendapatkan atau menghapus konfigurasi, konfigurasi default ke semua di atas; saat memperbarui, defaultnya adalah "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

Saat diaktifkan, Azure PowerShell akan memeriksa pembaruan secara otomatis dan menampilkan pesan petunjuk saat pembaruan tersedia. Nilai defaultnya adalah true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSubscriptionForLogin

Nama langganan atau GUID. Mengatur konteks default untuk Azure PowerShell saat masuk tanpa menentukan langganan.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableErrorRecordsPersistence

Ketika dinonaktifkan, rekaman kesalahan tidak akan ditulis ke ~/. Azure/ErrorRecords. Konfigurasi ini akan digantikan oleh "EnableErrorRecordsPersistence" sebagai keikutsertaan dalam rilis utama Az berikutnya sekitar November 2023.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableInstanceDiscovery

Atur ke true untuk menonaktifkan penemuan instans dan validasi otoritas. Fungsionalitas ini ditujukan untuk digunakan dalam skenario di mana titik akhir metadata tidak dapat dicapai, seperti di cloud privat atau Azure Stack. Proses penemuan instans memerlukan pengambilan metadata otoritas dari https://login.microsoft.com/ untuk memvalidasi otoritas. Dengan mengatur ini ke true, validasi otoritas dinonaktifkan. Akibatnya, sangat penting untuk memastikan bahwa host otoritas yang dikonfigurasi valid dan dapat dipercaya.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayBreakingChangeWarning

Kontrol jika pesan peringatan untuk melanggar perubahan ditampilkan atau disembunyikan. Saat diaktifkan, peringatan perubahan yang melanggar ditampilkan saat menjalankan cmdlet dengan perubahan yang melanggar dalam rilis mendatang.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayRegionIdentified

Saat diaktifkan, Azure PowerShell menampilkan rekomendasi di wilayah yang dapat mengurangi biaya Anda.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplaySecretsWarning

Saat diaktifkan, pesan peringatan akan ditampilkan ketika output cmdlet berisi rahasia. Pelajari lebih lanjut di https://go.microsoft.com/fwlink/?linkid=2258844

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplaySurveyMessage

Saat diaktifkan, Anda jarang diminta untuk berpartisipasi dalam survei pengalaman pengguna untuk Azure PowerShell.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EnableDataCollection

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EnableLoginByWam

[Pratinjau] Ketika diaktifkan, Web Account Manager (WAM) akan menjadi pengalaman masuk interaktif default. Ini akan kembali menggunakan browser jika platform tidak mendukung WAM. Perhatikan bahwa fitur ini sedang dalam pratinjau. Akun Microsoft (MSA) saat ini tidak didukung. Jangan ragu untuk menghubungi tim Azure PowerShell jika Anda memiliki umpan balik: https://aka.ms/azpsissue

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Menentukan cakupan perubahan konfigurasi, misalnya, apakah perubahan hanya berlaku untuk proses saat ini, atau untuk semua sesi yang dimulai oleh pengguna ini. Secara default, ini adalah CurrentUser.

Type:ConfigScope
Accepted values:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Boolean

String

Output

PSConfig