Поделиться через

Get-History

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

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

Синтаксис

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Описание

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

PowerShell автоматически ведет журнал каждого сеанса. Количество записей в журнале сеанса определяется значением переменной $MaximumHistoryCount предпочтения. Начиная с Windows PowerShell 3.0, значение по умолчанию — 4096. По умолчанию файлы журнала сохраняются в домашнем каталоге, но вы можете сохранить файл в любом месте. Дополнительные сведения о функциях журнала в PowerShell см. в разделе about_History.

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

Примеры

Пример 1. Получение журнала сеансов

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

Get-History

Пример 2. Получение записей, включающих строку

Этот пример получает записи в журнале команд, которые включают службу строк. Первая команда возвращает все записи из журнала сеанса. Оператор конвейера (|) передает результаты командлету Where-Object , который выбирает только команды, включающие службу.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Пример 3. Экспорт записей журнала до определенного идентификатора

В этом примере возвращается пять последних записей журнала, заканчивающихся записью 7. Оператор конвейера передает результат командлету Export-Csv , который форматирует журнал в виде текста с разделиниями-запятыми и сохраняет его в файле History.csv. Файл содержит данные, отображаемые при форматировании журнала в виде списка. Сюда входит состояние, время начала и окончания команды.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Пример 4. Отображение последней команды

В этом примере возвращается последняя команда в журнале команд. Последняя команда — это последняя введенная команда. Эта команда использует параметр Count для отображения только одной команды. По умолчанию Get-History возвращает самые последние команды. Эту команду можно сократить до "h -c 1", и она эквивалентна нажатию клавиши со стрелкой вверх.

Get-History -Count 1

Пример 5. Отображение всех свойств записей в журнале

В этом примере отображаются все свойства записей в журнале сеанса. Оператор конвейера передает результаты Get-History команды командлету Format-List , который отображает все свойства каждой записи журнала. Сюда входят идентификатор, состояние, время начала и окончания команды.

Get-History | Format-List -Property *

Параметры

-Count

Указывает количество последних записей журнала, которые получает этот командлет. По умолчанию Get-History получает все записи в журнале сеанса. Если в команде используются оба параметра Count и Id, последней выводится команда, указанная в параметре Id.

В Windows PowerShell 2.0 по умолчанию Get-History получает 32 последние записи.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Указывает массив идентификаторов записей в журнале сеанса. Get-History получает только указанные записи. При использовании параметров Id и Count в команде возвращает последние записи, заканчивающиеся записью, Get-History указанной параметром Id .

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

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

Int64

Вы можете передать идентификатор журнала в этот командлет.

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

HistoryInfo

Этот командлет возвращает объект журнала для каждого элемента журнала, который он получает.

Примечания

PowerShell включает следующие псевдонимы для Get-History:

  • Для всех платформ.
    • h
    • history
    • ghy

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

Начиная с Windows PowerShell 3.0 значение по умолчанию для переменной $MaximumHistoryCount предпочтения — 4096. В Windows PowerShell 2.0 значением по умолчанию является 64. Дополнительные сведения о переменной см. в $MaximumHistoryCountразделе about_Preference_Variables.