Возвращает список команд, введенных за время текущего сеанса.

Синтаксис

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, который отображает все свойства каждой записи журнала, в том числе идентификатор, статус и время начала и завершения команды.

Get-History