Comando Unlabel (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 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