Commande Label (Team Foundation Version Control)
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 :
- Commande Branche
- Commande Différence
- Commande Dir
- Commande Get
- History, commande
- Commande Fusionner
- Commande Afficher
Les types courants d’étiquettes sont des étiquettes jalons telles que M1
, Beta2
ou 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