Invoke-History
Выполняет команды из журнала сеансов.
Синтаксис
Default (По умолчанию)
Invoke-History
[[-Id] <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Invoke-History выполняет команды из истории сеанса. Вы можете передать объекты, представляющие команды из Get-History в Invoke-History, или вы можете идентифицировать команды в текущей истории по их идентификационному номеру . Чтобы найти идентификационный номер команды, используйте командлет Get-History.
Журнал сеансов управляется отдельно от журнала, поддерживаемого модулем PSReadLine. Обe истории доступны в тех сеансах, где загружен PSReadLine. Этот командлет работает только с историей сеансов. Дополнительные сведения см. в about_PSReadLine.
Примеры
Пример 1: Выполните последнюю команду из истории
В этом примере выполняется последняя или наиболее недавняя команда в истории сеанса. Эту команду можно сократить как r, псевдоним для Invoke-History.
Invoke-History
Пример 2. Выполните команду с указанным идентификатором
В этом примере выполняется команда в журнале сеансов с идентификатором 132. Так как имя параметра id является необязательным, можно сократить эту команду следующим образом: Invoke-History 132, ihy 132или r 132.
Invoke-History -Id 132
Пример 3. Выполнение последней команды с помощью текста команды
В этом примере выполняется последняя команда Get-Process в журнале сеансов. При вводе символов для параметра идентификатора, Invoke-History выполняет первую команду, которая соответствует шаблону, начиная с последних команд.
Invoke-History -Id get-pr
Замечание
Сопоставление шаблонов не учитывает регистр, но шаблон соответствует началу строки.
Пример 4. Выполнение последовательности команд из истории
В этом примере выполняются команды от 16 до 24. Так как вы можете перечислить только одно значение идентификатора, команда использует командлет ForEach-Object для выполнения команды Invoke-History один раз для каждого значения идентификатора.
16..24 | ForEach-Object {Invoke-History -Id $_ }
Пример 5
В этом примере выполняются семь команд в журнале, заканчивающиеся командой 255 (249–255). Он использует командлет Get-History для получения команд. Так как вы можете перечислить только одно значение идентификатора , команда использует командлет ForEach-Object для выполнения команды Invoke-History один раз для каждого значения идентификатора .
Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Id
Задает идентификатор команды в журнале. Вы можете ввести номер команды ID или первые несколько символов команды.
Если вы вводите символы, Invoke-History сначала соответствует самым последним командам. Если этот параметр не указан, Invoke-History выполнит последнюю или самую недавнюю команду. Чтобы найти номер Id команды, используйте командлет Get-History.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Вы можете передать историю Id в этот командлет.
Выходные данные
None
Этот командлет не возвращает собственные выходные данные, но команды, которые он выполняет, могут возвращать собственные выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Invoke-History:
ihyr
Журнал сеансов — это список команд, введенных во время сеанса. История сеансов представляет порядок выполнения, состояние и время начала и окончания команд. При вводе каждой команды PowerShell добавляет его в журнал, чтобы его можно было повторно использовать. Дополнительные сведения о журнале сеансов см. в разделе about_History.