Invoke-History

  • 参考
模块:
Microsoft.PowerShell.Core

从会话历史记录中运行命令。

语法

Invoke-History
      [[-Id] <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Invoke-History cmdlet 从会话历史记录中运行命令。 可以将表示命令的对象从 Get-History 传递给 Invoke-History，或通过使用命令 Id 号标识当前历史记录中的命令。 若要查找命令的标识号，请使用 Get-History cmdlet。

会话历史记录独立于 PSReadLine 模块维护的历史记录进行管理。 这两个历史记录在加载 PSReadLine 的会话中都可用。 此 cmdlet 仅适用于会话历史记录。 有关详细信息，请参阅 about_PSReadLine。

示例

示例 1：在历史记录中运行最新的命令

此示例运行会话历史记录中的最后一个或最新的命令。 可将此命令缩写为 r，Invoke-History 的别名。

Invoke-History

示例 2：运行具有指定 ID 的命令

此示例运行会话历史记录中 Id 为 132 的命令。 由于 Id 参数的名称为可选项，因此可将此命令缩写为 Invoke-History 132、ihy 132 或 r 132。

Invoke-History -Id 132

示例 3：通过使用命令文本运行最新的命令

此示例运行会话历史记录中的最新的 Get-Process 命令。 键入 Id 参数的字符时，Invoke-History 将运行它发现的与该模式匹配的第一个命令（从最新命令开始）。

Invoke-History -Id get-pr

注意

模式匹配不区分大小写，但模式与行的开头匹配。

示例 4：从历史记录运行一系列命令

此示例运行命令 16 至 24。 由于只能列出一个 Id 值，因此该命令使用 ForEach-Object cmdlet 为每个 Id 值运行一次 Invoke-History 命令。

16..24 | ForEach-Object {Invoke-History -Id $_ }

示例 5

此示例运行历史记录中以命令 255 结束的七个命令（249 到 255）。 它使用 Get-History cmdlet 检索命令。 由于只能列出一个 Id 值，因此该命令使用 ForEach-Object cmdlet 为每个 Id 值运行一次 Invoke-History 命令。

Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定历史记录中命令的 Id。 你可以键入命令的 Id 号或命令的前几个字符。

如果键入字符，则 Invoke-History 首先与最新命令匹配。 如果省略此参数，则 Invoke-History 将运行最后一个或最新的命令。 若要查找命令的 Id 号，请使用 Get-History cmdlet。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

可以通过管道将历史记录 Id 传递给此 cmdlet。

输出

None

此 cmdlet 不返回其自己的输出，但它运行的命令可能会返回自己的输出。

备注

PowerShell 包含 Invoke-History 的以下别名：

  • 所有平台：
    • ihy
    • r

会话历史记录是在会话期间输入的命令的列表。 会话历史记录表示命令的执行顺序、状态以及开始和结束时间。 当你输入每个命令时，PowerShell 会将其添加到历史记录，以便对其进行重复使用。 有关会话历史记录的详细信息，请参阅 about_History。