Commande Étiquettes (Team Foundation Version Control)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) tf labels affiche la liste des étiquettes dans le serveur TFVC.

Prérequis

Pour utiliser la commande labels, vous devez disposer de l’ensemble d’autorisations Lecture sur Autoriser pour tous les fichiers ou dossiers auxquels l’étiquette spécifiée est attachée. Si vous êtes autorisé à certains fichiers, mais pas tous les fichiers référencés dans l’étiquette, les résultats partiels sont affichés. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

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

Paramètres

Arguments

Argument

Description

<ownername>

Fournit une valeur telle que DOMAIN\JuanGo ou juango à l’option /owner.

<labelname>

Spécifie une chaîne qui doit être utilisée pour filtrer la liste des étiquettes. Si ce paramètre est omis, le champ nom de l’étiquette ne sera pas filtré.

<TeamProjectCollectionUrl>

URL de la collection de projets pour laquelle vous souhaitez afficher la liste des étiquettes, par exemple http://myserver:8080/tfs/DefaultCollection.

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier une valeur username en tant que DOMAIN\username ou username.

Options

Option

Description

/owner

Spécifie le nom de l’utilisateur propriétaire de l’étiquette. Par défaut, le propriétaire est la personne qui applique l’étiquette.

/format

Affiche des informations sur l’étiquette spécifiée dans l’un des formats suivants :

  • Brief : inclut l’étiquette, le propriétaire et la date créées. Il s’agit de la valeur par défaut.
  • Detailed : inclut également des commentaires, une étendue et une liste de fichiers et de dossiers associés à chaque étiquette.

/collection

Spécifie la collection de projets.

/login

Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.

Notes

  • La commande labels affiche des informations sur les étiquettes dans le serveur TFVC. Si vous ne spécifiez pas de serveur TFVC, TFVC tente de déterminer le serveur TFVC à l’aide du répertoire actif. Si le répertoire actif n’est pas mappé à un serveur TFVC, vous devez en spécifier un à l’aide de l’option /s.

  • Par défaut, les résultats affichent le nom de l’étiquette, le propriétaire et la date de création de chaque étiquette. Si le format est modifié sur detailed, les commentaires et la liste des fichiers et dossiers associés à chaque étiquette sont également affichés.

  • Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.

Exemples

L’exemple suivant affiche la liste des étiquettes créées par l’utilisateur jasonj.

c:\projects> tf labels /owner:jasonj

L’exemple suivant affiche des informations sur l’étiquette build1033 et répertorie les fichiers et dossiers auxquels l’étiquette a été appliquée dans le serveur TFVC.

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

L’exemple suivant montre comment afficher toutes les étiquettes du serveur TFVC qui ont un labelname qui commencent par build et sont au compte exécutant la commande labels.

c:\projects> tf labels build*