Comando history
Actualización: noviembre 2007
Muestra el historial de revisión de uno o varios archivos y carpetas.
Permisos necesarios
Para usar el comando history, el permiso Leer debe estar establecido en Permitir para todos los archivos o carpetas de los que se solicita el historial. Para obtener más información, vea Permisos de Team Foundation Server.
tf history [/server:servername] itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/noprompt]
Parámetros
Argumento |
Descripción |
|---|---|
servername |
Valor proporcionado por el usuario para la opción /server. Ejemplo: teamfoundation2. |
itemspec |
Identifica el archivo o carpeta cuyo historial se va a mostrar. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Opciones de la línea de comandos. |
versionspec |
Proporciona un valor como C58 para la opción /version. Para obtener más información acerca de cómo Team Foundation analiza una especificación de versión para determinar qué elementos se encuentran en su ámbito, vea Sintaxis de la línea de comandos (Team System). |
number |
Especifica cuántos conjuntos de cambios se deben incluir en la consulta del historial. |
username |
Proporciona un valor para la opción /user. Según la configuración de la red, puede especificar DOMINIO\nombreDeUsuario o nombreDeUsuario. |
Opción |
Descripción |
|---|---|
/server |
Identifica Team Foundation Server. Se requiere esta opción si el comando se invoca desde un directorio no asignado a un área de trabajo. |
/version |
Especifica la versión de los elementos cuyo historial de revisiones se va a mostrar. De forma predeterminada, Team Foundation utiliza la versión del área de trabajo. Esta opción no se puede combinar con la opción /slotmode. |
/stopafter |
Muestra el historial delnumber de conjuntos de cambios que especifica. Por ejemplo, /stopafter:10 muestra los diez últimos cambios que se efectuaron en el elemento especificado. |
/recursive |
Recupera información histórica sobre los elementos bajo la ruta de acceso especificada. |
/user |
Filtra la lista de cambios realizados en el usuario con nombre. Se puede utilizar un asterisco (*) para seleccionar todos los usuarios. Si no se especifica, se seleccionan todos los usuarios. |
/format |
Especifica las descripciones mostradas para obtener la información de historial. Brief muestra una línea sobre cada conjunto de cambios. Detailed muestra una descripción completa del conjunto de cambios. Si no se especifica, las descripciones son breves. |
/slotmode |
Muestra el historial de revisiones de todos los elementos que han ocupado alguna vez la ubicación de espacio de nombres especificada. |
/noprompt |
Suprime todos los mensajes de solicitud de datos. |
Comentarios
El comando history abre la ventana Historial, que muestra los botones para seleccionar Detalles, Ver y Comparar. Detalles muestra los detalles del conjunto de cambios. Ver muestra las versiones de los archivos. Comparar contrasta las versiones de los archivos con la versión del área de trabajo actual si sólo se selecciona una fila o con dos versiones diferentes si se seleccionan dos filas. En el menú de acceso directo de la ventana Historial, utilice la opción copy para copiar la información de texto de las filas actualmente seleccionadas en el Portapapeles. Para obtener más información, vea Introducción a la ventana del historial.
Puede utilizar el comando history para mostrar el historial de revisiones de uno o varios archivos y carpetas. Para cada conjunto de cambios en el que se incluyeron los elementos solicitados, Team Foundation muestra una entrada de la revisión en el conjunto de cambios generado. Los detalles del conjunto de cambios incluyen información sobre el usuario que confirmó el cambio en el servidor Control de versiones de Team Foundation, los archivos y carpetas cuyos cambios pendientes se confirmaron, el tipo de cambio pendiente que se confirmó, el número de conjuntos de cambios y la fecha y hora en que se creó el conjunto de cambios.
Si no especifica versionspec, Team Foundation muestra el historial completo del archivo o carpeta. Cuando proporciona una única especificación de versión, Team Foundation muestra información retrospectiva sobre el elemento desde esa versión hasta la versión 1. Si especifica un intervalo de versiones (con la sintaxis ~ ), se muestra el historial de esas versiones y todas las intermedias. Puede especificar un intervalo en orden ascendente o descendente.
Si incluye la opción /slotmode, Team Foundation muestra el historial de revisión del elemento especificado. Por ejemplo, si ha cambiado el nombre de un archivo, esta opción muestra el nombre anterior y el nuevo. . Dado que la opción /slotmode especifica un intervalo de elementos y versiones dispares, no debe combinar las opciones /slotmode y /version.
Puede utilizar el comando history para determinar el número de conjuntos de cambios en los que se confirmó un conjunto de archivos y, a continuación, utilizar el comando changeset para mostrar información más detallada sobre la naturaleza del conjunto de cambios y la operación de protección que lo creó. O bien, en la ventana Historial, puede seleccionar una fila y, a continuación, hacer clic en el botón Detalles.
Para obtener vínculos a otros comandos de Team Foundation que proporcionan información adicional sobre los elementos del servidor Control de versiones de Team Foundation y todas las áreas de trabajo que tenga asignadas, vea Comandos de información.
Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Ejemplos
El ejemplo siguiente muestra los cambios que se produjeron entre la versión 5 y la versión 8 del conjunto de cambios para 1256.c.
c:\projects> tf history /version:C5~C8 1256.c
El ejemplo siguiente muestra los últimos diez cambios que se produjeron en 314.cs.
c:\projects> tf history /stopafter:10 314.cs
El ejemplo siguiente muestra el historial con formato de resultados detallados para la ranura de espacio de nombres 1256.c.
c:\projects> tf history /format:detailed/slotmode 1256.c
Vea también
Conceptos
Trabajar con conjuntos de cambios del control de versiones
Referencia
Sintaxis de la línea de comandos (Team System)