Commande Label (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 label attache une étiquette ou supprime une étiquette d’une version d’un fichier ou d’un dossier dans le serveur TFVC.

Prérequis

Pour utiliser la commande label, vous devez disposer de l’autorisation Extraire définie sur Autoriser. Pour modifier ou supprimer des étiquettes créées par d’autres utilisateurs, vous devez disposer de l’autorisation Administrer les étiquettes sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Paramètres

Arguments

Argument

Description

<labelname>

Identifie le nom de l’étiquette à attacher, modifier ou supprimer des éléments spécifiés.

@<scope>

Spécifie un répertoire de serveur TFVC dans lequel labelname est unique. Ce paramètre vous permet de créer, gérer, récupérer et supprimer indépendamment une étiquette ou un ensemble d’éléments étiquetés lorsque deux étiquettes du même nom se trouvent dans différentes parties du serveur TFVC.

<ownername>

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

<itemspec>

Identifie le fichier ou le dossier à partir duquel étiqueter, réétiqueter ou modifier. Pour plus d’informations sur la façon dont TFVC analyse itemspec pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de Team Foundation Version Control.

Notes

Vous pouvez définir plusieurs arguments itemspec.

<versionspec>

Fournit une valeur telle que c2 pour l’option /version. Pour plus d’informations sur la façon dont TFVC analyse les spécifications d’une version pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de Team Foundation Version Control.

<comment>

Commentaire fourni par l’utilisateur sur l’étiquette.

@<commentfile>

Chemin d’accès fourni par l’utilisateur d’un fichier sur le disque qui contient le commentaire à utiliser pour l’étiquette.

<username>

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

<TeamProjectCollectionUrl>

L’URL de la collection de projets spécifiée qui contient une version d’un fichier ou d’un dossier auquel vous souhaitez joindre une étiquette ou à partir de laquelle vous souhaitez supprimer une étiquette, par exemple http://myserver:8080/tfs/DefaultCollection.

Options

Option

Description

/owner

Spécifie le nom de l’utilisateur propriétaire de l’étiquette.

/version

facultatif. Spécifie la version du fichier ou du dossier auquel l’étiquette doit être attachée, modifiée ou à partir de laquelle l’étiquette doit être supprimée. Il s’agit de valeurs d’ensemble de modifications, par exemple C93. Par défaut, TFVC utilise la version de l’espace de travail de base si aucune valeur versionspec n’est fournie.

/comment

Ajoute ou modifie une description ou un commentaire pour l’étiquette.

/child

Non documenté.

/recursive

Étiquette tous les éléments du répertoire qui correspondent à votre itemspec et versionspec. Impossible d’utiliser avec l’option /delete.

/delete

Supprime l’étiquette.

/login

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

/collection

Spécifie la collection de projets.

Notes

Une étiquette est un marqueur que vous pouvez attacher à un ensemble de fichiers et dossiers non liés dans le serveur TFVC. Utilisez l’étiquette pour simplifier la récupération de fichiers et de dossiers dans un espace de travail à des fins de développement ou de génération. Une étiquette est semblable à un ensemble de modifications ou à une date/heure auquel et à partir de laquelle vous pouvez ajouter et supprimer arbitrairement des fichiers et dossiers ou modifier les versions des éléments de cet élément. Une étiquette est une spécification de version qui peut être passée aux commandes TFVC suivantes :

Les types courants d’étiquettes sont des étiquettes jalons telles que M1, Beta2ou Release Candidate 0.

Les étiquettes sont spécifiques à la version. Autrement dit, vous ne pouvez attacher une étiquette qu’à une version d’un fichier ou d’un dossier. Chaque version d’un élément peut prendre en charge plusieurs étiquettes.

Une étiquette n’est pas un objet versionné. Par conséquent, l’historique des étiquettes des fichiers n’est pas suivi. En outre, une opération d’étiquette ne crée pas de modification en attente dans votre espace de travail. Lorsque vous émettez la commande label, la mise à jour est immédiatement reflétée dans le serveur TFVC.

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.

Supprimer et supprimer des étiquettes

Vous pouvez utiliser la commande Unlabel pour supprimer une étiquette d’un fichier ou d’un dossier. Vous pouvez également supprimer une étiquette du système à l’aide de la commande tf label /delete.

Pour plus d’informations sur une étiquette existante qui inclut une liste des éléments auxquels l’étiquette a été attachée, son commentaire, son étendue et son propriétaire, consultez Commande Étiquettes.

Gérer les étiquettes surchargées

Les noms d’étiquette doivent être uniques dans une étendue spécifiée. Lorsque vous ajoutez une étiquette, vous réservez l’utilisation de ce nom d’étiquette à ou sous l’étendue spécifiée ou implicite. La valeur par défaut du paramètre @scope est le projet, par exemple $/TeamProject1.

Si une autre équipe ou utilisateur ajoute une étiquette commune telle que M3 à un ensemble de fichiers contrôlés par la version dans une autre partie du serveur TFVC, vous pouvez appliquer l’étiquette M3 aux fichiers contrôlés par la version dans votre projet tant que les dossiers de projet racine se trouvent dans différents répertoires. Par exemple, si les fichiers du répertoire $/math sont étiquetés M3, vous pouvez également appliquer l’étiquette M3 aux fichiers dans votre répertoire $/projects.

Pour obtenir, supprimez une étiquette ou gérez vos éléments étiquetés M3, vous devez spécifier le paramètre @scope pour indiquer à TFVC l’étiquette M3 avec laquelle vous souhaitez travailler.

Vous pouvez empêcher d’autres utilisateurs de « surcharger » une étiquette telle que M3 dans différentes parties du serveur TFVC en créant votre étiquette à la racine $/ du serveur de contrôle de version Team Foundation ou en ajustant les autorisations d’étiquette pour certains dossiers.

Exemples

L’exemple suivant attache l’étiquette goodbuild à la version de l’espace de travail du dossier docs et les fichiers et dossiers qu’il contient.

c:\projects>tf label goodbuild docs /recursive

L’exemple suivant attache l’étiquette goodbuild au dossier docs, mais pas aux fichiers et dossiers que contient le dossier docs.

c:\projects>tf label goodbuild docs

L’exemple suivant attache l’étiquette goodbuild à la version 3 de 314.cs dans le serveur TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

L’exemple suivant supprime l’étiquette badbuild de tous les éléments du serveur TFVC.

c:\projects>tf label /delete badbuild

L’exemple suivant utilise l’option @ d’étendue pour appliquer une étiquette à 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs