Clear-History

  • Referencia
Modul:
Microsoft.PowerShell.Core

Bejegyzéseket töröl a PowerShell-munkamenet parancselőzményeiből.

Syntax

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

Description

Clear-History törli a parancselőzményeket egy PowerShell-munkamenetből. Minden PowerShell-munkamenetnek saját parancselőzményei vannak. A parancselőzmények megjelenítéséhez használja a Get-History parancsmagot.

Alapértelmezés szerint Clear-History törli a teljes parancselőzményt egy PowerShell-munkamenetből. A paraméterekkel Clear-History törölheti a kijelölt parancsokat.

Clear-History nem törli a PSReadLine parancselőzményfájlt. A PSReadLine modul minden PowerShell-munkamenet minden PowerShell-parancsát tartalmazó előzményfájlt tárol. A PowerShell-parancssorban a billentyűzet fel- és le nyílbillentyűivel görgetheti végig a parancselőzményeket. A parancselőzmények konfigurációjának megjelenítéséhez használja Get-PSReadLineOptiona PSReadLine következőt: . PSReadLine PowerShell 5.0-s vagy újabb verzióval. További információ: about_PSReadLine.

Példák

1. példa: Parancselőzmények törlése Egy PowerShell-munkamenetből

Ez a parancs törli az összes parancsot egy PowerShell-munkamenet előzményeiből.

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

A Get-History parancsmag megjeleníti a PowerShell-munkamenet előzményeit. Clear-History törli a teljes parancselőzményt. Get-History megjeleníti a frissített parancselőzményeket, és megerősíti a korábbi előzmények törlését.

2. példa: A legújabb parancsok törlése

Ez a parancs a Darabszám és a Legújabb paraméterek használatával törli a legújabb parancsokat egy PowerShell-munkamenet előzményeiből.

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

A Get-History parancsmag megjeleníti a PowerShell-munkamenet előzményeit. Clear-History parancselőzmények törlésére szolgál. A Count paraméter a törölni kívánt parancsok számát adja meg, a megadott azonosítót is beleértve. A Legújabb paraméter azt adja meg, hogy a legújabb parancsok törlődnek az előzményekből. Get-Historymegjeleníti a frissített parancselőzményeket, és megerősíti, hogy az öt legújabb parancs törölve lett, id 6 - Id 10.

3. példa: Adott feltételeknek megfelelő parancsok törlése

Ez a parancs törli a CommandLine paraméter által meghatározott feltételeknek megfelelő parancsokat.

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

A Get-History parancsmag megjeleníti a PowerShell-munkamenet előzményeit. Clear-History törli a parancselőzményeket. A CommandLine paraméter olyan parancsokat határoz meg, amelyek szintaxissal végződnek vagy súgóttartalmaznak. Get-Historymegjeleníti a frissített parancselőzményeket, és megerősíti, hogy törölték a 3- és 5-ös, 6-os és 7-ös azonosítójú parancsokat.

4. példa: Parancsok törlése azonosítószám alapján

Ez a parancs bizonyos előzményeket töröl az azonosító használatával. Több parancs törléséhez küldje el az azonosítószámok vesszővel tagolt listáját.

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

A Get-History parancsmag megjeleníti a PowerShell-munkamenet előzményeit. Clear-History törli a parancselőzményeket. Az Azonosító paraméter megadja, hogy mely parancsokat kell törölni. Get-History megjeleníti a frissített parancselőzményeket, és megerősíti, hogy a 3 . és az 5 . azonosító törölve lett.

5. példa: Parancsok törlése azonosítószám és darabszám szerint

Ez a parancs az Id és a Count paraméterekkel törli a parancselőzményeket. A parancsok fordított sorrendben törlődnek a megadott azonosítóból , a legújabbtól a legrégebbiig.

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

A Get-History parancsmag megjeleníti a PowerShell-munkamenet előzményeit. Clear-History törli a parancselőzményeket. Az Azonosító paraméter a 7- azonosítóval kezdődik. A Count paraméter öt parancs törlését adja meg, a megadott azonosítót is beleértve. Get-History Megjeleníti a frissített parancselőzményeket, és megerősíti, hogy öt parancs törölve lett, 3-os - azonosító: 7.

Paraméterek

-CommandLine

Törli a parancselőzményeket egy PowerShell-munkamenetből. A sztringnek pontos egyezésnek kell lennie, vagy helyettesítő karakterek használatával kell egyeznie a PowerShell-munkamenetek előzményeiben szereplő Get-Historyparancsokkal. Ha egynél több sztringet ad meg, Clear-History a sztringek bármelyikének megfelelő parancsokat törli. A CommandLine paraméter a Count paraméterrel használható.

Szóközzel rendelkező sztringek esetén használjon egyetlen idézőjelet. További információ: about_Quoting_Rules.

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

-Confirm

Megerősítést kér a Clear-History parancsmag futtatása előtt.

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

-Count

A törölt előzménybejegyzések Clear-History számát adja meg. A parancsok sorrendben törlődnek, kezdve az előzmények legrégebbi bejegyzésével.

A Darabszám és az Azonosító paraméterek együtt használhatók. A Count paraméter a törölni kívánt parancsok számát adja meg, a megadott azonosítót is beleértve. A megadott azonosítótól kezdve a parancsok fordított sorrendben törlődnek. Ha például az azonosító 30, a darabszám pedig 10, Clear-History akkor törli a 21–30. elemet.

A Count és a CommandLine paraméterek együtt használhatók. A Count a CommandLine paraméterértéknek megfelelő törlési parancsok számát adja meg. A parancsok egymást követő sorrendben törlődnek.

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

-Id

Megadja a törölni kívánt Clear-History parancselőzmény-azonosítót. Az azonosítószámok megjelenítéséhez használja a Get-History parancsmagot. Az azonosítószámok szekvenciálisak, és a parancsok megtartják az azonosítójukat egy PowerShell-munkamenetben. Az Azonosító paraméter a Darabszám és a Legújabb paraméterrel használható.

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

A Legújabb paraméter használata Clear-History esetén törli az előzmények legújabb bejegyzéseit. Alapértelmezés szerint Clear-History törli az előzmények legrégebbi bejegyzéseit.

A Legújabb paraméter azonosítóval és darabszámmal használható. A Count paraméter a törölni kívánt parancsok számát adja meg, a megadott azonosítót is beleértve. A megadott azonosítótól kezdve a parancsok egymást követő sorrendben törlődnek. Ha például az azonosító 30, a darabszám pedig 10, Clear-History akkor törli a 30–39. elemet.

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

-WhatIf

Megjeleníti, mi történne, ha a Clear-History parancsmag futna. A parancsmag nem fut.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A Windows PowerShell a következő aliasokat Clear-Historytartalmazza:

  • clhy

A PowerShell-munkamenetek előzményei a PowerShell-munkamenetek során megadott parancsok listája. Megtekintheti az előzményeket, hozzáadhat és törölhet parancsokat, és futtathat parancsokat az előzményekből. További információ: about_History.

A munkamenet-előzményeket a PSReadLine modul által fenntartott előzményektől elkülönítve kezeli a rendszer. Mindkét előzmények olyan munkamenetekben érhetők el, ahol a PSReadLine betöltődik. Ez a parancsmag csak a munkamenet-előzményekkel működik. További információ: about_PSReadLine.