Add-History

  • Referencia
Modul:
Microsoft.PowerShell.Core

Hozzáfűzi a bejegyzéseket a munkamenet-előzményekhez.

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 záró idejét jelölik. Az egyes parancsok megadásakor a PowerShell hozzáadja az előzményekhez, hogy újra felhasználhassa. A munkamenetek előzményeiről további információt a about_History talál.

A munkamenet-előzményeket a PSReadLine modul által fenntartott előzményektől elkülönítve kezeli a rendszer. Mindkét előzmények olyan munkamenetekben érhetők el, ahol a PSReadLine betöltődik. 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 Add-History. Ezzel a parancsmaggal adott parancsokat adhat hozzá az előzményekhez, vagy létrehozhat egyetlen előzményfájlt, amely több munkamenetből származó parancsokat is tartalmaz.

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 -Path C:\testing\history.csv -IncludeTypeInformation
Import-Csv -Path 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 importálja a parancsokat 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 -Path 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 hozzáadja az előzmények első öt parancsát 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ő átadja ő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 a folyamaton áthaladó objektumokat az InputObject paraméterrel társítja 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 lévő parancsokat az aktuális munkamenet-előzményekhez.

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

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

A második parancs a Add-History parancsmaggal 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 history.xml fájlban lévő parancsokat az aktuális munkamenet-előzményekhez.

Add-History -InputObject (Import-Clixml -Path 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ényeihez.

Paraméterek

-InputObject

Olyan bejegyzéstömböt ad meg, amely a munkamenetelőzmények Előzményinfo objektumaként hozzáadandó előzményekhez. 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
Required:False
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. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

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

Bevitelek

HistoryInfo

Ehhez a parancsmaghoz egy HistoryInfo objektumot is csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

HistoryInfo

A PassThru paraméter használatakor ez a parancsmag egy HistoryInfo objektumot ad vissza.

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 záró idejét jelölik. Az egyes parancsok megadásakor a PowerShell hozzáadja az előzményekhez, hogy újra felhasználhassa. A munkamenetek előzményeiről további információt a about_History 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íthat egy HistoryInfo objektumfájlt a fájlnakAdd-History. Ehhez exportálja egy parancs eredményét egy Get-History fájlba a parancsmag vagy Export-Clixml parancsmag Export-Csv 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-objektumokAdd-History fájlját egy folyamaton vagy egy változón keresztül. További információkért lásd a példákat.

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ájl típusadatait, oszlopfejléceit vagy mezőit.

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.