Partager via


History, commande

Affiche l'historique des révisions d'un ou de plusieurs fichiers ou dossiers. Les données sont affichées dans la fenêtre Historique, ou si l'option /noprompt est spécifiée, au niveau de l'invite de commandes.

Exigences générales : consultez Référence des autorisations pour Team Foundation Server.

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 d'équipe 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 ci-dessus, 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. Consultez Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control (page éventuellement en anglais).

itemspec

Spécifie les éléments pour lesquels afficher l'historique. Pour obtenir la syntaxe, consultez Référence de commande du contrôle de version Team Foundation.

/noprompt

Cette option :

  • 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 Référence de commande du 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 Référence de commande du 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. Consultez Matt Mitrik: Changing to Slot Mode in TFS 2010 Version Control (page éventuellement en anglais).

/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 l'une des limites suivantes sur les données d'historique :

  • Version maximale

  • Les versions minimales et maximales à l'aide de la syntaxe ~ de la plage.

La valeur par défaut est /version:W (la version de l'espace de travail).

Pour obtenir la syntaxe, consultez Référence de commande du contrôle de version Team Foundation.

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

Exemples

Obtenir l'historique d'un fichier unique

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

Affiche toutes les modifications appliquées à program.cs dans la fenêtre Historique.

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

Affiche toutes les modifications effectuées sur program.cs dans la fenêtre d'invite de commandes. Par exemple :

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

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

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

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

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

Affiche les 5 dernières modifications apportées aux éléments de SolutionA (y compris celles dans les sous-dossiers) :

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

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

Affiche les modifications apportées à tous les éléments dans SolutionA (y compris celles dans les sous-dossiers) de la version 30 et antérieure :

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

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

Affiche les modifications apportées à tous les éléments de SolutionA (y compris celles dans les sous-dossiers) le 23/04/12 ou précédemment :

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 version x à la version y

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

Affiche les modifications apportées à tous les éléments de SolutionA (y compris celles des sous-dossiers) entre le 12/04/2012 et le 23/04/12 :

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é

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

Affiche les détails des modifications apportées à tous les éléments de SolutionA (y compris ceux des sous-dossiers) entre le 12/04/2012 et le 23/04/12 :

-------------------------------------------------------------------------------
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

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

Affiche l'historique du dossier SolutionA dans la fenêtre Historique, qui vous permet d'explorer les premières modifications du 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 . /noprompt

Affiche la modification la plus récente du dossier SolutionA de la fenêtre d'invite de commandes.

Utilisation de Visual Studio

Conseils

  • Conseil Pour plus d'informations sur l'utilisation de la fenêtre Historique, consultez Obtenir l'historique d'un élément.

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

    • Dans la fenêtre Historique, double-cliquez sur l'ensemble de modifications ou ouvrez le menu contextuel et choisissez Détails de l'ensemble de modifications.

    • À partir de l'invite de commandes, utilisez Changeset Command.

  • Conseil Pour plus d'informations sur ces ensembles de modifications, consultez Rechercher et afficher des ensembles de modifications.

  • Conseil 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 d'équipe qui contient les éléments.

  • Conseil Consultez Afficher et gérer les versions antérieures.