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).
Prérequis
Pour utiliser la commande dir, l’autorisation Lire doit être définie 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 les options pour modifier le fonctionnement d’une commande.
Notes
Vous pouvez définir plusieurs arguments itemspec.
<versionspec>
La valeur fournie par l’utilisateur 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 définir une valeur de nom d’utilisateur comme DOMAIN\username ou username.
<TeamProjectCollectionUrl>
L’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 doit afficher uniquement les fichiers et dossiers d’une certaine version.
/recursive
Restaure tous les fichiers et sous-dossiers du 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 avec ;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.
Notes
La commande dir fonctionne sur les copies de fichiers du serveur Azure DevOps, et non sur les copies locales. La commande utilise le dossier mappé local pour localiser le chemin du serveur Azure DevOps approprié. 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 gestion de version Team Foundation.
Exemples
L’exemple suivant affiche une liste de fichiers, dossiers, sous-dossiers et fichiers dans le dossier serveur Azure DevOps auquel c:\projects est mappé. Le nombre d’éléments est également répertorié. Pour plus d’informations sur l’affichage et la modification des mappages de dossiers de travail, consultez Commande Espace de travail et Commande Workfold.
c:\projects>tf dir /recursive
L’exemple suivant affiche tous les fichiers serveur Azure DevOps au chemin d’accès 314dir. 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 le chemin du serveur Azure DevOps 314dir. 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 de serveur Azure DevOps.
c:\projects>tf dir /folders $/
L’exemple suivant répertorie chaque fichier et dossier dans le 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