Clear-History (Microsoft.PowerShell.Core)

Clear-History

Modül:

Microsoft.PowerShell.Core

PowerShell oturumu komut geçmişindeki girişleri siler.

Sözdizimi

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Clear-History
     [[-Count] <int>]
     [-CommandLine <string[]>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Tanım

Clear-History, bir PowerShell oturumundan komut geçmişini siler. Her PowerShell oturumunun kendi komut geçmişi vardır. Komut geçmişini görüntülemek için Get-History cmdlet'ini kullanın.

Varsayılan olarak Clear-History, bir PowerShell oturumundaki komut geçmişinin tamamını siler. Seçilen komutları silmek için Clear-History ile parametreleri kullanabilirsiniz.

Clear-History, PSReadLine komut geçmişi dosyasını temizlemez. PSReadLine modülü, her PowerShell oturumundaki her PowerShell komutunu içeren bir geçmiş dosyasını saklar. PowerShell isteminden komut geçmişinde gezinmek için klavyenizdeki yukarı ve aşağı okları kullanın. Komut geçmişine ilişkin PSReadLine yapılandırmasını görüntülemek için Get-PSReadLineOption'u kullanın. PSReadLine, PowerShell 5.0 ve üzeri sürümlerle birlikte gönderilir. Daha fazla bilgi için bkz. about_PSReadLine.

Örnekler

Örnek 1: PowerShell oturumundan komut geçmişini silme

Bu komut, PowerShell oturumunun geçmişindeki tüm komutları siler.

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'i PowerShell oturumunun geçmişini görüntüler. Clear-History komut geçmişinin tamamını siler. Get-History güncellenmiş komut geçmişini görüntüler ve önceki geçmişin silindiğini doğrular.

Örnek 2: En yeni komutları silin

Bu komut, PowerShell oturumunun geçmişinden en yeni komutları silmek için Sayma ve En Yeni parametrelerini kullanır.

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'i PowerShell oturumunun geçmişini görüntüler. Clear-History komut geçmişini silmek için kullanılır. Count parametresi, belirtilen Id dahil olmak üzere silinecek komutların sayısını belirtir. En Yeni parametresi, en yeni komutların geçmişten temizlendiğini belirtir. Get-History güncellenmiş komut geçmişini görüntüler ve en yeni beş komutun, Id 6 - Id 10'un silindiğini doğrular.

Örnek 3: Belirli ölçütlerle eşleşen komutları silin

Bu komut, CommandLine parametresi tarafından tanımlanan belirli ölçütlerle eşleşen komutları siler.

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'i PowerShell oturumunun geçmişini görüntüler. Clear-History komut geçmişini siler. CommandLine parametresi, Yardım içeren veya Sözdizimi ile biten komutları belirtir. Get-History güncellenmiş komut geçmişini görüntüler ve Id 3, Id 5, Id 6 ve komutlarının geçerli olduğunu onaylar. Kimlik 7 silindi.

Örnek 4: Komutları Kimlik numarasına göre silin

Bu komut, Kimliği kullanarak belirli geçmiş öğelerini siler. Birden fazla komutu silmek için Kimlik numaralarından oluşan virgülle ayrılmış bir liste gönderin.

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'i PowerShell oturumunun geçmişini görüntüler. Clear-History komut geçmişini siler. Id parametresi hangi komutların silineceğini belirtir. Get-History güncellenmiş komut geçmişini görüntüler ve Id 3 ile Id 5'in silindiğini doğrular.

Örnek 5: Komutları kimlik numarasına ve sayıma göre silin

Bu komut, komut geçmişini silmek için Id ve Count parametrelerini kullanır. Komutlar, belirtilen Kimlik'ten en yeniden en eskiye doğru ters sırayla silinir.

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'i PowerShell oturumunun geçmişini görüntüler. Clear-History komut geçmişini siler. Id parametresi Id 7 ile başlayacağını belirtir. Count parametresi, belirtilen Id dahil olmak üzere beş komutun silineceğini belirtir. Get-History güncellenmiş komut geçmişini görüntüler ve beş komutun silindiğini doğrular, Id 3 - Id 7.

Parametreler

-CommandLine

PowerShell oturumundan komut geçmişini siler. Dize tam olarak eşleşmeli veya Get-History tarafından görüntülenen PowerShell oturum geçmişindeki komutlarla eşleşmesi için joker karakterler kullanılmalıdır. Birden fazla dize girerseniz Clear-History, dizelerden herhangi biriyle eşleşen komutları siler. CommandLine parametresi Count ile kullanılabilir.

Boşluk içeren dizeler için tek tırnak işaretleri kullanın. Daha fazla bilgi için bkz. about_Quoting_Rules.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Confirm

Clear-History cmdlet'ini çalıştırmadan önce sizden onay ister.

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Count

Clear-History'in sildiği geçmiş girişlerinin sayısını belirtir. Komutlar, tarihteki en eski girişten başlayarak sırayla silinir.

Count ve Id parametreleri birlikte kullanılabilir. Count parametresi, belirtilen Id dahil olmak üzere silinecek komutların sayısını belirtir. Belirtilen Kimlik'ten başlayarak komutlar ters sırayla silinir. Örneğin, Id 30 ve Count 10 ise, Clear-History 21'den 30'a kadar olan öğeleri siler.

Count ve CommandLine parametreleri birlikte kullanılabilir. Count, CommandLine parametre değeriyle eşleşen, silinecek komutların sayısını belirtir. Komutlar sırayla silinir.

Tip :

Int32

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Id

Clear-History'in sildiği komut geçmişi Kimliğini belirtir. Kimlik numaralarını görüntülemek için Get-History cmdlet'ini kullanın. Kimlik numaraları sıralıdır ve komutlar PowerShell oturumu boyunca Kimlik numaralarını korur. Id parametresi Count ve En Yeni ile birlikte kullanılabilir.

Tip :

Int32[]

Konum:

0

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Newest

En Yeni parametresi kullanıldığında, Clear-History geçmişteki en yeni girişleri siler. Varsayılan olarak, Clear-History geçmişteki en eski girişleri siler.

En Yeni parametresi Kimlik ve Sayma ile birlikte kullanılabilir. Count parametresi, belirtilen Id dahil olmak üzere silinecek komutların sayısını belirtir. Belirtilen Kimlik'ten başlayarak komutlar sırayla silinir. Örneğin, Id 30 ve Count 10 ise, Clear-History 30 ile 39 arasındaki öğeleri siler.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-WhatIf

Clear-History cmdlet'i çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

PowerShell, Clear-History için aşağıdaki takma adları içerir:

• Tüm platformlar:

  clhy

PowerShell oturum geçmişi, PowerShell oturumu sırasında girilen komutların bir listesidir. Geçmişi görüntüleyebilir, komut ekleyip silebilir ve geçmişten komutları çalıştırabilirsiniz. Daha fazla bilgi için bkz. about_History.

Oturum geçmişi, PSReadLine modülü tarafından tutulan geçmişten ayrı olarak yönetilir. Her iki geçmiş de PSReadLine'ın yüklendiği oturumlarda mevcuttur. Bu cmdlet yalnızca oturum geçmişiyle çalışır. Daha fazla bilgi için about_PSReadLine'a bakın.