View, commande
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 [/collection:TeamProjectCollectionUrl] [/console] [/recursive] [/output:localfile]
[/shelveset:shelvesetname[;owner]] [/noprompt] itemspec
[/version:versionspec] [/login:username,[password]]
Paramètres
Argument |
Description |
---|---|
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient une version spécifique d'un fichier au sujet duquel vous souhaitez extraire des informations (par exemple, http://myserver:8080/tfs/DefaultCollection). |
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 afin de déterminer quels éléments se trouvent dans la portée, consultez Options de ligne de commande.
Remarque
Vous pouvez spécifier plusieurs arguments Itemspec.
|
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 (Contrôle de version). |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
localfile |
Fournit le chemin d'accès du dossier dans lequel vous souhaitez générer le fichier. |
Option |
Description |
---|---|
/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. |
/collection |
Spécifie 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. |
/output |
Génère le fichier dans un dossier local au lieu d'appeler un shell Windows pour ouvrir le fichier. |
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 via | ou > afin de l'enregistrer dans un autre fichier ou de le passer à un autre programme à des fins de 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 (Contrôle de version)