Compartilhar via

Comando de rótulo (Controle de Versão do Team Foundation)

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

O comando TFVC (Controle de Versão do Team Foundation) tf label anexa um rótulo ou remove um rótulo de uma versão de um arquivo ou pasta no servidor TFVC.

Pré-requisitos

Categoria Requirements
Permissões Permissão de rótulo definida como Permitir. Para modificar ou excluir rótulos criados por outros usuários, tenha os rótulos Administrar permissão definidos para Permitir.

Para obter mais informações, consulte permissões TFVC padrão.

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

de argumento

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 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 TFVC.

<ownername>

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

<itemspec>

Identifica o arquivo ou a pasta do qual rotular, rotular novamente ou modificar. Para obter mais informações sobre como o TFVC analisa o itemspec para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation.

Nota

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 uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Usar comandos de controle de versão do Team Foundation.

<comment>

Um comentário fornecido 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 para o rótulo.

<username>

Fornece 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 pasta à qual você deseja anexar um rótulo ou do qual deseja excluir um rótulo, por exemplo, http://myserver:8080/tfs/DefaultCollection.

Opções

opção

descrição

/owner

Especifica o nome do usuário que possui o rótulo.

/version

Opcional. Especifica a versão do arquivo ou da pasta à qual o rótulo deve ser anexado, modificado ou do qual o rótulo deve ser removido. Estes são valores de conjunto de alterações, por exemplo, C93. Por padrão, o TFVC usará a versão do workspace base se nenhuma versionspec for fornecida.

/comment

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

/child

Não documentado.

/recursive

Rotula todos os itens no diretório que correspondem ao itemspec e ao 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.

Observações

Um rótulo é um marcador que você pode anexar a um conjunto de arquivos e pastas não relacionados no servidor 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 ao qual e do qual você pode adicionar e remover arquivos e pastas arbitrariamente ou alterar as versões dos itens nela. Um rótulo é uma especificação de versão que pode ser passada para os seguintes comandos TFVC:

  • de comando do Branch
  • de comando Diferença
  • comando Dir
  • Obter de comando
  • de comando histórico de
  • comando Mesclagem
  • do comando View

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

Os rótulos são específicos da versão. Ou seja, você só pode anexar um rótulo a uma versão de um arquivo ou pasta. Cada versão de um item pode dar suporte a 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ê emite o comando label, a atualização é refletida imediatamente no servidor TFVC.

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.

Remover e excluir rótulos

Você pode usar o comando Cancelar rótulo para remover um rótulo de um arquivo ou pasta. Como alternativa, você pode excluir um rótulo do sistema usando o comando tf label /delete.

Para obter informações sobre um rótulo existente que inclui uma lista dos itens aos quais o rótulo foi anexado, seu comentário, escopo e proprietário, consulte o comando Labels.

Gerenciar rótulos sobrecarregados

Os nomes de rótulo devem ser exclusivos em um escopo especificado. Ao adicionar um rótulo, reserve o uso desse nome de rótulo no escopo especificado ou implícito. O valor padrão do 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 TFVC, você poderá 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 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 rotulados M3, especifique o parâmetro @scope para informar ao TFVC com qual rótulo M3 você deseja trabalhar.

Você pode impedir que outros usuários "sobrecarregem" um rótulo, como M3 em diferentes partes do servidor TFVC, criando seu rótulo na $/ raiz do servidor de controle de versão do Team Foundation ou ajustando permissões de Rótulo para determinadas pastas.

Exemplos

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

c:\projects>tf label goodbuild docs /recursive

O exemplo a seguir anexa o rótulo à pasta documentos , 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 do 314.cs no servidor 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 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
  • Last updated on