Condividi tramite

Clear-History

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Elimina le voci dalla cronologia dei comandi di PowerShell.

Sintassi

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

Descrizione

Clear-History elimina la cronologia dei comandi da una sessione di PowerShell. Ogni sessione di PowerShell ha la propria cronologia dei comandi. Per visualizzare la cronologia dei comandi, usare il Get-History cmdlet.

Per impostazione predefinita, Clear-History elimina l'intera cronologia dei comandi da una sessione di PowerShell. È possibile usare i parametri con Clear-History per eliminare i comandi selezionati.

Clear-History non cancella il file della cronologia dei PSReadLine comandi. Il PSReadLine modulo archivia un file di cronologia contenente ogni comando di PowerShell da ogni sessione di PowerShell. Da un prompt di PowerShell usare le frecce su e giù sulla tastiera per scorrere la cronologia dei comandi. Per visualizzare la configurazione per la PSReadLine cronologia dei comandi, usare Get-PSReadLineOption. PSReadLine fornito con PowerShell 5.0 e versioni successive. Per altre informazioni, vedere PSReadLine e about_PSReadLine.

Esempio

Esempio 1: Eliminare la cronologia dei comandi da una sessione di PowerShell

Questo comando elimina tutti i comandi dalla cronologia di una sessione di PowerShell.

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

PS> Clear-History

PS> Get-History

  Id CommandLine
  -- -----------
   5 Clear-History

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina l'intera cronologia dei comandi. Get-History visualizza la cronologia dei comandi aggiornata e conferma che la cronologia precedente è stata eliminata.

Esempio 2: Eliminare i comandi più recenti

Questo comando usa i parametri Count e Newest per eliminare i comandi più recenti dalla cronologia di una sessione di PowerShell.

PS> 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

PS> Clear-History -Count 5 -Newest

PS> 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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History viene usato per eliminare la cronologia dei comandi. Il parametro Count specifica il numero di comandi da eliminare, incluso l'ID specificato. Il parametro Più recente specifica che i comandi più recenti vengono cancellati dalla cronologia. Get-History visualizza la cronologia dei comandi aggiornata e conferma che i cinque comandi più recenti sono stati eliminati, ID 6 - ID 10.

Esempio 3: Eliminare i comandi che corrispondono a criteri specifici

Questo comando elimina i comandi che corrispondono a criteri specifici definiti dal parametro CommandLine .

PS C:\Test> 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

PS> Clear-History -CommandLine *Help*, *Syntax

PS> 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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina la cronologia dei comandi. Il parametro CommandLine specifica i comandi che contengono Guida o fine con sintassi. Get-History visualizza la cronologia dei comandi aggiornata e conferma che i comandi ID 3, ID 5, ID 6 e ID 7 sono stati eliminati.

Esempio 4: Eliminare i comandi in base al numero ID

Questo comando elimina elementi di cronologia specifici usando l'ID. Per eliminare più comandi, inviare un elenco delimitato da virgole di numeri ID .

PS> 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

PS C:\> Clear-History -Id 3, 5

PS> 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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina la cronologia dei comandi. Il parametro ID specifica quali comandi eliminare. Get-History visualizza la cronologia dei comandi aggiornata e conferma che l'ID 3 e l'ID 5 sono stati eliminati.

Esempio 5: Eliminare i comandi in base al numero id e al conteggio

Questo comando usa i parametri Id e Count per eliminare la cronologia dei comandi. I comandi vengono eliminati dall'ID specificato nell'ordine inverso, più recente a meno recente.

PS> 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

PS> Clear-History -Id 7 -Count 5

PS> 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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina la cronologia dei comandi. Il parametro ID specifica per iniziare con ID 7. Il parametro Count specifica per eliminare cinque comandi, inclusi l'ID specificato. Get-History visualizza la cronologia dei comandi aggiornata e conferma che cinque comandi sono stati eliminati, ID 3 - ID 7.

Parametri

-CommandLine

Elimina la cronologia dei comandi da una sessione di PowerShell. La stringa deve essere una corrispondenza esatta o usare caratteri jolly per corrispondere ai comandi nella cronologia delle sessioni di PowerShell visualizzata da Get-History. Se si immette più stringhe, Clear-History elimina i comandi che corrispondono a una delle stringhe. Il parametro CommandLine può essere usato con Count.

Per le stringhe con uno spazio, usare virgolette singole. Per altre informazioni, vedere about_Quoting_Rules.

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

-Confirm

Richiede la conferma prima di eseguire il Clear-History cmdlet.

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

-Count

Specifica il numero di voci di cronologia eliminate Clear-History . I comandi vengono eliminati in ordine, a partire dalla voce meno recente della cronologia.

I parametri Count e ID possono essere usati insieme. Il parametro Count specifica il numero di comandi da eliminare, incluso l'ID specificato. A partire dall'ID specificato, i comandi vengono eliminati in ordine sequenziale inverso. Ad esempio, se l'ID è 30 e il conteggio è 10, Clear-History elimina gli elementi da 21 a 30.

I parametri Count e CommandLine possono essere usati insieme. Count specifica il numero di comandi da eliminare che corrispondono al valore del parametro CommandLine . I comandi vengono eliminati in ordine sequenziale.

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

-Id

Specifica l'ID della cronologia dei comandi che Clear-History elimina. Per visualizzare i numeri ID , usare il Get-History cmdlet. I numeri ID sono sequenziali e i comandi mantengono il numero ID in una sessione di PowerShell. Il parametro ID può essere usato con Count e Newest.

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

-Newest

Quando viene usato il parametro Più recente , Clear-History elimina le voci più recenti nella cronologia. Per impostazione predefinita, Clear-History elimina le voci meno recenti nella cronologia.

Il parametro Più recente può essere usato con ID e Count. Il parametro Count specifica il numero di comandi da eliminare, incluso l'ID specificato. A partire dall'ID specificato, i comandi vengono eliminati in ordine sequenziale. Ad esempio, se l'ID è 30 e il conteggio è 10, Clear-History elimina gli elementi da 30 a 39.

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

-WhatIf

Mostra cosa succede se il Clear-History cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

Input

None

Non è possibile eseguire la pipe degli oggetti in Clear-History.

Output

None

Clear-History non genera alcun output.

Note

La cronologia delle sessioni di PowerShell è un elenco dei comandi immessi durante una sessione di PowerShell. È possibile visualizzare la cronologia, aggiungere ed eliminare comandi ed eseguire comandi dalla cronologia. Per altre informazioni, vedere about_History.