Commande Espaces de travail (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) workspaces affiche des informations sur les espaces de travail dans le système et met à jour les informations mises en cache sur une modification de nom d’utilisateur ou d’ordinateur sur un serveur Azure DevOps.
Prérequis
Pour utiliser la commande workspaces, l’autorisation Lire doit être définie sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.
Syntaxe
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Paramètres
Les sections suivantes décrivent les arguments et les options de la commande workspaces.
Arguments
Argument
Description
<owner-name>
Fournit une valeur à l’option /owner. Utilisez une chaîne vide (« ») pour faire correspondre les espaces de travail créés par n’importe quel utilisateur.
<computer-name>
Fournit une valeur à l’option /computer. Utilisez une chaîne vide (« ») pour faire correspondre les espaces de travail sur n’importe quel ordinateur.
<workspace-name>
Spécifie le nom d’un espace de travail pour afficher des informations sur. Si aucune valeur n’est spécifiée, les informations s’affichent sur tous les espaces de travail d’un serveur. Vous pouvez également utiliser un caractère générique astérisque (*) pour afficher des informations sur tous les espaces de travail d’un serveur.
<old-user-name>
Fournit l’ancien nom d’utilisateur de l’option /updateUserName.
<old-computer-name>
Fournit l’ancien nom de l’ordinateur pour l’option /updateComputerName.
<team-project-collection-url>
L’URL de la collection de projets qui contient les espaces de travail sur lesquelles vous souhaitez afficher des informations, 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
/owner
Spécifie le nom de l’utilisateur qui a créé l’espace de travail. Si aucun propriétaire n’est spécifié, TFVC retourne des informations sur les espaces de travail détenus par l’utilisateur actuel uniquement.
/computer
Spécifie le nom d’un ordinateur client par lequel filtrer la liste des espaces de travail pour le serveur. Si aucun ordinateur n’est spécifié, TFVC retourne des informations sur les espaces de travail sur l’ordinateur actuel uniquement.
/format
Spécifie le format des informations d’espace de travail. Brief retourne des informations sur l’espace de travail sans mappages. Detailed retourne des informations sur l’espace de travail et les mappages. Xml retourne des informations sur l’espace de travail, un mappage, la date d’accès la plus récente, ainsi que les alias de propriétaire. Le format détaillé ne peut être utilisé que lorsque l’option /collection est spécifiée. Brief est la valeur par défaut.
/updateUserName
Met à jour les informations d’identification de sécurité sur le serveur Azure DevOps pour un utilisateur dont le nom d’utilisateur réseau a été modifié. Si vous spécifiez cette option, vous devez également spécifier une collection de projets à l’aide de l’option /collection.
/updateComputerName
Indique à TFVC de mettre à jour ses tables pour refléter une modification du nom d’un ordinateur client. Si vous spécifiez cette option, vous devez également spécifier une collection de projets à l’aide de l’option /collection.
/remove
Supprime les entrées d’espace de travail spécifiées pour la collection de projets spécifiée du cache client.
/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 Server.
Notes
La commande workspaces de l’utilitaire de ligne de commande tf affiche des informations sur les espaces de travail sur l’ordinateur actuel, appartenant à un utilisateur spécifié ou pour tous les espaces de travail associés à un serveur Azure DevOps spécifique. Pour chaque espace de travail, TFVC affiche le nom, le propriétaire, le commentaire et le nom de l’ordinateur. Avec une sortie détaillée, il affiche également les mappages d’espace de travail. Sauf si vous fournissez un filtre tel que le propriétaire, l’ordinateur ou le nom de l’espace de travail, TFVC affiche uniquement des informations sur les espaces de travail que vous avez créés.
Pour plus d’informations sur la modification des propriétés de l’espace de travail, consultez la commande Espace de travail.
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.
Exemples
L’exemple suivant affiche la liste de tous les espaces de travail de l’utilisateur actuel sur l’ordinateur actuel :
c:\projects>tf workspaces
L’exemple suivant affiche la liste de tous les espaces de travail pour tous les utilisateurs sur tous les ordinateurs créés dans la collection de projets suivante à l’adresse https://myserver:8080/tfs/DefaultCollection :
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
L’exemple suivant affiche des informations détaillées sur tous les espaces de travail que l’utilisateur actuel a créés dans la collection de projets à l’adresse https://myserver:8080/tfs/DefaultCollection :
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
L’exemple suivant affiche des informations détaillées sur l’espace de travail WS1, qui appartient à l’utilisateur actuel et se trouve sur l’ordinateur actuel. Les informations affichées incluent une liste de mappages d’espaces de travail.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
L’exemple suivant supprime tous les espaces de travail mis en cache du cache dans la collection de projets à l’adresse https://myserver:8080/tfs/DefaultCollection :
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection