Commande dir (Team Foundation Version Control)

  • Article

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