Workfold, commande
Crée, modifie ou affiche des informations concernant les mappages entre les dossiers de votre espace de travail et les dossiers sur le 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 [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
Paramètres
Argument |
Description |
|---|---|
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. |
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient les dossiers que vous souhaitez comparer avec les dossiers du serveur (par exemple, http://myserver:8080/tfs/DefaultCollection). |
nom_utilisateur |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
Option |
Description |
|---|---|
/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. |
/collection |
Spécifie la collection du projet d'équipe. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
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
Masquer et dévoiler des dossiers dans un espace de travail
Créer un espace de travail et obtenir des fichiers
Référence
Syntaxe de ligne de commande (Contrôle de version)
Concepts
Créer un espace de travail pour utiliser le projet de votre équipe