刪除命令歷程記錄中的項目。

語法

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 所傳回的物件型別。

輸入

None

您無法經由管道將物件輸出至 Clear-History。

輸出

None

這個 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 的項目開始,刪除三個最舊的命令。






請參閱




目錄