Clear-History

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Elimina le voci dalla cronologia dei comandi della sessione 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 una 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 che contiene 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 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.

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

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.

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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History viene usato per eliminare la cronologia dei comandi. Il parametro Count consente di specificare il numero di comandi da eliminare, inclusi 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 soddisfano criteri specifici

Questo comando elimina i comandi che soddisfano criteri specifici definiti dal parametro 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

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 La Guida o terminano 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.

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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina la cronologia dei comandi. Il parametro Id specifica i comandi da 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 in ordine inverso, più recente a meno recente.

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

Il Get-History cmdlet visualizza la cronologia della sessione di PowerShell. Clear-History elimina la cronologia dei comandi. Il parametro Id specifica di iniziare con ID 7. Il parametro Count specifica di 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 trovare le corrispondenze con i comandi nella cronologia delle sessioni di PowerShell visualizzata da Get-History. Se si immettono più stringhe, Clear-History elimina i comandi che corrispondono a una qualsiasi 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 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 che Clear-History vengono eliminate. I comandi vengono eliminati in ordine, a partire dalla voce meno recente nella cronologia.

I parametri Count e Id possono essere usati insieme. Il parametro Count consente di specificare il numero di comandi da eliminare, inclusi l'ID specificato. A partire dall'ID specificato, i comandi vengono eliminati in ordine sequenziale inverso. Ad esempio, se l'ID è 30 e count è 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:Int32
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:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

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

Il parametro Newest può essere usato con ID e Count. Il parametro Count consente di specificare il numero di comandi da eliminare, inclusi l'ID specificato. A partire dall'ID specificato, i comandi vengono eliminati in ordine sequenziale. Ad esempio, se l'ID è 30 e count è 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 accadrebbe 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 inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

PowerShell include gli alias seguenti per Clear-History:

  • Tutte le piattaforme:
    • clhy

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.

La cronologia delle sessioni viene gestita separatamente dalla cronologia gestita dal modulo PSReadLine . Entrambe le cronologie sono disponibili nelle sessioni in cui viene caricato PSReadLine . Questo cmdlet funziona solo con la cronologia delle sessioni. Per altre informazioni, vedere about_PSReadLine.