Commande Workfold (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
La commande Team Foundation Version Control (TFVC) workfold crée, modifie ou affiche des informations sur les mappages entre vos dossiers d’espace de travail et les dossiers qui se trouvent sur le serveur Azure DevOps pour TFVC.
Prérequis
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 d’administration des espaces de travail sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.
Syntaxe
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
Paramètres
Les sections suivantes décrivent les arguments et les options de la commande workfold.
Arguments
Argument
Description
<workspace-name>
Spécifie le nom de l’espace de travail sur lequel la commande fonctionne avec l’option /workspace.
<server-folder>
Spécifie le nom d’un dossier de serveur Azure DevOps.
<local-folder>
Spécifie le nom d’un dossier local.
<team-project-collection-url>
URL de la collection de projets qui contient les dossiers que vous souhaitez comparer avec les dossiers serveur, par exemple https://myserver:8080/tfs/DefaultCollection/.
<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
/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 serveur Azure DevOps. Par défaut, la commande workfold utilise cette option, même si elle n’est pas spécifiée, sauf si /unmap, /cloak ou /decloak est spécifiée.
/unmap
Spécifie le mappage de dossiers à supprimer de l’espace de travail.
/cloak
Spécifie que le dossier doit être exclu des actions de contrôle de version effectuées dans l’espace de travail.
/decloak
Désactive le masquage d’un dossier afin que le dossier puisse être récupéré dans l’espace de travail.
/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
Vous pouvez utiliser la commande workfold de l’utilitaire de 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 du dossier serveur Azure DevOps sont récupérés lors de l’exécution d’une tf get opération. L’opération get ne fonctionne pas si le dossier côté client est masqué.
Vous pouvez également utiliser un caractère générique astérisque (*) pour mapper un dossier Azure DevOps Server et ses éléments immédiats à votre espace de travail local. Ce mappage est souvent appelé mappage de dossiers unique.
Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.
Options de mappage d’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 de serveur Azure DevOps à la liste mappée dans l’espace de travail à l’aide de l’option /map. Vous pouvez également exclure un élément de l’espace de travail explicitement à l’aide de l’option /cloak. Vous ne pouvez afficher que les éléments qui ont un parent mappé. Le masquage est un moyen efficace d’améliorer la vitesse des opérations get par lots et de conserver de l’espace sur le disque.
Utilisez le manteau avec discrétion. Pour éviter les problèmes de compilation et d’intégration, vous devez uniquement afficher les éléments que vous savez être en dehors de l’étendue de vos projets actuels et futurs, tels que les images et les fichiers de documentation externes.
Vous pouvez utiliser les options /unmap et /decloak permettant de supprimer sélectivement les entrées mappées et masquées du mappage de l’espace de travail.
Comment les mappages d’espace de travail sont appliqués
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 de serveur Azure DevOps, le système crée implicitement un mappage entre tous ses sous-dossiers actuels et futurs.
Par exemple, supposons que vous mappiez $/projects à C:\projects. Ensuite, vous ajoutez un projet appelé $/projects/project_one, puis vous exécutez la commande get sur l’espace de travail. Dans ce scénario, TFVC crée automatiquement un dossier de travail local nommé project_one dans le répertoire C:\projects.
L’exemple suivant utilise un caractère générique astérisque (*) pour mapper un dossier serveur et ses éléments immédiats à votre espace de travail local :
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
L’exemple suivant utilise la commande workfold pour remplacer le mappage créé automatiquement entre $/projects/project_one et C:\projects\project_one :
tf workfold $/projects/project_one C:\DifferentWorkfold
Mappages sous masquages
Les mappages de dossiers non masqués situés 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 résident c:\projects :
c:\projects>tf workfold
L’exemple suivant illustre le dossier c:\projects\lib :
c:\projects>tf workfold /cloak c:\projects\lib
L’exemple suivant affiche le mappage pour le fichier local word.cs :
c:\projects>tf workfold word.cs
L’exemple suivant mappe le dossier C:\DifferentWorkfold au dossier du serveur Azure DevOps $/projects/project_one et remplace le mappage de l’espace de travail précédent pour le dossier de serveur Azure DevOps $/projects/project_one :
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold