Compartir a través de

Comando Checkin

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando tfVC checkin comprueba los cambios de archivo y carpeta pendientes en el servidor.

Casi todos los cambios que realice en los archivos de la máquina de desarrollo se almacenan en el área de trabajo como un cambio pendiente hasta que lo registre. Al proteger los cambios, se almacenan como un conjunto de cambios en el servidor. El comando checkin proporciona una interfaz de usuario diferente para realizar los mismos procesos documentados para Visual Studio en Comprobación del trabajo en el código base del equipo.

Consejos

  • Para dejar de lado los cambios o limpiar el área de trabajo para otra tarea, use el comando Shelve.

  • Si los conflictos bloquean la comprobación, puede usar el Resolver comando para resolverlos.

  • Si una máquina y una cuenta de usuario no tienen un área de trabajo asignada a la colección de proyectos que contiene el conjunto de estantes, puede usar las opciones /shelveset y /collection para proteger un conjunto de estantes.

Prerrequisitos

Sintaxis

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Parámetros

Parámetro

Descripción

/author:<author name>

Identifica al autor de los cambios pendientes para que un usuario pueda comprobar los cambios en nombre de otro usuario.

Requiere el permiso CheckinOther. Consulte Referencia de permisos y grupos.

/bypass

Omite un requisito de registro de entrada cerrado. Para obtener más información, vea Inserción en el repositorio en una carpeta controlada por un proceso de compilación de inserción en el repositorio validada.

/collection:<ProjectCollectionUrl>

Si usa la opción shelveset, la opción /collection especifica la dirección URL de la colección de proyectos que contiene el conjunto de estantes. Por ejemplo: http://myserver:8080/tfs/DefaultCollection.

De forma predeterminada, se supone que la colección de proyectos es la que contiene el área de trabajo que asigna el directorio actual.

/comment

Asocia un comentario al conjunto de cambios mediante uno de los argumentos siguientes:

  • "<comment>": comentario proporcionado por el usuario sobre el registro de entrada.
  • @<comment file>: la ruta de acceso a un archivo en el disco que contiene el comentario de la comprobación.

/force

Fuerza un registro de entrada en los elementos con modificaciones pendientes incluso cuando no hay ningún cambio de contenido en el archivo.

<itemspec>

Especifica el ámbito de los elementos que se van a proteger desde el área de trabajo del usuario. Puede especificar más de un argumento itemspec. Para obtener una sintaxis, consulte Usar comandos de control de versiones de Team Foundation.

/login:<username>[,<password>]

Especifica la cuenta de usuario para ejecutar el comando. Consulte Usar comandos de control de versiones de Team Foundation.

/new

El estado seleccionado de cada cambio pendiente, tal como se muestra en el cuadro de diálogo Activar. El comentario, los elementos de trabajo asociados, las notas de registro y el motivo de invalidación de la directiva de comprobación se almacenan en el equipo de desarrollo como cambios pendientes hasta que los registre. La opción /new desactiva estos metadatos de registro antes de iniciar la sesión. Esta opción y el comportamiento que modifica no tienen ningún efecto cuando se usa la opción /noprompt.

/noautoresolve

De forma predeterminada, el sistema intenta automáticamente AutoResolve All conflictos. Especifique esta opción para deshabilitar este comportamiento predeterminado. Para obtener más información, consulte Resolver conflictos de control de versiones de Team Foundation.

/noprompt

Suprime la presentación de ventanas y cuadros de diálogo, como la Casilla de cuadro de diálogo y redirige los datos de salida al símbolo del sistema. Consulte Usar comandos de control de versiones de Team Foundation.

/notes

Proporciona una o varias notas de registro para asociar con el conjunto de cambios mediante uno de los argumentos siguientes:

  • <NoteFieldName>=<NoteFieldValue>: establece el valor del campo de nota de registro. Puede proporcionar varias expresiones de field=value separadas por punto y coma.
  • @<NoteFile>: la ruta de acceso proporcionada por el usuario de un archivo en el disco que contiene nombres y valores de campo de la nota de registro en el formato de field=value. Un icono de nota separado por punto y coma puede abarcar varias líneas, por ejemplo:

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Invalida una directiva de registro mediante uno de los argumentos siguientes:

  • reason: un motivo proporcionado por el usuario por el que se omite la directiva de registro.
  • reasonfile: ruta de acceso a un archivo que contiene una descripción proporcionada por el usuario del motivo por el que se omite la directiva de registro.

/recursive

Comprueba de forma recursiva los elementos del directorio especificado y los subdirectorios.

/saved

Ignore este parámetro.

/shelveset:<shelvesetname>[;<owner>]

Especifica un conjunto de estantes que se va a proteger. El argumento opcional owner especifica un conjunto de estantes que el usuario actual no posee.

Nota:

Después de registrar el conjunto de estantes, el sistema lo elimina.

/validate

Comprueba si la comprobación se realizaría correctamente, sin proteger los archivos. El sistema evalúa las directivas de protección, las notas de registro y enumera los conflictos.

Nota:

Si no especifica la opción /noprompt, debe seleccionar el botón Activar del cuadro de diálogo Activar para validar la casilla de entrada. Después de seleccionar este botón, el sistema no comprueba los archivos.

Ejemplos

En los ejemplos siguientes se supone que c:\code\SiteApp\Main es la carpeta principal asignada a la colección de proyectos en el área de trabajo del usuario.

Proteger todos los cambios pendientes en el área de trabajo actual

El comando siguiente muestra el cuadro de diálogo Proteger, que muestra todos los cambios pendientes en el área de trabajo actual. Puede usar el cuadro de diálogo Activar para seleccionar o desactivar los cambios pendientes que desea proteger, agregar un comentario, asociar elementos de trabajo y realizar otras tareas y, a continuación, elegir el botón Proteger cuando esté listo para continuar.

c:\code\SiteApp\Main>tf checkin

Proteger todos los cambios pendientes con un comentario

En el ejemplo siguiente se comprueban todos los cambios pendientes en el área de trabajo actual y se proporciona un comentario para ayudar a los compañeros de equipo a comprender el propósito de los cambios.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Proteger un cambio en un solo elemento sin usar el cuadro de diálogo Proteger

En el ejemplo siguiente se comprueban los cambios pendientes en program.cs. No se muestra el cuadro de diálogo Activar y, si hay conflictos, el sistema no muestra la ventana de conflictos.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt