Ajoute des entrées à l'historique de la 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 la 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 passer à Add-History, ou bien exporter les commandes vers un fichier CSV ou XML, puis les importer et 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 les commandes de plusieurs sessions.
Paramètres
-InputObject <PSObject[]>
Ajoute l'objet HistoryInfo spécifié à l'historique de la session. Vous pouvez utiliser ce paramètre pour envoyer un objet HistoryInfo de Get-History, Import-Clixml ou Import-CSV à Add-History.
|
Obligatoire ? |
false |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet historique pour chaque entrée de l'historique. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Microsoft.PowerShell.Commands.HistoryInfo Vous pouvez diriger un objet HistoryInfo vers Add-History. |
|
Sorties |
Aucune ou Microsoft.PowerShell.Commands.HistoryInfo Lorsque vous utilisez le paramètre PassThru, Add-History génère un objet HistoryInfo. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
L'historique de la session correspond à une liste des commandes entrées pendant la session, accompagnées de leur ID. Il représente l'ordre d'exécution, l'état, ainsi que les heures de début et de fin de la commande. À mesure que vous entrez chaque commande, Windows PowerShell l'ajoute à l'historique afin que vous puissiez la réutiliser. Pour plus d'informations sur l'historique de la session, consultez about_History.
Pour spécifier les commandes à ajouter à l'historique, utilisez le paramètre InputObject. La commande Add-History accepte uniquement les objets HistoryInfo, tels que ceux générés pour chaque commande par Get-History. Vous ne pouvez pas lui passer un chemin d'accès et un nom de fichier ou une liste de commandes.
Vous pouvez utiliser le paramètre -InputObject pour passer un fichier d'objets HistoryInfo à Add-History. Pour ce faire, exportez les résultats d'une commande Get-History vers un fichier en utilisant Export-CSV ou Export-Clixml, puis importez le fichier en utilisant Import-CSV ou Import-Clixml. Vous pouvez ensuite passer le fichier d'objets HistoryInfo importé à Add-History à travers un pipeline ou dans une variable. Pour plus d'informations, consultez les exemples.
Le fichier d'objets HistoryInfo que vous passez à 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 avez l'intention de repasser les objets à Add-History, n'utilisez pas le paramètre NoTypeInformation d'Export-Csv et ne supprimez pas les informations de type, les en-têtes de colonne ou un quelconque champ du fichier.
Pour modifier l'historique de la session, exportez la session vers un fichier CSV ou XML, modifiez le fichier, importez-le, puis utilisez Add-History pour l'ajouter à l'historique de la session active.
Exemple 1
C:\PS>get-history | export-csv c:\testing\history.csv C:\PS>import-csv history.csv | add-history Description ----------- Ces commandes ajoutent les commandes tapées dans une session Windows PowerShell à l'historique d'une autre session Windows PowerShell. La première commande obtient des objets qui représentent les commandes dans l'historique et les exporte vers le fichier History.csv. La deuxième commande est tapée à la ligne de commande d'une autre session. Elle utilise l'applet de commande Import-Csv pour importer les objets vers le fichier History.csv. L'opérateur de pipeline passe les objets à l'applet de commande Add-History, laquelle ajoute les objets qui représentent les commandes dans le fichier History.csv à l'historique de la session active.
Exemple 2
C:\PS>import-clixml c:\temp\history.xml | add-history -passthru | foreach-object {invoke-history}
Description
-----------
Cette commande importe les commandes du fichier History.xml, les ajoute à l'historique de la session active, puis les exécute dans l'historique combiné.
La première commande utilise la commande Import-Clixml pour importer un historique des commandes qui a été exporté vers le fichier History.xml. L'opérateur de pipeline (|) passe les commandes au paramètre Add-History, lequel les ajoute à l'historique de la session active. Le paramètre PassThru passe les objets représentant les commandes ajoutées à travers le pipeline.
Cette commande utilise ensuite 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 comme un bloc de script placé entre accolades ({}) car ForEach-Object requiert un bloc de script même lorsqu'il n'y a qu'une seule commande à appliquer.
Exemple 3
C:\PS>get-history -id 5 -count 5 | add-history Description ----------- Cette commande ajoute les cinq premières commandes de l'historique à la fin de l'historique. Elle utilise l'applet de commande Get-History pour obtenir les cinq commandes, en s'arrêtant à la cinquième commande. L'opérateur de pipeline (|) les passe à l'applet de commande Add-History, laquelle les ajoute à l'historique actif. La commande Add-History n'inclut aucun paramètre, mais Windows PowerShell associe les objets passés à travers le pipeline au paramètre InputObject.
Exemple 4
C:\PS>$a = import-csv c:\testing\history.csv C:\PS>add-history -inputobject $a -passthru Description ----------- Ces commandes ajoutent les commandes du fichier History.csv à l'historique de la session active. 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 la session active. Elle 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, Add-History ne génère aucune sortie à afficher.
Exemple 5
C:\PS>add-history -inputobject (import-clixml c:\temp\history01.xml) Description ----------- Cette commande ajoute les commandes du fichier History01.xml à l'historique de la session active. Elle utilise le paramètre InputObject pour passer les résultats de la commande entre parenthèses à Add-History. La commande entre parenthèses, qui est exécutée en premier, importe le fichier History01.xml dans Windows PowerShell. Add-History ajoute ensuite les commandes du fichier à l'historique de la session.
Voir aussi