Compartir a través de

Comando Lock (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | de Visual Studio 2022

El control de versiones de Team Foundation (TFVC) lock bloquea o desbloquea un archivo o carpeta. El comando deniega o restaura el derecho de los usuarios a consultar un elemento para su edición en un área de trabajo diferente o para proteger los cambios pendientes en un elemento de otra área de trabajo.

Prerrequisitos

Para usar el comando lock, tenga establecido el permiso Bloquear en Permitir. Necesita el Desbloquear los cambios de otro usuario permiso establecido en Permitir que quite un bloqueo mantenido por otro usuario si no tiene permiso de escritura para el área de trabajo de ese usuario. Para obtener más información, consulte permisos predeterminados de TFVC.

Sintaxis

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

Parámetros

Argumentos

de argumentos de

descripción

<itemspec>

Identifica el archivo o la carpeta que se va a bloquear o desbloquear. Para obtener más información sobre cómo TFVC analiza el itemspec para determinar qué elementos están dentro del ámbito, vea Usar opciones para modificar cómo funciona un comando.

Nota

Puede especificar más de un argumento itemspec.

<workspacename>

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

<username>

Proporciona un valor a la opción /login. Puede especificar un valor de username como DOMAIN\username o username.

<TeamProjectCollectionUrl>

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

Opciones

de opción de

descripción

/lock

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

Opciones de bloqueo:

  • None: quita un bloqueo de un elemento.

  • Checkin: permite desproteger y editar un elemento en todas las áreas de trabajo, pero impide que los usuarios protejan los cambios en el elemento fuera del /workspace especificado hasta que se libere explícitamente el bloqueo de entrada. Si el elemento especificado está bloqueado en cualquier otra área de trabajo, se produce un error en la operación de bloqueo.

  • Checkout: impide que los usuarios inicien sesión o desprotezque 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 en cualquiera de los elementos, se produce un error en la operación de bloqueo.

/workspace

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

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

/collection

Especifica la colección de proyectos.

Observaciones

Puede usar el comando lock para inmovilizar temporalmente la versión del servidor TFVC de un elemento para que pueda proteger un cambio pendiente sin tener que resolver ningún conflicto de combinación. Si desea impedir permanentemente el acceso a un elemento del servidor TFVC, debe usar el comando Permiso en su lugar.

Nota

Como cortesía de sus compañeros de equipo, notifíquelos cuando aplique un bloqueo a un elemento, explique por qué está haciendo esto y calcule cuándo planea quitar el bloqueo, si puede.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar comandos de control de versiones de Team Foundation.

Cómo bloquear un elemento

Puede bloquear un elemento mediante el comando lock o especificando una opción de lock durante la comisión de otros comandos de la utilidad de línea de comandos tf, incluidos:

Para add y branch, el bloqueo se coloca en el espacio de nombres donde se creará el nuevo elemento. Los bloqueos colocados con rename se aplican tanto a los espacios de nombres antiguos como a los nuevos. Para obtener más información, consulte Bloquear y desbloquear carpetas o archivos.

Tipos de bloqueo

TFVC proporciona dos tipos de bloqueos: checkin y checkout.

Un bloqueo de registro es menos restrictivo que un bloqueo de des check-out. Al aplicar un bloqueo de registro, los usuarios pueden seguir realizando cambios locales en el elemento de otras áreas de trabajo. Los cambios no se pueden proteger hasta que quite explícitamente el bloqueo de entrada del área de trabajo.

Un bloqueo de des check-out es más restrictivo que un bloqueo de registro. Cuando se aplica un bloqueo de desproteger a un archivo o carpeta controlado por versiones, los usuarios no pueden desproteger el elemento para editar ni proteger los cambios pendientes preexistentes. No se puede adquirir un bloqueo de des check-out si actualmente hay cambios pendientes en un elemento.

Para obtener más información sobre cuándo aplicar un bloqueo de des check-out y cuándo aplicar un bloqueo de registro, consulte Descripción de los tipos de bloqueo.

Funcionamiento del bloqueo

Si tiene un archivo desprotegido al bloquearlo, su estado se modifica para contener el nuevo tipo de bloqueo. Si los archivos no están desprotegido, se agrega un bloqueo cambio al conjunto de cambios pendientes del área de trabajo. A diferencia del comando checkout, lock no hace que un archivo se pueda editar automáticamente.

Los bloqueos en carpetas son recursivos implícitamente. Si bloquea una carpeta, no tiene que bloquear los archivos que contiene a menos que desee aplicar el bloqueo de descons check-out más restrictivo a un archivo de una carpeta que tenga un bloqueo de registro.

Desbloquear un elemento

Puede desbloquear un elemento bloqueado mediante la opción none. TFVC también desbloquea un elemento automáticamente al proteger los cambios pendientes en el área de trabajo.

Puede determinar qué archivos están bloqueados en el servidor TFVC y por los que los archivos se bloquearon mediante el comando estado de .

Ejemplos

En el ejemplo siguiente se impide que otros usuarios desprotezven 314.cs.

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

En el ejemplo siguiente se impide que otros usuarios comprueben los cambios en 1256.cs, pero les permite desprotegerlos en sus áreas de trabajo.

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

En el ejemplo siguiente se impide que otros usuarios realicen cambios pendientes en los elementos de la carpeta $/src del servidor TFVC.

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

En el ejemplo siguiente se desbloquean y hacen que todos los archivos de la carpeta del servidor $/src de $/src TFVC estén disponibles para la des check-out y la protección de otros usuarios.

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