History, commande
Mise à jour : novembre 2007
Affiche l'historique des révisions d'un ou de plusieurs fichiers et 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 [/server:servername] itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/noprompt]
Paramètres
Argument |
Description |
|---|---|
servername |
Valeur fournie par l'utilisateur pour l'option /server. Exemple : teamfoundation2. |
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 (Team System). |
number |
Spécifie combien d'ensembles de modifications doivent être inclus dans la requête d'historique. |
username |
Fournit une valeur pour l'option /user. En fonction des paramètres réseau, vous pouvez spécifier DOMAINE\nomutilisateur ou nomutilisateur. |
Option |
Description |
|---|---|
/server |
Identifie le serveur Team Foundation Server. Cette option est requise si la commande est appelée à partir d'un répertoire qui n'est pas mappé à un espace de travail. |
/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 lenumber d'ensembles de modifications que vous spécifiez. Par exemple, /stopafter:10 affiche les dix dernières modifications apportées à l'élément spécifié. |
/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 sur 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é. |
/noprompt |
Supprime les invites de saisie. |
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 Présentation de l'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 seule spécification de version, Team Foundation affiche les informations sur l'élément, en remontant depuis cette version jusqu'à 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 s'affiche. 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
Concepts
Utilisation des ensembles de modifications du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)
Autres ressources
Commandes de l'utilitaire en ligne de commande Tf