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

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

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

-Id

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

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.