Partilhar via

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

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | do Visual Studio 2022

O comando Team Foundation Version Control (TFVC) 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 espaço de trabalho diferente ou de fazer check-in de alterações pendentes em um item de um espaço de trabalho diferente.

Pré-requisitos

Categoria Requerimentos
Permissões - Bloquear permissão definida como Permitir.
- Desbloqueie as permissões de alterações de outros usuários definidas como Permitir se você não tiver permissão de Gravação para o espaço de trabalho de um usuário bloqueado.

Para obter mais informações, consulte Default TFVC permissions.

Sintaxe

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

Parâmetros

Argumentos

Argumento

Descrição

<itemspec>

Identifica o arquivo ou 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.

Observação

Você pode especificar mais de um itemspec argumento.

<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 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 Compreender os tipos de bloqueio.

Opções de bloqueio:

  • None: Remove um bloqueio de um item.

  • Checkin: Permite que seja feito check-out e editado de um item em todos os espaços de trabalho, mas impede que os usuários façam check-in de 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 espaço de trabalho, a operação de bloqueio falhará.

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

/workspace

Especifica o nome de um espaço de trabalho diferente no qual aplicar o bloqueio. Por padrão, o bloqueio é aplicado no espaço de trabalho em que 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.

Comentários

Você pode usar o comando lock 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 ter que resolver conflitos de mesclagem. Se você quiser impedir permanentemente o acesso a um item no servidor TFVC, use o comando Permission em vez disso.

Observação

Como cortesia para seus colegas de equipe, notifique-os quando você aplicar um bloqueio a um item, explique por que está fazendo isso e estime 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 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 antigo e novo. Para obter mais informações, consulte Bloquear e desbloquear pastas ou arquivos.

Tipos de bloqueio

TFVC fornece dois tipos de fechaduras: 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 espaços de trabalho. Não é possível fazer check-in das alterações até que você remova explicitamente o bloqueio de check-in do espaço de trabalho.

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 com controle de 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. Não é possível adquirir um bloqueio de check-out se houver alterações pendentes em um item.

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

Como funciona o bloqueio

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

Os 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 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 espaço de trabalho.

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 façam check-out 314.cs.

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

O exemplo a seguir impede que outros usuários façam check-in de alterações em 1256.cs mas permite que eles façam check-out em seus espaços de trabalho.

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

O exemplo a seguir impede que outros usuários façam alterações pendentes em 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 por outros usuários.

c:\projects>tf lock /lock:none $/src
  • Last updated on