Clear-History

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Elimina entradas del historial de comandos de sesión de PowerShell.

Syntax

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

Description

Clear-History elimina el historial de comandos de una sesión de PowerShell. Cada sesión de PowerShell tiene su propio historial de comandos. Para mostrar el historial de comandos, use el Get-History cmdlet .

De forma predeterminada, Clear-History elimina todo el historial de comandos de una sesión de PowerShell. Puede usar parámetros con Clear-History para eliminar comandos seleccionados.

Clear-History no borra el archivo de historial de PSReadLine comandos. El PSReadLine módulo almacena un archivo de historial que contiene todos los comandos de PowerShell de cada sesión de PowerShell. Desde un símbolo del sistema de PowerShell, use las flechas arriba y abajo del teclado para desplazarse por el historial de comandos. Para mostrar la PSReadLine configuración del historial de comandos, use Get-PSReadLineOption. PSReadLine se incluye con PowerShell 5.0 y versiones posteriores. Para más información, vea Acerca de PSReadLine.

Ejemplos

Ejemplo 1: Eliminación del historial de comandos de una sesión de PowerShell

Este comando elimina todos los comandos del historial de una sesión de 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

El Get-History cmdlet muestra el historial de la sesión de PowerShell. Clear-History elimina todo el historial de comandos. Get-History muestra el historial de comandos actualizado y confirma que se eliminó el historial anterior.

Ejemplo 2: Eliminación de los comandos más recientes

Este comando usa los parámetros Count y Newest para eliminar los comandos más recientes del historial de una sesión de 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

El Get-History cmdlet muestra el historial de la sesión de PowerShell. Clear-History se usa para eliminar el historial de comandos. El parámetro Count especifica el número de comandos que se van a eliminar, incluido el identificador especificado. El parámetro Más reciente especifica que los comandos más recientes se borran del historial. Get-Historymuestra el historial de comandos actualizado y confirma que se eliminaron los cinco comandos más recientes, Id. 6 - Id 10.

Ejemplo 3: Eliminación de comandos que coinciden con criterios específicos

Este comando elimina los comandos que coinciden con criterios específicos definidos por el parámetro 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

El Get-History cmdlet muestra el historial de la sesión de PowerShell. Clear-History elimina el historial de comandos. El parámetro CommandLine especifica comandos que contienen Ayuda o terminan con sintaxis. Get-History muestra el historial de comandos actualizado y confirma que se eliminaron los comandos Id 3, Id 5, Id 6 e Id 7 .

Ejemplo 4: Eliminar comandos por número de identificador

Este comando elimina elementos de historial específicos mediante el identificador. Para eliminar varios comandos, envíe una lista separada por comas de números de identificador .

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

El Get-History cmdlet muestra el historial de la sesión de PowerShell. Clear-History elimina el historial de comandos. El parámetro Id especifica qué comandos se van a eliminar. Get-History muestra el historial de comandos actualizado y confirma que se eliminaron el identificador 3 y el identificador 5 .

Ejemplo 5: Eliminación de comandos por número de identificador y recuento

Este comando usa los parámetros Id y Count para eliminar el historial de comandos. Los comandos se eliminan del identificador especificado en orden inverso, más reciente al más antiguo.

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

El Get-History cmdlet muestra el historial de la sesión de PowerShell. Clear-History elimina el historial de comandos. El parámetro Id especifica que comience con el identificador 7. El parámetro Count especifica eliminar cinco comandos, ambos incluidos en el identificador especificado. Get-History Muestra el historial de comandos actualizado y confirma que se eliminaron cinco comandos, Id. 3 - Id 7.

Parámetros

-CommandLine

Elimina el historial de comandos de una sesión de PowerShell. La cadena debe ser una coincidencia exacta o usar caracteres comodín para que coincidan con comandos en el historial de sesiones de PowerShell mostrado por Get-History. Si escribe más de una cadena, Clear-History elimina los comandos que coinciden con cualquiera de las cadenas. El parámetro CommandLine se puede usar con Count.

Para las cadenas con un espacio, use comillas simples. Para obtener más información, consulte about_Quoting_Rules.

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

-Confirm

Le pide confirmación antes de ejecutar el Clear-History cmdlet.

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

-Count

Especifica el número de entradas del historial que Clear-History elimina. Los comandos se eliminan en orden, empezando por la entrada más antigua del historial.

Los parámetros Count e Id se pueden usar juntos. El parámetro Count especifica el número de comandos que se van a eliminar, incluido el identificador especificado. A partir del identificador especificado, los comandos se eliminan en orden secuencial inverso. Por ejemplo, si el identificador es 30 y count es 10, Clear-History elimina los elementos de 21 a 30.

Los parámetros Count y CommandLine se pueden usar juntos. Count especifica el número de comandos que se van a eliminar que coincidan con el valor del parámetro CommandLine . Los comandos se eliminan en orden secuencial.

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

-Id

Especifica el identificador del historial de comandos que Clear-History elimina. Para mostrar los números de identificador , use el Get-History cmdlet . Los números de identificador son secuenciales y los comandos mantienen su número de identificador a lo largo de una sesión de PowerShell. El parámetro Id se puede usar con Count y Newest.

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

-Newest

Cuando se usa el parámetro Más reciente , Clear-History elimina las entradas más recientes del historial. De forma predeterminada, Clear-History elimina las entradas más antiguas del historial.

El parámetro Más reciente se puede usar con Id . y Count. El parámetro Count especifica el número de comandos que se van a eliminar, incluido el identificador especificado. A partir del identificador especificado, los comandos se eliminan en orden secuencial. Por ejemplo, si el identificador es 30 y count es 10, Clear-History elimina los elementos de 30 a 39.

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

-WhatIf

Muestra lo que sucedería si el Clear-History cmdlet se ejecuta. El cmdlet no se ejecuta.

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

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

PowerShell incluye los siguientes alias para Clear-History:

  • Todas las plataformas:
    • clhy

El historial de sesiones de PowerShell es una lista de los comandos especificados durante una sesión de PowerShell. Puede ver el historial, agregar y eliminar comandos, y ejecutar comandos desde el historial. Para obtener más información, consulte about_History.

El historial de sesiones se administra independientemente del historial mantenido por el módulo PSReadLine . Ambos historiales están disponibles en sesiones donde se carga PSReadLine . Este cmdlet solo funciona con el historial de sesiones. Para obtener más información, consulte about_PSReadLine.