Add-History

Bejegyzéseket fűz a munkamenet előzményeihez.

Syntax

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

Description

A Add-History parancsmag bejegyzéseket ad hozzá a munkamenet-előzmények végéhez, vagyis az aktuális munkamenet során megadott parancsok listájához.

A munkamenet előzményei a munkamenet során megadott parancsok listája. A munkamenet előzményei a végrehajtás sorrendjét, az állapotot, valamint a parancs kezdő és befejező időpontjai. Az egyes parancsok beírása során a PowerShell hozzáadja az előzményekhez, hogy újra felhasználhassa. A munkamenet előzményeiről további információt a about_History című témakörben talál.

A munkamenet-előzményeket a PSReadLine modul által kezelt előzményektől elkülönítve kezeli a rendszer. Mindkét előzmények olyan munkamenetekben érhetők el, ahol a PSReadLine be van töltve. Ez a parancsmag csak a munkamenet-előzményekkel működik. További információ: about_PSReadLine.

A parancsmaggal Get-History lekérheti és átadhatja a Add-Historyparancsokat, vagy exportálhatja a parancsokat EGY CSV- vagy XML-fájlba, majd importálhatja a parancsokat, és átadhatja az importált fájlt a következőnek Add-History: . Ezzel a parancsmaggal adott parancsokat adhat hozzá az előzményekhez, vagy létrehozhat egyetlen, több munkamenetből származó parancsokat tartalmazó előzményfájlt.

Példák

1. példa: Parancsok hozzáadása egy másik munkamenet előzményeihez

Ez a példa hozzáadja az egyik PowerShell-munkamenetben beírt parancsokat egy másik PowerShell-munkamenet előzményeihez.

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

Az első parancs lekéri az előzmények parancsait képviselő objektumokat, és exportálja őket a History.csv fájlba.

A második parancs egy másik munkamenet parancssorában van begépelve. A parancsmaggal Import-Csv importálja a fájlban lévő History.csv objektumokat. A folyamatkezelő (|) átadja az objektumokat a Add-History parancsmagnak, amely hozzáadja a fájl parancsait History.csv képviselő objektumokat az aktuális munkamenet-előzményekhez.

2. példa: Parancsok importálása és futtatása

Ez a példa parancsokat importál a History.xml fájlból, hozzáadja őket az aktuális munkamenet-előzményekhez, majd futtatja a parancsokat az egyesített előzményekben.

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

Az első parancs a Import-Clixml parancsmaggal importálja a fájlba History.xml exportált parancselőzményeket. A folyamatkezelő átadja a parancsokat a Add-History parancsmagnak, amely hozzáadja a parancsokat az aktuális munkamenet-előzményekhez. A PassThru paraméter átadja a hozzáadott parancsokat képviselő objektumokat a folyamaton.

A parancs ezután a ForEach-Object parancsmag használatával alkalmazza a Invoke-History parancsot az egyesített előzményekben szereplő összes parancsra. A Invoke-History parancs szkriptblokkként van formázva, kapcsos zárójelek között,{} a parancsmag Folyamat paraméterének ForEach-Object megfelelően.

3. példa: Az előzmények parancsainak hozzáadása az előzmények végéhez

Ez a példa az előzmények első öt parancsát adja hozzá az előzmények listájának végéhez.

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

A Get-History parancsmag az 5. paranccsal végződő öt parancsot kapja meg. A folyamatkezelő továbbítja őket a Add-History parancsmagnak, amely hozzáfűzi őket az aktuális előzményekhez. A Add-History parancs nem tartalmaz paramétereket, de a PowerShell társítja a folyamaton áthaladó objektumokat a következő InputObject paraméterével Add-History: .

4. példa: Parancsok hozzáadása .csv fájlban az aktuális előzményekhez

Ez a példa hozzáadja a History.csv fájlban található parancsokat az aktuális munkamenet-előzményekhez.

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

A Import-Csv parancsmag importálja a History.csv fájl parancsait, és a tartalmát a változóban $atárolja.

A második parancs a Add-History parancsmag használatával adja hozzá a parancsokat History.csv az aktuális munkamenet-előzményekhez. Az InputObject paraméter használatával adja meg a $a változót és a PassThru paramétert a parancssorban megjelenítendő objektum létrehozásához. A PassThru paraméter nélkül a Add-History parancsmag nem hoz létre kimenetet.

5. példa: Parancsok hozzáadása .xml fájlban az aktuális előzményekhez

Ez a példa hozzáadja a fájlban található history.xml parancsokat az aktuális munkamenet-előzményekhez.

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

Az InputObject paraméter zárójelben továbbítja a parancs eredményeit a Add-History parancsmagnak. Az elsőként végrehajtott zárójelben lévő parancs importálja a fájlt a history.xml PowerShellbe. A Add-History parancsmag ezután hozzáadja a fájlban lévő parancsokat a munkamenet-előzményekhez.

Paraméterek

-InputObject

A munkamenet előzményeihez HistoryInfo objektumként hozzáadandó bejegyzések tömbje. Ezzel a paraméterrel elküldhet egy HistoryInfo objektumot, például a parancsmagok Import-ClixmlImport-Csv által Get-Historyvisszaadott objektumokatAdd-History.

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

-Passthru

Azt jelzi, hogy ez a parancsmag minden előzménybejegyzéshez egy HistoryInfo objektumot ad vissza. Alapértelmezés szerint ez a parancsmag nem ad kimenetet.

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

Bevitelek

HistoryInfo

Ehhez a parancsmaghoz egy HistoryInfo objektumot is átirányíthat.

Kimenetek

None or Microsoft.PowerShell.Commands.HistoryInfo

Ez a parancsmag egy HistoryInfo objektumot ad vissza, ha megadja a PassThru paramétert . Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

A munkamenet előzményei a munkamenet során megadott parancsok és az azonosító listája. A munkamenet előzményei a végrehajtás sorrendjét, az állapotot, valamint a parancs kezdő és befejező időpontjai. Az egyes parancsok beírása során a PowerShell hozzáadja az előzményekhez, hogy újra felhasználhassa. A munkamenet előzményeiről további információt a about_History című témakörben talál.

Az előzményekhez hozzáadni kívánt parancsok megadásához használja az InputObject paramétert . A Add-History parancs csak HistoryInfo objektumokat fogad el, például a parancsmag által visszaadott objektumokat.Get-History Nem adhat meg elérési utat és fájlnevet vagy parancslistát.

Az InputObject paraméterrel továbbíthatja a HistoryInfo objektumokat a fájlnak Add-History. Ehhez exportálja egy Get-History parancs eredményét egy fájlba a vagy Export-Clixml a Export-Csv parancsmag használatával, majd importálja a fájlt a parancsmagok vagy Import-Clixml parancsmagok Import-Csv használatával. Ezután átadhatja az importált HistoryInfo-objektumok fájlját Add-History egy folyamaton vagy egy változón keresztül. További információt a példákban talál.

A parancsmagnak Add-History átadott HistoryInfo objektumok fájljának tartalmaznia kell a típusadatokat, az oszlopfejléceket és a HistoryInfo objektumok összes tulajdonságát. Ha vissza Add-Historyszeretné adni az objektumokat, ne használja a parancsmag NoTypeInformation paraméterét Export-Csv , és ne törölje a fájlban lévő típusadatokat, oszlopfejléceket vagy mezőket.

A munkamenet előzményeinek módosításához exportálja a munkamenetet EGY CSV- vagy XML-fájlba, módosítsa a fájlt, importálja a fájlt, és hozzáfűzi Add-History az aktuális munkamenet-előzményekhez.