Add, commande
Ajout de fichiers et dossiers depuis un système de fichiers local vers un serveur de contrôle de version Team Foundation.
Notes
Les résultats de cette commande ne sont pas reflétés au niveau du serveur de contrôle de version Team Foundation tant que vous n'avez pas effectué une opération d'archivage. Pour plus d'informations, consultez Archiver des modifications en attente.
Autorisations requises
Pour utiliser la commande add, vous devez posséder l'espace de travail et disposer de l'autorisation Extraire pour le dossier parent des nouveaux éléments avec la valeur Autoriser. Votre autorisation Verrouiller doit également avoir la valeur Autoriser si vous utilisez /lock:checkout ou /lock:checkin. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype]
[/noprompt] [/recursive] [/login:username,[password]]
Paramètres
Argument |
Description |
|---|---|
itemspec |
Identifie les fichiers ou dossiers à ajouter. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Contrôle de version). .gif "Remarque") Remarque
Vous pouvez spécifier plusieurs arguments Itemspec.
|
filetype |
Utilisé avec l'option /type. Pour plus d'informations, consultez Gestion des types de fichiers. |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme Domaine\NomUtilisateur ou NomUtilisateur. |
Option |
Description |
|---|---|
/type |
Substitue le type de fichier correspondant et ajoute des fichiers au serveur de contrôle de version Team Foundation qui utilise le type spécifié. Pour plus d'informations, consultez Gestion des types de fichiers. La détection du type de fichier est basée sur le contenu du premier kilo-octet du fichier. |
/lock |
Spécifie un type de verrou ou supprime un verrou d'un élément. Options de verrouillage :
|
/noprompt |
Supprime les invites de saisie. |
/recursive |
Ajoute tous les éléments dans le répertoire spécifié et ses sous-répertoires. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
Notes
Avant de pouvoir ajouter un élément au contrôle de version, vous devez configurer un espace de travail local et établir des mappages de dossiers de travail.
Add est une commande Modifications en attente. Elle planifie l'ajout des éléments spécifiés au serveur de contrôle de version Team Foundation en attendant la fin d'une opération d'archivage depuis votre espace de travail. Pour exécuter une commande de modification en attente, votre répertoire actif doit être mappé à un espace de travail et au serveur de contrôle de version Team Foundation auquel il correspond.
Lorsque vous utilisez la commande Add pour ajouter un nouvel élément au contrôle de version, cet élément n'est en réalité ajouté au serveur de contrôle de version Team Foundation qu'une fois que vous avez fini d'archiver vos modifications d'espace de travail les plus récentes. Au lieu de cela, l'élément est ajouté à la liste des modifications en attente pour l'espace de travail actuel. Pour valider un ajout en attente au serveur de contrôle de version Team Foundation, vous pouvez soit archiver directement le fichier ajouté, soit archiver toutes les modifications en attente dans l'espace de travail local. Si vous craignez qu'un autre utilisateur n'ajoute un fichier ou un dossier du même nom à vos ajouts en attente au serveur de contrôle de version Team Foundation avant que vous n'ayez pu archiver vos modifications en attente, vous pouvez inclure l'option /lock avec le paramètre Checkout pour empêcher l'opération. Pour plus d'informations, consultez Archiver des modifications en attente.
Si vous ajoutez 314.cs au contrôle de version à l'aide de tf add /teamproject/projects/math/314.cs, chacun de ces dossiers est considéré comme un ajout en attente s'ils n'existent pas déjà, tant que vous n'avez pas archivé vos modifications. Si, pendant l'archivage des modifications, l'un des dossiers présents dans le chemin d'accès spécifié ($/teamproject, $/teamproject/projects ou $/teamproject/projetcs/math) n'existe pas déjà dans le serveur de contrôle de version Team Foundation, Team Foundation le crée pour vous.
Vous pouvez utiliser la commande Add pour établir la structure de fichiers initiale d'un serveur de contrôle de version Team Foundation.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant ajoute les fichiers 314.c et 1256.c à la liste des modifications en attente pour l'espace de travail auquel le dossier de travail C:\Pi est associé.
c:\pi>tf add 314.cs 1256.c
L'exemple suivant ajoute tous les fichiers de code C# (.cs) dans le répertoire actif et ses sous-répertoires à la liste d'ajouts en attente pour l'espace de travail actuel.
c:\projects>tf add *.cs /recursive
L'exemple suivant ajoute tous les fichiers et dossiers dont les noms contiennent « hello » dans le répertoire actif et tous ses sous-dossiers à la liste d'ajouts en attente pour l'espace de travail auquel c:\projects correspond.
c:\projects>tf add *hello* /recursive
Voir aussi
Tâches
Ajouter au contrôle de version des fichiers et des dossiers non liés au projet ou à la solution
Archiver des modifications en attente
Verrouiller et déverrouiller des dossiers ou des fichiers
Concepts
Présentation des types de verrous