Changeset (Comando)
Muestra información sobre los atributos y permite cambiarlos, como los comentarios y notas de protección asociados a un conjunto de cambios.
Permisos necesarios
Para utilizar el comando changeset, debe tener el permiso Leer establecido en Permitir para los archivos o carpetas del conjunto de cambios de los que desea mostrar información completa. Los únicos usuarios que pueden modificar las notas y los comentarios asociados a un conjunto de cambios son aquéllos que crearon el conjunto de cambios o que tengan el permiso global Revisar los cambios de otros usuarios. Para obtener más información, vea Permisos de Team Foundation Server.
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Parámetros
Argumento |
Descripción |
|---|---|
comment |
Proporciona un comentario sobre la protección. |
@commentfile |
Especifica una ruta de acceso de un archivo en disco que contiene el comentario utilizado para la protección. |
NoteFieldName=NoteFieldValue |
Establece el valor del campo de nota de protección. Puede proporcionar varias expresiones "campo=valor" separadas por punto y coma. |
@notefile |
Proporciona la ruta de acceso de un archivo en disco que contiene los nombres y valores del campo de nota de protección en el formato "campo=valor", con uno por línea. |
TeamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene un conjunto de cambios sobre el que desea mostrar información o cuyos atributos desea modificar (por ejemplo, http://myserver:8080/tfs/DefaultCollection). |
username |
Proporciona un valor para la opción /user. Puede especificar este argumento como Dominio\NombreDeUsuario o NombreDeUsuario. |
changesetnumber |
Identifica el conjunto de cambios que se va a revisar o modificar. No se puede utilizar con /latest. |
Opción |
Descripción |
|---|---|
/comment |
Reemplaza el comentario del conjunto de cambios que se creó durante el proceso de protección por un nuevo comentario. |
/notes |
Proporciona una o varias notas de protección para asociar al conjunto de cambios. |
/latest |
Especifica el conjunto de cambios más reciente. No se puede utilizar con changesetnumber. |
/noprompt |
Suprime todos los mensajes de solicitud de datos. |
/collection |
Especifica la colección del proyecto de equipo. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server. |
Comentarios
Un conjunto de cambios es un conjunto de revisiones de archivos y carpetas que se confirmaron en el servidor control de versiones de Team Foundation como parte del mismo evento de protección. Para obtener más información, vea Trabajar con conjuntos de cambios.
Puede utilizar el comando changeset para ver los atributos de un conjunto de cambios y modificar sus propiedades. Puede utilizar el comando History para determinar sobre qué conjunto de cambios desea obtener información. Para obtener más información, vea History (Comando).
Para obtener vínculos a otros comandos de Team Foundation que proporcionan información adicional acerca de 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 información detallada sobre el conjunto de cambios 8675309 en un formato modificable en el cuadro de diálogo Conjunto de cambios y reemplaza el comentario existente por "This is a new comment" (Este comentario es nuevo).
Después de presionar ENTRAR, aparece el cuadro de diálogo Detalles del conjunto de cambios <número del conjunto de cambios> - Archivos de código fuente. Haga clic en Guardar para asociar el comentario al conjunto de cambios.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
El ejemplo siguiente proporciona dos notas de protección para asociar al conjunto de cambios.
c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309
El ejemplo siguiente proporciona dos notas de protección que incluyen espacios en los valores y nombres que se van a asociar al conjunto de cambios.
c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309
El ejemplo siguiente asocia las notas de protección incluidas en notes.txt del archivo con el conjunto de cambios 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
Donde notes.txt puede estar en el formato siguiente:
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
En el ejemplo siguiente se reemplaza el comentario existente para el conjunto de cambios 8675309 y se muestra información sobre el conjunto de cambios en la ventana de símbolo del sistema. El ejemplo no inicia el cuadro de diálogo Conjunto de cambios.
c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309
El ejemplo siguiente muestra la información no modificable sobre el conjunto de cambios 8675309 en la ventana Símbolo del sistema.
c:\projects>tf changeset 8675309 /noprompt
Resultados de ejemplo:
Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment: This check-in fixes issues in several features. I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
$/baz/proj/bif.c Added
$/baz/proj/buf.c Modified, Renamed
Work Items:
34527 The "Access Denied" message is not descriptive enough.
35628 The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
Code Reviewer: ShellM
Performance Reviewer: ShellM
Security Reviewer: ShellM
Vea también
Referencia
Conceptos
Trabajar con conjuntos de cambios