Get-History
Obtiene una lista de los comandos especificados durante la sesión actual.
Sintaxis
Default (valor predeterminado)
Get-History
[[-Id] <Int64[]>]
[[-Count] <Int32>]
[<CommonParameters>]
Description
El cmdlet Get-History obtiene el historial de sesión, 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 sesiones viene determinado por el valor de la variable de preferencia $MaximumHistoryCount. A partir de Windows PowerShell 3.0, el valor predeterminado es 4096.
Puede guardar el historial de sesión en formato XML o CSV. De forma predeterminada, los archivos de historial se guardan en el directorio principal, pero puede guardar el archivo en cualquier ubicación.
Para obtener más información sobre las características del historial en PowerShell, consulte about_History en Microsoft Docs.
Ejemplos
Ejemplo 1: Obtención del historial de sesiones
Get-History
Este comando obtiene las entradas del historial de sesión. La pantalla predeterminada muestra cada comando y su identificador, que indica el orden en que se ejecutaron.
Ejemplo 2: Obtención de entradas que incluyen una cadena
Get-History | Where-Object {$_.CommandLine -like "*Service*"}
Este comando obtiene entradas en el historial de comandos que incluyen el servicio de cadena. El primer comando obtiene todas las entradas del historial de sesión. El operador de canalización (|) pasa los resultados al cmdlet Where-Object, que selecciona solo los comandos que incluyen el servicio.
Ejemplo 3: Exportar como máximo siete entradas
Get-History -ID 7 -Count 5 | Export-Csv History.csv
Este comando obtiene las cinco entradas del historial más recientes que terminan con la entrada 7. El operador de canalización pasa el resultado al cmdlet Export-Csv, 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.
Ejemplo 4: Mostrar el comando más reciente
Get-History -Count 1
Este comando 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.
Ejemplo 5: Mostrar todas las propiedades de las entradas del historial
Get-History | Format-List -Property *
Este comando muestra todas las propiedades de las entradas en el historial de sesión. El operador de canalización pasa los resultados de un comando Get-History al cmdlet Format-List, 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.
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 utiliza los parámetros Count y Id en un comando, la presentación finaliza 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.
Propiedades de parámetro
| Tipo: | Int32 |
| 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 una matriz de los identificadores de las entradas en el historial de sesiones. Get-History solo obtiene 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.
Propiedades de parámetro
| Tipo: | Int64[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| 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
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
- El historial de sesiones es una lista de los comandos especificados 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, vea about_History.
- A partir de Windows PowerShell 3.0, el valor predeterminado de la variable de preferencia
$MaximumHistoryCountes 4096. En Windows PowerShell 2.0, el valor predeterminado es 64. Para obtener más información sobre la variable de$MaximumHistoryCount, vea about_Preference_Variables.