Get-History
Возвращает список команд, введенных во время текущего сеанса.
Синтаксис
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 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 |
Входные данные
Вы можете передать идентификатор журнала в этот командлет.
Выходные данные
Этот командлет возвращает объект журнала для каждого элемента журнала, который он получает.
Примечания
Журнал сеанса — это список команд, введенных за время сеанса. Журнал сеанса представляет порядок выполнения, состояние, а также время начала и окончания команды. По мере ввода каждой команды PowerShell добавляет ее в журнал, чтобы ее можно было использовать повторно. Дополнительные сведения об журнале команд см. в разделе about_History.
Начиная с Windows PowerShell 3.0 значение по умолчанию для переменной $MaximumHistoryCount
предпочтения — 4096
. В Windows PowerShell 2.0 значением по умолчанию является 64
. Дополнительные сведения о переменной см. в $MaximumHistoryCount
разделе about_Preference_Variables.