Clear-History
刪除命令歷程記錄中的項目。
語法
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 為 10 且 Id 為 30，Clear-History 就會清除項目 21 到 30 (含頭尾)。
如果在相同的命令中使用 Count 和 CommandLine 參數，Clear-History 會從 CommandLine 參數所指定的項目開始，清除由 Count 參數所指定的項目數目。
必要? |
false |
位置? |
2 |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Id <Int32[]>
刪除具有指定之歷程記錄識別碼的命令。
若要尋找命令的歷程記錄識別碼，請使用 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 所傳回的物件型別。
輸入 |
無 您無法經由管道將物件輸出至 Clear-History。 |
輸出 |
無 這個 Cmdlet 不會產生任何輸出。 |
附註
工作階段歷程記錄是在工作階段期間所輸入命令的清單。您可以檢視歷程記錄、新增及刪除命令，以及從歷程記錄執行命令。如需詳細資訊，請參閱 about_History。
刪除歷程記錄中的命令之後，命令歷程記錄中剩餘項目的歷程記錄識別碼並不會變更。
範例 1
C:\PS>clear-history
描述
-----------
刪除工作階段歷程記錄中的所有命令。
範例 2
C:\PS>clear-history -id 23, 25
描述
-----------
刪除歷程記錄識別碼為 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
描述
-----------
從識別碼為 10 的項目開始，刪除三個最舊的命令。