Commande Unlabel (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande unlabel Team Foundation Version Control (TFVC) supprime un élément d’une étiquette existante dans le serveur de contrôle de version.

Prérequis

Pour utiliser la commande unlabel, vous devez posséder l’étiquette ou régler l’autorisation Administrer les étiquettes sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf unlabel [/collection:<team-project-collection-url>] [/recursive] [/login:<username>, [<password>]] <label-name> <item-specification>

Paramètres

Les sections suivantes décrivent les arguments et les options de la commande unlabel.

Arguments

Argument

Description

<team-project-collection-url>

Spécifie l’URL de la collection de projets qui contient l’élément que vous souhaitez supprimer d’une étiquette existante, par exemple https://myserver:8080/tfs/DefaultCollection.

<label-name>

Spécifie le nom de l’étiquette à supprimer des éléments spécifiés.

<item-specification>

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

Notes

Vous pouvez spécifier plusieurs arguments de spécification d’élément.

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier DOMAIN\<username> ou <username> pour cette valeur.

<password>

Fournit une valeur à l’option /login.

Options

Option Description
/recursive Supprime l’étiquette spécifiée de tous les éléments du répertoire particulier et de tous les sous-répertoires qui correspondent à la spécification de l’élément.
/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 unlabel de l’utilitaire de ligne de commande tf supprime un élément d’une étiquette existante dans le serveur Azure DevOps. Pour une présentation des étiquettes, consultez Utiliser des étiquettes pour prendre un instantané de vos fichiers. Pour plus d’informations sur l’affectation d’une étiquette à un ensemble de fichiers et de dossiers, consultez commande Label (Team Foundation Version Control).

Si vous supprimez tous les éléments d’une étiquette dans le serveur Azure DevOps, cette étiquette est supprimée. Vous pouvez également supprimer une étiquette à l’aide de la commande tf label /delete. Pour en savoir plus sur les étiquettes existantes dans le système, consultez commande Labels.

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

Exemples

L’exemple suivant supprime l’étiquette goodbuild de 314.cs :

c:\projects>tf unlabel goodbuild $/src/314.cs

L’exemple suivant supprime l’étiquette Beta1 de tous les fichiers et dossiers de la collection à l’adresse suivante https://myserver:8080/tfs/DefaultCollection :

c:\projects>tf unlabel Beta1 $/ /collection:https://myserver:8080/tfs/DefaultCollection /recursive