Comando labels (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 tf labels do TFVC (Controle de Versão do Team Foundation) exibe a lista de rótulos no servidor do TFVC.

Pré-requisitos

Para usar o comando labels, é necessário ter a permissão de Leitura definida como Permitir para todos os arquivos ou pastas aos quais o rótulo especificado está anexado. Se você tiver permissão para alguns, mas não todos os arquivos referenciados no rótulo, os resultados parciais serão exibidos. Para saber mais, consulte Permissões padrão do TFVC.

Sintaxe

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]

Parâmetros

Argumentos

Argument

Descrição

<ownername>

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

<labelname>

Especifica uma cadeia de caracteres que deve ser usada para filtrar a lista de rótulos. Se esse parâmetro for omitido, o campo nome do rótulo não será filtrado.

<TeamProjectCollectionUrl>

A URL da coleção de projetos cuja lista de rótulos você quer exibir, por exemplo, http://myserver:8080/tfs/DefaultCollection.

<username>

Mostra um valor para a opção /login. É possível especificar um valor username como DOMAIN\username ou username.

Opções

Opção

Descrição

/owner

Especifica o nome do usuário proprietário do rótulo. Por padrão, o proprietário é a pessoa que aplica o rótulo.

/format

Exibe informações sobre o rótulo especificado em um dos seguintes formatos:

  • Brief: inclui rótulo, proprietário e data de criação. Esse é o padrão.
  • Detailed: também inclui comentários, escopo e uma lista de arquivos e pastas associados a cada rótulo.

/collection

Especifica a coleção de projetos.

/login

Especifica o nome de usuário e a senha para autenticar o usuário no Azure DevOps.

Comentários

  • O comando labels exibe informações sobre rótulos no servidor do TFVC. Se você não especificar um servidor do TFVC, o TFVC tentará determinar a opção que está usando o diretório atual. Se o diretório atual não estiver mapeado para um servidor do TFVC, especifique um usando a opção /s.

  • Por padrão, os resultados exibem o nome do rótulo, o proprietário e a data de criação de cada um. Se o formato for alterado para detailed, os comentários e a lista de arquivos e pastas associados a cada rótulo também serão exibidos.

  • Para saber mais sobre como usar o utilitário de linha de comando tf, consulte Usar comandos do controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exibe a lista de rótulos criados pelo usuário jasonj.

c:\projects> tf labels /owner:jasonj

O exemplo a seguir exibe informações sobre o rótulo build1033 e lista os arquivos e pastas aos quais o rótulo foi aplicado no servidor do TFVC.

c:\projects> tf labels /format:detailed build1033

O exemplo a seguir exibe todos os rótulos no servidor do TFVC que têm um labelname que começa com build e pertencem à conta que executa o comando labels.

c:\projects> tf labels build*