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

  • Artigo

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

Visual Studio 2019 | 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

Para usar o lock comando, você deve ter a permissão Bloquear definida como Permitir. Você precisa da permissão Desbloquear alterações de outro usuário definida como Permitir para remover um bloqueio mantido por outro usuário se não tiver permissão de Gravação para o espaço de trabalho 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

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 para determinar quais itens estão dentro do escopo, consulte Usar opções para modificar o funcionamento de itemspec um comando.

Nota

Você pode especificar mais de um itemspec argumento.

<workspacename>

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

<username>

Fornece um valor para a /login opção. Você pode especificar um username valor como um ou usernameDOMAIN\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 um item seja submetido a check-out e editado em todos os espaços de trabalho, mas impede que os usuários façam check-in de alterações no item fora do especificado /workspace 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.

Observações

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, você deve usar o comando Permission em vez disso.

Nota

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 tf comando, consulte Usar comandos de controle de versão do Team Foundation.

Como bloquear um item

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

Para add e branch, o bloqueio é colocado no namespace onde o novo item será criado. Os bloqueios colocados com rename aplicam-se 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, uma alteração de bloqueio será adicionada ao conjunto de alterações pendentes do espaço de trabalho. Ao contrário do checkout comando, 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 none opção. 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