共用方式為

Add-History

  • 參考
模組:
Microsoft.PowerShell.Core

將專案附加至會話歷程記錄。

語法

Add-History
   [[-InputObject] <PSObject[]>]
   [-Passthru]
   [<CommonParameters>]

Description

Add-History Cmdlet 會將專案新增至工作階段歷程記錄的結尾，也就是在目前工作階段期間輸入的命令清單。 您可以使用 Get-History Cmdlet 來取得命令，並將其傳遞至 Add-History，或者您可以將命令匯出至 CSV 或 XML 檔案，然後匯入命令，然後將匯入的檔案傳遞至 Add-History。 您可以使用此 Cmdlet 將特定命令新增至歷程記錄，或建立包含來自多個會話之命令的單一歷程記錄檔。

範例

範例 1：將命令新增至不同會話的歷程記錄

# Get objects representing the commands in the history and exports them to the History.csv file.
Get-History | Export-Csv c:\testing\history.csv
# Use the `Import-Csv` cmdlet to import the objects in the History.csv file.
Import-Csv history.csv | Add-History

這些命令會將一個 Windows PowerShell 會話中輸入的命令新增至不同 Windows PowerShell 會話的歷程記錄。 第二個命令是在不同會話的命令行輸入。

管線運算子 | 會將 對象傳遞至 Add-History Cmdlet，此 Cmdlet 會將代表 History.csv 檔案中命令的物件新增至目前的會話歷程記錄。

範例 2：匯入和執行命令

Import-Clixml c:\temp\history.xml | Add-History -Passthru | ForEach-Object -Process {Invoke-History}

此命令會從 History.xml 檔案匯入命令、將它們新增至目前的會話歷程記錄，然後在合併的歷程記錄中執行命令。

Import-Clixml Cmdlet 會匯入導出至 History.xml 檔案的命令歷程記錄。

管線運算符會將命令傳遞至 Add-History Cmdlet，此 Cmdlet 會將命令新增至目前的會話歷程記錄。

PassThru 參數會傳遞代表管線中新增命令的物件。

ForEach-Object Cmdlet，將 Invoke-History 命令套用至合併歷程記錄中的每個命令。

Invoke-History 命令會格式化為以大括弧括住的腳本區塊，如 ForEach-Object Cmdlet 的 Process 參數所要求。

範例 3：將歷程記錄中的命令新增至歷程記錄結尾

Get-History -Id 5 -Count 5 | Add-History

此命令會將歷程記錄中的前五個命令新增至歷程記錄清單的結尾。 它會使用 Get-History Cmdlet 來取得結束於命令 5 的五個命令。 管線運算符會將它們傳遞給 Add-History Cmdlet，以將它們附加至目前的歷程記錄。

Add-History 命令不包含任何參數，但 Windows PowerShell 會將透過管線傳遞的物件與 Add-History的 InputObject 參數產生關聯。

範例 4：將 .csv 檔案中的命令新增至目前的歷程記錄

$a = Import-Csv c:\testing\history.csv
Add-History -InputObject $a -PassThru

這些命令會將 History.csv 檔案中的命令新增至目前的會話歷程記錄。

第一個命令會使用 Import-Csv Cmdlet 匯入 History.csv 檔案中的命令，並將其內容儲存在變數 $a中。

第二個命令會使用 Add-History Cmdlet，將命令從 History.csv 新增至目前的會話歷程記錄。

它會使用 InputObject 參數來指定 $a 變數和 PassThru 參數，以產生要顯示在命令行的物件。 如果沒有 PassThru 參數，Add-History Cmdlet 不會產生任何輸出。

範例 5：將 .xml 檔案中的命令新增至目前的歷程記錄

Add-History -InputObject (Import-Clixml c:\temp\history01.xml)

此命令會將 History01.xml 檔案中的命令新增至目前的會話歷程記錄。 它會使用 InputObject 參數，將命令的結果以括號傳遞至 Add-History Cmdlet。

先執行括弧中的 命令會將 History01.xml 檔案匯入 Windows PowerShell。 Add-History Cmdlet 接著會將檔案中的命令新增至會話歷程記錄。

參數

-InputObject

指定要新增至歷程記錄的項目陣列，做為 HistoryInfo 物件新增至工作階段歷程記錄。 您可以使用此參數來提交 HistoryInfo 物件，例如 Get-History、Import-Clixml或 Import-Csv Cmdlet 所傳回的物件，以 Add-History。

類型:PSObject[]
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Passthru

指出此 Cmdlet 會針對每個記錄專案傳回記錄物件。 根據預設，此 Cmdlet 不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

HistoryInfo

您可以使用管線將 HistoryInfo 物件傳送至此 Cmdlet。

輸出

None or Microsoft.PowerShell.Commands.HistoryInfo

如果您 指定 passThru 參數，此 Cmdlet 會傳回 HistoryInfo 物件。 否則，此 Cmdlet 不會產生任何輸出。

備註

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

  • 若要指定要新增至歷程記錄的命令，請使用 InputObject 參數。 Add-History 命令只接受 HistoryInfo 物件，例如 Get-History Cmdlet 針對每個命令傳回的物件。 您無法將路徑和檔案名或命令清單傳遞。

  • 您可以使用 InputObject 參數，將 HistoryInfo 物件的檔案傳遞至 Add-History。 若要這樣做，請使用 Export-Csv 或 Export-Clixml Cmdlet 將 Get-History 命令的結果匯出至檔案，然後使用 Import-Csv 或 Import-Clixml Cmdlet 匯入檔案。 然後，您可以將匯入 HistoryInfo 的檔案傳遞 物件，以透過管線或變數 Add-History。 如需詳細資訊，請參閱範例。

  • HistoryInfo 的檔案 傳遞至 Add-History Cmdlet 的對象必須包含類型資訊、數據行標題，以及 HistoryInfo 物件的所有屬性。 如果您想要將對象傳回 Add-History，請勿使用 Export-Csv Cmdlet 的 NoTypeInformation 參數，也不會刪除檔案中的類型資訊、數據行標題或任何字段。 若要修改會話歷程記錄，請將會話導出至 CSV 或 XML 檔案、修改檔案、匯入檔案，並使用 Add-History 將它附加至目前的工作階段歷程記錄。