Add-History

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Добавляет записи в журнал сеанса.

Синтаксис

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

Описание

Командлет Add-History добавляет записи в конец журнала сеансов, то есть список команд, введенных во время текущего сеанса.

Журнал сеанса — это список команд, введенных за время сеанса. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. При вводе каждой команды PowerShell добавляет его в журнал, чтобы его можно было повторно использовать. Дополнительные сведения о журнале сеансов см. в about_History.

Журнал сеансов управляется отдельно от журнала, поддерживаемого модулем PSReadLine . Обе истории доступны в сеансах, где загружается PSReadLine . Этот командлет работает только с журналом сеансов. Дополнительные сведения см. в about_PSReadLine.

Командлет можно использовать Get-History для получения команд и передачи их Add-Historyв, либо экспортировать команды в CSV-файл или XML-файл, а затем импортировать команды и передать импортированный файл Add-History. Этот командлет позволяет добавить определенные команды в журнал или создать единый файл журнала, в котором содержатся команды, введенные в течение нескольких сеансов.

Примеры

Пример 1. Добавление команд в журнал другого сеанса

В этом примере команды, введенные в одном сеансе PowerShell, добавляются в журнал другого сеанса PowerShell.

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

Первая команда получает объекты, представляющие команды в журнале, и экспортирует их в History.csv файл.

Вторая команда должна вводится в командной строке другого сеанса. Он использует Import-Csv командлет для импорта объектов в History.csv файле. Оператор конвейера (|) передает объекты командлету, который добавляет объекты Add-History , представляющие команды в файле в History.csv текущий журнал сеансов.

Пример 2. Импорт и выполнение команд

В этом примере команды импортируются из History.xml файла, добавляются в текущий журнал сеансов, а затем выполняются команды в объединенном журнале.

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

Первая команда использует Import-Clixml командлет для импорта журнала команд, экспортированного в History.xml файл. Оператор конвейера передает команды командлету Add-History , который добавляет команды в текущий журнал сеансов. Параметр PassThru передает объекты, представляющие добавленные команды вниз конвейера.

Затем команда использует ForEach-Object командлет для применения Invoke-History команды к каждой из команд в объединенном журнале. Команда Invoke-History отформатирована как блок скрипта, заключенная в фигурные скобки ({}), в соответствии с параметром Process командлета ForEach-Object .

Пример 3. Добавление команд в журнал в конец журнала

Этот пример добавляет первые пять команд в журнал в конец списка журналов.

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

Командлет Get-History получает пять команд, заканчивающиеся командой 5. Оператор конвейера передает их командлету Add-History , который добавляет их в текущий журнал. Команда Add-History не содержит никаких параметров, но PowerShell связывает объекты, передаваемые через конвейер, с параметром Add-HistoryInputObject.

Пример 4. Добавление команд в файл .csv в текущий журнал

В этом примере команды в файле добавляются в History.csv текущий журнал сеансов.

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

Командлет Import-Csv импортирует команды в History.csv файле и сохраняет его содержимое в переменной $a.

Вторая команда использует Add-History командлет для добавления команд из History.csv текущего журнала сеансов. Он использует параметр InputObject для указания $a переменной и параметра PassThru для создания объекта для отображения в командной строке. Без параметра Add-History PassThru командлет не создает выходные данные.

Пример 5. Добавление команд в файл .xml в текущий журнал

В этом примере команды в файле добавляются в history.xml текущий журнал сеансов.

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

Параметр InputObject передает результаты команды в скобках командлету Add-History . Команда в скобках, которая выполняется сначала, импортирует history.xml файл в PowerShell. Затем Add-History командлет добавляет команды в файл в журнал сеансов.

Параметры

-InputObject

Задает массив записей, добавляемых в журнал как объект HistoryInfo в журнал сеансов. Этот параметр можно использовать для отправки объекта HistoryInfo, например возвращаемых Import-ClixmlGet-Historyкомандлетами или Import-Csv командлетамиAdd-History.

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

-Passthru

Указывает, что этот командлет возвращает объект HistoryInfo для каждой записи журнала. По умолчанию этот командлет не создает выходные данные.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

HistoryInfo

Объект HistoryInfo можно передать в этот командлет.

Выходные данные

None

По умолчанию этот командлет не возвращает выходные данные.

HistoryInfo

При использовании параметра PassThru этот командлет возвращает объект HistoryInfo .

Примечания

Журнал сеансов — это список команд, введенных во время сеанса вместе с идентификатором. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. При вводе каждой команды PowerShell добавляет его в журнал, чтобы его можно было повторно использовать. Дополнительные сведения о журнале сеансов см. в about_History.

Чтобы указать команды для добавления в журнал, используйте параметр InputObject . Команда Add-History принимает только объекты HistoryInfo , такие как возвращенные для каждой команды командлетом Get-History . Передать путь и имя файла или список команд по конвейеру нельзя.

Параметр InputObject можно использовать для передачи файла объектов Add-HistoryHistoryInfo в . Для этого экспортируйте результаты Get-History команды в файл с помощью Export-Csv командлета или Export-Clixml командлета, а затем импортируйте файл с помощью Import-Csv командлетов или Import-Clixml командлетов. Затем можно передать файл импортированных объектов HistoryInfo через Add-History конвейер или переменную. Дополнительные сведения см. в примерах.

Файл объектов HistoryInfo , которые вы передаете Add-History командлету, должен включать сведения о типе, заголовки столбцов и все свойства объектов HistoryInfo . Если вы планируете передать объекты обратноAdd-History, не используйте параметр Export-Csv NoTypeInformation командлета и не удаляйте сведения о типе, заголовки столбцов или любые поля в файле.

Чтобы изменить журнал сеансов, экспортируйте сеанс в CSV-файл или XML-файл, измените файл, импортируйте файл и добавьте Add-History его в текущий журнал сеансов.