History, commande
Affiche l'historique des révisions d'un ou de plusieurs fichiers et/ou dossiers.
Autorisations requises
Pour utiliser la commande history, vous devez disposer de l'autorisation Lire avec la valeur Autoriser pour tous les fichiers ou dossiers pour lesquels l'historique est demandé. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf history itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt] [/login:username,[password]] [/sort:ascending,descending] [/collection:TeamProjectCollectionUrl]
Paramètres
Argument |
Description |
|---|---|
itemspec |
Identifie le fichier ou dossier pour lequel afficher l'historique. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Options de ligne de commande. |
versionspec |
Fournit une valeur, telle que C58, pour l'option /version. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Contrôle de version). |
number |
Spécifie combien d'ensembles de modifications doivent être inclus dans la requête d'historique. |
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient un ou plusieurs fichiers ou dossiers au sujet desquels vous souhaitez afficher l'historique des révisions (par exemple, http://myserver:8080/tfs/DefaultCollection). |
username |
Fournit une valeur aux options /login et /user. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
Option |
Description |
|---|---|
/version |
Spécifie la version des éléments pour laquelle afficher l'historique des révisions. Par défaut, Team Foundation utilise la version de l'espace de travail. Vous ne pouvez pas utiliser cette option avec l'option /slotmode. |
/stopafter |
Affiche l'historique pour les numéros d'ensembles de modifications que vous spécifiez. |
/recursive |
Récupère les informations d'historique à propos des éléments figurant dans le chemin d'accès spécifié. |
/user |
Filtre la liste des modifications apportées à l'utilisateur nommé. L'astérisque (*) peut servir à sélectionner tous les utilisateurs. Si rien n'est spécifié, tous les utilisateurs sont sélectionnés. |
/format |
Spécifie les descriptions affichées pour les informations d'historique. Brief affiche une ligne à propos de chaque ensemble de modifications. Detailed affiche une description complète de l'ensemble de modifications. Si rien n'est spécifié, les descriptions sont brèves. |
/slotmode |
Affiche l'historique des révisions de tous les éléments ayant déjà occupé l'emplacement d'espace de noms spécifié. Si vous avez renommé un fichier, cette option affiche l'historique de révision du fichier sous le nom ancien et nouveau. |
/noprompt |
Supprime les invites de saisie. |
/itemmode |
Affiche l'historique des révisions de l'élément spécifié qui a un chemin d'accès unique. Contrairement à l'option /slotmode, si vous avez renommé un fichier, cette option indiquera l'historique des révisions du fichier seulement sous un nouveau nom. |
/collection |
Spécifie la collection du projet d'équipe. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
/sort |
Trie l'historique des révisions pour un ou plusieurs fichiers ou dossiers dans l'un des ordres suivants :
|
Notes
La commande d'historique ouvre la fenêtre Historique, qui affiche des boutons permettant de sélectionner Détails, Affichage et Comparer. Détails affiche les détails de l'ensemble de modifications. Affichage affiche les versions des fichiers. Comparer compare les versions des fichiers avec votre version actuelle dans l'espace de travail si une seule ligne est sélectionnée, ou avec deux versions différentes si deux lignes sont sélectionnées. Dans le menu contextuel de la fenêtre Historique, utilisez l'option copy pour copier vers le Presse-papiers les informations textuelles des lignes actuellement sélectionnées. Pour plus d'informations, consultez Utilisation de la fenêtre Historique.
Vous pouvez utiliser la commande history pour afficher l'historique des révisions d'un ou de plusieurs fichiers et dossiers. Pour chaque ensemble de modifications dans lequel les éléments demandés ont été inclus, Team Foundation affiche une entrée de révision dans la sortie de l'ensemble de modifications. Les détails de l'ensemble de modifications incluent des informations sur l'utilisateur ayant validé la modification dans le serveur de contrôle de version Team Foundation, les fichiers et les dossiers pour lesquels les modifications en attente ont été validées, le type de modification en attente qui a été validé, le numéro de l'ensemble de modifications et la date et l'heure de sa création.
Si vous ne fournissez aucune spécification de version (versionspec), Team Foundation affiche l'historique complet du fichier ou du dossier. Lorsque vous fournissez une spécification de version unique, Team Foundation affiche les informations relatives à l'élément de cette version en remontant à la version 1. Si vous spécifiez une plage de versions (à l'aide de la syntaxe ~ ), l'historique de ces versions et de toutes les versions intermédiaires est indiqué. La plage peut être spécifiée dans l'ordre croissant ou décroissant.
Si vous incluez l'option /slotmode, Team Foundation affiche l'historique des révisions pour l'élément spécifié. Par exemple, si vous avez renommé un fichier, cette option affiche l'ancien nom et le nouveau. L'option /slotmode spécifie une plage d'éléments et de versions disparates. Vous ne devez donc pas mélanger les options /slotmode et /version.
Vous pouvez utiliser la commande history pour déterminer le numéro de l'ensemble de modifications dans lequel un jeu de fichiers a été validé, puis utiliser la commande d'ensemble de modifications pour afficher davantage de détails sur la nature de l'ensemble de modifications et sur l'archivage qui l'a créé. Vous pouvez aussi sélectionner une ligne dans la fenêtre Historique, puis cliquer sur le bouton Détails.
Pour obtenir des liens vers d'autres commandes de Team Foundation qui fournissent des informations supplémentaires sur les éléments se trouvant sur votre serveur de contrôle de version Team Foundation et tous les espaces de travail qui mappent à ce serveur, consultez Commandes d'information.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant affiche les modifications intervenues entre l'ensemble de modifications version 5 et ses versions 8 à 1256.c.
c:\projects> tf history /version:C5~C8 1256.c
L'exemple suivant affiche les dix dernières modifications apportées à 314.cs.
c:\projects> tf history /stopafter:10 314.cs
L'exemple suivant affiche la sortie détaillée et mise en forme de l'historique de l'emplacement d'espace de noms 1256.c.
c:\projects> tf history /format:detailed /slotmode 1256.c
Voir aussi
Référence
Syntaxe de ligne de commande (Contrôle de version)
Concepts
Utilisation d'ensembles de modifications
Autres ressources
Commandes de l'utilitaire en ligne de commande Tf