Compartir a través de


Comandos checkout y edit

Convierte en grabable el archivo local y cambia su estado Cambio pendiente a "editar" en el área de trabajo. Edit es un alias del comando Checkout. Para obtener más información, vea Cambios Pendientes.

Nota

   Cualquier edición efectuada en elementos desprotegidos no se refleja en el servidor de control de versiones de Team Foundation hasta que se realice una operación de protección. Para obtener más información, vea Proteger los cambios pendientes.

Permisos necesarios

Para utilizar el comando checkout, su permiso Desproteger debe estar establecido en Permitir, y debe ser propietario del área de trabajo o tener su permiso global Administrar áreas de trabajo establecido en Permitir. Asimismo, si utiliza la opción /lock con un valor distinto de None, su permiso Bloquear debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

tf checkout [/lock:(none|checkin|checkout)] [/recursive] 

[/type:encoding] itemspec [/login:username,[password]]

Parámetros

Argumento

Descripción

encoding

Proporciona un valor para la opción /type. Entre las alternativas se incluyen las siguientes: Text, que es un alias para la codificación de Windows actual (Windows-1252 en sistemas de EE.UU.) o Unicode (basado en la marca de orden de bytes o BOM), Binary y todas las demás codificaciones de archivo compatibles con el sistema operativo Windows. También puede utilizar Auto, que detecta el tipo automáticamente. Para obtener más información, vea Administrar tipos de archivo.

itemspec

Especifica uno o varios archivos para desproteger. Aquí puede utilizar caracteres comodín.

username

Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario.

Opción

Descripción

/type

Reemplaza manualmente la codificación de archivo que Team Foundation asocia con los archivos especificados.

/recursive

Desprotege todos los archivos que coinciden con itemspec en el directorio actual y en todas las subcarpetas del directorio actual.

/lock

Impide que otros usuarios puedan proteger o desproteger los archivos especificados. Para obtener más información, vea Introducción a los tipos de bloqueo.

Opciones de bloqueo:

  • Ninguno

    Valor predeterminado. No se aplica ningún bloqueo. Si existe algún bloqueo en el archivo especificado, la opción None lo quita.

  • Checkin

    Otros usuarios pueden desproteger los elementos especificados, pero no pueden proteger las revisiones en los archivos bloqueados hasta que libere el bloqueo. Si cualquier otro usuario ha bloqueado uno de los elementos especificados, la operación de bloqueo produce un error.

  • Checkout

    Impide que otros usuarios desprotejan cualquiera de los elementos especificados hasta que libere el bloqueo. Si cualquier otro usuario ha bloqueado uno de los elementos especificados, la operación de bloqueo produce un error.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server.

Comentarios

El comportamiento predeterminado del comando checkout se determina en función de si la opción Obtener la última versión del elemento al desprotegerlo está habilitada. Para obtener más información sobre cómo ver o cambiar esta configuración, vea Habilitar el control de versiones de Team Foundation para obtener los últimos archivos en estado de desprotección.

Si Obtener la última versión del elemento al desprotegerlo está habilitada, el comportamiento del comando checkout es similar al comportamiento de desprotección de Visual SourceSafe. Si la última versión del elemento no está en el área de trabajo, Team Foundation obtiene la última versión de Team Foundation Server y la copia en el área de trabajo. Si hay una versión anterior del mismo elemento en el área de trabajo, se sobrescribe con la última versión.

Si Obtener la última versión del elemento al desprotegerlo está deshabilitada, Team Foundation no obtiene la última versión del servidor de control de versiones de Team Foundation durante una operación de desprotección. En su lugar, convierte en grabable la versión del área de trabajo actual. Para obtener más información, vea Obtener el código fuente para el proyecto de equipo.

Puede utilizar tf edit como un alias para checkout.

De forma predeterminada, varios usuarios pueden desproteger al mismo tiempo el mismo elemento con control de versiones. Cuando utiliza tf para desproteger un elemento que tiene cambios pendientes en otra área de trabajo, la información sobre la naturaleza de esos otros cambios se imprime en la línea de comandos. En la mayoría de los entornos de desarrollo de colaboración, es poco probable que realice un cambio en el área de trabajo que represente un posible conflicto de combinación con un cambio pendiente en otra área de trabajo, o viceversa. Team Foundation le permite resolver automáticamente la mayoría de los conflictos que se producen. Para los conflictos que no se pueden resolver automáticamente, utilice el Comando resolve para decidir sin ningún riesgo qué cambio, suyo o realizado por otros usuarios, desea mantener. Si le preocupa que otros usuarios puedan realizar en sus áreas de trabajo cambios que entren en conflicto con sus cambios pendientes, puede utilizar el Status (Comando) para supervisar los cambios recién aplicados a otras áreas de trabajo. Opcionalmente, puede utilizar el Comando lock para impedir que otros usuarios puedan proteger o desproteger hasta que haya protegido o desbloqueado sus propios cambios. Como procedimiento recomendado, utilice el comando lock con precaución y notifique a sus compañeros de equipo por qué lo utiliza y cuándo piensa quitar el bloqueo.

Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.

Ejemplos

En el ejemplo siguiente se convierte 314.cs en grabable en disco y se agrega a la lista de cambios pendientes del área de trabajo.

c:\pi> tf checkout 314.cs

El ejemplo siguiente desprotege 314.cs y 271.cs.

c:\pi>tf checkout 314.cs 271.cs

En el ejemplo siguiente se desprotege page.xsl y se cambia la propiedad de codificación para el tipo de archivo de Team Foundation a text. Text es un alias para la codificación de Windows actual como Windows-1252.

c:\pi>tf checkout /type:text page.xsl

Vea también

Tareas

Desproteger y editar elementos bajo control de versiones

Referencia

Get (Comando)

Checkin (Comando)

Unshelve (Comando)

Conceptos

Introducción a los tipos de bloqueo

Configuración de desprotección de Team Foundation

Otros recursos

Comandos de la utilidad Tf de la línea de comandos