Invoke-History

模組:
Microsoft.PowerShell.Core Module

執行會話歷史中的指令。

語法

Default (預設值) 

Invoke-History
    [[-Id] <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Invoke-History指令檔會從會話歷史中執行指令。 你可以將代表指令的物件從 Get-History 傳到 Invoke-History，或者你可以用 指令的 ID 編號來識別目前歷史中的指令。 要找到指令的識別碼，請使用 Get-History cmdlet。

會話歷程記錄會與 PSReadLine 模組所維護的歷程記錄分開管理。 這兩個歷程記錄可在載入 PSReadLine 的會話中使用。 此 Cmdlet 僅適用於會話歷程記錄。 如需詳細資訊，請參閱 about_PSReadLine。

範例

範例 1：執行歷史上最新的指令

此範例執行會話歷史中最後一個或最近的指令。 你可以將此指令縮寫為 r，即 的別名 Invoke-History。

Invoke-History

範例 2：執行具有指定 ID 的指令

這個範例 在 會話歷史中執行該指令，ID 為 132。 由於 Id 參數的名稱是可選的，你可以將此指令縮寫為： Invoke-History 132、、 ihy 132或 r 132。

Invoke-History -Id 132

範例 3：使用命令文字執行最新的指令

此範例執行會話歷史中最新的 Get-Process 指令。 當你輸入 Id 參數的字元時，執行 Invoke-History 第一個找到符合模式的指令，從最近的指令開始。

Invoke-History -Id get-pr

Note

模式匹配不區分大小寫，但模式與行首相符。

範例 4：執行一連串歷史中的指令

這個範例執行指令 16 到 24。 因為你只能列出一個 id 值，指令會用 ForEach-Object cmdlet 對每個 id 值執行一次指令Invoke-History。

16..24 | ForEach-Object {Invoke-History -Id $_ }

範例 5

此範例執行歷史中以指令 255（249 至 255）結尾的七個指令。 它使用 Get-History cmdlet 來取得指令。 因為你只能列出一個 id 值，指令會用 ForEach-Object cmdlet 對每個 id 值執行Invoke-History一次指令。

Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Id

指定歷史中指令的 ID 。 你可以輸入指令的 ID 號碼或指令的前幾個字元。

如果你輸入 characters， Invoke-History 會先匹配最近的指令。 如果你省略了這個參數，就會 Invoke-History 執行最後一個或最近的指令。 要找到指令的 ID 編號，請使用 Get-History cmdlet。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

你可以把歷史 ID 輸入這個 cmdlet。

輸出

None

此 cmdlet 不會回傳自身輸出，但執行的指令可能會回傳自己的輸出。

備註

PowerShell 包含下列 Invoke-History的別名：

  • 所有平臺：
    • ihy
    • r

工作階段歷程記錄是工作階段期間輸入的命令清單。 會話歷程記錄代表命令的執行順序、狀態和開始和結束時間。 當您輸入每個命令時，PowerShell 會將它新增至歷程記錄，以便重複使用它。 如需了解有關工作階段歷程更多的詳細資料，請參閱 about_History。