Get-History

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Obtiene una lista de los comandos introducidos durante la sesión actual.

Syntax

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Description

El Get-History cmdlet obtiene el historial de sesiones, es decir, la lista de comandos especificados durante la sesión actual.

PowerShell mantiene automáticamente un historial de cada sesión. El número de entradas del historial de sesión viene determinado por el valor de la $MaximumHistoryCount variable de preferencia. A partir de Windows PowerShell 3.0, el valor predeterminado es 4096. Los archivos del historial se guardan de forma predeterminada en el directorio particular, pero se pueden guardar en cualquier otra ubicación. Para obtener más información sobre las características del historial en PowerShell, 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.

Ejemplos

Ejemplo 1: Obtención del historial de sesiones

En este ejemplo se obtienen las entradas del historial de sesiones. La pantalla predeterminada muestra cada comando y su identificador, que indica el orden en que se ejecutaron.

Get-History

Ejemplo 2: Obtención de entradas que incluyen una cadena

En este ejemplo se obtienen entradas en el historial de comandos que incluyen el servicio de cadena. El primer comando obtiene todas las entradas en el historial de la sesión. El operador de canalización (|) pasa los resultados al Where-Object cmdlet , que selecciona solo los comandos que incluyen el servicio.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Ejemplo 3: Exportar entradas del historial hasta un identificador específico

En este ejemplo se obtienen las cinco entradas del historial más recientes que terminan con la entrada 7. El operador de canalización pasa el resultado al Export-Csv cmdlet , que da formato al historial como texto separado por comas y lo guarda en el archivo History.csv. El archivo incluye los datos que se muestran al dar formato al historial como una lista. Esto incluye el estado y las horas de inicio y finalización del comando.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Ejemplo 4: Mostrar el comando más reciente

En este ejemplo se obtiene el último comando del historial de comandos. El último comando es el comando especificado más recientemente. Este comando usa el parámetro Count para mostrar solo un comando. De forma predeterminada, Get-History obtiene los comandos más recientes. Este comando se puede abreviar a "h - c 1" y equivale a presionar la tecla de flecha arriba.

Get-History -Count 1

Ejemplo 5: Mostrar todas las propiedades de las entradas del historial

En este ejemplo se muestran todas las propiedades de las entradas del historial de sesiones. El operador de canalización pasa los resultados de un Get-History comando al Format-List cmdlet , que muestra todas las propiedades de cada entrada del historial. Esto incluye el identificador, el estado y las horas de inicio y finalización del comando.

Get-History | Format-List -Property *

Parámetros

-Count

Especifica el número de entradas del historial más recientes que obtiene este cmdlet. De forma predeterminada, Get-History obtiene todas las entradas del historial de sesiones. Si usa los parámetros Count e Id en un comando, la presentación termina con el comando especificado por el parámetro Id .

En Windows PowerShell 2.0, de forma predeterminada, Get-History obtiene las 32 entradas más recientes.

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

-Id

Especifica una matriz de los identificadores de las entradas en el historial de sesiones. Get-History obtiene solo entradas especificadas. Si usa los parámetros Id y Count en un comando, Get-History obtiene las entradas más recientes que terminan con la entrada especificada por el parámetro Id .

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

Entradas

Int64

Puede canalizar un identificador de historial a este cmdlet.

Salidas

HistoryInfo

Este cmdlet devuelve un objeto de historial para cada elemento de historial que obtiene.

Notas

PowerShell incluye los siguientes alias para Get-History:

  • Todas las plataformas:
    • h
    • history
    • ghy

El historial de la sesión es una lista de los comandos escritos durante la sesión. El historial de sesiones representa el orden de ejecución, el estado y las horas de inicio y finalización del comando. Al escribir cada comando, PowerShell lo agrega al historial para que pueda reutilizarlo. Para obtener más información sobre el historial de comandos, consulte about_History.

A partir de Windows PowerShell 3.0, el valor predeterminado de la $MaximumHistoryCount variable de preferencia es 4096. En Windows PowerShell 2.0, el valor predeterminado es 64. Para obtener más información sobre la variable $MaximumHistoryCount, vea about_Preference_Variables.