Update-AzConfig

Modul:

Az.Accounts Module

Memperbarui konfigurasi Azure PowerShell.

Sintaks

Default (Default)

Update-AzConfig
    [-AppliesTo <String>]
    [-Scope <ConfigScope>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-CheckForUpgrade <Boolean>]
    [-DefaultSubscriptionForLogin <String>]
    [-DisableInstanceDiscovery <Boolean>]
    [-DisplayBreakingChangeWarning <Boolean>]
    [-DisplayRegionIdentified <Boolean>]
    [-DisplaySecretsWarning <Boolean>]
    [-DisplaySurveyMessage <Boolean>]
    [-EnableDataCollection <Boolean>]
    [-EnableErrorRecordsPersistence <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.

Nota

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. Nilai yang mungkin 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".

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CheckForUpgrade

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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DefaultProfile

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

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DefaultSubscriptionForLogin

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DisplayRegionIdentified

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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DisplaySecretsWarning

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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DisplaySurveyMessage

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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-EnableErrorRecordsPersistence

Ketika diaktifkan, rekaman kesalahan akan ditulis ke ~/. Azure/ErrorRecords.

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LoginExperienceV2

Hanya aktif saat mengautentikasi secara interaktif, memungkinkan pengguna untuk memilih langganan dan penyewa yang digunakan dalam perintah berikutnya. Kemungkinan nilai iklan 'Aktif' (Default) dan 'Nonaktif'. 'Aktif' memerlukan input pengguna. 'Nonaktif' akan menggunakan penyewa dan langganan pertama yang dikembalikan oleh Azure, dapat berubah tanpa pemberitahuan dan mengarah ke eksekusi perintah dalam konteks yang tidak diinginkan (tidak disarankan).

Properti parameter

Jenis:	LoginExperienceConfig
Nilai default:	None
Nilai yang diterima:	On, Off
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	ConfigScope
Nilai default:	None
Nilai yang diterima:	CurrentUser, Process, Default, Environment
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

Boolean

String

Output

PSConfig