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 | 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 label comando, você deve ter a permissão Label definida como Permitir. Para modificar ou excluir rótulos criados por outros usuários, você deve ter a permissão Administrar rótulos definida como 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

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 dentro do 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 /owner opção.

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

Nota

Você pode especificar mais de um itemspec argumento.

<versionspec>

Fornece um valor como c2 para a /version opção. 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 /login opção. Você pode especificar um valor de nome de usuário como ou DOMAIN\usernameusername.

<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 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 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 seu itemspec e versionspec. Não pode ser usado com a /delete opção.

/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 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 label comando, a atualização é imediatamente refletida no servidor TFVC.

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.

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 tf label /delete comando.

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 @scope parâmetro é 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 M3 rótulo 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 M3, você também poderá aplicar o M3 rótulo aos arquivos no diretório $/projects .

Para obter, remover um rótulo ou gerenciar de outra forma seus M3itens rotulados, você deve especificar o parâmetro para informar ao @scope TFVC com qual M3 rótulo 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 as permissões de rótulo para determinadas pastas.

Exemplos

O exemplo a seguir anexa o goodbuild rótulo à versão do 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 goodbuild 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 goodbuild rótulo à 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 badbuild rótulo 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