Comando changeset

  • Artículo

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