jeudi 17 novembre 2011

Get-History

NOM
    Get-History

RÉSUMÉ
    Obtient la liste des commandes entrées pendant la session active.

SYNTAXE
    Get-History [[-Id] <Int64[]>] [[-Count] <int>] [<CommonParameters>]


DESCRIPTION
    L'applet de commande Get-History obtient l'historique de la session, c'est-à-dire la liste des commandes entrées pendant la session active. Windows PowerShell gère automatiquement un historique de chaque session. Vous pouvez enregistrer l'historique de la session au format XML ou CSV. Par défaut, les fichiers d'historique sont enregistrés dans le répertoire de base, mais vous pouvez les enregistrer dans n'importe quel emplacement.


PARAMÈTRES
    -Count <int>
        Affiche le nombre spécifié d'entrées de l'historique les plus récentes. La valeur par défaut est 32. Si vous utilisez à la fois les paramètres Count et Id dans une commande, l'affichage se termine par la commande spécifiée
         par le paramètre Id.

        Obligatoire ?                false
        Position ?                   2
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Id <Int64[]>
        Spécifie le numéro d'ID d'une commande dans l'historique de la session. Get-History obtient uniquement la commande spécifiée. Si vous utilisez Id et Count, Get-History obtient les commandes les plus récentes se terminant par la commande spécifiée par le paramètre Id.

        Obligatoire ?                false
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue)
        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
    Int64
        Vous pouvez diriger un ID d'historique vers Get-History.


SORTIES
    Microsoft.PowerShell.Commands.HistoryInfo
        Get-History retourne un objet d'historique pour chaque élément d'historique obtenu.


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 des commandes, consultez about_History.

        Vous pouvez également faire référence à Get-History en utilisant ses alias intégrés, « h », « history » et « ghy ». Pour plus d'informations, consultez about_Aliases.


    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>get-history


    Description
    -----------
    Cette commande obtient les dernières 32 commandes envoyées. L'affichage par défaut présente chaque commande et son ID, lequel indique l'ordre d'exécution.





    -------------------------- EXEMPLE 2 --------------------------

    C:\PS>get-history | where-object {$_.commandLine -like "*service*"}


    Description
    -----------
    Cette commande obtient les entrées de l'historique des commandes qui incluent le mot « service ». La première commande obtient les 32 entrées les plus récentes de l'historique de la session. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object, laquelle sélectionne uniquement les commandes qui incluent « service ».





    -------------------------- EXEMPLE 3 --------------------------

    C:\PS>get-history -id 7 -count 5 | export-csv history.csv


    Description
    -----------
    Cette commande obtient les cinq entrées les plus récentes de l'historique se terminant par l'entrée 7. L'opérateur de pipeline (|) passe le résultat à l'applet de commande Export-Csv, laquelle met en forme l'historique en tant que texte séparé par des virgules et l'enregistre dans le fichier History.csv. Le fichier inclut les données qui s'affichent lorsque vous mettez en forme l'historique en tant que liste, y compris l'état et les heures de début et de fin de la commande.





    -------------------------- EXEMPLE 4 --------------------------

    C:\PS>get-history -count 1


    Description
    -----------
    Cette commande obtient la dernière commande (la plus récemment entrée) dans l'historique des commandes. Elle utilise le paramètre Count pour afficher une seule commande. Par défaut, Get-History affiche les commandes les plus récentes. Cette commande peut être abrégée sous la forme « h -c 1 » et revient à appuyer sur la touche Haut.





    -------------------------- EXEMPLE 5 --------------------------

    C:\PS>get-history -count $MaximumHistoryCount


    Description
    -----------
    Cette commande affiche toutes les commandes enregistrées dans l'historique de la session. Par défaut, $MaximumHistoryCount a la valeur 64 ; cette commande peut donc être abrégée sous la forme « h -c 64 ».





    -------------------------- EXEMPLE 6 --------------------------

    C:\PS>get-history | format-list


    Description
    -----------
    Cette commande affiche toutes les propriétés des entrées de l'historique de la session. L'opérateur de pipeline (|) passe le résultat à l'applet de commande Format-List, laquelle affiche toutes les propriétés de chaque entrée de l'historique, y compris l'ID, l'état et les heures de début et de fin de la commande.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113317
    about_history
    Invoke-History
    Add-History
    Clear-History

Aucun commentaire:

Enregistrer un commentaire