Add, commande
Mise à jour : novembre 2007
Ajoute de nouveaux fichiers et dossiers depuis un emplacement de système de fichiers local à un serveur de contrôle de version Team Foundation.
.gif "Remarque") Remarque : |
|---|
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é d'opération d'archivage. Pour plus d'informations, consultez Comment : archiver les 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. Vous devez également disposer de l'autorisation Verrouiller avec la valeur Autoriser si /lock:checkout ou /lock:checkin est utilisé. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf add itemspec [/lock:none|checkin|checkout] [/type:filetype]
[/noprompt] [/recursive]
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) pour déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Team System). |
filetype |
Utilisé avec l'option /type. Pour plus d'informations, consultez Types de fichiers. |
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 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. |
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. Pour plus d'informations sur la mise en route, consultez Procédure pas à pas : utilisation du contrôle de version Team Foundation à partir de la ligne de commande.
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 Comment : archiver les 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, consultez Procédure pas à pas : utilisation du contrôle de version Team Foundation à partir de la ligne de commande.
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
Comment : archiver les modifications en attente
Comment : verrouiller et déverrouiller des dossiers ou des fichiers
Concepts
Présentation des types de verrous