Workspace, commande

Vous permet de créer, de supprimer, d'afficher ou de modifier les propriétés et les mappages associés à un espace de travail.

Autorisations requises

Pour modifier ou supprimer un espace de travail existant, vous devez en être le propriétaire ou disposer de l'autorisation globale Administrer les espaces de travail avec la valeur Autoriser. Pour créer un espace de travail, vous devez disposer de l'autorisation globale Créer un espace de travail avec la valeur Autoriser. Pour créer des espaces de travail pour d'autres utilisateurs, vous devez disposer de l'autorisation Administrer les espaces de travail avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
 [/computer:computername] [/comment:("comment"|@comment file)]
 [/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]

tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]

tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]

Paramètres

Notes

Un espace de travail est une copie locale des fichiers et des dossiers présents sur le serveur, plus de toutes les modifications que vous avez apportées localement. Lorsque vous ajouter, éditez, supprimez, déplacez, renommez ou modifiez d'une manière ou d'une autre un élément sous contrôle de version, vos modifications restent isolées dans votre espace de travail, au sein duquel vous pouvez les effectuer et les tester. Vos modifications en attente sont validées sur le serveur et deviennent accessibles à d'autres utilisateurs hors de votre espace de travail lorsque vous effectuez un archivage.

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.

Création d'un espace de travail

Avant de pouvoir ajouter des fichiers au serveur de contrôle de version ou extraire des éléments du serveur pour les modifier, vous devez créer un espace de travail ou en associer un existant au répertoire actif. Pour plus d'informations, consultez Créer un espace de travail et obtenir des fichiers.

Pour que le répertoire actif devienne le dossier de travail pour un espace de travail existant sur votre ordinateur, tapez tf workspaceworkspacename, où workspacename est le nom de l'espace de travail existant. La boîte de dialogue Modifier l'espace de travail s'affiche. Cliquez sur Cliquez ici pour entrer un nouveau dossier de travail, tapez le chemin d'accès du serveur pour lequel vous souhaitez mapper le répertoire actif dans la zone Dossier du contrôle de code source , tapez le répertoire actif dans la zone Dossier local et cliquez sur OK.

Lorsque vous créez un nouvel espace de travail, vous pouvez spécifier un modèle d'espace de travail dans le cadre de l'option /new . Lorsque vous spécifiez un modèle d'espace de travail, Team Foundation crée un nouvel espace de travail sur l'ordinateur actuel, définit le propriétaire comme étant le propriétaire actuel et duplique les propriétés d'espace de travail suivantes dans le nouvel espace de travail à partir du modèle d'espace de travail : mappages et commentaire. Si aucun nom n'est spécifié, le système utilise un nom dérivé du nom de l'ordinateur actuel. Lorsque vous créez un espace de travail à l'aide d'un modèle, Team Foundation ne récupère pas les fichiers qu'il mappe à partir du serveur. Utilisez la Get, commande pour synchroniser le nouvel espace de travail avec la version la plus récente installée sur le serveur.

Mappage d'un seul dossier

Vous pouvez choisir de mapper uniquement les enfants immédiats d'un dossier de contrôle de version à un espace de travail local. Pour cela, ajoutez un astérisque comme caractère générique dans la zone Dossier du contrôle de code source dans la boîte de dialogue Ajouter un espace de travail. Par exemple, $/dossier/*. Sinon, par défaut, tous les enfants du dossier de contrôle de version sont mappés à l'espace de travail local de manière récursive.

Le mappage d'un seul dossier dans une hiérarchie de contrôle de version est utile parce qu'il limite le nombre d'éléments téléchargés à l'ordinateur client. Une autre méthode pour limiter des fichiers téléchargés consiste à masquer des fichiers dont vous n'avez pas besoin dans votre espace de travail. Pour plus d'informations, consultez Masquer et dévoiler des dossiers dans un espace de travail. Cela réduit les temps de téléchargement et économise de l'espace disque sur l'ordinateur client.

Suppression d'un espace de travail

Si vous supprimez un espace de travail contenant des modifications en attente, Team Foundation annule ces dernières au cours du processus de suppression. La suppression d'un espace de travail ne supprime pas de l'ordinateur client les fichiers et dossiers qui se trouvaient dans cet espace de travail.

Modification d'un espace de travail

Vous pouvez modifier les attributs d'espace de travail suivants :

• Nom de l'espace de travail

• Commentaire

• Mappages du dossier de travail

Si aucune spécification d'espace de travail n'est fournie, l'espace de travail du dossier actif est utilisé.

Exemples

L'exemple suivant ouvre la boîte de dialogue Ajouter un espace de travail et crée un nouvel espace de travail. Vous pouvez utiliser la boîte de dialogue Ajouter un espace de travail pour modifier le dossier de contrôle de code source, le propriétaire, l'ordinateur, le commentaire et les dossiers locaux.

c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection

L'exemple suivant crée un nouvel espace de travail appelé Beta1 et assigne jenh comme propriétaire. Vous devez disposer de l'autorisation AdminWorkspaces pour assigner la propriété d'un nouvel espace de travail à un autre utilisateur. Pour plus d'informations sur les autorisations de sécurité, consultez Autorisations de Team Foundation Server.

c:\projects>tf workspace /new Beta1;jenh

L'exemple suivant crée un nouvel espace de travail en utilisant comme modèle l'espace de travail Beta1 qui appartient à jenh.

c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://myserver:8080/tfs/DefaultCollection

L'exemple suivant supprime l'espace de travail Beta1 du serveur.

c:\projects>tf workspace /delete Beta1

L'exemple suivant modifie les propriétés de l'espace de travail actuel.

c:\projects>tf workspace

L'exemple suivant ouvre l'espace de travail Beta1 dont l'utilisateur jenh est propriétaire afin que vous puissiez consulter ses propriétés et mappages. Si vous disposez des autorisations AdminWorkspaces, vous pouvez modifier les propriétés et mappages de cet espace de travail.

c:\projects> tf workspace Beta1;jenh

Voir aussi

Tâches

Créer un espace de travail et obtenir des fichiers

Masquer et dévoiler des dossiers dans un espace de travail

Référence

Syntaxe de ligne de commande (Contrôle de version)

Workspaces, commande

Concepts

Créer un espace de travail pour utiliser le projet de votre équipe

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf