Add-History

Připojí položky k historii relace.

Syntax

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

Description

Rutina Add-History přidá položky na konec historie relace, tj. seznam příkazů zadaných během aktuální relace.

Historie relací je seznam příkazů zadaných během relace. Historie relací představuje pořadí provádění, stav a časy spuštění a ukončení příkazu. Při zadávání jednotlivých příkazů ho PowerShell přidá do historie, abyste ho mohli znovu použít. Další informace o historii relací najdete v tématu about_History.

Historie relací se spravuje odděleně od historie udržované modulem PSReadLine . Obě historie jsou k dispozici v relacích, ve kterých je načtena sada PSReadLine . Tato rutina funguje jenom s historií relace. Další informace najdete v about_PSReadLine.

Pomocí rutiny můžete Get-History získat příkazy a předat je Add-History, nebo můžete exportovat příkazy do souboru CSV nebo XML, pak importovat příkazy a předat importovaný soubor .Add-History Tuto rutinu můžete použít k přidání konkrétních příkazů do historie nebo k vytvoření jednoho souboru historie, který obsahuje příkazy z více než jedné relace.

Příklady

Příklad 1: Přidání příkazů do historie jiné relace

Tento příklad přidá příkazy zadané v jedné relaci PowerShellu do historie jiné relace PowerShellu.

Get-History | Export-Csv c:\testing\history.csv -IncludeTypeInformation
Import-Csv c:\testing\history.csv | Add-History

První příkaz získá objekty představující příkazy v historii a exportuje je do History.csv souboru.

Druhý příkaz je zadán na příkazovém řádku jiné relace. Import-Csv Pomocí rutiny importuje objekty v History.csv souboru. Operátor kanálu (|) předá objekty rutině Add-History , která přidá objekty představující příkazy v History.csv souboru do aktuální historie relací.

Příklad 2: Import a spuštění příkazů

Tento příklad naimportuje příkazy ze History.xml souboru, přidá je do aktuální historie relací a pak spustí příkazy v kombinované historii.

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

První příkaz použije rutinu Import-Clixml k importu historie příkazů, která byla exportována do History.xml souboru. Operátor kanálu předá příkazy rutině Add-History , která přidá příkazy do aktuální historie relací. Parametr PassThru předá objekty představující přidané příkazy z kanálu.

Příkaz pak použije rutinu ForEach-ObjectInvoke-History k použití příkazu na každý z příkazů v kombinované historii. Příkaz Invoke-History je formátovaný jako blok skriptu uzavřený do závorek ({}), jak to vyžaduje parametr Process rutiny ForEach-Object .

Příklad 3: Přidání příkazů v historii na konec historie

Tento příklad přidá prvních pět příkazů v historii na konec seznamu historie.

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

Rutina Get-History získá pět příkazů končících příkazem 5. Operátor kanálu je předá rutině Add-History , která je připojí k aktuální historii. Příkaz Add-History neobsahuje žádné parametry, ale PowerShell přidruží objekty předávané kanálem k parametru InputObject parametru Add-History.

Příklad 4: Přidání příkazů do souboru .csv do aktuální historie

Tento příklad přidá příkazy v History.csv souboru do aktuální historie relací.

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

Rutina Import-Csv naimportuje příkazy v History.csv souboru a uloží jeho obsah do proměnné $a.

Druhý příkaz použije rutinu Add-History k přidání příkazů z History.csv do aktuální historie relací. Pomocí parametru InputObject určuje $a proměnnou a parametr PassThru k vygenerování objektu, který se má zobrazit na příkazovém řádku. Bez parametru Add-HistoryPassThru rutina nevygeneruje žádný výstup.

Příklad 5: Přidání příkazů do souboru .xml do aktuální historie

Tento příklad přidá příkazy v history.xml souboru do aktuální historie relací.

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

Parametr InputObject předává výsledky příkazu v závorkách rutině Add-History . Příkaz v závorkách, který se spustí jako první, naimportuje history.xml soubor do PowerShellu. Rutina Add-History pak přidá příkazy v souboru do historie relací.

Parametry

-InputObject

Určuje pole položek, které se mají přidat do historie jako HistoryInfo objekt do historie relace. Tento parametr můžete použít k odeslání objektu HistoryInfo , jako jsou například objekty, které vrací Get-History, Import-Clixmlnebo Import-Csv rutiny, do Add-History.

Type:PSObject[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Passthru

Označuje, že tato rutina vrátí objekt HistoryInfo pro každou položku historie. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

HistoryInfo

Objekt HistoryInfo můžete do této rutiny převést.

Výstupy

None or Microsoft.PowerShell.Commands.HistoryInfo

Tato rutina vrátí objekt HistoryInfo , pokud zadáte parametr PassThru . Jinak tato rutina negeneruje žádný výstup.

Poznámky

Historie relací je seznam příkazů zadaných během relace společně s ID. Historie relací představuje pořadí provádění, stav a časy spuštění a ukončení příkazu. Při zadávání jednotlivých příkazů ho PowerShell přidá do historie, abyste ho mohli znovu použít. Další informace o historii relací najdete v tématu about_History.

Chcete-li zadat příkazy pro přidání do historie, použijte parametr InputObject . Příkaz Add-History přijímá pouze objekty HistoryInfo , například objekty vrácené pro každý příkaz rutinou Get-History . Nelze jej předat cestu a název souboru nebo seznam příkazů.

Pomocí parametru InputObject můžete předat soubor Objektů HistoryInfo do Add-History. Pokud to chcete udělat, exportujte výsledky Get-History příkazu do souboru pomocí Export-Csv rutiny nebo Export-Clixml rutiny a pak soubor naimportujte pomocí rutin Import-Csv nebo Import-Clixml rutin. Pak můžete předat soubor importovaných objektů HistoryInfo do Add-History kanálu nebo v proměnné. Další informace najdete v příkladech.

Soubor objektů HistoryInfo , které předáte rutině Add-History , musí obsahovat informace o typu, záhlaví sloupců a všechny vlastnosti HistoryInfo objektů. Pokud chcete předat objekty zpět Add-History, nepoužívejte parametr Export-CsvNoTypeInformation rutiny a neodstraňovat informace o typu, záhlaví sloupců ani žádná pole v souboru.

Pokud chcete upravit historii relací, exportujte relaci do souboru CSV nebo XML, upravte soubor, importujte soubor a použijte Add-History ho k jeho připojení k aktuální historii relací.