Add-History

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

Add-History cmdlet 将条目添加到会话历史记录的末尾，即当前会话期间输入的命令列表。 可以使用 Get-History cmdlet 获取命令并将其传递给 Add-History，也可以将命令导出到 CSV 或 XML 文件，然后导入命令，并将导入的文件传递给 Add-History。 可以使用此 cmdlet 将特定命令添加到历史记录，或创建包含多个会话中的命令的单个历史记录文件。

# 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 文件中命令的对象添加到当前会话历史记录。

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 命令的格式设置为脚本块，括在大括号中，processForEach-Object cmdlet 参数要求。

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

此命令将历史记录中的前五个命令添加到历史记录列表的末尾。 它使用 Get-History cmdlet 获取以命令 5 结尾的五个命令。 管道操作者将它们传递给 Add-History cmdlet，该 cmdlet 将它们追加到当前历史记录中。

Add-History 命令不包含任何参数，但 Windows PowerShell 会将通过管道传递的对象与 Add-History 参数相关联。

$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 不会生成任何输出。

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

此命令将 History01.xml 文件中的命令添加到当前会话历史记录中。 它使用 InputObject 参数将命令的结果传递给 Add-History cmdlet。

首先执行的括号中的命令会将 History01.xml 文件导入 Windows PowerShell。 然后，Add-History cmdlet 将文件中的命令添加到会话历史记录中。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将 HistoryInfo 对象传递给此 cmdlet。

如果指定 PassThru 参数，此 cmdlet 将返回 HistoryInfo 对象。 否则，此 cmdlet 不会生成任何输出。

• 会话历史记录是会话期间与 ID 一起输入的命令的列表。 会话历史记录表示执行顺序、状态以及命令的开始和结束时间。 输入每个命令时，Windows PowerShell 会将其添加到历史记录中，以便重复使用它。 有关会话历史记录的详细信息，请参阅 about_History。

• 若要指定要添加到历史记录的命令，请使用 InputObject 参数。 Add-History 命令仅接受 HistoryInfo 对象，例如由 Get-History cmdlet 为每个命令返回的对象。 不能向其传递路径和文件名或命令列表。

• 可以使用 InputObject 参数将 HistoryInfo 对象的文件传递给 Add-History。 为此，请使用 Get-History 或 Export-Csv cmdlet 将 Export-Clixml 命令的结果导出到文件，然后使用 Import-Csv 或 Import-Clixml cmdlet 导入文件。 然后，可以将导入的 HistoryInfo 对象的文件通过管道或变量传递到 Add-History。 有关详细信息，请参阅示例。

• 传递给 cmdlet 的 Add-History 对象的文件必须包括类型信息、列标题以及 HistoryInfo 对象的所有属性。 如果打算将对象传递回 Add-History，请不要使用 cmdlet 的 Export-Csv 参数，也不会删除文件中的类型信息、列标题或任何字段。 若要修改会话历史记录，请将会话导出到 CSV 或 XML 文件、修改文件、导入文件，并使用 Add-History 将其追加到当前会话历史记录。