Comando lock
Actualización: noviembre 2007
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] [/server:servername] [/recursive]
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. |
workspacename |
Valor proporcionado por el usuario para la opción /workspace. |
servername |
Valor proporcionado por el usuario para la opción /server. Ejemplo: http://teamfoundation2:8080/. |
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. |
/server |
Especifica la dirección URL del servidor Control de versiones de Team Foundation en el que va a trabajar. Esta opción es obligatoria cuando el comando se invoca desde un directorio no asignado a un área de trabajo. |
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 Comando permission.
.gif "Nota") 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 Cómo: Bloquear y desbloquear carpetas o 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 Comando status.
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
Conceptos
Introducción a los tipos de bloqueo
Trabajar con espacios de trabajo del control de versiones
Referencia
Sintaxis de la línea de comandos (Team System)