Partilhar via

Comando Label (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 | do Visual Studio 2022

O comando Team Foundation Version Control (TFVC) 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

Para usar o comando label, tenha a permissão Rótulo definida como Permitir. Para modificar ou excluir rótulos criados por outros usuários, tenha a permissão Administrar rótulos definida como Permitir. Para obter mais informações, consulte Default TFVC permissions.

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

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 criar, gerenciar, recuperar e excluir de forma independente um rótulo ou conjunto de itens rotulados quando dois rótulos com o mesmo nome estiverem em partes diferentes do servidor TFVC.

<ownername>

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

<itemspec>

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

Observação

Você pode especificar mais de um itemspec argumento.

<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 da 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 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 usa a versão base do espaço de trabalho se nenhum versionspec for fornecido.

/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 seu 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 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 espaço de trabalho para fins de desenvolvimento ou compilação. Um rótulo é como um conjunto de alterações ou data/hora para o qual e a partir do qual você pode 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 TFVC:

Tipos comuns de rótulos são rótulos de marcos 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 suportar vários rótulos.

Um rótulo não é um objeto versionado. Portanto, o histórico de rótulos dos arquivos não é rastreado. Além disso, uma operação de rótulo não cria uma alteração pendente em seu espaço de trabalho. Quando você emite o comando label, a atualização é imediatamente refletida 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 eliminar etiquetas

Você pode usar o comando Unlabel 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 comando Rótulos.

Gerenciar rótulos sobrecarregados

Os nomes dos rótulos devem ser exclusivos em todo um escopo especificado. Ao adicionar um rótulo, você reserva o uso desse nome de rótulo no escopo especificado ou implícito ou sob ele. 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 com controle de versão em uma parte diferente do servidor TFVC, você poderá aplicar o rótulo M3 a arquivos com controle de versão em seu projeto, desde que as pastas raiz do projeto estejam em diretórios diferentes. Por exemplo, se os arquivos no diretório $/math estiverem rotulados , você também poderá aplicar o rótulo aos arquivos no diretório $/projects.

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

Você pode impedir que outros usuários "sobrecarreguem" 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 de rótulo para determinadas pastas.

Exemplos

O exemplo a seguir anexa o rótulo à versão de espaço de trabalho da pasta docs e aos arquivos e pastas que ela contém.

c:\projects>tf label goodbuild docs /recursive

O exemplo a seguir anexa o rótulo à 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 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 @ escopo para aplicar um rótulo a 314.cs.

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