Compartir a través de

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

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

Prerrequisitos

Consulte permisos predeterminados de TFVC.

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 supone que la colección de proyectos es la que contiene el área de trabajo que asigna el directorio actual.

/format

Especifica cuánto detalle se debe mostrar sobre cada conjunto de cambios cuando se especifica la opción /noprompt:

  • Brief (valor predeterminado): muestra una línea sobre cada conjunto de cambios que incluye: número de identificador, cambios realizados, usuario que realizó los cambios, fecha y comentario. Algunos de los datos se pueden truncar.

  • 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 con la hora, los elementos modificados, las notas de registro y las advertencias de la directiva de protección.

/itemmode

No se puede combinar esta opción con la opción /slotmode. Para obtener más información, vea Matt Mitrik: Cambio al modo ranura en TFS 2010 Control de versiones.

<itemspec>

Especifica los elementos para los que se va a mostrar el historial. Para obtener una sintaxis, consulte Usar comandos de control de versiones de Team Foundation.

/noprompt

Suprime la presentación de ventanas y cuadros de diálogo, como la ventana historial de y redirige los datos de salida al símbolo del sistema. Consulte Usar comandos de control de versiones de Team Foundation.

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

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

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

/recursive

Recupera de forma recursiva los datos históricos de los elementos del directorio especificado y de los subdirectorios.

/slotmode

No se puede combinar esta opción con la opción /itemmode. Para obtener más información, vea Matt Mitrik: Cambio al modo ranura en TFS 2010 Control de versiones.

/sort

Ordena el historial de revisiones de uno o varios archivos o carpetas en cualquiera de los siguientes pedidos:

  • 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. Un símbolo asterisco (*) incluye datos sobre los cambios de todos los usuarios, el valor predeterminado.

/version:<versionspec>

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

No se puede combinar esta opción con la opción /slotmode.

Para obtener una sintaxis, consulte Usar 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 haga clic con el botón derecho en el conjunto de cambios y elija Detalles del conjunto de cambios.

    • En el símbolo del sistema, use el comando Changeset.

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

Ejemplos

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

Obtención del historial de un único archivo

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

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

En el ejemplo siguiente se muestran todos los cambios realizados en program2.cs en la ventana del 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 el historial de todos los elementos de una carpeta

En el ejemplo siguiente se muestran todos los cambios realizados en todos los elementos de SolutionA, incluidos los de subcarpetas, en la ventana historial de.

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

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

En el ejemplo siguiente se muestran los cinco últimos cambios realizados en los elementos de SolutionA, incluidos los de 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

Obtención del historial de la versión x y anteriores

En el ejemplo siguiente se muestran los cambios realizados en todos los elementos de SolutionA, incluidos los de 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

Obtención del historial de la fecha D y anteriores

En los ejemplos siguientes se muestran los cambios realizados en todos los elementos de SolutionA, incluidos los de subcarpetas, el 4/23/12 o versiones anteriores, 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

Obtener el historial de una variedad de fechas

En el ejemplo siguiente se muestran los cambios realizados en todos los elementos de SolutionA, incluidos los de subcarpetas, entre 4/12/2012 y 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 ejemplo siguiente se muestran detalles sobre los cambios realizados en todos los elementos de SolutionA, incluidos los de subcarpetas, entre 4/12/2012 y 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 el historial no recursivo de una carpeta

En el ejemplo siguiente se muestra el historial de la carpeta SolutionA en la ventana Historial de de Visual Studio, lo que le permite explorar los cambios anteriores en la carpeta. Por ejemplo, si el cambio más reciente a la carpeta era un cambio de nombre, puede expandir el conjunto de cambios para ver los cambios que se produjeron antes del cambio de nombre.

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

En el ejemplo siguiente 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