Partilhar via

Add-History

  • Referência
Módulo:
Microsoft.PowerShell.Core

Acrescenta entradas ao histórico da sessão.

Sintaxe

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

Description

O cmdlet Add-History adiciona entradas ao final do histórico da sessão, ou seja, à lista de comandos inseridos durante a sessão atual.

O histórico da sessão é uma lista dos comandos inseridos durante a sessão. O histórico da sessão representa a ordem de execução, o status e as horas de início e término do comando. À medida que você insere cada comando, o PowerShell o adiciona ao histórico para que você possa reutilizá-lo. Para obter mais informações sobre o histórico da sessão, consulte about_History.

O histórico da sessão é gerenciado separadamente do histórico mantido pelo módulo PSReadLine. Ambos os históricos estão disponíveis em sessões onde PSReadLine é carregado. Este cmdlet só funciona com o histórico da sessão. Para obter mais informações, consulte about_PSReadLine.

Você pode usar o cmdlet Get-History para obter os comandos e passá-los para Add-History, ou pode exportar os comandos para um arquivo CSV ou XML, importar os comandos e passar o arquivo importado para Add-History. Você pode usar esse cmdlet para adicionar comandos específicos ao histórico ou para criar um único arquivo de histórico que inclua comandos de mais de uma sessão.

Exemplos

Exemplo 1: Adicionar comandos ao histórico de uma sessão diferente

Este exemplo adiciona os comandos digitados em uma sessão do PowerShell ao histórico de uma sessão diferente do PowerShell.

Get-History | Export-Csv -Path C:\testing\history.csv -IncludeTypeInformation
Import-Csv -Path C:\testing\history.csv | Add-History

O primeiro comando obtém objetos que representam os comandos no histórico e os exporta para o arquivo History.csv.

O segundo comando é digitado na linha de comando de uma sessão diferente. Ele usa o cmdlet Import-Csv para importar os objetos no arquivo History.csv. O operador de pipeline (|) passa os objetos para o cmdlet Add-History, que adiciona os objetos que representam os comandos no arquivo History.csv ao histórico de sessões atual.

Exemplo 2: Importar e executar comandos

Este exemplo importa comandos do arquivo History.xml, adiciona-os ao histórico da sessão atual e executa os comandos no histórico combinado.

Import-Clixml -Path C:\temp\history.xml | Add-History -PassThru | ForEach-Object -Process {Invoke-History}

O primeiro comando usa o cmdlet Import-Clixml para importar um histórico de comandos que foi exportado para o arquivo History.xml. O operador de pipeline passa os comandos para o cmdlet Add-History, que adiciona os comandos ao histórico da sessão atual. O parâmetro PassThru passa os objetos que representam os comandos adicionados para baixo no pipeline.

Em seguida, o comando usa o cmdlet ForEach-Object para aplicar o comando Invoke-History a cada um dos comandos no histórico combinado. O comando Invoke-History é formatado como um bloco de script, entre chaves ({}), conforme exigido pelo parâmetro Process do cmdlet ForEach-Object.

Exemplo 3: Adicionar comandos do histórico ao final do histórico

Este exemplo adiciona os cinco primeiros comandos do histórico ao final da lista de histórico.

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

O cmdlet Get-History obtém os cinco comandos que terminam no comando 5. O operador de pipeline transmite esses elementos para o cmdlet Add-History, que os adiciona ao histórico atual. O comando Add-History não inclui parâmetros, mas o PowerShell associa os objetos passados pelo pipeline ao parâmetro InputObject de Add-History.

Exemplo 4: Adicionar comandos em um arquivo .csv ao histórico atual

Este exemplo adiciona os comandos no arquivo History.csv ao histórico da sessão atual.

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

O cmdlet Import-Csv importa os comandos no arquivo History.csv e armazena seu conteúdo na variável $a.

O segundo comando usa o cmdlet Add-History para adicionar os comandos do History.csv ao histórico da sessão atual. Ele usa o parâmetro InputObject para especificar a variável $a e o parâmetro PassThru para gerar um objeto a ser exibido na linha de comando. Sem o parâmetro PassThru, o cmdlet Add-History não gera nenhuma saída.

Exemplo 5: Adicionar comandos em um arquivo .xml ao histórico atual

Este exemplo adiciona os comandos no arquivo history.xml ao histórico da sessão atual.

Add-History -InputObject (Import-Clixml -Path C:\temp\history.xml)

O parâmetro InputObject passa os resultados do comando entre parênteses para o cmdlet Add-History. O comando entre parênteses, que é executado primeiro, importa o arquivo history.xml para o PowerShell. Em seguida, o cmdlet Add-History adiciona os comandos no arquivo ao histórico da sessão.

Parâmetros

-InputObject

Especifica uma matriz de entradas a ser adicionada ao histórico da sessão como objeto HistoryInfo. Você pode usar este parâmetro para submeter um objeto HistoryInfo, como os que são retornados pelos cmdlets Get-History, Import-Clixmlou Import-Csv, para Add-History.

Tipo:PSObject[]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Indica que esse cmdlet retorna um objeto HistoryInfo para cada entrada de histórico. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

HistoryInfo

Você pode canalizar um objeto HistoryInfo para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

HistoryInfo

Quando se utiliza o parâmetro PassThru, este cmdlet retorna um objeto HistoryInfo.

Notas

O histórico da sessão é uma lista dos comandos inseridos durante a sessão, juntamente com o ID. O histórico da sessão representa a ordem de execução, o status e as horas de início e término do comando. À medida que você insere cada comando, o PowerShell o adiciona ao histórico para que você possa reutilizá-lo. Para obter mais informações sobre o histórico da sessão, consulte about_History.

Para especificar os comandos a serem adicionados ao histórico, use o parâmetro InputObject. O comando Add-History aceita apenas objetos HistoryInfo, como os retornados para cada comando pelo cmdlet Get-History. Não é possível passar um caminho e nome de arquivo ou uma lista de comandos.

Você pode usar o parâmetro InputObject para passar um arquivo de objetos HistoryInfo para Add-History. Para fazer isso, exporte os resultados de um comando Get-History para um arquivo usando o cmdlet Export-Csv ou Export-Clixml e, em seguida, importe o arquivo usando os cmdlets Import-Csv ou Import-Clixml. Em seguida, você pode passar o arquivo de objetos HistoryInfo importados para Add-History através de um pipeline ou em uma variável. Para obter mais informações, consulte os exemplos.

O ficheiro de objetos HistoryInfo que se passa para o cmdlet Add-History deve incluir as informações de tipo, os cabeçalhos de coluna e todas as propriedades dos objetos HistoryInfo. Se você pretende passar os objetos de volta para Add-History, não use o parâmetro NoTypeInformation do cmdlet Export-Csv e não exclua as informações de tipo, cabeçalhos de coluna ou quaisquer campos no arquivo.

Para modificar o histórico da sessão, exporte a sessão para um arquivo CSV ou XML, modifique o arquivo, importe o arquivo e use Add-History para anexá-lo ao histórico da sessão atual.