Comando Unlabel (Controle de Versão do Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
O comando unlabel no TFVC (Controle de Versão do Team Foundation) remove um item de um rótulo existente no servidor de controle de versão.
Pré-requisitos
Para usar o comando unlabel, você deve ser proprietário do rótulo ou ter a permissão Administrar rótulos definida como Permitir. Para saber mais, confira Permissões padrão do TFVC.
Sintaxe
tf unlabel [/collection:<team-project-collection-url>] [/recursive] [/login:<username>, [<password>]] <label-name> <item-specification>
Parâmetros
Veja nas seções a seguir a descrição dos argumentos e das opções do comando unlabel.
Argumentos
Argument
Descrição
<team-project-collection-url>
Especifica a URL da coleção de projetos que contém o item que você deseja remover de um rótulo existente, por exemplo, https://myserver:8080/tfs/DefaultCollection.
<label-name>
Especifica o nome do rótulo a ser removido dos itens especificados.
<item-specification>
Identifica o arquivo ou pasta do qual remover o rótulo especificado. Para obter mais informações sobre como o TFVC analisa as especificações de item 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 argumento de especificação de item.
<username>
Mostra um valor para a opção /login. É possível especificar esse valor como DOMAIN\<username> ou <username>.
<password>
Mostra um valor para a opção /login.
Opções
| Opção | Descrição |
|---|---|
/recursive |
Remove o rótulo especificado de todos os itens no diretório específico e todos os subdiretórios que correspondem à especificação do item. |
/collection |
Especifica a coleção de projetos. |
/login |
Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps. |
Comentários
O unlabel comando do tf utilitário de linha de comando remove um item de um rótulo existente no servidor do Azure DevOps. Para obter uma introdução aos rótulos, consulte Usar rótulos para tirar uma screenshot de seus arquivos. Para obter informações sobre como atribuir um rótulo a um conjunto de arquivos e pastas, consulte o comando Label (Controle de Versão do Team Foundation).
Se você remover todos os itens de um rótulo no servidor do Azure DevOps, esse rótulo será excluído. Você também pode excluir um rótulo usando o comando tf label /delete. Para obter mais informações sobre os rótulos existentes no sistema, consulte Comando Rótulos.
Para saber mais sobre como usar o utilitário de linha de comando tf, confira Usar comandos de controle de versão do Team Foundation.
Exemplos
O exemplo a seguir remove o rótulo goodbuild de 314.cs:
c:\projects>tf unlabel goodbuild $/src/314.cs
O exemplo a seguir remove o rótulo Beta1 de todos os arquivos e pastas na coleção em https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf unlabel Beta1 $/ /collection:https://myserver:8080/tfs/DefaultCollection /recursive