Status, commande

Affiche des informations relatives aux 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 [/collection:TeamProjectCollectionUrl] [/login:username,[password]] ([/workspace:workspacename[;workspaceowner]]|[/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 (Contrôle de version).

RemarqueRemarque
Vous pouvez spécifier plusieurs arguments Itemspec.

TeamProjectCollectionUrl

URL de la collection de projets d'équipe au sujet de laquelle vous souhaitez afficher les informations d'état (par exemple, http://myserver:8080/tfs/DefaultCollection).

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

/collection

Identifie la collection du projet d'équipe.

/login

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

/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 une liste des modifications apportées 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 de jeux de réservations.

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 de la collection qui est située à l'adresse http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:*

L'exemple suivant affiche des informations sur toutes les modifications que Joe a effectuées mais n'a pas archivées, dans tous les espaces de travail de la collection qui est située à l'adresse http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:* /user:Joe

Voir aussi

Référence

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

Changeset, commande

Shelvesets, commande

Concepts

Créer un espace de travail pour utiliser le projet de votre équipe

Modifications en attente

Utilisation d'ensembles de modifications

Utilisation de jeux de réservations

Commandes d'information

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf

Comparaison de dossiers et de fichiers