Commande Status (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) status, ou son alias stat, affiche des informations sur les modifications en attente apportées aux fichiers et dossiers et aux candidats aux modifications en attente dans un ou plusieurs espaces de travail. Lorsque vous utilisez l’option /shelveset, la commande affiche des informations sur les modifications en attente dans un jeu de réservations.

Notes

Un candidat de modification en attente est un fichier dans le dossier ou sous-dossier de l’espace de travail qui n’est pas ajouté au contrôle de version. Pour afficher tous les candidats aux modifications en attente dans Visual Studio, accédez à Team Explorer>Modifications en attente>Modifications exclues, puis sélectionnez Détectées.

Prérequis

Pour utiliser la commande status, vous devez disposer de l’autorisation Lecture pour l’élément source et des autorisations Extraire et Fusionner pour le dossier cible défini sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Paramètres

Arguments

Argument

Description

/collection: <TeamProjectCollectionUrl>

Lorsque vous utilisez l'option /workspace, spécifie l'URL de la collection de projets qui contient l'espace de travail qui contient des modifications en attente. Par exemple : http://myserver:8080/tfs/DefaultCollection.

Si elle n'est pas spécifiée, par défaut la collection de projets est présumée être celle qui contient l'espace de travail qui mappe le répertoire actif.

Ignoré si vous n’utilisez pas l’option /workspace.

Notes

Consultez les Remarques pour connaître les limitations de cette option.

/format

Spécifie la quantité de détails à afficher sur chaque modification en attente :

  • Brief (valeur par défaut) : affiche une ligne sur chaque modification en attente qui inclut : nom de fichier, modifications, si l'élément est verrouillé indiqué par un astérisque*, chemin d'accès local et utilisateur (si vous utilisez les options /collection et /workspace). Certaines des données peuvent être tronquées.
  • Detailed : affiche une description complète de chaque modification en attente. En plus des informations ci-dessus, cette option affiche des informations supplémentaires telles que la date et l'heure.

<itemspec>

Spécifie les éléments pour lesquels vous souhaitez obtenir les données de modification en attente. Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Team Foundation. Vous pouvez spécifier plusieurs arguments itemspec.

/login

Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/recursive

Extrait de manière récursive des données sur les modifications en attente pour les éléments du répertoire spécifié et tous les sous-répertoires.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Spécifie le jeu de réservations qui contient les modifications que vous souhaitez répertorier.

Cette option ne peut pas être combinée avec l'option /workspace.

/user

Répertorie toutes les modifications en attente apportées par l'utilisateur spécifié. Un astérisque * inclut des données sur les modifications de tous les utilisateurs. La valeur par défaut est l’utilisateur actuel.

Valeurs acceptables pour cette option :

  • <username>
  • <useraccount>
  • Astérisque *

Notes

Consultez les Remarques pour connaître les limitations de cette option.

/workspace:<workspacename>[;<workspaceowner>]

Spécifie le nom de l'espace de travail qui contient des modifications en attente. S'il n'est pas spécifié, l'espace de travail est celui qui mappe le répertoire actif.

Vous pouvez spécifier workspaceowner pour obtenir des informations sur les modifications en attente dans un espace de travail qui appartient à un utilisateur spécifique. S'il n'est pas spécifié, l'espace de travail est présumé être soit l'utilisateur actuel, ou si spécifié, le /login:<username>.

Cette option ne peut pas être combinée avec l'option /shelveset.

Notes

Consultez les Remarques pour connaître les limitations de cette option.

Notes

Vous pouvez utiliser la commande status pour afficher les modifications en attente dans l'espace de travail actuel, par exemple l'espace de travail qui mappe le répertoire actif, qu'il s'agisse d'un espace de travail local ou d'un espace de travail du serveur. Vous pouvez également utiliser cette commande pour consulter des modifications en attente d'un espace de travail du serveur distant, par exemple, modifications apportées par un autre utilisateur sur un autre ordinateur dev à l'aide des options /collection, /user et /workspace. Toutefois, vous ne pouvez pas consulter des modifications en attente dans un espace de travail local distant.

Pour plus d’informations, consultez Choisir entre l’utilisation d’un espace de travail local ou d’un espace de travail de serveur.

Exemples

Dans les exemples suivants, supposez que $/SiteApp/Main/ est mappé à c:\code\SiteApp\Main\ dans l’espace de travail.

Répertorier tous les changements de l'espace de travail actuel

L’exemple suivant répertorie toutes les modifications en attente dans l’espace de travail :

c:\code\SiteApp\Main\SolutionA\>tf stat

Répertorier tous les modifications apportées à un dossier

L’exemple suivant répertorie toutes les modifications en attente apportées à tous les éléments du dossier SolutionA :

c:\code\SiteApp\Main>tf stat SolutionA\*

Répertorier toutes les modifications dans un dossier et ses sous-dossiers

L’exemple suivant répertorie les modifications en attente apportées à tous les éléments du dossier SolutionA, y compris les modifications apportées à ses sous-dossiers :

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Étapes suivantes