Clear-History

Menghapus entri dari riwayat perintah sesi PowerShell.

Sintaks

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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 Get-History cmdlet .

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 PSReadLine file riwayat perintah. 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 PSReadLine konfigurasi 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

Get-History Cmdlet 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 Hitung dan Terbaru 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

Get-History Cmdlet menampilkan riwayat sesi PowerShell. Clear-History digunakan untuk menghapus riwayat perintah. Parameter Hitung menentukan jumlah perintah yang akan dihapus, termasuk Id yang ditentukan. Parameter Terbaru menentukan bahwa perintah terbaru dihapus dari riwayat. Get-Historymenampilkan 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

Get-History Cmdlet menampilkan riwayat sesi PowerShell. Clear-History menghapus riwayat perintah. Parameter CommandLine menentukan perintah yang berisi Bantuan atau diakhir 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 nomor Id 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

Get-History Cmdlet 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 telah 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, terbaru ke terlama.

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

Get-History Cmdlet menampilkan riwayat sesi PowerShell. Clear-History menghapus riwayat perintah. Parameter Id menentukan untuk memulai dengan Id 7. Parameter Hitung menentukan untuk menghapus lima perintah, termasuk Id yang ditentukan. Get-History menampilkan riwayat perintah yang diperbarui dan mengonfirmasi bahwa lima perintah dihapus, Id 3 - Id 7.

Parameter

-CommandLine

Menghapus riwayat perintah dari sesi PowerShell. String harus sama persis atau menggunakan kartubebas 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 selengkapnya, lihat about_Quoting_Rules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Confirm

Meminta konfirmasi sebelum menjalankan Clear-History cmdlet.

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

-Count

Menentukan jumlah entri riwayat yang Clear-History dihapus. Perintah dihapus secara berurutan, dimulai dengan entri terlama dalam riwayat.

Parameter Count dan Id dapat digunakan bersama-sama. Parameter Hitung 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. Hitungan menentukan jumlah perintah yang akan dihapus yang cocok dengan nilai parameter CommandLine . Perintah dihapus dalam urutan berurutan.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Menentukan Id riwayat perintah yang Clear-History dihapus. Untuk menampilkan nomor Id , gunakan Get-History cmdlet. Nomor Id berurutan dan perintah menyimpan nomor Id mereka di seluruh sesi PowerShell. Parameter Id dapat digunakan dengan Count dan Newest.

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Hitung menentukan jumlah perintah yang akan dihapus, termasuk Id yang ditentukan. Dimulai pada Id yang ditentukan, perintah dihapus dalam urutan berurutan. Misalnya, jika Id adalah 30 dan Jumlah adalah 10, Clear-History menghapus item 30 hingga 39.

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

-WhatIf

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

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

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 about_History.

Riwayat sesi dikelola secara terpisah dari riwayat yang dikelola oleh modul PSReadLine . Kedua riwayat tersedia dalam sesi tempat PSReadLine dimuat. Cmdlet ini hanya berfungsi dengan riwayat sesi. Untuk informasi selengkapnya lihat, about_PSReadLine.