Compartir a través de


Comando lock

Bloquea o desbloquea un archivo o carpeta a fin de denegar o restaurar los derechos de los usuarios para desproteger un elemento para su modificación en un área de trabajo diferente o proteger cambios pendientes de un elemento de otra área de trabajo.

Permisos necesarios

Para utilizar el comando lock, el permiso Bloquear debe estar establecido en Permitir. Es necesario que tenga el permiso Desbloquear los cambios de otros usuarios establecido en Permitir para quitar un bloqueo mantenido por otro usuario si no dispone del permiso Escribir para el área de trabajo de ese usuario. Para obtener más información, vea Permisos de Team Foundation Server.

tf lock itemspec /lock:(none|checkout|checkin) 
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl] 

Parámetros

Argumento

Descripción

itemspec

Identifica el archivo o carpeta que se va a bloquear o desbloquear. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Opciones de la línea de comandos.

NotaNota
Puede especificar más de un argumento Itemspec.

workspacename

Valor proporcionado por el usuario para la opción /workspace.

username

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

TeamProjectCollectionUrl

La dirección URL de la colección de proyectos de equipo que contiene el archivo o carpeta que desea bloquear o desbloquear (por ejemplo, http://myserver:8080/tfs/DefaultCollection).

Opción

Descripción

/lock

Especifica un tipo de bloqueo o quita un bloqueo de un elemento. Para obtener más información, vea Introducción a los tipos de bloqueo.

Opciones de bloqueo:

  • Ninguno

    Quita el bloqueo de un elemento.

  • Checkin

    Permite que un elemento se desproteja y modifique en todas las áreas de trabajo, pero impide que los usuarios protejan los cambios realizados en el elemento fuera del /workspace especificado hasta que se libere explícitamente el bloqueo de protección. Si el elemento especificado está bloqueado en otra área de trabajo, se produce un error en la operación de bloqueo.

  • Checkout

    Evita que los usuarios puedan proteger o desproteger los elementos especificados hasta que libere explícitamente el bloqueo. Si los usuarios han bloqueado cualquiera de los elementos especificados o si existen cambios pendientes para alguno de los elementos, se produce un error en la operación de bloqueo.

/workspace

Especifica el nombre de un área de trabajo diferente a la que aplicar el bloqueo. De forma predeterminada, el bloqueo se aplica al área de trabajo en la que se encuentra actualmente.

/login

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

/collection

Especifica la colección del proyecto de equipo.

Comentarios

Puede utilizar el comando lock para inmovilizar temporalmente la versión en el servidor control de versiones de Team Foundation de un elemento a fin de que pueda proteger un cambio pendiente sin tener que solucionar conflictos de combinación. Si desea evitar permanentemente el acceso a un elemento en el servidor control de versiones de Team Foundation, debe utilizar en su lugar Permission (Comando).

Nota

Como deferencia hacia sus compañeros de equipo, notifíqueles cuando aplica un bloqueo a un elemento, explique por qué lo hace y, si es posible, indique cuándo va a quitar el bloqueo.

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

Cómo bloquear un elemento

Puede bloquear un elemento mediante el comando lock o especificando una opción de bloqueo mientras ejecuta otros comandos de la utilidad de línea de comandos tf, entre los que se incluyen:

Con los comandos add y branch, el bloqueo se coloca en el espacio de nombres en el que se creará el nuevo elemento. Los bloqueos definidos con cambios de nombre se aplican a los espacios de nombres anteriores y nuevos. Para obtener más información, vea Bloquear y desbloquear carpetas y archivos.

Tipos de bloqueo

Team Foundation proporciona dos tipos de bloqueo: checkin y checkout.

Un bloqueo checkin es menos restrictivo que un bloqueo checkout. Cuando aplica un bloqueo checkin, los usuarios pueden continuar realizando cambios locales en el elemento en otras áreas de trabajo. Los cambios no se pueden proteger hasta que se quite explícitamente el bloqueo checkin del área de trabajo.

Un bloqueo checkout es más restrictivo que un bloqueo checkin. Cuando aplica un bloqueo checkout a un archivo o carpeta con control de versiones, los usuarios no pueden desproteger el archivo para modificarlo ni proteger cambios pendientes que ya existían. No puede aplicar un bloqueo checkout si existe algún cambio pendiente para un elemento.

Para obtener más información sobre cuándo aplicar un bloqueo checkout o un bloqueo checkin, vea Introducción a los tipos de bloqueo.

Cómo funciona el bloqueo

Si un archivo está desprotegido cuando lo bloquea, su estado se modifica para contener el nuevo tipo de bloqueo. Si los archivos no están desprotegidos, se agrega un cambio de "bloqueo" al conjunto de cambios pendientes del área de trabajo. A diferencia del comando checkout , lock no convierte automáticamente un archivo en modificable.

Los bloqueos de carpetas son implícitamente recursivos. Si bloquea una carpeta, no necesita bloquear los archivos que contiene a menos que desee aplicar el bloqueo checkout, más restrictivo, a un archivo de una carpeta que tiene un bloqueo checkin.

Desbloquear un elemento

Puede desbloquear un elemento bloqueado mediante la opción none . Además, Team Foundation desbloquea automáticamente un elemento cuando protege los cambios pendientes en el área de trabajo.

Puede determinar qué archivos están bloqueados en el servidor control de versiones de Team Foundation y quién los ha bloqueado utilizando el Status (Comando).

Ejemplos

El ejemplo siguiente impide que otros usuarios desprotejan 314.cs.

c:\projects>tf lock /lock:checkout 314.cs

El ejemplo siguiente impide que otros usuarios protejan los cambios en 1256.cs pero les permite desprotegerlo en sus áreas de trabajo.

c:\projects>tf lock /lock:checkin 1256.cs

El ejemplo siguiente impide que otros usuarios definan cambios pendientes en cualquier elemento de la carpeta src/ del servidor control de versiones de Team Foundation.

c:\projects>tf lock /lock:checkout $/src

El ejemplo siguiente desbloquea todos los archivos de la carpeta src/ del servidor control de versiones de Team Foundation y los deja disponibles para la desprotección y protección por parte de otros usuarios.

c:\projects>tf lock /lock:none src/

Vea también

Referencia

Sintaxis de la línea de comandos (Control de versiones)

Comandos checkout y edit

Status (Comando)

Conceptos

Introducción a los tipos de bloqueo

Crear un área de trabajo para trabajar con el proyecto de equipo

Otros recursos

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

Trabajar con bloqueos del control de versiones