Workfold, commande
Mise à jour : novembre 2007
Crée, modifie ou affiche des informations concernant les mappages entre les dossiers de votre espace de travail et les dossiers du serveur de contrôle de version Team Foundation.
Autorisations requises
Pour utiliser la commande workfold, vous devez être le propriétaire de l'espace de travail spécifié ou implicite ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf workfold localfolder
tf workfold [/workspace:workspacename]
tf workfold [/server:servername] [/workspace:workspacename]
serverfolder
tf workfold [/map serverfolder localfolder] [/server:servername]
[/workspace:workspacename] (serverfolder|localfolder)
tf workfold /unmap [/server:servername] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder)
tf workfold /cloak
(serverfolder|localfolder) [/workspace:workspacename] [/s:servername]
tf workfold /decloak (serverfolder|localfolder)
[/workspace:workspacename] [/s:servername]
Paramètres
Argument |
Description |
|---|---|
servername |
Spécifie le nom de votre Team Foundation Server pour l'option /server. Exemple : teamfoundation2. |
workspacename |
Spécifie le nom de l'espace de travail dans lequel la commande fonctionne pour l'option /workspace. |
serverfolder |
Spécifie le nom d'un dossier du serveur de contrôle de version Team Foundation. |
localfolder |
Spécifie le nom d'un dossier local. |
Option |
Description |
|---|---|
/server |
Identifie le serveur Team Foundation Server. Cette option est requise si la commande est appelée à partir d'un répertoire qui n'est pas mappé à un espace de travail. |
/workspace |
Spécifie le nom de l'espace de travail dans lequel travailler. |
/map |
Spécifie une association entre un dossier local et le dossier du serveur de contrôle de version Team Foundation. Par défaut, la commande workfold utilise cette option même si elle n'est pas spécifiée, à moins que /unmap, /cloak ou /decloak ne soit spécifié. |
/unmap |
Spécifie quel mappage de dossier doit être supprimé de l'espace de travail. |
/cloak |
Spécifie que le dossier doit être exclu de toutes actions de contrôle de version effectuées dans l'espace de travail. |
/decloak |
Dévoile un dossier afin qu'il puisse être récupéré dans l'espace de travail. |
Notes
Vous pouvez utiliser la commande workfold de l'utilitaire en ligne de commande tf pour créer et modifier des mappages d'espace de travail. Un mappage d'espace de travail crée un dossier côté client dans lequel tous les fichiers et sous-dossiers contenus dans le dossier du serveur de contrôle de version Team Foundation sont récupérés lorsque vous exécutez une opération tf get. Cette opération get ne fonctionnera pas si le dossier côté client est masqué.
Vous pouvez également spécifier un astérisque (*) comme caractère générique pour mapper un dossier Team Foundation Server et ses éléments immédiats à votre espace de travail local. Cette opération est également souvent appelée « mappage d'un seul dossier ».
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.
Options de mappage de l'espace de travail
Un mappage d'espace de travail est une liste d'éléments actifs et masqués. Vous pouvez ajouter des éléments du serveur de contrôle de version Team Foundation à la liste mappée dans l'espace de travail à l'aide de l'option /map. Vous pouvez également exclure explicitement un élément de l'espace de travail en utilisant l'option /cloak. Vous ne pouvez masquer que les éléments qui ont un parent mappé. Le masquage est un moyen efficace pour améliorer la vitesse d'opérations Get par lots et économiser l'espace disque.
Utilisez-le avec précautions. Pour éviter les problèmes de compilation et d'intégration, vous ne devez masquer que les éléments dont vous êtes sûr qu'ils se situent hors de la portée de vos projets actuels et futurs, tels que des images et des fichiers de documentation externes.
Vous pouvez utiliser les options /unmap et /decloak pour supprimer du mappage de l'espace de travail des entrées mappées et masquées de manière sélective.
Comment sont appliqués les mappages d'espace de travail
Par défaut, les mappages d'espace de travail sont appliqués de manière récursive. Lorsque vous mappez un dossier local à un dossier du serveur de contrôle de version Team Foundation, le système crée implicitement un mappage entre tous ses sous-dossiers actuels et futurs. Par exemple, si vous mappez $/projects à c:\projects, ajoutez ensuite un projet appelé $/projects/project_one, puis exécutez une commande get sur l'espace de travail, Team Foundation crée automatiquement un dossier de travail local nommé project_one dans le répertoire C:\projects.
Dans cet exemple, vous pouvez utiliser un caractère générique, "*", pour mapper un dossier de serveur et ses éléments immédiats à votre espace de travail local :
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
Dans cet exemple, vous pouvez substituer le mappage créé automatiquement entre $/projects/project_one et C:\projects\project_one en utilisant la commande workfold comme suit :
tf workfold $/projects/project_one C:\DifferentWorkfold
Mappages sous masquages
Les mappages de dossiers dévoilés qui se trouvent sous un dossier masqué dans la hiérarchie de contrôle de version peuvent être mappés à votre espace de travail local.
Exemples
L'exemple suivant affiche les mappages de l'espace de travail dans lequel c:\projects réside.
c:\projects>tf workfold
L'exemple suivant masque le dossier c:\projects\lib.
c:\projects>tf workfold /cloak c:\projects\lib
L'exemple suivant affiche le mappage du fichier local word.cs.
c:\projects>tf workfold word.cs
L'exemple suivant mappe le dossier C:\DifferentWorkfold au dossier $/projects/project_one du serveur de contrôle de version Team Foundation et remplace le précédent mappage d'espace de travail pour le dossier $/projects/project_one du serveur de contrôle de version Team Foundation.
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold
Voir aussi
Tâches
Comment : masquer et dévoiler des dossiers dans un espace de travail
Comment : créer un espace de travail mappé
Concepts
Utilisation des espaces de travail du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)