Commande View (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
La commande TFVC (Team Foundation Version Control) view récupère une version spécifique d’un fichier, la stocke dans un dossier temporaire sur votre ordinateur et l’affiche.
Conditions préalables
Pour utiliser la commande view, définissez l’autorisation Lecture sur Autoriser. Pour plus d’informations, consultez autorisations TFVC par défaut.
Syntaxe
tf view [/collection:<team-project-collection-url>] [/console] [/recursive] [/output:<local-file>]
[/shelveset:<shelveset-name>[;<owner>]] [/noprompt] <item-spec>
[/version:<version-spec>] [/login:<username>,[<password>]]
Paramètres
Les sections suivantes décrivent les arguments et les options de la commande view.
Arguments
argument
Description
<team-project-collection-url>
Fournit l’URL de la collection de projets qui contient une version spécifique d’un fichier que vous souhaitez récupérer des informations sur, par exemple, https://myserver:8080/tfs/DefaultCollection.
<shelveset-name> [:<owner>]
Identifie l’ensemble de rayons. L’argument <owner> facultatif est utilisé pour spécifier un ensemble de rayons qui n’appartient pas à l’utilisateur actuel.
<item-spec>
Identifie le fichier ou le dossier à récupérer. Pour plus d’informations sur la façon dont TFVC analyse l’argument <item-spec> pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de contrôle de version Team Foundation - Utilisez des options pour modifier la façon dont une fonction de commande.
Note
Vous pouvez spécifier plusieurs arguments <item-spec>.
<version-spec>
Fournit une valeur telle que C3 pour l’option /version. Pour plus d’informations sur la façon dont TFVC analyse une spécification de version pour déterminer quels éléments se trouvent dans son étendue, consultez Utiliser les commandes de contrôle de version Team Foundation.
<username>
Fournit une valeur à l’option /login. Vous pouvez spécifier cette valeur comme DOMAIN\<username> ou <username>.
<password>
Fournit une valeur à l’option /login.
<local-file>
Fournit le chemin d’accès au dossier du fichier de sortie.
Options
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 disque à l’aide de la redirection de console, mais utilisez un nom ou un emplacement différent de l’élément avec version.
/recursive
Affiche tous les éléments du répertoire spécifié et de tous les sous-répertoires.
/shelveset
Spécifie le jeu d’étagères par nom.
/noprompt
Spécifie que TFVC ne doit pas vous inviter avant d’afficher chaque fichier lorsque vous incluez une expression générique dans un argument <item-spec> qui correspond à plusieurs fichiers.
/version
Spécifie la version du fichier à ouvrir pour l’affichage. Si vous omettez cette option, view récupère la dernière version du serveur Azure DevOps.
/collection
Spécifie la collection de projets.
/login
Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.
/output
Génère le fichier dans un dossier local au lieu d’appeler un interpréteur de commandes Windows pour ouvrir le fichier.
Remarques
La commande view de l’utilitaire de ligne de commande tf récupère une copie en lecture seule d’un fichier à partir du serveur Azure DevOps, stocke le fichier dans un dossier temporaire sur votre ordinateur et affiche le contenu du fichier. Sauf si vous spécifiez une version particulière, TFVC récupère la dernière version du fichier à partir du serveur Azure DevOps.
La commande view n’ajoute pas de fichiers à votre espace de travail ou les examine. Pour plus d’informations sur la façon d’obtenir la version du serveur Azure DevOps d’un fichier et de l’extraire, consultez Obtenir la commande et commandes d’extraction et de modification.
Vous pouvez utiliser la commande difference pour afficher les différences entre deux versions d’un fichier. Pour plus d’informations, consultez commande Différence.
Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.
Options de sortie
Par défaut, TFVC affiche le contenu du fichier dans la visionneuse associée à son type de fichier.
Si vous incluez l’option
/console, TFVC imprime le contenu du fichier dans la console de commandes. De même, si TFVC ne peut pas localiser une visionneuse pour le type de fichier que vous avez spécifié, elle imprime le contenu du fichier dans la console de commandes.Vous pouvez rediriger le contenu d’un fichier vers une sortie standard à l’aide de
|ou de\>. Cette option permet d’enregistrer le fichier dans un autre fichier ou de le transmettre à un autre programme pour le post-traitement.
Exemples
L’exemple suivant affiche la dernière version du fichier 314.cs:
c:\projects>tf view 314.cs
L’exemple suivant affiche la version de 314.cs qui a été vérifiée avec l’ensemble de modifications 1999 :
c:\projects>tf view /version:C1999 314.cs
L’exemple suivant récupère la version 5 de 314.cs et l’écrit dans le fichier 314.old:
c:\projects>tf view /version:5 314.cs > 314.old
L’exemple suivant affiche la dernière version de chaque fichier qui correspond à l’expression générique *.cs:
c:\projects>tf view *.cs