Bagikan melalui


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]
     [-DisableInstanceDiscovery]
     [-DisplayBreakingChangeWarning]
     [-DisplayRegionIdentified]
     [-DisplaySecretsWarning]
     [-DisplaySurveyMessage]
     [-EnableDataCollection]
     [-EnableErrorRecordsPersistence]
     [-EnableLoginByWam]
     [-LoginExperienceV2]
     [<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".
Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CheckForUpgrade

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultSubscriptionForLogin

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplayRegionIdentified

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplaySecretsWarning

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplaySurveyMessage

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EnableErrorRecordsPersistence

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

Jangan meminta konfirmasi saat menghapus semua konfigurasi.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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).

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PassThru

Mengembalikan true jika cmdlet dijalankan dengan benar.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:ConfigScope
Nilai yang diterima:CurrentUser, Process, Default, Environment
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

None

Output

Boolean