Partager via

Commande Status (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation Version Control (TFVC) status commande, 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 ensemble de rayons.

Note

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ée.

Conditions préalables

Pour utiliser la commande status, disposez de l’autorisation Lecture pour l’élément source et les 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 les modifications en attente. Par exemple : http://myserver:8080/tfs/DefaultCollection.

S’il n’est pas spécifié, par défaut, la collection de projets est supposée être celle qui contient l’espace de travail qui mappe le répertoire actif.

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

Note

Consultez 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 incluant : nom de fichier, modifications, indique si l’élément est verrouillé comme indiqué par un astérisque *, un chemin local et un utilisateur si vous utilisez les options /collection et /workspace. Certaines données peuvent être tronquées.
  • Detailed: affiche une description complète de chaque modification en attente. Outre les informations ci-dessus, cette option affiche plus de données telles que la date et l’heure.

<itemspec>

Spécifie les éléments pour lesquels vous souhaitez obtenir des données modifiées 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 à utiliser pour exécuter la commande. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/recursive

Récupère de manière récursive les données relatives aux modifications en attente apportées aux éléments du répertoire spécifié et aux sous-répertoires spécifiés.

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

Spécifie le jeu d’étagères 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 *

Note

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

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

Spécifie le nom de l’espace de travail qui contient les 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 données sur les modifications en attente dans un espace de travail appartenant à un utilisateur spécifique. S’il n’est pas spécifié, l’espace de travail est supposé être l’utilisateur actuel, ou s’il est spécifié, le /login:<username>.

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

Note

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

Remarques

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 serveur. Vous pouvez également utiliser cette commande pour afficher les modifications en attente dans un espace de travail serveur distant, par exemple les modifications apportées par un autre utilisateur sur un autre ordinateur de développement, à l’aide des options /collection, /useret /workspace. Toutefois, vous ne pouvez pas afficher les modifications en attente dans un espace de travail local distant.

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

Exemples

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

Répertorier toutes les modifications dans 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 toutes les modifications dans 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