Compartir a través de

Clear-History

  • Referencia
Módulo:
Microsoft.PowerShell.Core

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

Sintaxis

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 cmdlet Get-History.

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 comandos PSReadLine. El módulo PSReadLine almacena un archivo de historial que contiene todos los comandos de PowerShell de cada sesión de PowerShell. Desde un indicador de PowerShell, utilice las flechas arriba y abajo del teclado para desplazarse por el historial de comandos. Para mostrar la configuración del historial de comandos PSReadLine, utilice Get-PSReadLineOption. PSReadLine se distribuye 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 cmdlet Get-History 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 cmdlet Get-History 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 de especificado. El parámetro Newest especifica que los comandos más recientes se borran del historial. Get-History muestra 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 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 cmdlet Get-History muestra el historial de la sesión de PowerShell. Clear-History elimina el historial de comandos. El parámetro CommandLine especifica los comandos que contienen Ayuda o terminan con Sintaxis. Get-History muestra el historial de comandos actualizado y confirma que los comandos id. 3, id. 5, id. 6y id. 7 se eliminaron.

Ejemplo 4: Eliminar comandos por número de identificador

Este comando borra elementos específicos del historial utilizando el Id. Para eliminar varios comandos, envíe una lista separada por comas de números 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

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

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

Este comando utiliza los parámetros Id y Recuento para eliminar el historial de comandos. Los comandos se eliminan del Id especificado en orden inverso, del más nuevo 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 cmdlet Get-History muestra el historial de la sesión de PowerShell. Clear-History elimina el historial de comandos. El parámetro Id especifica que se empiece por Id 7. El parámetro Count especifica que se eliminen cinco comandos, incluido el Id especificado. Get-History muestra el historial de comandos actualizado y confirma que se han eliminado 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 utilizar comodines para que coincida con los comandos del historial de sesiones de PowerShell que muestra 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 utilizar con Count.

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

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Confirm

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

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 y Id se pueden usar juntos. El parámetro Count especifica el número de comandos que se van a eliminar, incluido el identificador de especificado. A partir del identificador de especificado, los comandos se eliminan en orden secuencial inverso. Por ejemplo, si el Id es 30 y el Count es 10, Clear-History elimina los elementos 21 a 30.

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

Tipo:Int32
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

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

Tipo:Int32[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 Newest se puede utilizar con Id y Count. El parámetro Count especifica el número de comandos que se van a eliminar, incluido el identificador de especificado. A partir del identificador de especificado, los comandos se eliminan en orden secuencial. Por ejemplo, si el Id es 30 y el Count es 10, Clear-History elimina los elementos 30 a 39.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

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, vea about_History.

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