Status, commande
Mise à jour : novembre 2007
Affiche des informations sur les modifications en attente apportées aux éléments dans un ou plusieurs espaces de travail.
Autorisations requises
Pour utiliser la commande status, vous devez disposer de l'autorisation Lire avec la valeur Autoriser pour tous les fichiers ou dossiers spécifiés. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
Paramètres
Argument |
Description |
|---|---|
itemspec |
Identifie le fichier ou le dossier pour lequel afficher des détails d'état. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Team System). |
servername |
Valeur fournie par l'utilisateur pour l'option /server. Exemple : http://teamfoundation2:8080. |
workspacename |
Valeur fournie par l'utilisateur pour l'option /workspace. |
workspaceowner |
Spécifie le nom de l'utilisateur qui a créé l'espace de travail. |
shelvesetname |
Valeur fournie par l'utilisateur pour l'option /shelveset. |
shelvesetowner |
Spécifie le nom du propriétaire du jeu de réservations. |
username |
Fournit une valeur pour l'option /user. Une valeur de nom d'utilisateur peut s'exprimer de deux manières, en fonction des paramètres réseau : DOMAINE\nomutilisateur ou nomutilisateur. |
Option |
Description |
|---|---|
/server |
Identifie le serveur Team Foundation Server. Cette option est requise si la commande est appelée à partir d'un répertoire qui n'est pas mappé à un espace de travail. |
/workspace |
Spécifie le nom de l'espace de travail pour lequel vous souhaitez consulter une liste de modifications. Si cette option n'est pas spécifiée et que vous exécutez la commande à partir d'un répertoire qui a été ajouté à un espace de travail, l'espace de travail actuel est utilisé. Cette option ne peut pas être combinée avec l'option /shelveset. |
/shelveset |
Nom du jeu de réservations pour lequel vous souhaitez consulter une liste de modifications. Cette option ne peut pas être combinée avec l'option /workspace. |
/format |
Format des informations d'état. Brief affiche des modifications ou une liste de modifications qui ont été mises en attente d'archivage. Detailed affiche des informations d'état complètes. Brief est la valeur par défaut. |
/recursive |
Affiche des informations d'état pour tous les éléments d'un répertoire particulier et ses sous-répertoires. |
/user |
Filtre la liste des modifications apportées à l'utilisateur nommé. Un astérisque (*) peut être utilisé pour représenter tous les utilisateurs. La valeur par défaut correspond à l'utilisateur actuel. |
Notes
Vous pouvez utiliser la commande status pour afficher une liste des modifications en attente. Une modification en attente est une révision de fichier ou de dossier qui n'a pas été soumise au serveur et fournie dans un ensemble de modifications avec version. Pour plus d'informations, consultez Modifications en attente.
Vous pouvez également spécifier l'option /shelveset pour afficher des détails sur les modifications réservées sans version qui composent un jeu de réservations. Pour plus d'informations sur la différence entre les modifications en attente et les modifications réservées, consultez Utilisation des jeux de réservations du contrôle de version.
Pour obtenir des liens vers d'autres commandes de Team Foundation qui fournissent des informations supplémentaires sur les éléments se trouvant sur le serveur et tous les espaces de travail qui correspondent à ce serveur, consultez Commandes d'information.
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.
Résultat de la commande
Si le type de modification en attente est rename, le nouveau nom s'affiche. Pour plus d'informations, consultez Rename, commande (contrôle de version Team Foundation).
Il existe deux modes d'affichage : bref et détaillé.
/Format:brief affiche le nom de fichier, la modification et le chemin d'accès local de l'élément, l'état du verrouillage, le type de modification en attente qu'il représente, l'utilisateur qui a effectué la modification et l'emplacement de la version d'espace de travail de l'élément sur le disque. Le résultat est d'abord trié par dossier, puis par nom de fichier dans le dossier.
/Format:detailed affiche plusieurs lignes d'informations sur chaque modification en attente dans la sortie. La sortie détaillée inclut tout ce qu'inclut la sortie brève et y ajoute la date, l'heure et d'autres informations.
Exemples
L'exemple suivant affiche des informations sur toutes les modifications en attente pour l'utilisateur actuel dans l'espace de travail actuel. L'espace de travail actuel est l'espace de travail auquel le répertoire local est mappé.
c:\projects>tf status
L'exemple suivant affiche toutes les modifications en attente pour l'utilisateur actuel sous d:\src sur l'ordinateur actuel.
c:\projects>tf status/recursive d:\src
L'exemple suivant affiche toutes les modifications en attente pour l'utilisateur actuel dans l'espace de travail Beta1.
c:\projects>tf status/workspace:Beta1
L'exemple suivant affiche des informations d'état pour toutes les modifications en attente pour l'utilisateur Jason.
c:\projects>tf status/user:Jason
L'exemple suivant affiche des informations d'état pour toutes les modifications en attente pour tous les utilisateurs, dans tous les espaces de travail sur le serveur.
c:\projects>tf status/user:*
L'exemple suivant affiche des informations sur toutes les modifications en attente pour l'utilisateur actuel dans tous les espaces de travail sur le serveur situé sur teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:*
L'exemple suivant affiche des informations sur toutes les modifications que Joe a faites, mais n'a pas archivées, dans tous les espaces de travail qui correspondent au serveur de teamserver2.
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe
Voir aussi
Concepts
Utilisation des espaces de travail du contrôle de version
Utilisation des ensembles de modifications du contrôle de version
Utilisation des jeux de réservations du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)
Autres ressources
Commandes de l'utilitaire en ligne de commande Tf
Comparaison de dossiers et de fichiers dans le contrôle de version