Elimina entradas del historial de comandos.

Sintaxis

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

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

Descripción

El cmdlet Clear-History elimina comandos del historial de comandos, es decir, la lista de los comandos especificados durante la sesión actual.

Sin parámetros, Clear-History elimina todos los comandos del historial de la sesión, pero se pueden utilizar los parámetros de Clear-History para eliminar comandos seleccionados.

Parámetros

-CommandLine <string[]>

Elimina comandos con las cadenas de texto especificadas. Si escribe más de una cadena, Clear-History elimina comandos que tengan cualquiera de las cadenas.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

true

-Count <int>

Borra el número especificado de entradas del historial, comenzando por la entrada más antigua del historial.

Si utiliza los parámetros Count e Id en el mismo comando, el cmdlet borra el número de entradas especificado por el parámetro Count, comenzando por la entrada especificada por el parámetro Id. Por ejemplo, si Count es 10 e Id es 30, Clear-History borra los elementos 21 a 30 (ambos inclusive).

Si utiliza los parámetros Count y CommandLine en el mismo comando, Clear-History borra el número de entradas especificado por el parámetro Count, comenzando por la entrada especificada por el parámetro CommandLine.

¿Requerido?

false

¿Posición?

2

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Id <Int32[]>

Elimina comandos con los identificadores de historial especificados.

Para buscar el identificador de historial de un comando, se utiliza Get-History.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Newest

Elimina las entradas más recientes del historial. De forma predeterminada, Clear-History elimina las entradas más antiguas del historial.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

False

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar objetos a Clear-History.

Salidas

Ninguno

Este cmdlet no genera resultados.

Notas

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

La eliminación de un comando del historial no cambia los identificadores de historial de los elementos restantes del historial de comandos.

Ejemplo 1

C:\PS>clear-history

Descripción
-----------
Elimina todos los comandos del historial de la sesión.






Ejemplo 2

C:\PS>clear-history -id 23, 25

Descripción
-----------
Elimina los comandos con los identificadores de historial 23 y 25.






Ejemplo 3

C:\PS>clear-history -command *help*, *command

Descripción
-----------
Elimina comandos que incluyen "help" o finalizan en "command".






Ejemplo 4

C:\PS>clear-history -count 10 -newest

Descripción
-----------
Elimina los 10 comandos más recientes del historial.






Ejemplo 5

C:\PS>clear-history -id 10 -count 3

Descripción
-----------
Elimina los tres comandos más antiguos que empiezan por la entrada con identificador 10.






Vea también




Tabla de contenido