Workspaces, commande

Affiche des informations sur les espaces de travail du système et met à jour les informations en cache concernant les modifications de nom d'utilisateur ou de nom d'ordinateur sur le serveur qui exécute Visual Studio Team Foundation Server.

Autorisations requises

Pour utiliser la commande workspaces, vous devez disposer de l'autorisation Lire avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf workspaces [/owner:ownername] [/computer:computername] 
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed)] 
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName] 
[workspacename][/login:username,[password]]

tf workspaces /remove:(*|workspace1[,workspace2,...]) 
/collection:(*|TeamProjectCollectionUrl)

Paramètres

Argument

Description

ownername

Fournit une valeur pour l'option /owner. Spécifiez "*" pour correspondre aux espaces de travail créés par n'importe quel utilisateur.

computername

Fournit une valeur pour l'option /computer . Spécifiez "*" pour correspondre aux espaces de travail sur n'importe quel ordinateur.

workspacename

Spécifie le nom de l'espace de travail à propos duquel afficher les informations. Si un workspacename n'est pas spécifié, les informations sur tous les espaces de travail d'un serveur s'affichent. Vous pouvez également utiliser le caractère générique "*" pour afficher les informations sur tous les espaces de travail d'un serveur.

oldUserName

Fournit l'ancien nom d'utilisateur pour l'option /updateUserName.

oldComputerName

Fournit l'ancien nom d'ordinateur pour l'option /updateComputerName.

TeamProjectCollectionUrl

URL de la collection de projets d'équipe qui contient les espaces de travail au sujet desquels vous souhaitez afficher des informations (par exemple, http://myserver:8080/tfs/DefaultCollection).

username

Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur.

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é, Team Foundation retourne des informations concernant uniquement les espaces de travail dont l'utilisateur actuel est propriétaire.

/computer

Spécifie le nom d'un ordinateur client par lequel filtrer la liste d'espaces de travail pour le serveur. Si aucun ordinateur n'est spécifié, Team Foundation retourne des informations concernant uniquement les espaces de travail de l'ordinateur actuel.

/format

Spécifie le format des informations d'espace de travail. Brief retourne les informations d'espace de travail sans mappages. Detailed retourne les informations d'espace de travail, ainsi que les mappages. 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 Team Foundation pour un utilisateur dont le nom d'utilisateur réseau a été modifié. Si vous spécifiez cette option, vous devez également indiquer une collection de projets d'équipe à l'aide de l'option /collection.

/updateComputerName

Indique à Team Foundation de mettre à jour ses tables pour répercuter une modification du nom d'un ordinateur client. Si vous spécifiez cette option, vous devez également indiquer une collection de projets d'équipe à l'aide de l'option /collection.

/remove

Supprime du cache client les entrées d'espace de travail spécifiées pour la collection du projet d'équipe spécifié.

/collection

Spécifie la collection du projet d'équipe.

/login

Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Team Foundation Server.

Notes

La commande workspaces de l'utilitaire en ligne de commande tf affiche des informations concernant les espaces de travail de l'ordinateur actuel, possédés par un utilisateur spécifié, ou sur tous les espaces de travail associés à un serveur Team Foundation Server spécifique. Pour chaque espace de travail, Team Foundation affiche son nom, son propriétaire, le commentaire et le nom de l'ordinateur. Avec l'option de sortie détaillée, il affiche également les mappages d'espace de travail. À moins de fournir un filtre, tel que le propriétaire, l'ordinateur ou le nom de l'espace de travail, Team Foundation n'affiche d'informations que sur les espaces de travail créés par vous-même.

Pour plus d'informations sur la façon de modifier les propriétés des espaces de travail, consultez Workspace, commande.

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.

Exemples

L'exemple suivant affiche une 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 de tous les utilisateurs sur tous les ordinateurs qui ont été créés dans la collection de projets d'équipe suivante à l'adresse http://myserver:8080/tfs/DefaultCollection.

c:\projects>tf workspaces /owner:* /computer:* /collection:http://myserver:8080/tfs/DefaultCollection

L'exemple suivant affiche les informations détaillées sur tous les espaces de travail créés par l'utilisateur actuel dans la collection de projets d'équipe à l'adresse http://myserver:8080/tfs/DefaultCollection.

c:\projects>tf workspaces /computer:* /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection

L'exemple suivant affiche des informations détaillées, y compris une liste de mappages d'espace de travail, concernant l'espace de travail "WS1" possédé par l'utilisateur actuel et situé sur l'ordinateur actuel.

c:\projects>tf workspaces /format:detailed /collection:http://myserver:8080/tfs/DefaultCollection WS1

L'exemple suivant supprime tous les espaces de travail du cache dans la collection de projets d'équipe à l'adresse http://myserver:8080/tfs/DefaultCollection.

c:\projects>tf workspaces /remove:* /collection:http://myserver:8080/tfs/DefaultCollection

Voir aussi

Tâches

Créer un espace de travail et obtenir des fichiers

Référence

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

Workspace, commande

Workfold, 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