Clear-AzConfig

Menghapus nilai konfigurasi yang ditetapkan oleh pengguna.

Sintaks

ClearAll (Default)

Clear-AzConfig
    [-Force]
    [-PassThru]
    [-AppliesTo <String>]
    [-Scope <ConfigScope>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClearByKey

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. 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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-DisplayRegionIdentified

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

Properti parameter

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

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-DisplaySurveyMessage

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

Properti parameter

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

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-EnableErrorRecordsPersistence

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

Properti parameter

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

Kumpulan parameter

ClearByKey
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-Force

Jangan meminta konfirmasi saat menghapus semua konfigurasi.

Properti parameter

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

Kumpulan parameter

ClearAll
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
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:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-PassThru

Mengembalikan true jika cmdlet dijalankan dengan benar.

Properti parameter

Jenis:SwitchParameter
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

-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

None

Output

Boolean