Get-History
取得目前工作階段期間輸入的命令清單。
Syntax
Get-History
[[-Id] <Int64[]>]
[[-Count] <Int32>]
[<CommonParameters>]
Description
Get-History Cmdlet 會取得工作階段歷程記錄,也就是目前的工作階段期間輸入的命令的清單。
PowerShell 會自動維護每個工作階段的歷程記錄。 工作階段歷程記錄中的項目數是由 $MaximumHistoryCount 喜好設定變數的值所決定。 自 Windows PowerShell 3.0 起,預設值是 4096。
您可以將工作階段歷程記錄儲存為 XML 或 CSV 格式。 根據預設,歷程記錄檔案會儲存在主目錄中,但是您可以將檔案儲存在任何位置。
如需PowerShell中歷程記錄功能的詳細資訊,請參閱 Microsoft Docs中的about_History。
範例
範例 1:取得會話歷程記錄
Get-History
此命令會取得工作階段歷程記錄中的項目。 默認顯示會顯示每個命令及其識別碼,表示它們執行的順序。
範例 2:取得包含字串的專案
Get-History | Where-Object {$_.CommandLine -like "*Service*"}
此命令會取得包含字串服務的命令歷程記錄中的專案。 第一個命令會取得工作階段歷程記錄中所有項目。 管線運算子 (|) 會將結果傳遞至 Where-Object Cmdlet,它只會選取包含服務的命令。
範例 3:最多匯出七個專案
Get-History -ID 7 -Count 5 | Export-Csv History.csv
此命令會取得結尾是項目 7 的五個最新歷程記錄項目。 管線運算符會將結果傳遞至 Export-Csv Cmdlet,此 Cmdlet 會將歷程記錄格式化為逗號分隔文字,並將它儲存在 History.csv 檔案中。 檔案包含當您將歷程記錄格式化為清單時所顯示的數據。 這包括命令的狀態和開始和結束時間。
範例 4:顯示最新的命令
Get-History -Count 1
此命令會取得命令歷程記錄中的最後一個命令。 最後一個命令是最近輸入的命令。 此命令使用 Count 參數只顯示一個命令。 根據預設,Get-History 會取得最新的命令。 此命令可以縮寫成 "h -c 1",而且相當於按下向上鍵。
範例 5:顯示歷程記錄中專案的所有屬性
Get-History | Format-List -Property *
此命令會顯示工作階段歷程記錄中的所有項目屬性。 管線運算符會將 Get-History 命令的結果傳遞至 Format-List Cmdlet,以顯示每個記錄專案的所有屬性。 這包括命令的標識碼、狀態和開始和結束時間。
參數
-Count
指定這個 Cmdlet 取得的最新歷程記錄項目數目。 根據預設, Get-History 會 取得會話歷程記錄中的所有專案。 如果您同時在命令中使用 Count 和 Id 參數,畫面結尾會是 Id 參數所指定的命令。
在 Windows PowerShell 2.0 中,根據預設,Get-History 會取得 32 個最新項目。
Type: | Int32 |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定工作階段歷程記錄中項目識別碼的陣列。 Get-History 只會取得指定的專案。 如果您在命令中同時使用 Id 和Count 參數,Get-History 會取得結尾是 Id 參數指定之項目的最新項目。
Type: | Int64[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
Int64
您可以使用管線將歷程記錄標識碼傳送至此 Cmdlet。
輸出
這個 Cmdlet 會針對它取得的每個歷程記錄專案傳回歷程記錄物件。
備註
- 工作階段歷程記錄是工作階段期間輸入的命令清單。 會話歷程記錄代表命令的執行順序、狀態和開始和結束時間。 當您輸入每個命令時,PowerShell 會將它新增至歷程記錄,以便重複使用。 如需命令歷程記錄的詳細資訊,請參閱 about_History。
- 從 Windows PowerShell 3.0 開始,喜好設定變數的
$MaximumHistoryCount
預設值為 4096。 在 Windows PowerShell 2.0 中,預設值是 64。 如需變數的詳細資訊$MaximumHistoryCount
,請參閱 about_Preference_Variables。