Comando Bloquear

Bloqueia ou desbloqueia um arquivo ou pasta para negar ou restaurar o direito de usuários a fazer check-out de um item para edição em um espaço de trabalho diferente ou fazer check-in alterações pendentes para um item de um espaço de trabalho diferente.

Permissões necessárias

Para usar o lock de comando, você deve ter o Lock permissão definida Permitir. Tendo o desbloqueio de conjunto de permissões de alterações do outro usuário Permitir é necessária para remover um bloqueio mantido por outro usuário, se você não tem gravar permissão para o espaço de trabalho do usuário. For more information, see Permissões de Team Foundation Server.

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

Parâmetros

Argument

Description

itemspec

Identifica o arquivo ou pasta para bloquear ou desbloquear. Para obter mais informações sobre como Team Foundation itemspecs analisa para determinar quais itens estão dentro do escopo, consulte Opções de linha de comando.

ObservaçãoObservação
Você pode especificar mais de um Itemspec argumento.

workspacename

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

username

Fornece um valor para o /login opção. Você pode especificar um valor de username como domínio\nome de usuário ou nome de usuário.

TeamProjectCollectionUrl

A URL da coleção de projeto de equipe que contém o arquivo ou pasta que deseja bloquear ou desbloquear (por exemplo, http://myserver:8080/tfs/DefaultCollection).

Option

Description

/lock

Especifica o tipo de bloqueio ou remove um bloqueio de um item. For more information, see Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • None

    Remove um bloqueio de um item.

  • Checkin

    Permite que um item a ser check-out e editado em todos os espaços de trabalho, mas impede que usuários verificar as alterações para o item fora especificado /workspace até você liberar explicitamente o check-in bloqueio. Se o item especificado está bloqueado em qualquer outro espaço de trabalho, a operação de bloqueio falhará.

  • Check-out

    Impede que usuários fazendo check-in ou check-out de itens especificados, até que você explicitamente libera o bloqueio. Se usuários bloquearam qualquer um dos itens especificados, ou se as alterações pendentes existe contra qualquer um dos itens, a falha de operação de bloqueio.

/workspace

Especifica o nome de outro espaço de trabalho no qual aplicar o bloqueio. Por padrão, o bloqueio é aplicado no espaço de trabalho no qual você está atualmente.

/login

Especifica o nome de usuário e senha para autenticar o usuário com Visual Studio Team Foundation Server.

/collection

Especifica a coleção de projeto de equipe.

Comentários

Você pode usar o comando lock para congelar temporariamente o Controle de versão do Team Foundation versão do servidor de um item para que você possa verificar em uma alteração pendente sem precisar resolver conflitos de mesclagem. Se você deseja impedir o acesso a um item permanentemente a Controle de versão do Team Foundation server, você deve usar o Comando de permissão em vez disso.

ObservaçãoObservação

Como cortesia aos seus colegas de equipe, notificá-los quando você aplica um bloqueio para um item, explique por que estão fazendo isso e estimar quando você planeja remover o bloqueio, se possível.

Para obter mais informações sobre como localizar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.

Como bloquear um Item

Você pode bloquear um item usando o bloqueio ou especificando uma opção de bloqueio durante a comissão de vários outros comandos da tf um utilitário de linha de comando que inclui:

Para adicionar e filiais, o bloqueio é colocado no namespace onde o novo item será criado. Bloqueios colocados com renomeação se aplicam a ambos os espaços para nome antigo e novo. For more information, see Bloquear e desbloquear arquivos ou pastas.

Tipos de bloqueio

Team Foundationfornece dois tipos de bloqueios: checkin and 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 fazer alterações de locais para o item em outros espaços de trabalho. As alterações não podem ser verificadas até que você explicitamente remova o bloqueio de check-in do espaço de trabalho.

Um bloqueio no check-out é mais restritivo do que um bloqueio de check-in. Quando você aplica um bloqueio no check-out para um controle de versão arquivo ou pasta, os usuários não podem fazer check-out do arquivo para edição nem fazer check-in preexistente alterações pendentes. Se não existem alterações pendentes para um item, você não pode adquirir um bloqueio de check-out.

Para obter mais informações sobre quando aplicar um bloqueio no check-out e quando aplicar um bloqueio de check-in, consulte Noções básicas sobre tipos de bloqueio.

Como funciona o bloqueio

Se você tiver um arquivo de check-out ao bloqueá-lo, seu status é modificado para conter o novo tipo de bloqueio. Se os arquivos não são checked out, o "bloqueio" alteração é adicionada ao conjunto de alterações de espaço de trabalho pendentes. Ao contrário do checkout comando, lock não tornar automaticamente um arquivo editável.

Os bloqueios de pastas são, implicitamente, recursiva. Se você bloquear uma pasta, você precisa bloquear os arquivos que nela contidos, a menos que você deseja aplicar o bloqueio de check-out mais restritivo para um arquivo em uma pasta que tenha um bloqueio de check-in.

Desbloqueando um Item

Você pode desbloquear um item bloqueado usando o none opção. Além disso, Team Foundation desbloqueia um item automaticamente quando você verificar alterações pendentes na área de trabalho.

Você pode determinar quais arquivos estão presos a Controle de versão do Team Foundation server e por quem os arquivos foram bloqueados usando o Comando de status.

Examples

O exemplo a seguir impede que outros usuários fazendo check-out de 314.cs.

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

O exemplo a seguir impede que outros usuários verificar as alterações para 1256.cs, mas permite o check-out nos seus espaços de trabalho.

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

O exemplo a seguir impede que outros usuários alterações pendentes para todos os itens do src / pasta do Controle de versão do Team Foundation server.

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

O exemplo a seguir desbloqueia e torna a todos os arquivos do src / Controle de versão do Team Foundation a pasta do servidor disponível para check-out e check-in por outros usuários.

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

Consulte também

Referência

Sintaxe de linha de comando (controle de versão)

Check-out e editar comandos

Comando de status

Conceitos

Noções básicas sobre tipos de bloqueio

Configurar a sua máquina de desenvolvimento para trabalhar com projeto do sua equipe

Outros recursos

Comandos do utilitário de linha de comando do TF

Trabalhando com bloqueios de controle de versão