NOM
Add-History
RÉSUMÉ
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 [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
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.
NOTES
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-C lixml, 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.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113279
about_History
Get-History
Invoke-History
Clear-History
Aucun commentaire:
Enregistrer un commentaire