Compartir a través de

Comando Changeset

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019

Visual Studio 2019 | de Visual Studio 2022

Muestra información sobre y permite cambiar los atributos, como comentarios y notas de registro, que están asociados a un conjunto de cambios.

Prerrequisitos

Para usar el comando changeset, tenga el permiso Leer establecido en Permitir para los archivos o carpetas del conjunto de cambios para 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 los usuarios que crearon el conjunto de cambios o un usuario que tenga el Revisar los cambios de otro usuario permiso global.

Para obtener más información, consulte 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

de argumentos de descripción
comment Proporciona un comentario sobre el registro de entrada.
@<commentfile> Especifica una ruta de acceso de un archivo en el disco que contiene el comentario usado para la comprobación.
<NoteFieldName>=<NoteFieldValue> Establece el valor del campo de nota de entrada. Puede proporcionar varias expresiones de field=value separadas por punto y coma.
@<notefile> Proporciona la ruta de acceso de un archivo en el disco que contiene los nombres y valores de campo de la nota de registro en el formato de field=value con uno por línea.
<TeamProjectCollectionUrl> Dirección URL de la colección de proyectos 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 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

de opción de descripción
/comment Reemplaza el comentario del conjunto de cambios que se creó durante el proceso de registro, por un nuevo comentario.
/notes Proporciona una o varias notas de registro para asociar con el conjunto de cambios.
/latest Especifica el conjunto de cambios más reciente. No se puede usar con <changesetnumber>.
/noprompt Suprime las solicitudes de entrada de usted.
/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 protección. Para obtener más información, vea Trabajar 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 el conjunto de cambios sobre el que desea obtener información. Para obtener más información, vea Comando historial.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar 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 visual Studio Details for Changeset 8675309 - Source Files cuadro de diálogo y reemplaza el comentario existente por Se trata de un nuevo comentario.

c:\projects>tf changeset /comment:"This is a new comment." 8675309

Después de escribir el comando, en el cuadro de diálogo Visual Studio Details for Changeset 8675309 - Source Files ,seleccione Guardar para asociar el comentario con el conjunto de cambios.

En el ejemplo siguiente se proporcionan dos notas de registro para asociar con el conjunto de cambios.

c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309

En el ejemplo siguiente se proporcionan dos notas de registro 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 registro incluidas en el archivo notes.txt con el conjunto de cambios 8675309.

c:\projects>tf changeset /notes:@notes.txt 8675309

Donde el notes.txt puede tener el siguiente formato:

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 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

Salida 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 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