Label, tâche
Vous pouvez utiliser la tâche Label pour attacher une étiquette à la version la plus récente des fichiers dans votre espace de travail.
Paramètres
Paramètre |
Description |
|---|---|
TeamFoundationServerUrl |
Spécifie l'URL du serveur qui exécute Visual Studio Team Foundation Server (par exemple, http://MyServer:8080). |
BuildUri |
Spécifie l'URI (Uniform Resource Identifier) de build. |
Name |
Spécifie le nom de l'étiquette. Par défaut, le nom de l'étiquette créé par Team Foundation Build est le même que la propriété BuildNumber. Substituez la propriété LabelName dans le fichier TFSBuild.proj pour spécifier un nom d'étiquette différent. |
Scope |
Spécifie la portée de l'étiquette que vous créez. Ce paramètre a le même effet que l'argument @scope de la commande tf label. Pour plus d'informations, consultez Label, commande (contrôle de version Team Foundation). |
Version |
Spécifie la version du fichier ou du dossier. Par défaut, Team Foundation Build étiquette le contenu entier de l'espace de travail spécifié par la propriété WorkspaceName. Substituez la propriété LabelVersion pour spécifier un versionspec différent. Cela correspond au paramètre versionspec de la commande tf.exe label. Pour plus d'informations, consultez Label, commande (contrôle de version Team Foundation). |
Files |
Spécifie les éléments que vous souhaitez étiqueter. Par défaut, Team Foundation Build remplace la version des éléments qui existent déjà dans son étiquette. Cela correspond à une valeur replace de l'option /child dans la commande tf.exe label. Affectez à la propriété LabelFiles la valeur merge dans le fichier TFSBuild.proj si vous ne souhaitez pas modifier des éléments dans une étiquette existante. |
Child |
Par défaut, Team Foundation Build remplace la version des éléments qui existent déjà dans son étiquette. Attribuez à la propriété LabelChild la valeur merge dans le fichier TFSBuild.proj si vous ne souhaitez pas modifier les éléments présents dans une étiquette existante. Cela correspond à l'option /child de la commande tf.exe label. |
Comments |
Spécifie le commentaire utilisé par Team Foundation Build pour l'étiquette. Le commentaire par défaut créé par Team Foundation Build est « Étiquette créée par Team Build ». Substituez la propriété LabelComment dans le fichier TFSBuild.proj si vous souhaitez spécifier un autre commentaire. |
Recursive |
Spécifie si les fichiers sont étiquetés de manière récursive. Cela correspond à l'option /recursive de la commande tf.exe label. Attribuez à la propriété LabelRecursive la valeur false dans le fichier TFSBuild.proj. Cette action étiquette uniquement les éléments de niveau supérieur. |
Notes
La tâche Label est définie dans le fichier Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. Le fichier Microsoft.TeamFoundation.Build.targets contient une instance de la tâche Label que Team Foundation Build utilise comme implémentation par défaut pour la cible CoreLabel.
Le dossier <racine>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild sur l'ordinateur Team Foundation Build contient le fichier Microsoft.TeamFoundation.Build.targets.
Exemple
L'exemple suivant affiche l'instance par défaut de la tâche Label définie dans le fichier Microsoft.TeamFoundation.Build.targets.
<Label
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildURI)"
Name="$(LabelName)"
Scope="$(LabelScope)"
Version="$(LabelVersion)"
Files="$(LabelFiles)"
Child="$(LabelChild)"
Comments="$(LabelComment)"
Recursive="$(LabelRecursive)" />
Voir aussi
Tâches
Personnaliser des numéros de build
Référence
Label, commande (contrôle de version Team Foundation)