Commande Historique (Team Foundation Version Control)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande tf history Team Foundation Version Control (TFVC) affiche l’historique de révision d’un ou plusieurs fichiers ou dossiers. Les données de commande sont affichées dans la fenêtre Historique dans Visual Studio ou si l’option /noprompt est spécifiée, à l’invite de commandes.

Vous pouvez également utiliser Visual Studio pour obtenir l’historique des révisions. Pour plus d’informations, consultez Obtenir l’historique d’un élément.

Prérequis

Consultez Autorisations TFVC par défaut.

Syntaxe

tf hist[ory] itemspec [/version:versionspec] 
[/stopafter:number] [/recursive] [/user:username] 
[/format:(brief|detailed)] [/slotmode] [/itemmode] [/noprompt]
[/login:username,[password]] [/sort:ascending,descending]
[/collection:TeamProjectCollectionUrl]

Paramètres

Paramètre

Description

/collection:<TeamProjectCollectionUrl>

Spécifie l'URL de la collection de projets qui contient les éléments. Par exemple : http://myserver:8080/tfs/DefaultCollection.

Par défaut, la collection de projets d'équipe est présumée être celle qui contient l'espace de travail qui mappe le répertoire actif.

/format

Spécifie la quantité de détails à afficher sur chaque ensemble de modifications lorsque l'option /noprompt est spécifiée :

  • Brief (valeur par défaut) : affiche une ligne sur chaque ensemble de modifications qui inclut : numéro d'ID, modifications apportées, utilisateur qui a effectué les modifications, la date et le commentaire. Certaines des données peuvent être tronquées.

  • Detailed  : affiche une description complète de chaque ensemble de modifications. En plus des informations précédentes, cette option affiche des informations supplémentaires telles que la date et l'heure, les éléments modifiés, les notes d'archivage et les avertissements de stratégie d'archivage.

/itemmode

Vous ne pouvez pas utiliser cette option avec l'option /slotmode. Pour plus d’informations, consultez Matt Mitrik : modification du mode d’emplacement dans la gestion de version TFS 2010.

<itemspec>

Spécifie les éléments pour lesquels afficher l'historique. Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Team Foundation.

/noprompt

Supprime l'affichage des fenêtres et des boîtes de dialogue, telles que la fenêtre Historique, et redirige les données de production vers l'invite de commandes. Consultez Utiliser les commandes de contrôle de version Team Foundation.

N'affiche pas l'historique des révisions qui se sont produites avant qu'un élément soit déplacé, renommé, connecté ou fusionné.

/login:<username>[,<password>]

Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/recursive

Extrait de manière récursive des données d'historique sur les éléments dans le répertoire et tous les sous-répertoires spécifiés.

/slotmode

Vous ne pouvez pas utiliser cette option avec l'option /itemmode. Pour plus d’informations, consultez Matt Mitrik : modification du mode d’emplacement dans la gestion de version TFS 2010.

/sort

Trie l'historique des révisions pour un ou plusieurs fichiers ou dossiers dans l'un des ordres suivants :

  • Ascending : de la révision la plus ancienne à la plus récente.

  • Descending (par défaut) : de la révision la plus récente à la plus ancienne.

Vous devez utiliser l'option /noprompt avec cette option.

/stopafter:<number>

Spécifie le nombre maximal d'ensembles de modifications pour afficher des données d'historique.

/user:<username>

Filtre les données d'historique pour afficher les modifications apportées par l'utilisateur spécifié. Un astérisque (*) inclut des données sur les modifications de tous les utilisateurs (valeur par défaut).

/version:<versionspec>

Spécifie la version maximale, ou les versions minimales et maximales à l’aide de la syntaxe de plage ~. La valeur par défaut est /version:W (la version de l'espace de travail).

Vous ne pouvez pas utiliser cette option avec l'option /slotmode.

Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Team Foundation.

Notes

  • Pour obtenir davantage d'informations détaillées à propos d'un ensemble de modifications (par exemple, pour consulter les éléments de travail associés) :

    • Dans la fenêtre Historique de Visual Studio, double-cliquez ou cliquez avec le bouton droit sur le jeu de modifications, puis choisissez Détails de l’ensemble de modifications.

    • À partir de l’invite de commandes, utilisez la commande Changeset.

  • L'option /collection est utile pour exécuter cette commande à partir d'un ordinateur et d'un compte d'utilisateur qui n'a pas d'espace de travail mappé à la collection de projets qui contient les éléments.

Exemples

Les exemples suivants supposent que c:\code\SiteApp\Main est mappé au dossier principal de l’espace de travail.

Obtenir l'historique d'un fichier unique

L’exemple suivant affiche toutes les modifications apportées à program2.cs dans la fenêtre Historique.

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs

L’exemple suivant affiche toutes les modifications apportées à program2.cs dans la fenêtre d’invite de commandes.

c:\code\SiteApp\Main\SolutionA\Project1>tf history program2.cs /noprompt

Sortie :

Changeset Change                     User              Date       Comment
--------- -------------------------- ----------------- ---------- -------- 
29        edit                       Jamal Hartnett    4/23/2012  Fix bug
20        add                        Raisa Pokrovskaya 4/12/2012  Add new

Obtenir l'historique de tous les éléments d'un dossier

L’exemple suivant affiche toutes les modifications apportées à tous les éléments dans SolutionA (y compris celles dans les sous-dossiers) de la fenêtre Historique.

c:\code\SiteApp\Main\SolutionA>tf history * /recursive

Obtenir l'historique des cinq dernières modifications apportées à tous les éléments d'un dossier

L’exemple suivant affiche les cinq dernières modifications apportées aux éléments de SolutionA, y compris celles dessous-dossiers, dans la fenêtre d’invite de commandes :

c:\code\SiteApp\Main\SolutionA>tf history * /noprompt /recursive /stopafter:5

Sortie :

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
31        Raisa Pokrovskaya 5/15/2012
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to Proje
15        Raisa Pokrovskaya 4/8/2012

Obtenir l'historique de la version X et des versions antérieures

L’exemple suivant affiche les modifications apportées à tous les éléments de SolutionA, y compris dans les sous-dossiers, dans la version 30 et les versions antérieures, dans la fenêtre d’invite de commandes :

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:30

Sortie :

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 
15        Raisa Pokrovskaya 4/8/2012

Obtenir l'historique de la date D et des dates antérieures

Les exemples suivants affichent les modifications apportées à tous les éléments de SolutionA, y compris dans les sous-dossiers, le 23/04/2012 ou versions antérieures, dans la fenêtre d’invite de commandes :

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/24/2012

Ou :

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D2012-04-24T12:00

Sortie :

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to 15        Raisa Pokrovskaya 4/8/2012

Obtenir l’historique à partir d’une plage de dates

L’exemple suivant affiche les modifications apportées à tous les éléments de SolutionA, y compris dans les sous-dossiers, entre le 12/04/2012 et le 23/04/2012, dans la fenêtre d’invite de commandes :

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Sortie :

Changeset User              Date       Comment
--------- ----------------- ---------- ----------------------------------------
30        Raisa Pokrovskaya 4/23/2012
29        Jamal Hartnett    4/23/2012  Fix bug in new method
20        Raisa Pokrovskaya 4/12/2012  Add new method, add program2.cs to

Obtenir l'historique détaillé

L’exemple suivant affiche des détails sur les modifications apportées à tous les éléments de SolutionA, y compris dans les sous-dossiers, entre le 12/04/2012 et le 23/04/20122, dans la fenêtre d’invite de commandes :

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012 /format:detailed

Sortie :

-------------------------------------------------------------------------------
Changeset: 30
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:23:05 PM

Comment:
  Much better name for this file

Items:
  rename                $/SiteApp/Main/SolutionA/Project1/programBig.cs
  delete, source rename $/SiteApp/Main/SolutionA/Project1/program3.cs;X15

-------------------------------------------------------------------------------
Changeset: 29
User: Raisa Pokrovskaya (Fabrikam)
Date: Monday, April 23, 2012 1:03:13 PM

Comment:
  Fix bug in new method

Items:
  edit $/SiteApp/Main/SolutionA/Project1/program1.cs
  edit $/SiteApp/Main/SolutionA/Project1/program2.cs

-------------------------------------------------------------------------------
Changeset: 20
User: Raisa Pokrovskaya (Fabrikam)
Date: Thursday, April 12, 2012 5:09:35 PM

Comment:
  Add new method, add program2.cs to Project1

Items:
  add $/SiteApp/Main/SolutionA/Project1/program2.cs

Check-in Notes:
  Documentation:
    An important new part of our codebase.

Policy Warnings:
  Override Reason:
    Jamal agrees with me that we can bypass for this check-in.
  Messages:
    The Code Analysis Policy requires files to be checked in through Visual
Studio with an open solution.

Obtenir l'historique non récurrent d'un dossier

L’exemple suivant affiche l’historique du dossier SolutionA dans la fenêtre Historique de Visual Studio, ce qui vous permet d’explorer les modifications antérieures apportées au dossier. Par exemple, si la modification la plus récente dans le dossier a été un changement de nom, vous pouvez développer l'ensemble de modifications pour consulter les modifications qui se sont produites avant l'opération de changement de nom.

c:\code\SiteApp\Main\SolutionA>tf history .

L’exemple suivant affiche la modification la plus récente du dossier SolutionA de la fenêtre d'invite de commandes.

c:\code\SiteApp\Main\SolutionA>tf history . /noprompt