Comando label (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 comando tf label do TFVC (Controle de Versão do Team Foundation) anexa ou remove um rótulo da versão de um arquivo ou uma pasta no servidor do TFVC.

Pré-requisitos

Para usar o comando label, é necessário ter a permissão de Rótulo definida como Permitir. Para modificar ou excluir rótulos criados por outros usuários, é necessário ter a permissão Administrar rótulos definida como Permitir. Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parâmetros

Argumentos

Argument

Descrição

<labelname>

Identifica o nome do rótulo a ser anexado, modificado ou removido dos itens especificados.

@<scope>

Especifica um diretório de servidor do TFVC no qual o labelname é exclusivo. Esse parâmetro permite que você crie, gerencie, recupere e exclua independentemente um rótulo ou conjunto de itens rotulados quando dois rótulos de mesmo nome estiverem em partes diferentes do servidor do TFVC.

<ownername>

Fornece um valor como DOMAIN\JuanGo ou apenas juango para a opção /owner.

<itemspec>

Identifica o arquivo ou a pasta a serem rotulados, rotulados novamente ou modificados. Para saber mais sobre como o TFVC analisa o itemspec a fim de definir quais itens estão dentro do escopo, confira Usar os comandos de controle de versão do Team Foundation.

Observação

Você pode especificar mais de um argumento itemspec.

<versionspec>

Fornece um valor, como c2 para a opção /version. Para obter mais informações sobre como o TFVC analisa especificação de versão para determinar quais itens estão dentro do escopo, consulte Usar comandos do controle de versão do Team Foundation.

<comment>

Um comentário feito pelo usuário sobre o rótulo.

@<commentfile>

O caminho fornecido pelo usuário de um arquivo no disco que contém o comentário a ser usado no rótulo.

<username>

Mostra um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.

<TeamProjectCollectionUrl>

A URL da coleção de projetos especificada que contém uma versão de um arquivo ou uma pasta em que você deseja anexar ou excluir um rótulo, por exemplo, http://myserver:8080/tfs/DefaultCollection.

Opções

Opção

Descrição

/owner

Especifica o nome do usuário proprietário do rótulo.

/version

Opcional. Especifica a versão do arquivo ou da pasta em que o rótulo deve ser anexado, modificado ou removido. Estes são valores de conjunto de alterações, por exemplo, C93. Por padrão, o TFVC usa a versão base do workspace se versionspec não for fornecido.

/comment

Adiciona ou modifica uma descrição ou comentário do rótulo.

/child

Não documentado.

/recursive

Rotula todos os itens no diretório que correspondem a itemspec e versionspec. Não pode ser usado com a opção /delete.

/delete

Remove o rótulo.

/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

Um rótulo é um marcador que pode ser anexado a um conjunto de arquivos e pastas não relacionados no servidor do TFVC. Use o rótulo para simplificar a recuperação de arquivos e pastas em um workspace para fins de desenvolvimento ou build. Um rótulo é como um conjunto de alterações ou data/hora em que é possível adicionar e remover arbitrariamente arquivos e pastas ou alterar as versões dos itens nele. Um rótulo é uma especificação de versão que pode ser passada para os seguintes comandos do TFVC:

Tipos comuns de rótulos são rótulos de marco, como M1, Beta2 ou Release Candidate 0.

Os rótulos são específicos da versão, ou seja, só é possível anexar um a uma versão de arquivo ou pasta. Cada versão de um item pode aceitar vários rótulos.

Um rótulo não é um objeto com versão. Portanto, o histórico de rótulos de arquivos não é rastreado. Além disso, uma operação de rótulo não cria uma alteração pendente em seu workspace. Quando você executa o comando label, a atualização é aparece imediatamente no servidor do TFVC.

Para saber mais sobre como usar o utilitário de linha de comando tf, confira Usar comandos do Controle de Versão do Team Foundation.

Remover e excluir rótulos

É possível usar o comando unlabel para remover um rótulo de um arquivo ou pasta. Outra opção é excluir um rótulo do sistema com o comando tf label /delete.

Para saber mais sobre um rótulo existente que inclui uma lista dos itens aos quais foi anexado, seu comentário, escopo e proprietário, confira o comando labels.

Gerenciar rótulos sobrecarregados

Os nomes de rótulo devem ser exclusivos em um escopo especificado. Ao adicionar um rótulo, você reserva o uso desse nome de rótulo no escopo especificado ou implícito. O valor padrão para o parâmetro @scope é o projeto, por exemplo, $/TeamProject1.

Se outra equipe ou usuário adicionar um rótulo comum como M3 a um conjunto de arquivos controlados por versão em uma parte diferente do servidor do TFVC, será possível aplicar o rótulo M3 a arquivos controlados por versão em seu projeto, desde que as pastas de projeto raiz estejam em diretórios diferentes. Por exemplo, se os arquivos no diretório $/math forem rotulados com M3, você também poderá aplicar o rótulo M3 aos arquivos no diretório $/projects.

Para obter, remover um rótulo ou gerenciar seus itens com M3, especifique o parâmetro @scope para informar ao TFVC com qual rótulo M3 você deseja trabalhar.

É possível impedir que outros usuários "sobrecarreguem" um rótulo, como M3, em diferentes partes do servidor do TFVC. Para isso, é preciso criar seu rótulo na raiz $/ do servidor de controle de versão do Team Foundation ou ajustar as permissões de Rótulo para determinadas pastas.

Exemplos

O exemplo a seguir anexa o rótulo goodbuild à versão do workspace da pasta docs e aos arquivos e pastas que ele contém.

c:\projects>tf label goodbuild docs /recursive

O exemplo a seguir anexa o rótulo goodbuild à pasta docs, mas não aos arquivos e pastas que a pasta docs contém.

c:\projects>tf label goodbuild docs

O exemplo a seguir anexa o rótulo goodbuild à versão 3 de 314.cs no servidor do TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

O exemplo a seguir exclui o rótulo badbuild de todos os itens no servidor do TFVC.

c:\projects>tf label /delete badbuild

O exemplo a seguir usa a opção de escopo @ para aplicar um rótulo a 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs