Freigeben über

Add-History

Modul:
Microsoft.PowerShell.Core Module

Fügt Einträge an den Sitzungsverlauf an.

Syntax

Default (Standard) 

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

Beschreibung

Das Cmdlet Add-History fügt dem Ende des Sitzungsverlaufs Einträge hinzu, d. h. die Liste der Befehle, die während der aktuellen Sitzung eingegeben wurden. Sie können das Cmdlet Get-History verwenden, um die Befehle abzurufen und an Add-Historyzu übergeben, oder Sie können die Befehle in eine CSV- oder XML-Datei exportieren, dann die Befehle importieren und die importierte Datei an Add-Historyübergeben. Mit diesem Cmdlet können Sie dem Verlauf bestimmte Befehle hinzufügen oder eine einzelne Verlaufsdatei erstellen, die Befehle aus mehreren Sitzungen enthält.

Beispiele

Beispiel 1: Hinzufügen von Befehlen zum Verlauf einer anderen Sitzung

# 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

Diese Befehle fügen die in einer Windows PowerShell-Sitzung eingegebenen Befehle zum Verlauf einer anderen Windows PowerShell-Sitzung hinzu. Der zweite Befehl wird an der Befehlszeile einer anderen Sitzung eingegeben.

Der Pipelineoperator | übergibt die Objekte an das Cmdlet Add-History, wodurch die Objekte hinzugefügt werden, die die Befehle in der History.csv Datei dem aktuellen Sitzungsverlauf darstellen.

Beispiel 2: Importieren und Ausführen von Befehlen

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

Dieser Befehl importiert Befehle aus der datei History.xml, fügt sie dem aktuellen Sitzungsverlauf hinzu und führt dann die Befehle im kombinierten Verlauf aus.

Das cmdlet Import-Clixml importiert einen Befehlsverlauf, der in die History.xml Datei exportiert wurde.

Der Pipelineoperator übergibt die Befehle an das Cmdlet Add-History, wodurch die Befehle zum aktuellen Sitzungsverlauf hinzugefügt werden.

Der Parameter PassThru gibt die Objekte, die die hinzugefügten Befehle darstellen, über die Pipeline weiter.

Das cmdlet ForEach-Object, um den befehl Invoke-History auf jeden der Befehle im kombinierten Verlauf zu anwenden.

Der befehl Invoke-History ist als Skriptblock formatiert, der in geschweifte Klammern eingeschlossen ist, wie vom parameter Process des Cmdlets ForEach-Object erforderlich.

Beispiel 3: Hinzufügen der ersten fünf Befehle im Verlauf am Ende der Verlaufsliste.

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

Mit diesem Befehl werden die ersten fünf Befehle im Verlauf am Ende der Verlaufsliste hinzugefügt. Es verwendet das Cmdlet Get-History, um die fünf Befehle abzurufen, die auf Befehl 5 enden. Der Pipeline-Operator leitet sie weiter an das Add-History cmdlet, das sie auf den aktuellen Verlauf anwendet.

Der befehl Add-History enthält keine Parameter, aber Windows PowerShell ordnet die Objekte, die über die Pipeline übergeben werden, dem parameter InputObject parameter von Add-Historyzu.

Beispiel 4: Befehle in einer .csv-Datei zum aktuellen Verlauf hinzufügen

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

Diese Befehle fügen die Befehle in der History.csv Datei zum aktuellen Sitzungsverlauf hinzu.

Der erste Befehl verwendet das Cmdlet Import-Csv, um die Befehle in der History.csv Datei zu importieren und deren Inhalt in der Variablen $azu speichern.

Der zweite Befehl verwendet das Cmdlet Add-History, um die Befehle aus History.csv zum aktuellen Sitzungsverlauf hinzuzufügen.

Es verwendet den InputObject Parameter, um die $a Variable und den PassThru Parameter anzugeben, um ein Objekt zu generieren, das in der Befehlszeile angezeigt werden soll. Ohne den parameter PassThru generiert das cmdlet Add-History keine Ausgabe.

Beispiel 5: Hinzufügen von Befehlen in einer .xml-Datei zum aktuellen Verlauf

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

Mit diesem Befehl werden die Befehle in der History01.xml Datei zum aktuellen Sitzungsverlauf hinzugefügt. Er verwendet den parameter InputObject, um die Ergebnisse des Befehls in Klammern an das Cmdlet Add-History zu übergeben.

Der Befehl in Klammern, der zuerst ausgeführt wird, importiert die History01.xml Datei in Windows PowerShell. Das cmdlet Add-History fügt dann die Befehle in der Datei zum Sitzungsverlauf hinzu.

Parameter

-InputObject

Gibt ein Array von Einträgen an, die dem Verlauf als HistoryInfo-Objekt zum Sitzungsverlauf hinzugefügt werden sollen. Sie können diesen Parameter verwenden, um ein HistoryInfo-objekt zu übermitteln, z. B. die objekte, die vom Get-History, Import-Clixmloder Import-Csv Cmdlets zurückgegeben werden, an Add-History.

Parametereigenschaften

Typ:

PSObject[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Passthru

Gibt an, dass dieses Cmdlet ein Verlaufsobjekt für jeden Verlaufseintrag zurückgibt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

HistoryInfo

Sie können ein HistoryInfo- objekt an dieses Cmdlet weiterleiten.

Ausgaben

None or Microsoft.PowerShell.Commands.HistoryInfo

Dieses Cmdlet gibt ein HistoryInfo--Objekt zurück, wenn Sie den PassThru--Parameter angeben. Andernfalls generiert dieses Cmdlet keine Ausgabe.

Hinweise

  • Der Sitzungsverlauf ist eine Liste der Befehle, die während der Sitzung zusammen mit der ID eingegeben wurden. Der Sitzungsverlauf stellt die Reihenfolge der Ausführung, den Status und die Start- und Endzeiten des Befehls dar. Während Sie jeden Befehl eingeben, fügt Windows PowerShell ihn dem Verlauf hinzu, damit Sie ihn wiederverwenden können. Weitere Informationen über die Historie der Sitzung finden Sie unter about_History.

  • Um die Befehle anzugeben, die dem Verlauf hinzugefügt werden sollen, verwenden Sie den parameter InputObject. Der befehl Add-History akzeptiert nur HistoryInfo- Objekte, z. B. die für jeden Befehl vom Cmdlet Get-History zurückgegebenen. Sie können es nicht als Pfad und Dateinamen oder als Liste von Befehlen übergeben.

  • Sie können den parameter InputObject verwenden, um eine Datei mit HistoryInfo- Objekten an Add-Historyzu übergeben. Exportieren Sie dazu die Ergebnisse eines Get-History Befehls mithilfe des Cmdlets Export-Csv oder Export-Clixml in eine Datei, und importieren Sie die Datei dann mithilfe der cmdlets Import-Csv oder Import-Clixml. Anschließend können Sie die Datei importierter HistoryInfo--Objekte an Add-History über eine Pipeline oder in einer Variablen übergeben. Weitere Informationen finden Sie in den Beispielen.

  • Die Datei HistoryInfo Objekte, die Sie an das Cmdlet Add-History übergeben, müssen die Typinformationen, Spaltenüberschriften und alle Eigenschaften der HistoryInfo--Objekte enthalten. Wenn Sie die Objekte an Add-Historyübergeben möchten, verwenden Sie nicht den NoTypeInformation Parameter des Cmdlets Export-Csv, und löschen Sie nicht die Typinformationen, Spaltenüberschriften oder Felder in der Datei. Um den Sitzungsverlauf zu ändern, exportieren Sie die Sitzung in eine CSV- oder XML-Datei, ändern Sie die Datei, importieren Sie die Datei, und verwenden Sie Add-History, um sie an den aktuellen Sitzungsverlauf anzufügen.