Comando history (Control de versiones de Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

El comando tf history de Control de versiones de Team Foundation (TFVC) muestra el historial de revisiones de uno o varios archivos o carpetas. Los datos del comando se muestran en la ventana Historial de Visual Studio o, si se especifica la opción /noprompt, en el símbolo del sistema.

También se puede usar Visual Studio para obtener el historial de revisiones. Para obtener más información, vea Obtención del historial de un elemento.

Requisitos previos

Vea Permisos de TFVC predeterminados.

Sintaxis

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 que contiene los elementos. Por ejemplo: http://myserver:8080/tfs/DefaultCollection.

De forma predeterminada, se da por hecho que la colección de proyectos es una que contiene el área de trabajo asignada al directorio actual.

/format

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

• Brief (valor predeterminado): muestra una línea por 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 más datos, 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. Para obtener más información, vea este artículo de 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 la sintaxis, vea Uso de comandos de Control de versiones de Team Foundation.

/noprompt

Suprime la visualizació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 Uso de comandos de 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 que ejecuta el comando. Vea Uso de comandos de 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. Para obtener más información, vea este artículo de 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. Si se usa un símbolo de asterisco (*), se incluyen los datos de los cambios realizados por todos los usuarios (valor predeterminado).

/version:<versionspec>

Especifica la versión máxima, o bien las versiones mínima y máxima, usando la sintaxis de intervalo ~. El valor predeterminado es /version:W, que es la versión del área de trabajo.

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

Para obtener la sintaxis, vea Uso de comandos de Control de versiones de Team Foundation.

Observaciones

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

  • En la ventana Historial de Visual Studio, haga doble clic (o clic con el botón derecho) en el conjunto de cambios y seleccione Detalles del conjunto de cambios.

  • Desde el símbolo del sistema, use el comando changeset.

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

Ejemplos

En los siguientes ejemplos se da por hecho que c:\code\SiteApp\Main se asigna a la carpeta principal del área de trabajo.

Obtener historial de un solo archivo

En el siguiente ejemplo se muestran todos los cambios realizados en program2.cs en la ventana Historial.

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

En el siguiente ejemplo se muestran todos los cambios realizados en program2.cs en la ventana de símbolo del sistema.

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

Salida:

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

En el siguiente ejemplo se muestran todos los cambios realizados en todos los elementos de SolutionA (incluidos los que están en subcarpetas) en la ventana Historial.

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

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

En el siguiente ejemplo se muestran los cinco últimos cambios realizados en los elementos de SolutionA (incluidos los que están en subcarpetas) en la ventana del símbolo del sistema:

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

Salida:

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

En el siguiente ejemplo se muestran los cambios realizados en los elementos de SolutionA (incluidos los que están en subcarpetas), en la versión 30 y anteriores, en la ventana del símbolo del sistema:

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

Salida:

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

En los siguientes ejemplos se muestran los cambios realizados en los elementos de SolutionA (incluidos los que están en subcarpetas), con fecha del 4/23/12 o anterior, en la ventana del símbolo del sistema:

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

O:

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

Salida:

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

Obtención del historial a partir de un intervalo de fechas

En el siguiente ejemplo se muestran los cambios realizados en los elementos de SolutionA (incluidos los que están en subcarpetas), entre las fechas 4/12/2012 and 4/23/2012, en la ventana del símbolo del sistema:

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

Salida:

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

En el siguiente ejemplo se muestran detalles de los cambios realizados en los elementos de SolutionA (incluidos los que están en subcarpetas), entre las fechas 4/12/2012 and 4/23/2012, en la ventana del símbolo del sistema:

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

Salida:

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

En el siguiente ejemplo se muestra el historial de la carpeta SolutionA en la ventana Historial, lo que permite explorar los cambios efectuados anteriormente 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 .

En el siguiente ejemplo se muestra el cambio más reciente en la carpeta SolutionA en la ventana del símbolo del sistema.

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

Artículos relacionados

• Para obtener información sobre cómo usar la ventana Historial, vea Obtención del historial de un elemento.
• Para obtener más información sobre los conjuntos de cambios, vea Búsqueda y visualización de conjuntos de cambios.
• Vea también Visualización y administración de versiones anteriores.