通过

Get-History

模块:
Microsoft.PowerShell.Core Module

获取当前会话期间输入的命令的列表。

语法

Default （默认值） 

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

说明

Get-History cmdlet 获取会话历史记录，即当前会话期间输入的命令列表。

PowerShell 会自动维护每个会话的历史记录。 会话历史记录中的条目数由$MaximumHistoryCount首选项变量的值确定。 从 Windows PowerShell 3.0 开始，默认值为 4096。

可以使用 XML 或 CSV 格式保存会话历史记录。 默认情况下，历史记录文件保存在主目录中，但你可以在任何位置保存该文件。

有关 PowerShell 中的历史记录功能的详细信息，请参阅 Microsoft Docs 中的 about_History。

示例

示例 1：获取会话历史记录

Get-History

此命令获取会话历史记录中的条目。 默认显示显示每个命令及其 ID，指示其运行顺序。

示例 2：获取包含字符串的条目

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

此命令获取包含字符串服务的命令历史记录中的条目。 第一个命令获取会话历史记录中的所有条目。 管道运算符 （|） 将结果传递给 Where-Object cmdlet，该 cmdlet 仅选择包含服务的命令。

示例 3：最多导出七个条目

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

此命令获取以条目 7 结尾的五个最新历史记录条目。 管道运算符将结果传递给 Export-Csv cmdlet，该 cmdlet 将历史记录格式化为逗号分隔文本，并将其保存在 History.csv 文件中。 该文件包括将历史记录格式化为列表时显示的数据。 这包括命令的状态和开始和结束时间。

示例 4：显示最新的命令

Get-History -Count 1

此命令获取命令历史记录中的最后一个命令。 最后一个命令是最近输入的命令。 此命令使用 Count 参数仅显示一个命令。 默认情况下，Get-History 获取最新的命令。 此命令可以缩写为“h -c 1”，相当于按向上键。

示例 5：显示历史记录中条目的所有属性

Get-History | Format-List -Property *

此命令显示会话历史记录中条目的所有属性。 管道运算符将 Get-History 命令的结果传递给 Format-List cmdlet，该 cmdlet 显示每个历史记录项的所有属性。 这包括命令的 ID、状态和开始和结束时间。

参数

-Count

指定此 cmdlet 获取的最新历史记录条目数。 默认情况下，Get-History 获取会话历史记录中的所有条目。 如果在命令中使用 Count 和 Id 参数，则显示以由 Id 参数指定的命令结束。

在 Windows PowerShell 2.0 中，默认情况下，Get-History 获取 32 个最新条目。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Id

指定会话历史记录中条目 ID 的数组。 Get-History 仅获取指定的条目。 如果在命令中使用 Id 和 Count 参数，Get-History 获取以 Id 参数指定的条目结尾的最新条目。

参数属性

类型:

Int64[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Int64

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

输出

HistoryInfo

此 cmdlet 将返回它所获取的每个历史记录项的历史记录对象。

备注

  • 会话历史记录是会话期间输入的命令的列表。 会话历史记录表示命令的运行顺序、状态和开始和结束时间。 输入每个命令时，PowerShell 会将其添加到历史记录中，以便重复使用它。 有关命令历史记录的详细信息，请参阅 about_History。
  • 从 Windows PowerShell 3.0 开始，$MaximumHistoryCount 首选项变量的默认值为 4096。 在 Windows PowerShell 2.0 中，默认值为 64。 有关 $MaximumHistoryCount 变量的详细信息，请参阅 about_Preference_Variables。