Comando changeset
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Muestra información sobre los atributos (como comentarios y notas de inserción en el repositorio) que están asociados a un conjunto de cambios y permite cambiar dichos atributos.
Requisitos previos
Para usar el comando changeset, debe tener el permiso de Lectura establecido en Permitir para los archivos o carpetas del conjunto de cambios cuya información completa quiere mostrar. Los únicos usuarios que pueden modificar las notas y comentarios asociados a un conjunto de cambios son los que crearon el conjunto de cambios, o bien un usuario que tenga el permiso global para Revisar los cambios de otro usuario.
Para más información, vea Permisos predeterminados de TFVC.
Sintaxis
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Parámetros
Argumento
| Argument | Descripción |
|---|---|
comment |
Proporciona un comentario sobre la inserción en el repositorio. |
@<commentfile> |
Especifica una ruta de acceso a un archivo en disco que contiene el comentario que se usó para la inserción en el repositorio. |
<NoteFieldName>=<NoteFieldValue> |
Establece el valor del campo de la nota de inserción en el repositorio. Se pueden proporcionar varias expresiones field=value separadas por punto y coma. |
@<notefile> |
Proporciona la ruta de acceso a un archivo en disco que contiene los nombres y valores del campo de la nota de inserción en el repositorio en el formato field=value, con uno por línea. |
<TeamProjectCollectionUrl> |
Dirección URL de la colección de proyectos que contiene un conjunto de cambios cuya información quiere mostrar o cuyos atributos quiere modificar, por ejemplo, http://myserver:8080/tfs/DefaultCollection. |
<username> |
Proporciona un valor a la opción /user. Puede especificar este argumento como Domain\username o username. |
<changesetnumber> |
Identifica el conjunto de cambios que se va a revisar o modificar. No se puede usar con /latest. |
Opción
| Opción | Descripción |
|---|---|
/comment |
Reemplaza por un comentario nuevo el comentario del conjunto de cambios que se creó durante el proceso de inserción en el repositorio. |
/notes |
Proporciona una o más notas de inserción en el repositorio para asociarlas al conjunto de cambios. |
/latest |
Especifica el conjunto de cambios más reciente. No se puede usar con <changesetnumber>. |
/noprompt |
Suprime las solicitudes de entrada. |
/collection |
Especifica la colección de proyectos. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps. |
Observaciones
Un conjunto de cambios es un conjunto de revisiones de archivos y carpetas que se han confirmado en el servidor de Control de versiones de Team Foundation como parte del mismo evento de inserción en el repositorio. Para obtener más información, consulte Trabajo con conjuntos de cambios.
Puede usar el comando changeset para ver los atributos de un conjunto de cambios y modificar sus propiedades. Puede usar el comando history para determinar de qué conjunto de cambios quiere obtener información. Para obtener más información, consulte Comando history.
Para más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de comandos de control de versiones de Team Foundation.
Ejemplos
En el ejemplo siguiente se muestra información detallada sobre el conjunto de cambios 8675309 en un formato editable en el cuadro de diálogo Detalles del conjunto de cambios n.º 8675309: Archivos de origen de Visual Studio y se reemplaza el comentario existente por This is a new comment (Este comentario es nuevo).
c:\projects>tf changeset /comment:"This is a new comment." 8675309
Después de escribir el comando, en el cuadro de diálogo Detalles del conjunto de cambios n.º 8675309: Archivos de origen de Visual Studio, seleccione Guardar para asociar el comentario con el conjunto de cambios.
En el ejemplo siguiente se proporcionan dos notas de inserción en el repositorio para asociarlas con el conjunto de cambios.
c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309
En el ejemplo siguiente se proporcionan dos notas de inserción en el repositorio 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
En el ejemplo siguiente se asocian las notas de inserción en el repositorio incluidas en el archivo notes.txt con el conjunto de cambios 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
El archivo notes.txt puede tener el formato siguiente:
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
En el ejemplo siguiente se reemplaza el comentario existente del conjunto de cambios 8675309 y se muestra información sobre el conjunto de cambios en la ventana del símbolo del sistema. En este ejemplo no se abre el cuadro de diálogo Conjunto de cambios de Visual Studio.
c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309
En el ejemplo siguiente se muestra información no editable sobre el conjunto de cambios 8675309 en la ventana del símbolo del sistema.
c:\projects>tf changeset 8675309 /noprompt
Resultados del 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 isn't 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