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. .gif "Nota") Nota
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:
|
/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)
Conceptos
Introducción a los tipos de bloqueo
Crear un área de trabajo para trabajar con el proyecto de equipo