Compartir a través de

History (Comando)

  • Artículo

Muestra el historial de revisiones de uno o varios archivos o carpetas. Los datos se muestran en la ventana Historial o, si se especifica la opción /noprompt, en el símbolo del sistema.

Requisitos: vea Referencia de permisos para 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]

Parámetros

Parámetro

Descripción

/collection: TeamProjectCollectionUrl

Especifica la dirección URL de la colección de proyectos de equipo que contiene los elementos. Por ejemplo: http://myserver:8080/tfs/DefaultCollection.

De forma predeterminada, se supone que la colección de proyectos de equipo es la que contiene el área de trabajo que asigna el directorio actual.

/format

Especifica el nivel de detalle que se muestra sobre cada conjunto de cambios cuando se especifica la opción /noprompt:

  • Brief (valor predeterminado): muestra una línea para cada conjunto de cambios que incluye el número de identificador, los cambios realizados, el usuario que realizó los cambios, la fecha y un comentario. Algunos datos pueden aparecer truncados.

  • Detailed: muestra una descripción completa de cada conjunto de cambios. Además de la información anterior, esta opción muestra datos adicionales como la fecha y la hora, los elementos modificados, las notas de protección y las advertencias sobre directivas de protección.

/itemmode

Esta opción no se puede combinar con la opción /slotmode. Vea el artículo escrito por Matt Mitrik sobre cómo cambiar al modo de ranura en el control de versiones de TFS 2010.

itemspec

Especifica los elementos para los que se muestra el historial. Para obtener información sobre la sintaxis, vea Usar los comandos del control de versiones de Team Foundation.

/noprompt

Esta opción:

  • Suprime la presentación de ventanas y de cuadros de diálogo (como la ventana Historial) y redirige los datos de salida al símbolo del sistema. Vea Usar los comandos del control de versiones de Team Foundation.

  • No muestra el historial de las revisiones que se produjeron antes de mover, cambiar de nombre, bifurcar o combinar un elemento.

/login:username,[password]

Especifica la cuenta de usuario para ejecutar el comando. Vea Usar los comandos del control de versiones de Team Foundation.

/recursive

Recupera de forma recursiva los datos históricos de los elementos del directorio especificado o de cualquier subdirectorio.

/slotmode

Esta opción no se puede combinar con la opción /itemmode. Vea el artículo escrito por Matt Mitrik sobre cómo cambiar al modo de ranura en el control de versiones de TFS 2010.

/sort

Ordena el historial de revisiones de uno o más archivos o carpetas en cualquiera de los siguientes órdenes:

  • Ascending: de la revisión más antigua a la más reciente.

  • Descending (valor predeterminado): de la revisión más reciente a la más antigua.

Debe usar la opción /noprompt con esta opción.

/stopafter:number

Especifica el número máximo de conjuntos de cambios que se van a mostrar en los datos del historial.

/user:username

Filtra los datos históricos para mostrar los cambios realizados por el usuario especificado. Mediante el símbolo de asterisco (*) se incluyen los datos de los cambios realizados por todos los usuarios (valor predeterminado).

/version:versionspec

Especifica uno de los siguientes límites en los datos del historial:

  • La versión máxima

  • Las versiones mínima y máxima mediante el uso de la sintaxis de intervalo ~.

El valor predeterminado es /version:W (la versión del área de trabajo).

Para obtener información sobre la sintaxis, vea Usar los comandos del control de versiones de Team Foundation.

Esta opción no se puede combinar con la opción /slotmode.

Ejemplos

Obtener historial de un solo archivo

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

Muestra todos los cambios realizados en program.cs en la ventana Historial.

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

Muestra todos los cambios realizados en program.cs en la ventana del símbolo del sistema. Por ejemplo:

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

Obtener historial de todos los elementos de una carpeta

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

Muestra todos los cambios realizados en todos los elementos de SolutionA (incluidos los de las subcarpetas) en la ventana Historial.

Obtener historial de los cinco últimos cambios en los elementos de una carpeta

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

Muestra los cinco últimos cambios realizados en los elementos de SolutionA (incluidos los de las subcarpetas):

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

Obtener historial de la versión x y anteriores

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

Muestra los cambios realizados en todos los elementos de SolutionA (incluidos los de las subcarpetas) en la versión 30 y anteriores:

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

Obtener historial hasta la fecha D

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

O bien

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

Muestra los cambios realizados en todos los elementos de SolutionA (incluidos los de las subcarpetas) hasta el 23/04/2012:

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

Obtener historial desde la versión x hasta la versión y

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

Muestra los cambios realizados en todos los elementos de SolutionA (incluidos los de las subcarpetas) entre el 12/04/2012 y el 23/04/2012:

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

Obtener historial detallado

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

Muestra los detalles sobre los cambios realizados en todos los elementos de SolutionA (incluidos los de las subcarpetas) entre el 12/04/2012 y el 23/04/2012:

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

Obtener historial no recursivo de una carpeta

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

Muestra el historial de la carpeta SolutionA en la ventana Historial, lo que le permite explorar los cambios anteriores efectuados en la carpeta. Por ejemplo, si el cambio más reciente en la carpeta es un cambio de nombre, puede expandir el conjunto de cambios para ver los cambios que se produjeron antes de cambiar el nombre.

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

Muestra el cambio más reciente en la carpeta SolutionA de la ventana del símbolo del sistema.

Trabajar en Visual Studio

Sugerencias

  • Sugerencia Para obtener información sobre cómo usar la ventana Historial, vea Obtener el historial de un elemento.

  • Sugerencia Para obtener información más detallada sobre un conjunto de cambios (por ejemplo, si desea ver los elementos de trabajo asociados):

    • En la ventana Historial, haga doble clic en el conjunto de cambios, o abra el menú contextual, y elija Detalles del conjunto de cambios.

    • Desde el símbolo del sistema, utilice el comando Changeset Command.

  • Sugerencia Para obtener más información sobre los conjuntos de cambios, vea Buscar y ver conjuntos de cambios.

  • Sugerencia La opción /collection resulta útil para ejecutar este comando desde un equipo y una cuenta de usuario que no tenga ningún área de trabajo asignada a la colección de proyectos de equipo que contiene los elementos.

  • Sugerencia Vea Ver y administrar versiones pasadas.