Comando Rótulos (Controle de Versão do Team Foundation)

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 labels exibe a lista de rótulos no servidor TFVC.

Pré-requisitos

Para usar o labels comando, você deve 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 para todos os arquivos referenciados no rótulo, os resultados parciais serão exibidos. Para obter mais informações, consulte Permissões TFVC padrão.

Sintaxe

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

Parâmetros

Argumentos

Argumento

Descrição

<ownername>

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

<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 de nome do rótulo não será filtrado.

<TeamProjectCollectionUrl>

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

<username>

Fornece um valor para a /login opção. Você pode especificar um username valor como um ou usernameDOMAIN\username .

Opções

Opção

Descrição

/owner

Especifica o nome do usuário que possui o 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. Esta é a predefiniçã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 com o Azure DevOps.

Observações

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

  • Por padrão, os resultados exibem o nome do rótulo, o proprietário e a data de criação de cada rótulo. 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 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.

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 build1033 rótulo e lista os arquivos e pastas aos quais o rótulo foi aplicado no servidor TFVC.

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

O exemplo a seguir exibe todos os rótulos no servidor TFVC que têm um labelname que começa com build e são de propriedade da conta que executa o labels comando.

c:\projects> tf labels build*