Get-History 帮助信息

如下说明是翻译PowerShell中: help Get-History 产生的帮助信息.

译者: Edengundam(马涛)

 

Get-History

 

大纲

取得在当前会话中输入命令的列表.

 

语法

Get-History [[-id] <long[]>] [[-count] <int>] [<CommonParameters>]

 

详细描述

Get-History cmdlet取得会话历史, 它是当前会话中输入命令的列表. Windows PowerShell为每个会话自动维护历史信息. 你可以将会话历史以XML或者CSV格式保存. 默认情况下, 历史文件保存在主目录下($home), 但是你可以将其存储在任何位置.

 

参数

 

-id <long[]>

指定会话历史中命令的ID号. Get-History取得指定的命令. 如果你同时使用Id和Count, Get-History将会取得到Id参数指定的命令号的最近输入命令.

 

强制参数?	false
参数位置?	1
默认值	当前ID之前的所有ID
允许从管道绑定输入?	true (根据值)
允许通配符扩展?	false

 

-count <int>

显示指定数量的最近历史项. 默认值为32. 如果你在一个命令中同时使用Count和Id, 则显示将结束在指定的Id命令处.

 

强制参数?	false
参数位置?	2
默认值	32
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

None

 

返回类型

HistoryInfo对象

 

注意

 

更多信息, 输入"Get-Help Get-History -detailed".需要技术信息, 输入 "Get-Help Get-History -full".

 

会话历史是在会话期间输入的命令以及它们对应的ID号列表, ID号用来表示命令执行的顺序, 状态和结束时间. 随着你每次输入命令, Windows PowerShell将它们添加到历史中, 使您之后可以重新使用它.

 

默认情况下, 历史可以记录64条命令, 你可以通过修改变量$MaximumHistoryCount的值来修改记录命令的数量. 当历史信息记录满时, 将会删除最久的命令来记录新的命令.

 

你只能通过结束Windows PowerShell会话来清空会话历史.

 

当命令执行完毕时才会被添加到历史中, 而不是在输入时. 如果命令执行时间较长, 或者是在嵌套的提示符(只有在退出嵌套提示符下才算完成)下执行, 他们可能会与实际输入的顺序不一致.

 

除了可以使用Get-History命令, 你可以通过使用键盘的上下箭头在历史中导航. 关于会话历史的更多信息, 键入"get-help about_history".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

你可以使用Get-History的内建别名"h", "history"和"ghy".需要更多信息, 查看 About_Alias.

 

例1

 

C:/PS>get-history

 

此命令取得最近提交的32个命令. 默认显示命令及其ID号, 后者指示了执行的顺序.

 

例2

 

C:/PS>get-history | where-object {$_.commandLine -like "*service*"}

 

此命令取得历史中包含单词"service"的历史项. 第一个命令取得会话历史中最近输入的32个命令. 管道运算符(|)将结果发送给Where-Object cmdlet, 后者只选择包含"service"单词的命令.

 

例3

 

C:/PS>get-history -id 7 -count 5 | export-csv history.csv

  

此命令取得以7结尾的最后输入的5个历史项. 管道符(|)将结果发送给Export-Csv cmdlet, 后者将历史格式化为CSV文件并将其保存为History.csv文件. 文件保存了当你以列表形式显示历史时的数据, 包含了状态, 命令开始和结束时间.

 

例4

 

C:/PS>get-history -count 1

 

此命令取得历史中最后(最近输入的)的命令. 它使用了参数Count来显示一个命令. 默认情况下, Get-History显示最近输入的命令. 此命令可以缩写为"h -c 1", 也等价于按一下键盘的上箭头.

 

例5

 

C:/PS>get-history -count $MaximumHistoryCount

 

此命令显示所有保存的会话历史. 默认情况下, $MaximumHistoryCount等于64, 所以此命令可以简写为"h -c 64".

 

例6

 

C:/PS>get-history | format-list

 

此命令显示会话历史中项的所有属性. 管道符号(|)将结果发送给Format-List cmdlet, 后者将会显示每个历史项的所有属性, 包括了ID, 状态以及命令的开始和结束时间.

 

相关链接

Invoke-History

Add-History