Add-History
Добавляет записи в журнал сеанса.
Синтаксис
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-History
InputObject.
Пример 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-Clixml
Get-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 можно передать в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра PassThru этот командлет возвращает объект HistoryInfo .
Примечания
Журнал сеансов — это список команд, введенных во время сеанса вместе с идентификатором. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. При вводе каждой команды PowerShell добавляет его в журнал, чтобы его можно было повторно использовать. Дополнительные сведения о журнале сеансов см. в about_History.
Чтобы указать команды для добавления в журнал, используйте параметр InputObject . Команда Add-History
принимает только объекты HistoryInfo , такие как возвращенные для каждой команды командлетом Get-History
. Передать путь и имя файла или список команд по конвейеру нельзя.
Параметр InputObject можно использовать для передачи файла объектов Add-History
HistoryInfo в . Для этого экспортируйте результаты 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
его в текущий журнал сеансов.
Связанные ссылки
PowerShell