Partager via

Add-History

  • Référence
Module:
Microsoft.PowerShell.Core

Ajoute des entrées à l’historique de session.

Syntaxe

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

Description

L’applet de commande Add-History ajoute des entrées à la fin de l’historique de session, c’est-à-dire la liste des commandes entrées pendant la session active. Vous pouvez utiliser l’applet de commande Get-History pour obtenir les commandes et les transmettre à Add-History, ou exporter les commandes vers un fichier CSV ou XML, puis importer les commandes, puis passer le fichier importé à Add-History. Vous pouvez utiliser cette applet de commande pour ajouter des commandes spécifiques à l’historique ou créer un fichier d’historique unique qui inclut des commandes de plusieurs sessions.

Exemples

Exemple 1 : Ajouter des commandes à l’historique d’une autre session

# 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

Ces commandes ajoutent les commandes tapées dans une session Windows PowerShell à l’historique d’une autre session Windows PowerShell. La deuxième commande est tapée sur la ligne de commande d’une autre session.

L’opérateur de pipeline | transmet les objets à l’applet de commande Add-History, ce qui ajoute les objets représentant les commandes du fichier History.csv à l’historique de session actuel.

Exemple 2 : Importer et exécuter des commandes

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

Cette commande importe des commandes à partir du fichier History.xml, les ajoute à l’historique de session actuel, puis exécute les commandes dans l’historique combiné.

L’applet de commande Import-Clixml importe un historique de commandes exporté dans le fichier History.xml.

L’opérateur de pipeline transmet les commandes à l’applet de commande Add-History, ce qui ajoute les commandes à l’historique de session actuel.

Le paramètre PassThru transmet les objets représentant les commandes ajoutées vers le bas du pipeline.

L’applet de commande ForEach-Object pour appliquer la commande Invoke-History à chacune des commandes de l’historique combiné.

La commande Invoke-History est mise en forme en tant que bloc de script, placé entre accolades, comme requis par le paramètre Process de l’applet de commande ForEach-Object.

Exemple 3 : Ajouter des commandes dans l’historique à la fin de l’historique

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

Cette commande ajoute les cinq premières commandes de l’historique à la fin de la liste d’historiques. Il utilise l’applet de commande Get-History pour obtenir les cinq commandes se terminant par la commande 5. L’opérateur de pipeline les transmet à l’applet de commande Add-History, qui les ajoute à l’historique actuel.

La commande Add-History n’inclut aucun paramètre, mais Windows PowerShell associe les objets transmis par le pipeline au paramètre InputObject de Add-History.

Exemple 4 : Ajouter des commandes dans un fichier .csv à l’historique actuel

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

Ces commandes ajoutent les commandes dans le fichier History.csv à l’historique de session actuel.

La première commande utilise l’applet de commande Import-Csv pour importer les commandes dans le fichier History.csv et stocker son contenu dans la variable $a.

La deuxième commande utilise l’applet de commande Add-History pour ajouter les commandes de History.csv à l’historique de session actuel.

Il utilise le paramètre InputObject pour spécifier la variable $a et le paramètre PassThru pour générer un objet à afficher sur la ligne de commande. Sans le paramètre passThru , l’applet de commande ne génère aucune sortie.

Exemple 5 : Ajouter des commandes dans un fichier .xml à l’historique actuel

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

Cette commande ajoute les commandes du fichier History01.xml à l’historique de session actuel. Il utilise le paramètre InputObject pour transmettre les résultats de la commande entre parenthèses à l’applet de commande .

La commande entre parenthèses, qui est exécutée en premier, importe le fichier History01.xml dans Windows PowerShell. L’applet de commande Add-History ajoute ensuite les commandes du fichier à l’historique de session.

Paramètres

-InputObject

Spécifie un tableau d’entrées à ajouter à l’historique en tant qu’objet HistoryInfo à l’historique de session. Vous pouvez utiliser ce paramètre pour envoyer un objet HistoryInfo, tel que ceux retournés par le Get-History, Import-Clixmlou les applets de commande Import-Csv, à Add-History.

Type:PSObject[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Passthru

Indique que cette applet de commande retourne un objet d’historique pour chaque entrée d’historique. Par défaut, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

HistoryInfo

Vous pouvez diriger un objet HistoryInfo vers cette applet de commande.

Sorties

None or Microsoft.PowerShell.Commands.HistoryInfo

Cette applet de commande retourne un objet HistoryInfo si vous spécifiez le paramètre PassThru. Sinon, cette applet de commande ne génère aucune sortie.

Notes

  • L’historique des sessions est une liste des commandes entrées pendant la session, ainsi que l’ID. L’historique des sessions représente l’ordre d’exécution, l’état et les heures de début et de fin de la commande. Lorsque vous entrez chaque commande, Windows PowerShell l’ajoute à l’historique afin de pouvoir le réutiliser. Pour plus d’informations sur l’historique des sessions, consultez about_History.

  • Pour spécifier les commandes à ajouter à l’historique, utilisez le paramètre InputObject. La commande Add-History accepte uniquement objets HistoryInfo, tels que ceux retournés pour chaque commande par l’applet de commande Get-History. Vous ne pouvez pas lui transmettre un chemin d’accès et un nom de fichier ou une liste de commandes.

  • Vous pouvez utiliser le paramètre InputObject pour transmettre un fichier d’objets HistoryInfo HistoryInfo à Add-History. Pour ce faire, exportez les résultats d’une commande Get-History dans un fichier à l’aide de l’applet de commande Export-Csv ou Export-Clixml, puis importez le fichier à l’aide des applets de commande Import-Csv ou Import-Clixml. Vous pouvez ensuite transmettre le fichier d’objets HistoryInfo importés à Add-History via un pipeline ou dans une variable. Pour plus d’informations, consultez les exemples.

  • Le fichier de HistoryInfo objets que vous passez à l’applet de commande Add-History doit inclure les informations de type, les en-têtes de colonne et toutes les propriétés des objets HistoryInfo. Si vous envisagez de renvoyer les objets à Add-History, n’utilisez pas le paramètre NoTypeInformation de l’applet de commande Export-Csv et ne supprimez pas les informations de type, les en-têtes de colonne ou les champs du fichier. Pour modifier l’historique de session, exportez la session vers un fichier CSV ou XML, modifiez le fichier, importez le fichier et utilisez Add-History pour l’ajouter à l’historique de session actuel.