Get-History (Microsoft.PowerShell.Core)

Get-History

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

句法

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

描述

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

PowerShell 自动维护每个会话的历史记录。会话历史记录中的条目数由 $MaximumHistoryCount 首选项变量的值确定。从 Windows PowerShell 3.0 开始，默认值为 4096。默认情况下，历史文件保存在主目录中，但您可以将文件保存在任何位置。有关 PowerShell 中的历史记录功能的更多信息，请参阅 about_History。

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

示例

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

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

Get-History

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

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

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

示例 3：导出特定 ID 之前的历史记录条目

此示例获取以条目 7 结尾的五个最新历史记录条目。管道运算符将结果传递给 Export-Csv cmdlet，该 cmdlet 将历史记录格式化为逗号分隔的文本并将其保存在历史记录中。 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 cmdlet，后者显示每个历史记录条目的所有属性。这包括命令的 ID、状态以及开始和结束时间。

Get-History | Format-List -Property *

参数

-Count

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

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

整数32

1

None

False

False

False

-Id

指定会话历史记录中条目 ID 的数组。 Get-History 仅获取指定条目。如果您在命令中同时使用 Id 和 Count 参数，Get-History 会获取以 类型 ：

Int64[]

0

None

False

True

False

输入

Int64

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

输出

历史信息

此 cmdlet 为其获取的每个历史记录项返回一个历史记录对象。

笔记

PowerShell 包含以下 Get-History 别名：

• 所有平台：

  h

history

ghy

会话历史记录是会话期间输入的命令的列表。会话历史记录表示命令的运行顺序、状态以及开始和结束时间。当您输入每个命令时，PowerShell 会将其添加到历史记录中，以便您可以重复使用它。有关命令历史记录的更多信息，请参阅 about_History。

从 Windows PowerShell 3.0 开始，$MaximumHistoryCount 首选项变量的默认值为 4096。在 Windows PowerShell 2.0 中，默认值为 64。有关 $MaximumHistoryCount 变量的更多信息，请参阅 about_Preference_Variables。