Anexa entradas al historial de la sesión.
Sintaxis
Add-History [[-InputObject] <PSObject[]>] [-PassThru] [<CommonParameters>]
Descripción
El cmdlet Add-History agrega entradas al final del historial de la sesión, es decir, la lista de los comandos especificados durante la sesión actual.
Se puede usar el cmdlet Get-History para obtener los comandos y pasarlos a Add-History, o bien exportarlos a un archivo CSV o XML, importarlos después y, por último, pasar el archivo importado a Add-History. Este cmdlet permite agregar comandos específicos al historial o crear un único archivo de historial que incluya los comandos de varias sesiones.
Parámetros
-InputObject <PSObject[]>
Agrega el objeto HistoryInfo especificado al historial de la sesión. Puede utilizar este parámetro para enviar un objeto HistoryInfo de Get-History, Import-Clixml o Import-CSV a Add-History.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto de historial para cada entrada del historial. De forma predeterminada, este cmdlet no genera resultados.
|
¿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 |
Microsoft.PowerShell.Commands.HistoryInfo También se puede canalizar un objeto HistoryInfo a Add-History. |
|
Salidas |
None o Microsoft.PowerShell.Commands.HistoryInfo Cuando se usa el parámetro PassThru, Add-History genera un objeto HistoryInfo. En caso contrario, este cmdlet no genera resultados. |
Notas
El historial de la sesión es una lista de los comandos especificados durante la sesión con el identificador. El historial de la sesión representa el orden de ejecución, el estado y las horas de inicio y finalización del comando. A medida que escriba cada comando, Windows PowerShell lo agregará al historial para que pueda usarlo de nuevo. Para obtener más información sobre el historial de la sesión, vea about_History.
Para especificar los comandos que se van a agregar al historial, se usa el parámetro InputObject. El comando Add-History acepta únicamente objetos HistoryInfo, como los que genera Get-History para cada comando. No puede pasarle rutas de acceso y nombres de archivo, o una lista de comandos.
Se puede usar el parámetro -InputObject para pasar un archivo de objetos HistoryInfo a Add-History. Para ello, se exportan los resultados de un comando Get-History a un archivo mediante Export-CSV o Export-Clixml y, a continuación, se importa el archivo con Import-CSV o Import-Clixml. Después, puede pasar el archivo importado de objetos HistoryInfo a Add-History a través de una canalización o en una variable. Para obtener más información, vea los ejemplos.
El archivo de objetos HistoryInfo pasado a Add-History debe incluir la información de tipos, encabezados de columna y todas las propiedades de estos objetos. Si intenta pasar de nuevo los objetos a Add-History, no use el parámetro NoTypeInformation de Export-CSV ni elimine la información de tipos, encabezados de columna ni ningún campo del archivo.
Para modificar el historial de la sesión, exporte la sesión a un archivo CSV o XML, modifique el archivo, impórtelo y use Add-History para anexarlo al historial de la sesión actual.
Ejemplo 1
C:\PS>get-history | export-csv c:\testing\history.csv C:\PS>import-csv history.csv | add-history Descripción ----------- Estos comandos agregan los comandos especificados en una sesión de Windows PowerShell al historial de otra sesión de Windows PowerShell. El primer comando obtiene objetos que representan los comandos del historial y los exporta al archivo History.csv. El segundo comando se escribe en la línea de comandos de otra sesión. Usa el cmdlet Import-Csv para importar los objetos al archivo History.csv. 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 la sesión actual.
Ejemplo 2
C:\PS>import-clixml c:\temp\history.xml | add-history -passthru | foreach-object {invoke-history}
Descripción
-----------
Este comando importa comandos desde el archivo History.xml, los agrega al historial de la sesión actual y luego los ejecuta en el historial combinado.
El primer comando usa el comando Import-Clixml para importar un historial de comandos exportado al archivo History.xml. El operador de canalización (|) pasa los comandos al parámetro Add-History, que los agrega al historial de la sesión actual. El parámetro PassThru pasa los objetos que representan los comandos agregados a través de la canalización.
A continuación, el comando utiliza el cmdlet ForEach-Object para aplicar el comando Invoke-History a cada uno de los comandos en el historial combinado. El comando Invoke-History presenta el formato de un bloque de script que se coloca entre llaves ({}) porque ForEach-Object requiere un bloque de script aunque solo haya que aplicar un comando.
Ejemplo 3
C:\PS>get-history -id 5 -count 5 | add-history Descripción ----------- Este comando agrega los cinco primeros comandos del historial al final de la lista del historial. Usa el cmdlet Get-History para obtener los cinco comandos que finalizan en el comando 5. El operador de canalización (|) los pasa al cmdlet Add-History, que los anexa al historial actual. El comando Add-History no contiene parámetros, pero Windows PowerShell asocia los objetos pasados a través de la canalización al parámetro InputObject.
Ejemplo 4
C:\PS>$a = import-csv c:\testing\history.csv C:\PS>add-history -inputobject $a -passthru Descripción ----------- Estos comandos agregan los comandos del archivo History.csv al historial de la sesión actual. El primer comando usa el cmdlet Import-Csv para importar los comandos del 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 la sesión actual. Usa el parámetro InputObject para especificar la variable $a y el parámetro PassThru para generar un objeto que se muestra en la línea de comandos. Sin el parámetro PassThru, Add-History no genera resultados que mostrar.
Ejemplo 5
C:\PS>add-history -inputobject (import-clixml c:\temp\history01.xml) Descripción ----------- Este comando agrega los comandos del archivo History01.xml al historial de la sesión actual. Usa el parámetro InputObject para pasar los resultados del comando entre paréntesis a Add-History. El comando entre paréntesis, que se ejecuta en primer lugar, importa el archivo History01.xml a Windows PowerShell. A continuación, Add-History agrega los comandos del archivo al historial de la sesión.
Vea también