Compartilhar via

Comando Lock (Controle de Versão do Team Foundation)

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O TFVC (Controle de Versão do Team Foundation) lock bloqueia ou desbloqueia um arquivo ou pasta. O comando nega ou restaura o direito dos usuários de fazer check-out de um item para edição em um workspace diferente ou fazer check-in de alterações pendentes em um item de um workspace diferente.

Pré-requisitos

Para usar o comando lock, tenha a permissão Bloquear definida como Permitir. Você precisa do Desbloquear as alterações de outros usuários permissão definida para Permitir remover um bloqueio mantido por outro usuário se você não tiver permissão Gravar para o workspace desse usuário. Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

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

Parâmetros

Argumentos

de argumento

descrição

<itemspec>

Identifica o arquivo ou a pasta a ser bloqueado ou desbloqueado. Para obter mais informações sobre como o TFVC analisa o itemspec para determinar quais itens estão dentro do escopo, consulte Usar opções para modificar como um comando funciona.

Nota

Você pode especificar mais de um argumento itemspec.

<workspacename>

O valor fornecido pelo usuário para a opção /workspace.

<username>

Fornece um valor para a opção /login. Você pode especificar um valor username como DOMAIN\username ou username.

<TeamProjectCollectionUrl>

A URL da coleção de projetos que contém o arquivo ou a pasta que você deseja bloquear ou desbloquear, por exemplo, http://myserver:8080/tfs/DefaultCollection.

Opções

opção

descrição

/lock

Especifica um tipo de bloqueio ou remove um bloqueio de um item. Para obter mais informações, consulte Noções básicas sobre os tipos de bloqueio.

Opções de bloqueio:

  • None: remove um bloqueio de um item.

  • Checkin: permite que um item seja verificado e editado em todos os workspaces, mas impede que os usuários verifiquem as alterações no item fora do /workspace especificado até que você libere explicitamente o bloqueio de check-in. Se o item especificado estiver bloqueado em qualquer outro workspace, a operação de bloqueio falhará.

  • Checkout: impede que os usuários faça check-in ou faça check-out dos itens especificados até que você libere explicitamente o bloqueio. Se os usuários bloquearem qualquer um dos itens especificados ou se houver alterações pendentes em qualquer um dos itens, a operação de bloqueio falhará.

/workspace

Especifica o nome de um workspace diferente no qual aplicar o bloqueio. Por padrão, o bloqueio é aplicado no workspace no qual você está atualmente.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

/collection

Especifica a coleção de projetos.

Observações

Você pode usar o comando de bloqueio para congelar temporariamente a versão do servidor TFVC de um item para que você possa fazer check-in de uma alteração pendente sem precisar resolver conflitos de mesclagem. Se você quiser impedir permanentemente o acesso a um item no servidor TFVC, deverá usar o comando permissão em vez disso.

Nota

Como cortesia para seus colegas de equipe, notifique-os quando você aplicar um bloqueio a um item, explicar por que você está fazendo isso e estimar quando planeja remover o bloqueio, se puder.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Como bloquear um item

Você pode bloquear um item usando o comando lock ou especificando uma opção de lock durante a comissão de vários outros comandos do utilitário de linha de comando tf, incluindo:

Para add e branch, o bloqueio é colocado no namespace onde o novo item será criado. Os bloqueios colocados com rename se aplicam aos namespaces antigos e novos. Para obter mais informações, consulte Bloquear e desbloquear pastas ou arquivos.

Tipos de bloqueio

O TFVC fornece dois tipos de bloqueios: checkin e checkout.

Um bloqueio de check-in é menos restritivo do que um bloqueio de check-out. Quando você aplica um bloqueio de check-in, os usuários podem continuar a fazer alterações locais no item em outros workspaces. As alterações não podem ser verificadas até que você remova explicitamente o bloqueio de check-in do workspace.

Um bloqueio de check-out é mais restritivo do que um bloqueio de check-in. Quando você aplica um bloqueio de check-out a um arquivo ou pasta controlado por versão, os usuários não podem fazer check-out do item para edição nem fazer check-in de alterações pendentes pré-existentes. Você não poderá adquirir um bloqueio de check-out se houver alterações pendentes em um item no momento.

Para obter mais informações sobre quando aplicar um bloqueio de check-out e quando aplicar um bloqueio de check-in, consulte Entenda os tipos de bloqueio.

Como o bloqueio funciona

Se você tiver um arquivo com check-out ao bloqueá-lo, seu status será modificado para conter o novo tipo de bloqueio. Se os arquivos não forem verificados, um bloqueio alteração será adicionado ao conjunto de alterações pendentes do workspace. Ao contrário do comando checkout, lock não torna automaticamente um arquivo editável.

Bloqueios em pastas são implicitamente recursivos. Se você bloquear uma pasta, não precisará bloquear os arquivos que ela contém, a menos que você queira aplicar o bloqueio de check-out mais restritivo a um arquivo em uma pasta que tenha um bloqueio de check-in.

Desbloquear um item

Você pode desbloquear um item bloqueado usando a opção none. O TFVC também desbloqueia um item automaticamente quando você faz check-in de alterações pendentes no workspace.

Você pode determinar quais arquivos estão bloqueados no servidor TFVC e por quem os arquivos foram bloqueados usando o comando status .

Exemplos

O exemplo a seguir impede que outros usuários saiam 314.cs.

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

O exemplo a seguir impede que outros usuários verifiquem as alterações para 1256.cs mas permite que eles façam check-out em seus workspaces.

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

O exemplo a seguir impede que outros usuários sejam alterados pendentes para quaisquer itens na pasta $/src no servidor TFVC.

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

O exemplo a seguir desbloqueia e disponibiliza todos os arquivos na pasta do servidor $/src TFVC para check-out e check-in de outros usuários.

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