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

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.
username	Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur.
TeamProjectCollectionUrl	URL de la collection de projets d'équipe qui contient l'espace de travail au sujet dont vous souhaitez créer, modifier, supprimer ou afficher des informations (par exemple, http://myserver:8080/tfs/DefaultCollection).
ownername	Fournit une valeur pour l'option /newowner .

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.
/newname	Renomme un espace de travail existant.
/noprompt	Exécute la commande Workspace spécifiée sans afficher de boîte de dialogue.
/collection	Spécifie la collection du projet d'équipe.
/permission	Spécifie les options d'autorisation de l'espace de travail : Privé : Seuls les propriétaires peuvent utiliser, archiver des fichiers ou administrer l'espace de travail. Public limité : N'importe quel utilisateur valide peut utiliser l'espace de travail. Cependant, seuls les propriétaires peuvent archiver des fichiers ou administrer l'espace de travail. Public : N'importe quel utilisateur valide peut utiliser, archiver des fichiers ou administrer l'espace de travail.
/login	Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server.
/newowner	Spécifie le nom d'utilisateur du nouveau propriétaire de l'espace de travail.

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