Workspace, commande
Mise à jour : novembre 2007
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)]
[/s:servername] [workspacename[;workspaceowner]]
tf workspace /delete [/server:servername] workspacename[;workspaceowner]
tf workspace [/server:servername] [/comment: (“comment”|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]]
Paramètres
Argument |
Description |
|---|---|
workspacename |
Spécifie un nom pour l'espace de travail à créer, modifier, supprimer ou sur lequel afficher des informations. |
workspaceowner |
Spécifie un nom d'utilisateur pour l'espace de travail. Ce paramètre est requis lorsque le propriétaire de l'espace de travail n'est pas la personne qui exécute la commande. |
computername |
Fournit une valeur pour l'option /computer . |
comment |
Fournit une valeur pour l'option /comment . |
@commentfile |
Spécifie le chemin d'accès d'un fichier où le commentaire doit être lu. |
servername |
Valeur fournie par l'utilisateur pour l'option /server. Par exemple, teamfoundation2. |
Option |
Description |
|---|---|
/new |
Crée un nouvel espace de travail. |
/template |
Spécifie un espace de travail existant à utiliser comme modèle pour créer le nouvel espace de travail. Le nouvel espace de travail utilise les mappages de l'espace de travail existant. |
/delete |
Supprime l'espace de travail spécifié. |
/computer |
Spécifie le nom de l'ordinateur sur lequel créer l'espace de travail. Il s'agit d'une option avancée. |
/comment |
Fournit un commentaire qui décrit l'espace de travail. |
/server |
Identifie le serveur Team Foundation Server. Cette option est requise lorsque vous créez un nouvel espace de travail et que vous essayez de lancer la commande workspace à partir d'un répertoire non mappé à un espace de travail. |
/newname |
Renomme un espace de travail existant. |
/noprompt |
Exécute la commande Workspace spécifiée sans afficher de boîte de dialogue. |
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 nouvel 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 Comment : créer un espace de travail mappé.
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 Comment : 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 /server:teamserver2
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 /server:teamserver2
L'exemple suivant supprime l'espace de travail Beta1 du système.
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
Comment : créer un espace de travail mappé
Comment : masquer et dévoiler des dossiers dans un espace de travail
Concepts
Utilisation des espaces de travail du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)