Возвращает список команд, введенных за время текущего сеанса.
Синтаксис
Get-History [[-Id] <Int64[]>] [[-Count] <int>] [<CommonParameters>]
Описание
Командлет Get-History возвращает журнал сеанса, в котором содержится список команд, введенных за время текущего сеанса. Windows PowerShell автоматически ведет журнал команд в каждом сеансе. Сохранить журнал сеанса можно в формате XML или CSV. По умолчанию файлы журнала сохраняются в корневом каталоге, но можно сохранить файл и в другом месте.
Параметры
-Count <int>
Отображает заданное количество последних записей журнала. Значение по умолчанию — 32. Если в команде используются и параметр Count, и параметр Id, то отображение заканчивается командой, указанной параметром Id.
Обязательно? |
false |
Позиция? |
2 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Id <Int64[]>
Задает идентификационный номер команды в журнале сеанса. Get-History получает только указанную команду. Если используются Id и Count, командлет Get-History извлекает последние команды, заканчивая командой, указанной параметром Id.
Обязательно? |
false |
Позиция? |
1 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByValue) |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
Int64 Идентификатор записи журнала можно передать командлету Get-History по конвейеру. |
Выходные данные |
Microsoft.PowerShell.Commands.HistoryInfo Командлет Get-History возвращает объект журнала для каждого получаемого элемента журнала. |
Примечания
Журнал сеанса представляет собой список команд, введенных за время сеанса, вместе с идентификатором. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. При вводе каждой команды Windows PowerShell добавляет ее в журнал, чтобы обеспечить возможность ее повторного использования. Дополнительные сведения о журнале команд см. в разделе "about_History".
При вызове командлета Get-History можно использовать его встроенные псевдонимы "h", "history" и "ghy". Дополнительные сведения см. в разделе About_Aliases.
Пример 1
C:\PS>get-history Description ----------- Эта команда возвращает 32 последние введенные команды. По умолчанию выводится каждая команда и ее идентификатор, показывающий порядок выполнения.
Пример 2
C:\PS>get-history | where-object {$_.commandLine -like "*service*"} Description ----------- Эта команда возвращает записи журнала команд, содержащие слово "service". Первая команда возвращает 32 последних записи в журнале сеанса. Оператор конвейера (|) передает результаты командлету Where-Object, который выбирает только команды, содержащие слово "service".
Пример 3
C:\PS>get-history -id 7 -count 5 | export-csv history.csv Description ----------- Эта команда возвращает 5 последних записей журнала, заканчивая записью 7. Оператор конвейера (|) передает результат командлету Export-Csv, который форматирует журнал в виде текста, разделенного запятыми, и сохраняет его в файле History.csv. Этот файл включает данные, отображаемые при форматировании журнала в виде списка, в том числе статус и время начала и завершения команды.
Пример 4
C:\PS>get-history -count 1 Description ----------- Эта команда возвращает последнюю (наиболее свежую) команду в журнале команд. Для вывода только одной команды используется параметр Count. По умолчанию командлет Get-History выводит последние команды. Команда может быть сокращена до "h -c 1" и эквивалентна нажатию клавиши "вверх".
Пример 5
C:\PS>get-history -count $MaximumHistoryCount Description ----------- Эта команда выводит все команды, сохраненные в журнале сеанса. По умолчанию переменная $MaximumHistoryCount равна 64, так что эту команду можно сократить до "h -c 64".
Пример 6
C:\PS>get-history | format-list Description ----------- Эта команда выводит все свойства записей в журнале сеанса. Оператор конвейера (|) передает результат командлету Format-List, который отображает все свойства каждой записи журнала, в том числе идентификатор, статус и время начала и завершения команды.
См. также