Compartir a través de

Add-History

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Anexa entradas al historial de sesiones.

Sintaxis

Add-History
   [[-InputObject] <PSObject[]>]
   [-Passthru]
   [<CommonParameters>]

Description

El cmdlet Add-History agrega entradas al final del historial de sesiones, es decir, la lista de comandos especificados durante la sesión actual. Puede usar el cmdlet Get-History para obtener los comandos y pasarlos a Add-History, o puede exportar los comandos a un archivo CSV o XML, importar los comandos y pasar el archivo importado a Add-History. Puede usar este cmdlet para agregar comandos específicos al historial o para crear un único archivo de historial que incluya comandos de más de una sesión.

Ejemplos

Ejemplo 1: Agregar comandos al historial de una sesión diferente

# Get objects representing the commands in the history and exports them to the History.csv file.
Get-History | Export-Csv c:\testing\history.csv
# Use the `Import-Csv` cmdlet to import the objects in the History.csv file.
Import-Csv history.csv | Add-History

Estos comandos agregan los comandos tipados en una sesión de Windows PowerShell al historial de una sesión de Windows PowerShell diferente. El segundo comando se escribe en la línea de comandos de una sesión diferente.

El operador de canalización | pasa los objetos al cmdlet Add-History, que agrega los objetos que representan los comandos del archivo History.csv al historial de sesión actual.

Ejemplo 2: Importación y ejecución de comandos

Import-Clixml c:\temp\history.xml | Add-History -Passthru | ForEach-Object -Process {Invoke-History}

Este comando importa comandos del archivo History.xml, los agrega al historial de sesión actual y, a continuación, ejecuta los comandos en el historial combinado.

El cmdlet Import-Clixml importa un historial de comandos que se exportó al archivo History.xml.

El operador de canalización pasa los comandos al cmdlet Add-History, que agrega los comandos al historial de sesión actual.

El parámetro PassThru pasa los objetos que representan los comandos agregados a la canalización.

El cmdlet ForEach-Object para aplicar el comando Invoke-History a cada uno de los comandos del historial combinado.

El comando Invoke-History tiene formato de bloque de script, entre llaves, según lo requiera el parámetro Process Process del cmdlet ForEach-Object.

Ejemplo 3: Agregar comandos en el historial al final del historial

Get-History -Id 5 -Count 5 | Add-History

Este comando agrega los cinco primeros comandos del historial al final de la lista de historial. Usa el cmdlet Get-History para obtener los cinco comandos que terminan en el comando 5. El operador de canalización los pasa al cmdlet Add-History, que los anexa al historial actual.

El comando no incluye ningún parámetro, pero Windows PowerShell asocia los objetos pasados a través de la canalización con el parámetro InputObject de de .

Ejemplo 4: Agregar comandos en un archivo .csv al historial actual

$a = Import-Csv c:\testing\history.csv
Add-History -InputObject $a -PassThru

Estos comandos agregan los comandos del archivo History.csv al historial de sesión actual.

El primer comando usa el cmdlet Import-Csv para importar los comandos en el archivo History.csv y almacenar su contenido en la variable $a.

El segundo comando usa el cmdlet Add-History para agregar los comandos de History.csv al historial de sesión actual.

Usa el parámetro InputObject para especificar la variable $a y el parámetro PassThru para generar un objeto que se muestre en la línea de comandos. Sin el parámetro PassThru, el cmdlet no genera ninguna salida.

Ejemplo 5: Agregar comandos en un archivo .xml al historial actual

Add-History -InputObject (Import-Clixml c:\temp\history01.xml)

Este comando agrega los comandos del archivo History01.xml al historial de sesión actual. Usa el parámetro InputObject para pasar los resultados del comando entre paréntesis al cmdlet Add-History.

El comando entre paréntesis, que se ejecuta primero, importa el archivo History01.xml en Windows PowerShell. A continuación, el cmdlet Add-History agrega los comandos del archivo al historial de sesión.

Parámetros

-InputObject

Especifica una matriz de entradas que se van a agregar al historial como objeto HistoryInfo al historial de sesión. Puede usar este parámetro para enviar un objeto HistoryInfo, como los devueltos por los cmdlets de Get-History, Import-Clixmlo Import-Csv, para Add-History.

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

-Passthru

Indica que este cmdlet devuelve un objeto de historial para cada entrada del historial. De forma predeterminada, este cmdlet no genera ninguna salida.

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

Entradas

HistoryInfo

Puede canalizar un objeto HistoryInfo a este cmdlet.

Salidas

None or Microsoft.PowerShell.Commands.HistoryInfo

Este cmdlet devuelve un objeto HistoryInfo si especifica el parámetro PassThru. De lo contrario, este cmdlet no genera ninguna salida.

Notas

  • El historial de sesiones es una lista de los comandos especificados durante la sesión junto con el identificador. 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, Windows PowerShell lo agrega al historial para que pueda reutilizarlo. Para obtener más información sobre el historial de sesiones, consulte about_History.

  • Para especificar los comandos que se van a agregar al historial, use el parámetro InputObject. El comando Add-History solo acepta objetos HistoryInfo, como los devueltos por cada comando por el cmdlet Get-History. No se puede pasar una ruta de acceso y un nombre de archivo ni una lista de comandos.

  • Puede usar el parámetro InputObject para pasar un archivo de objetos HistoryInfo de a Add-History. Para ello, exporte los resultados de un comando de Get-History a un archivo mediante el cmdlet Export-Csv o Export-Clixml y, a continuación, importe el archivo mediante los cmdlets Import-Csv o Import-Clixml. A continuación, puede pasar el archivo de objetos HistoryInfo importados a Add-History a través de una canalización o en una variable. Para obtener más información, consulte los ejemplos.

  • El archivo de HistoryInfo objetos que se pasan al cmdlet Add-History debe incluir la información de tipo, los encabezados de columna y todas las propiedades de los objetos HistoryInfo. Si tiene previsto volver a pasar los objetos a Add-History, no use el parámetro NoTypeInformation del cmdlet Export-Csv y no elimine la información de tipo, los encabezados de columna ni ningún campo del archivo. Para modificar el historial de sesiones, exporte la sesión a un archivo CSV o XML, modifique el archivo, importe el archivo y use Add-History para anexarlo al historial de sesión actual.