Clear-History
Menghapus entri dari riwayat perintah sesi PowerShell.
Sintaks
IDParameter (Default)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
Clear-History
[[-Count] <int>]
[-CommandLine <string[]>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Clear-History menghapus riwayat perintah dari sesi PowerShell. Setiap sesi PowerShell memiliki riwayat perintahnya sendiri. Untuk menampilkan riwayat perintah, gunakan cmdlet Get-History.
Secara default, Clear-History menghapus seluruh riwayat perintah dari sesi PowerShell. Anda dapat menggunakan parameter dengan Clear-History untuk menghapus perintah yang dipilih.
Clear-History tidak menghapus file riwayat perintah PSReadLine. Modul PSReadLine menyimpan file riwayat yang berisi setiap perintah PowerShell dari setiap sesi PowerShell. Dari perintah PowerShell, gunakan panah atas dan bawah pada keyboard Anda untuk menggulir riwayat perintah. Untuk menampilkan konfigurasi PSReadLine untuk riwayat perintah, gunakan Get-PSReadLineOption.
PSReadLine dikirim dengan PowerShell 5.0 ke atas. Untuk informasi selengkapnya, lihat about_PSReadLine.
Contoh
Contoh 1: Menghapus riwayat perintah dari sesi PowerShell
Perintah ini menghapus semua perintah dari riwayat sesi PowerShell.
Get-History
Id CommandLine
-- -----------
1 Set-Location .\Test
2 Update-Help
3 Set-Location C:\Test\Logs
4 Get-Location
Clear-History
Get-History
Id CommandLine
-- -----------
5 Clear-History
Cmdlet Get-History menampilkan riwayat sesi PowerShell.
Clear-History menghapus seluruh riwayat perintah.
Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi riwayat sebelumnya telah dihapus.
Contoh 2: Menghapus perintah terbaru
Perintah ini menggunakan parameter Count dan Newest untuk menghapus perintah terbaru dari riwayat sesi PowerShell.
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
3 Get-Command Clear-History -Syntax
4 Get-Command Clear-History -ShowCommandInfo
5 Get-Help Get-Alias
6 Get-Command Get-ChildItem -Syntax
7 Get-Help Clear-History
8 Set-Location C:\Test\Logs
9 Get-Help Get-Variable
10 Get-Help Get-ChildItem
Clear-History -Count 5 -Newest
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
3 Get-Command Clear-History -Syntax
4 Get-Command Clear-History -ShowCommandInfo
5 Get-Help Get-Alias
11 Clear-History -Count 5 -Newest
Cmdlet Get-History menampilkan riwayat sesi PowerShell.
Clear-History digunakan untuk menghapus riwayat perintah. Parameter Hitungan menentukan jumlah perintah yang akan dihapus, termasuk Id yang ditentukan. Parameter Terbaru menentukan bahwa perintah terbaru dihapus dari riwayat.
Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi bahwa lima perintah terbaru dihapus, Id 6 - Id 10.
Contoh 3: Menghapus perintah yang cocok dengan kriteria tertentu
Perintah ini menghapus perintah yang cocok dengan kriteria tertentu yang ditentukan oleh parameter CommandLine.
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
3 Get-Command Clear-History -Syntax
4 Get-Command Clear-History -ShowCommandInfo
5 Get-Help Get-Alias
6 Get-Command Get-ChildItem -Syntax
7 Get-Help Clear-History
Clear-History -CommandLine *Help*, *Syntax
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
4 Get-Command Clear-History -ShowCommandInfo
8 Clear-History -CommandLine *Help*, *Syntax
Cmdlet Get-History menampilkan riwayat sesi PowerShell.
Clear-History menghapus riwayat perintah. Parameter CommandLine menentukan perintah yang berisi Bantuan atau berakhir dengan Sintaks.
Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi bahwa perintah Id 3, Id 5, Id 6, dan Id 7 dihapus.
Contoh 4: Hapus perintah menurut nomor Id
Perintah ini menghapus item riwayat tertentu menggunakan Id . Untuk menghapus beberapa perintah, kirimkan daftar id angka yang dipisahkan koma.
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-History
3 Get-Help Get-Alias
4 Get-Command Clear-History
5 Get-Command Clear-History -Syntax
6 Get-Command Clear-History -ShowCommandInfo
Clear-History -Id 3, 5
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-History
4 Get-Command Clear-History
6 Get-Command Clear-History -ShowCommandInfo
7 Get-History
8 Clear-History -Id 3, 5
Cmdlet Get-History menampilkan riwayat sesi PowerShell.
Clear-History menghapus riwayat perintah. Parameter Id menentukan perintah mana yang akan dihapus.
Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi bahwa Id 3 dan Id 5 dihapus.
Contoh 5: Hapus perintah menurut nomor dan jumlah Id
Perintah ini menggunakan parameter Id dan Count untuk menghapus riwayat perintah. Perintah dihapus dari Id yang ditentukan dalam urutan terbalik, dari yang terbaru ke yang terdahulu.
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
3 Get-Command Clear-History -Syntax
4 Get-Command Clear-History -ShowCommandInfo
5 Get-Help Get-Alias
6 Get-Command Get-ChildItem -Syntax
7 Get-Help Clear-History
8 Set-Location C:\Test\Logs
9 Get-Help Get-Variable
10 Get-Help Get-ChildItem
Clear-History -Id 7 -Count 5
Get-History
Id CommandLine
-- -----------
1 Set-Location C:\Test\
2 Get-Command Clear-History
8 Set-Location C:\Test\Logs
9 Get-Help Get-Variable
10 Get-Help Get-ChildItem
11 Clear-History -Id 7 -Count 5
Cmdlet Get-History menampilkan riwayat sesi PowerShell.
Clear-History menghapus riwayat perintah. Parameter Id menentukan untuk dimulai dengan Id 7. Parameter Hitungan menjelaskan untuk menghapus lima perintah, termasuk Id yang ditentukan. Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi bahwa lima perintah telah dihapus, termasuk Id 3 - dan Id 7.
Parameter
-CommandLine
Menghapus riwayat perintah dari sesi PowerShell. String harus sama persis atau menggunakan wildcard untuk mencocokkan perintah dalam riwayat sesi PowerShell yang ditampilkan oleh Get-History. Jika Anda memasukkan lebih dari satu string, Clear-History menghapus perintah yang cocok dengan salah satu string. Parameter CommandLine dapat digunakan dengan Count.
Untuk string dengan spasi, gunakan kutipan tunggal. Untuk informasi lebih lanjut, lihat about_Quoting_Rules.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
CommandLineParameter
| 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 Clear-History.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| 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 |
-Count
Menentukan jumlah entri riwayat yang Clear-History hapus. Perintah dihapus secara berurutan, dimulai dengan entri terlama dalam riwayat.
Parameter Count dan Id dapat digunakan bersama-sama. Parameter Hitungan menentukan jumlah perintah yang akan dihapus, termasuk id yang ditentukan. Dimulai pada id yang ditentukan, perintah dihapus dalam urutan berurutan terbalik. Misalnya, jika Id adalah 30 dan Jumlah adalah 10, Clear-History menghapus item 21 hingga 30.
Parameter Count dan CommandLine dapat digunakan bersama-sama. Count menentukan jumlah perintah yang akan dihapus yang cocok dengan nilai parameter CommandLine. Perintah dihapus dalam urutan berurutan.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Id
Menentukan riwayat perintah Id yang Clear-History hapus. Untuk menampilkan nomor Id, gunakan cmdlet Get-History. Nomor Id berurutan dan perintah menyimpan nomor Id mereka di seluruh sesi PowerShell. Parameter Id dapat digunakan dengan Count dan Newest.
Properti parameter
| Jenis: | Int32[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
IDParameter
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Newest
Saat parameter terbaru digunakan, Clear-History menghapus entri terbaru dalam riwayat. Secara default, Clear-History menghapus entri terlama dalam riwayat.
Parameter terbaru dapat digunakan dengan Id dan Count. Parameter Hitungan menentukan jumlah perintah yang akan dihapus, termasuk Id yang ditentukan. Dimulai pada Id yang ditentukan, perintah dihapus dalam urutan berturut-turut. Misalnya, jika Id adalah 30 dan Count adalah 10, Clear-History menghapus item 30 hingga 39.
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 |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet Clear-History berjalan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| 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
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
PowerShell menyertakan alias berikut untuk Clear-History:
- Semua platform:
clhy
Riwayat sesi PowerShell adalah daftar perintah yang dimasukkan selama sesi PowerShell. Anda dapat melihat riwayat, menambahkan dan menghapus perintah, dan menjalankan perintah dari riwayat. Untuk informasi selengkapnya, lihat tentang_Sejarah.
Riwayat sesi dikelola secara terpisah dari riwayat yang dikelola oleh modul PSReadLine
