删除命令历史记录中的条目。
语法
Clear-History [[-Id] <Int32[]>] [[-Count] <int>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>] Clear-History [[-Count] <int>] [-CommandLine <string[]>] [-Newest] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
Clear-History cmdlet 删除命令历史记录中的命令（即当前会话期间输入的命令的列表）。
如果不使用参数，Clear-History 会删除会话历史记录中的所有命令，但可以使用 Clear-History 的参数来删除选定的命令。
参数
-CommandLine <string[]>
删除具有指定文本字符串的命令。如果输入了多个字符串，则 Clear-History 会删除具有其中任意字符串的命令。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
true |
-Count <int>
从历史记录中最旧的条目开始，清除指定数量的历史记录条目。
如果在同一命令中使用了 Count 和 Id 参数，该 cmdlet 会自 Id 参数所指定的条目开始，清除 Count 参数所指定数量的条目。例如，如果 Count 和 Id 分别为 10 和 30，Clear-History 将清除 21 到 30 项（包括 21 和 30 项）。
如果在同一命令中使用了 Count 和 CommandLine 参数，则 Clear-History 会自 CommandLine 参数所指定的条目开始，清除 Count 参数所指定数量的条目。
|
是否为必需？ |
false |
|
位置？ |
2 |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Id <Int32[]>
删除具有指定历史记录 ID 的命令。
要查找命令的历史记录 ID，请使用 Get-History。
|
是否为必需？ |
false |
|
位置？ |
1 |
|
默认值 |
无 |
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Newest
删除历史记录中最新的条目。默认情况下，Clear-History 删除历史记录中最旧的条目。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
False |
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Confirm
在执行命令之前提示您进行确认。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-WhatIf
描述如果执行该命令会发生什么情况（无需实际执行该命令）。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
None 不能通过管道将对象传递给 Clear-History。 |
|
输出 |
None 此 cmdlet 将不产生任何输出。 |
说明
会话历史记录是会话期间输入的命令的列表。可以查看历史记录、添加和删除命令以及运行历史记录中的命令。有关详细信息，请参阅 about_History。
删除历史记录中的命令不会更改命令历史记录中剩余项的历史记录 ID。
示例 1
C:\PS>clear-history 说明 ----------- 删除会话历史记录中的所有命令。
示例 2
C:\PS>clear-history -id 23, 25 说明 ----------- 删除历史记录 ID 分别为 23 和 25 的命令。
示例 3
C:\PS>clear-history -command *help*, *command 说明 ----------- 删除包含“help”或以“command”结尾的命令。
示例 4
C:\PS>clear-history -count 10 -newest 说明 ----------- 删除历史记录中最新的 10 个命令。
示例 5
C:\PS>clear-history -id 10 -count 3 说明 ----------- 删除自 ID 为 10 的条目开始最旧的三个命令。
另请参阅