Clear-AzConfig

Menghapus nilai konfigurasi yang ditetapkan oleh pengguna.

Sintaks

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

Deskripsi

Menghapus nilai konfigurasi yang ditetapkan oleh pengguna. Secara default semua konfigurasi akan dihapus. Anda juga dapat menentukan kunci konfigurasi untuk dihapus.

Contoh

Contoh 1

Clear-AzConfig -Force

Hapus semua konfigurasi. -Force menekan permintaan untuk konfirmasi.

Contoh 2

Clear-AzConfig -EnableDataCollection

Hapus konfigurasi "EnableDataCollection".

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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayRegionIdentified

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySurveyMessage

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Jangan meminta konfirmasi saat menghapus semua konfigurasi.

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

-PassThru

Mengembalikan true jika cmdlet dijalankan dengan benar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

None

Output

Boolean