Commande Dir (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
La commande dir affiche tout ou partie du contenu du serveur pour Team Foundation Version Control (TFVC).
Conditions préalables
Pour utiliser la commande dir, avez jeu d’autorisations Lire sur Autoriser. Pour plus d’informations, consultez autorisations TFVC par défaut.
Syntaxe
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Paramètres
Arguments
argument
Description
<itemspec>
Identifie le fichier ou le dossier sur lequel retourner des informations. Pour plus d’informations sur la façon dont TFVC analyse le itemspec pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser des options pour modifier la façon dont une fonction de commande.
Note
Vous pouvez spécifier plusieurs arguments itemspec.
<versionspec>
Valeur fournie par l’utilisateur 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 une valeur de nom d’utilisateur comme DOMAIN\username ou username.
<TeamProjectCollectionUrl>
URL de la collection de projets qui contient un ou plusieurs fichiers ou dossiers sur lesquels vous souhaitez afficher des informations, par exemple http://myserver:8080/tfs/DefaultCollection/.
Options
option
Description
/version
Spécifie que TFVC ne doit afficher que les fichiers et dossiers d’une certaine version.
/recursive
Affiche tous les fichiers et sous-dossiers dans le répertoire spécifié.
/folders
Affiche uniquement les dossiers.
/deleted
Affiche les éléments supprimés et les éléments existants. Les éléments supprimés sont suivis de ;Xn où n est l’ID de suppression.
/login
Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.
/collection
Spécifie la collection de projets.
Remarques
La commande dir fonctionne sur les copies du serveur Azure DevOps des fichiers, et non sur les copies locales. La commande utilise le dossier mappé local pour localiser le chemin approprié du serveur Azure DevOps. Vous utilisez cette commande pour explorer le serveur Azure DevOps et identifier les fichiers que vous devrez peut-être obtenir.
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.
Exemples
L’exemple suivant affiche une liste de fichiers, de dossiers, de sous-dossiers et de fichiers dans le dossier du serveur Azure DevOps auquel c :\projects mappe. Le nombre d’éléments est également répertorié. Pour plus d’informations sur la façon d’afficher et de modifier les mappages de dossiers de travail, consultez commande Espace de travail et commande Workfold.
c:\projects>tf dir /recursive
L’exemple suivant montre comment afficher tous les fichiers serveur Azure DevOps au 314dir chemin d’accès. Le sous-dossier 314dir n’a pas besoin d’exister dans le dossier local.
c:\projects>tf dir 314dir
L’exemple suivant affiche la version des fichiers étiquetés My label dans la 314dir chemin du serveur Azure DevOps. Le sous-dossier 314dir n’a pas besoin d’exister dans le dossier local.
c:\projects>tf dir /version:L"My label" 314dir
L’exemple suivant affiche tous les dossiers à la racine du serveur Azure DevOps. Le dossier de travail local est ignoré, car $/ désigne un chemin d’accès au serveur Azure DevOps.
c:\projects>tf dir /folders $/
L’exemple suivant répertorie chaque fichier et dossier du serveur Azure DevOps.
c:\projects>tf dir /recursive $/
L’exemple suivant répertorie tous les éléments du dossier actif, y compris les éléments supprimés avec leurs ID de suppression.
c:\projects>tf dir /deleted