View, commande
Mise à jour : novembre 2007
La commande view récupère une version spécifique d'un fichier dans un dossier temporaire de votre ordinateur et l'affiche.
Autorisations requises
Pour utiliser la commande view, vous devez disposer de l'autorisation Lire avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf view [/server:servername] [/console] [/recursive]
[/shelveset:shelvesetname[;owner]] [/noprompt] itemspec
[/version:versionspec]
Paramètres
Argument |
Description |
|---|---|
servername |
Valeur fournie par l'utilisateur pour l'option /server. Exemple : teamserver2. |
shelvesetname [:owner] |
Identifie le jeu de réservations. L'argument owner facultatif est utilisé pour spécifier un jeu de réservations qui n'appartient pas à l'utilisateur actuel. |
Itemspec |
Identifie le fichier ou le dossier à récupérer. 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 Options de ligne de commande. |
Versionspec |
Fournit une valeur, telle que C3, pour l'option /version. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Team System). |
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. |
/console |
Spécifie que la sortie du fichier doit être dirigée vers la console. Cette option est utile si vous souhaitez écrire le fichier sur le disque à l'aide de la redirection de la console (avec un nom ou un emplacement différent de l'élément dont la version est gérée). |
/recursive |
Affiche tous les éléments dans le répertoire spécifié et ses sous-répertoires. |
/shelveset |
Spécifie le jeu de réservations par nom. |
/noprompt |
Spécifie que Team Foundation ne doit pas vous adresser d'invite avant d'afficher chaque fichier lorsque vous incluez un caractère générique dans des itemspec qui correspondent à plusieurs fichiers. |
/version |
Spécifie la version du fichier à ouvrir pour l'afficher. Si vous omettez cette option, view récupère la version du serveur de contrôle de version Team Foundation la plus récente. |
Notes
La commande view de l'utilitaire en ligne de commande tf récupère une copie en lecture seule d'un fichier du serveur de contrôle de version Team Foundation, la place dans un dossier temporaire de votre ordinateur et affiche son contenu. À moins de spécifier une version particulière, Team Foundation récupère la version la plus récente du fichier sur le serveur de contrôle de version Team Foundation.
La commande view ne récupère pas les fichiers dans votre espace de travail ni ne les extrait. Consultez Get, commande et Checkout et Edit, commandes pour plus d'informations sur la façon d'obtenir la version du serveur de contrôle de version Team Foundation et d'extraire des fichiers.
Vous pouvez utiliser la Difference, commande pour afficher les différences entre deux versions d'un fichier.
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.
Options de sortie
Par défaut, Team Foundation affiche le contenu du fichier dans la visionneuse associée à son type de fichier.
Si vous incluez l'option /console, Team Foundation affiche le contenu du fichier sur la console de commande. De même, si Team Foundation ne peut localiser de visionneuse pour le type de fichier que vous avez spécifié, il affiche le contenu du fichier sur la console de commande.
Enfin, vous pouvez rediriger le contenu d'un fichier vers une sortie standard à l'aide de | ou > afin de l'enregistrer dans un autre fichier ou de le passer à un autre programme pour un post-traitement.
Exemples
L'exemple suivant affiche la version la plus récente du fichier 314.c.
c:\projects>tf view 314.c
L'exemple suivant affiche la version de 314.c archivée avec l'ensemble de modifications 1999.
c:\projects>tf view /version:C1999 314.c
L'exemple suivant récupère la version 5 de 314.c et l'écrit dans le fichier 314.old.
c:\projects>tf view /version:5 314.c > 314.old
L'exemple suivant affiche la version la plus récente de chaque fichier correspondant au caractère générique "* .cs."
c:\projects>tf view *.cs
Voir aussi
Référence
Syntaxe de ligne de commande (Team System)