Commande workspace (Team Foundation Version Control)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande workspace de Team Foundation Version Control (TFVC) permet de créer, supprimer, afficher ou modifier des propriétés et des mappages associés à un espace de travail.

Prérequis

  • Pour modifier ou supprimer un espace de travail existant, vous devez être le propriétaire ou l’autorisation globale d’Administrer des espaces de travail doit être définie sur Autoriser.
  • Pour créer un espace de travail, l’autorisation globale Créer un espace de travail doit être définie sur Autoriser.
  • Pour créer des espaces de travail pour d’autres utilisateurs, l’autorisation Administrer les espaces de travail doit être définie sur Autoriser.

Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]

tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]

tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Paramètres

Les sections suivantes décrivent les arguments et les options de la commande workspace.

Arguments

Argument Description
<workspace-name> Spécifie un nom pour l’espace de travail que vous souhaitez créer, modifier, supprimer ou sur lequel vous souhaitez afficher des informations.
<workspace-owner> 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.
<computer-name> Fournit une valeur à l’option /computer.
<comment> Fournit une valeur à l’option /comment.
@<comment-file> Spécifie le chemin d’accès d’un fichier dans lequel le commentaire doit être lu.
<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.
<team-project-collection-url> URL de la collection de projets qui contient l’espace de travail que vous souhaitez créer, modifier, supprimer ou sur lequel vous souhaitez afficher des informations, par exemple https://myserver:8080/tfs/DefaultCollection.
<owner-name> Fournit une valeur à l’option /newowner.

Options

Option Description
/new Crée un espace de travail.
/template Spécifie un espace de travail existant à utiliser comme modèle pour créer un 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 un espace de travail. Cette option est 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 d’espace de travail spécifiée sans afficher de boîte de dialogue.
/collection Spécifie la collection de projets.
/permission Spécifie les options pour les autorisations d’espace de travail :

    - Private : seuls les propriétaires peuvent utiliser, archiver les fichiers ou administrer l’espace de travail.


    - Public Limited : tout utilisateur valide peut utiliser l’espace de travail. Mais seuls les propriétaires peuvent archiver les fichiers ou administrer l’espace de travail.


    - Public : tout utilisateur valide peut utiliser, archiver les fichiers ou administrer l’espace de travail.
/location Spécifie l’emplacement de création de l’espace de travail :

    - local : sur l’ordinateur du client. Cette valeur est la valeur par défaut.


    - server : sur le serveur Azure DevOps.
/login Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.
/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 dossiers sur le serveur, ainsi que des modifications que vous avez apportées localement. Lorsque vous ajoutez, modifiez, supprimez, déplacez, renommez ou modifiez un élément à version contrôlée, vos modifications sont isolées dans votre espace de travail, où vous pouvez effectuer et tester vos modifications. Lorsque vous archivez votre travail dans le codebase de l’équipe, vous validez vos modifications sur le serveur. Ils deviennent disponibles pour d’autres utilisateurs en dehors de votre espace de travail.

Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de gestion de version Team Foundation.

Créer un espace de travail

Avant de pouvoir ajouter des fichiers au serveur de gestion de version ou archiver des éléments sur le serveur, vous devez créer un espace de travail ou en associer un existant au répertoire actif. Pour plus d’informations, consultez Configurer Team Foundation Version Control sur votre machine de développement.

Pour faire du répertoire actif un dossier de travail pour un espace de travail existant sur votre ordinateur, procédez comme suit :

  1. Saisissez tf workspace <workspace-name>, où <workspace-name> est le nom de l’espace de travail existant. La boîte de dialogue Modifier l’espace de travail s’affiche.
  2. Sélectionnez cliquez ici pour entrer un nouveau dossier de travail.
  3. Dans la zone Dossier du contrôle de code source, indiquez le chemin du serveur auquel vous souhaitez mapper le répertoire actif.
  4. Dans la zone Dossier local, indiquez le répertoire actif.
  5. Sélectionnez OK.

Lorsque vous créez un 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, TFVC crée un espace de travail sur l’ordinateur actuel. TFVC définit également le propriétaire sur le propriétaire actuel et réplique les propriétés d’espace de travail suivantes dans le nouvel espace de travail à partir du modèle d’espace de travail : mappings et comment. Si aucun nom n’est spécifié, le système utilise un nom basé sur le nom de l’ordinateur actuel. Lorsque vous créez un espace de travail à l’aide d’un modèle, TFVC ne récupère pas les fichiers auxquels il mappe à partir du serveur. Utilisez la commande get pour synchroniser le nouvel espace de travail avec la dernière version sur le serveur. Pour plus d’informations, voir Commande get.

Mappage de dossiers uniques

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

Le mappage de dossiers uniques au sein d’une hiérarchie de gestion de version est utile, car il limite le nombre d’éléments téléchargés sur l’ordinateur client. Une autre façon de limiter les fichiers téléchargés consiste à masquer les fichiers dont vous n’avez pas besoin sur votre espace de travail. Pour plus d’informations, consultez Optimiser votre espace de travail. Cette approche permet d’accélérer les temps de téléchargement et d’économiser de l’espace disque sur l’ordinateur client.

Supprimer un espace de travail

Si vous supprimez un espace de travail qui contient des modifications en attente, TFVC annule les modifications en attente dans le cadre du processus de suppression. La suppression d’un espace de travail ne supprime pas les fichiers et dossiers sur l’ordinateur client qui se trouvaient dans cet espace de travail.

Notes

Les commandes qui s’exécutent manuellement nécessitent l’option /noprompt pour contourner l’accusé de réception de l’utilisateur. Soyez prudent si vous utilisez la méthode PowerShell Start() pour exécuter des commandes. L’option /noprompt peut être automatiquement définie dans PowerShell.

Lors de la suppression d’un espace de travail, vous devez fournir <workspace-owner> et <workspace-name>

Vous pouvez utiliser la commande workspace pour récupérer ces valeurs. Pour plus d’informations, consultez commande de l’espace de travail. Pour rechercher la valeur <workspace-owner>, exécutez la commande suivante :

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Pour rechercher la valeur <workspace-name>, utilisez la valeur <OwnerId> de la sortie de la commande précédente comme valeur <workspace-owner>. Cette valeur a le format d’un ID d’objet Azure Active Directory (Azure AD) suivi d’une barre oblique inverse et d’un nom d’utilisateur principal. Utilisez la valeur entière. Exécutez ensuite la commande suivante :

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Pour supprimer l’espace de travail, exécutez la commande suivante :

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Modifier un espace de travail

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

  • Nom de l’espace de travail
  • Commentaire
  • Mappages de dossiers de travail

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

Exemples

L’exemple suivant ouvre la boîte de dialogue Ajouter un espace de travail et crée un 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:https://myserver:8080/tfs/DefaultCollection

L’exemple suivant crée un espace de travail appelé Beta1 et affecte jenh comme propriétaire de l’espace de travail. Vous devez disposer de l’autorisation AdminWorkspaces pour attribuer la propriété d’un nouvel espace de travail à un autre utilisateur. Pour plus d’informations sur les autorisations de sécurité, consultez Autorisations TFVC par défaut.

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

L’exemple suivant crée un espace de travail à l’aide de l’espace de travail Beta1 appartenant à jenh en tant que modèle :

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://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 appartenant à jenh afin que vous puissiez voir ses propriétés et mappages. Si vous disposez de l’autorisation AdminWorkspaces, vous pouvez modifier les propriétés et mappages de l’espace de travail.

c:\projects> tf workspaces Beta1;jenh