Add-History
Fügt Einträge zum Sitzungsverlauf hinzu.
Syntax
Default (Standard)
Add-History
[[-InputObject] <PSObject[]>]
[-Passthru]
[<CommonParameters>]
Beschreibung
Das Cmdlet Add-History fügt Einträge am Ende des Sitzungsverlaufs hinzu, d. h. an der 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-History zu ü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
PS> get-history | export-csv c:\testing\history.csv
PS> 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 erste Befehl ruft Objekte ab, die die Befehle im Verlauf darstellen, und exportiert sie in die History.csv Datei. Der zweite Befehl wird an der Befehlszeile einer anderen Sitzung eingegeben. Es wird das Cmdlet Import-Csv verwendet, um die Objekte in der History.csv Datei zu importieren. Der Pipelineoperator übergibt die Objekte an das Cmdlet Add-History , das die Objekte, die die Befehle in der History.csv Datei darstellen, dem aktuellen Sitzungsverlauf hinzufügt.
Beispiel 2
PS> import-clixml c:\temp\history.xml | add-history -passthru | foreach-object -process {invoke-history}
Dieser Befehl importiert Befehle aus der History.xml Datei, fügt sie dem aktuellen Sitzungsverlauf hinzu und führt dann die Befehle im kombinierten Verlauf aus.
Der erste Befehl verwendet das Cmdlet Import-Clixml, um einen Befehlsverlauf zu importieren, der in die History.xml Datei exportiert wurde. Der Pipelineoperator (|) übergibt die Befehle an den Add-History-Parameter , der die Befehle dem aktuellen Sitzungsverlauf hinzufügt. Der PassThru-Parameter übergibt die Objekte, die die hinzugefügten Befehle darstellen, in der Pipeline.
Der Befehl verwendet dann das Cmdlet ForEach-Object, um den Befehl Invoke-History auf jeden der Befehle im kombinierten Verlauf anzuwenden. Der Befehl Invoke-History wird als Skriptblock (in geschweifte Klammern) formatiert, wie für den Parameter Process des Cmdlets ForEach-Object erforderlich.
Beispiel 3
PS> 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. Das Cmdlet Get-History wird verwendet, um die fünf Befehle abzurufen, die mit Befehl 5 enden. Der Pipelineoperator (|) übergibt sie an das Cmdlet Add-History , das sie an den aktuellen Verlauf anfügt. Der Befehl Add-History enthält keine Parameter, aber Windows PowerShell ordnet die Objekte, die durch die Pipeline übergeben werden, dem InputObject-Parameter von Add-History zu.
Beispiel 4
PS> $a = import-csv c:\testing\history.csv
PS> 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 den Inhalt in der Variablen $a zu speichern. Der zweite Befehl verwendet das Cmdlet Add-History , um die Befehle aus History.csv dem 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 PassThru-Parameter generiert das Cmdlet Add-History keine Ausgabe.
Beispiel 5
PS> 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 InputObject-Parameter , 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 dem Sitzungsverlauf hinzu.
Parameter
-InputObject
Fügt das angegebene HistoryInfo-Objekt dem Sitzungsverlauf hinzu. Sie können diesen Parameter verwenden, um ein HistoryInfo-Objekt, z. B. die Objekte, die von den Cmdlets Get-History, Import-Cligml oder Import-Csv zurückgegeben werden, an Add-History zu übermitteln.
Parametereigenschaften
| Typ: | PSObject[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Passthru
Gibt für jeden Verlaufseintrag ein Verlaufsobjekt zurück. 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 über die Pipeline an Add-History übergeben.
Ausgaben
None or Microsoft.PowerShell.Commands.HistoryInfo
Wenn Sie den PassThru-Parameter verwenden, gibt Add-History ein HistoryInfo-Objekt zurück. Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
Der Sitzungsverlauf ist eine Liste der Befehle, die während der Sitzung eingegeben wurden, zusammen mit der ID. 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. solche, die für jeden Befehl vom Cmdlet Get-History zurückgegeben werden. Sie können es nicht als Pfad und Dateinamen oder als Liste von Befehlen übergeben.
Sie können den InputObject-Parameter verwenden, um eine Datei mit HistoryInfo-Objekten an Add-History zu ü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 mit den Cmdlets Import-Csv oder Import-Clixml. Anschließend können Sie die Datei der importierten HistoryInfo-Objekte über eine Pipeline oder in einer Variablen an Add-History übergeben. Weitere Informationen finden Sie in den Beispielen.
Die Datei mit HistoryInfo-Objekten, die Sie an das Cmdlet Add-History übergeben, muss die Typinformationen, Spaltenüberschriften und alle Eigenschaften der HistoryInfo-Objekte enthalten. Wenn Sie beabsichtigen, die Objekte an Add-History zurückzuübergeben, 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 bearbeiten, exportieren Sie die Sitzung in eine CSV- oder XML-Datei, bearbeiten Sie die Datei, importieren Sie die Datei und verwenden Sie Add-Verlauf , um sie an den aktuellen Sitzungsverlauf anzuhängen.