Clear-History
Elimina entradas del historial de comandos de PowerShell.
Sintaxis
IDParameter (valor predeterminado)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
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 obtener más información, consulte PSReadLine y about_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.
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
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.
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
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.
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
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.
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
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.
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
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 sobre_las_normas_de_citación.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
CommandLineParameter
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet Clear-History.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | Int |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | Int[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
IDParameter
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si se ejecuta el cmdlet Clear-History. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
None
No se pueden canalizar objetos a Clear-History.
Salidas
None
Clear-History no genera ninguna salida.
Notas
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.