Commande Afficher (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
La commande Team Foundation Version Control (TFVC) view récupère une version spécifique d’un fichier, le stocke dans un dossier temporaire sur votre ordinateur et l’affiche.
Prérequis
Pour utiliser la commande view, l’autorisation Lire doit être définie 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 sur lequel vous souhaitez récupérer des informations, par exemple, https://myserver:8080/tfs/DefaultCollection.
<shelveset-name> [:<owner>]
Identifie le jeu de réservations. L’argument facultatif <owner> est utilisé pour définir un jeu de réservations 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 gestion de version Team Foundation, Utiliser des options pour modifier le fonctionnement d’une commande.
Notes
Vous pouvez spécifier plusieurs arguments <item-spec>.
<version-spec>
Fournit une valeur comme C3 pour l’option /version. Pour plus d’informations sur la façon dont TFVC analyse les spécifications d’une version pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de Team Foundation Version Control.
<username>
Fournit une valeur à l’option /login. Vous pouvez spécifier DOMAIN\<username> ou <username> pour cette valeur.
<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 le disque à l’aide de la redirection de console, mais utilisez un nom ou un emplacement différent de l’élément versionné.
/recursive
Affiche tous les éléments dans le répertoire spécifié et ses sous-répertoires, s’il y en a.
/shelveset
Spécifie le jeu de réservations 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.
Notes
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. À moins que vous ne définissiez 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 ne les extrait pas. 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 Extraire et modifier les commandes.
Vous pouvez utiliser la commande difference pour afficher les différences entre deux versions d’un fichier. Pour plus d’informations, consultez la Commande Différence.
Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de gestion 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é, il imprime le contenu du fichier dans la console de commandes.Vous pouvez rediriger le contenu d’un fichier vers la sortie standard à l’aide de
|ou\>. 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 montre comment afficher la version de 314.cs qui a été archivée avec le jeu 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