Folderdiff, commande
Mise à jour : novembre 2007
Utilisez la commande folderdiff pour afficher et comparer une représentation visuelle des différences entre des fichiers situés dans deux dossiers de serveur, dans un dossier de serveur et un dossier local ou dans deux dossiers locaux.
Autorisations requises
Pour utiliser la commande folderdiff, vous devez disposer de l'autorisation Lire avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf folderdiff [sourcePath] targetPath [/recursive] [/noprompt] [/server:serverName:port] [/filter:filter] [/filterLocalPathsOnly] [/view:same,different,sourceOnly,targetOnly]
Paramètres
Argument |
Description |
---|---|
sourcePath |
Chemin d'accès local ou chemin d'accès de serveur qui est le chemin d'accès source de l'opération de comparaison. Si cet argument n'est pas fourni et si targetPath est le chemin d'accès mappé local, sourcePath le chemin d'accès de serveur est mappé à celui-ci. |
targetPath |
Chemin d'accès local ou chemin d'accès de serveur qui est le chemin d'accès cible de l'opération de comparaison. |
serverName:port |
Si ce paramètre est spécifié, tous les chemins d'accès de serveur sont supposés se trouver sur ce serveur. Ce paramètre a priorité sur le mappage de chemin d'accès local. |
filter |
Spécifie une liste délimitée par des points-virgules répertoriant les masques de filtre d'inclusion et d'exclusion pour l'option /filter. La valeur par défaut est "*" (tout inclure). La section Notes de cette rubrique inclut une description détaillée des filtres et masques. |
Option |
Description |
---|---|
/recursive |
Facultatif. Spécifie que les deux dossiers sont entièrement comparés de manière récursive. |
/noprompt |
Facultatif. tf folderdiff s'exécute sans afficher l'interface utilisateur. À la place, le résultat s'affiche dans la fenêtre d'invite de commandes. |
/filter |
Facultatif. Spécifie une liste des masques de filtre et d'inclusion qui sont utilisés pour faire correspondre les noms des fichiers et dossiers à comparer. |
/filterLocalPathsOnly |
Facultatif. Spécifie que seuls les chemins d'accès local seront filtrés, à moins qu'il n'existe un chemin d'accès de serveur correspondant. |
/view |
Facultatif. Spécifie quelles informations sont incluses dans le résultat à l'aide d'une liste des valeurs suivantes séparées par des virgules : same—affichage des fichiers ayant le même contenu dans les répertoires source et cibles. different—affichage des fichiers n'ayant pas le même contenu dans les répertoires source et cibles. sourceOnly—affichage des fichiers qui n'existent que dans le répertoire source. targetOnly—affichage des fichiers qui n'existent que dans le répertoire cible. La valeur par défaut est "different,sourceOnly,targetOnly". |
Notes
Le résultat s'affiche dans la fenêtre d'invite de commandes si vous spécifiez /noprompt. Sinon, il s'affiche dans la fenêtre Différence de dossier. Lorsque le système compare le dossier mappé local au dossier de serveur auquel il est mappé, le résultat affiché dans la fenêtre Différence de dossier inclut une liste des modifications en attente. De plus, le résultat affiché dans la fenêtre Différence de dossier vous indique si le dossier local contient la copie la plus récente ou non.
Le résultat affiché dans la fenêtre d'invite de commandes répertorie tous les fichiers des dossiers dans les cinq sections suivantes :
Éléments qui existent uniquement dans le dossier de serveur.
Éléments qui existent uniquement dans le dossier local..
Éléments qui ont un contenu différent.
Éléments qui ont un contenu identique (vous devez spécifier le même argument avec l'option /view ).
Résumé
Filtres de fichier et de dossier
Un filtre est une liste triée des masques de noms utilisés pour faire correspondre le nom des fichiers et dossiers à comparer. Chaque masque peut contenir les caractères génériques point d'interrogation (?) et astérisque (*). '?' '?' correspond exactement à un caractère et '*' correspond à zéro, un ou plusieurs caractères. Les masques d'un filtre sont délimités par des points-virgules (;). Les masques de dossier doivent se terminer par une barre oblique inverse (\). Pour spécifier un masque d'exclusion, préfixez le masque avec un point d'exclamation (!).
Le filtre est appliqué aux noms de fichier et de dossier à l'aide des règles suivantes :
Lorsque des masques de fichier et de dossier sont spécifiés ensemble dans un filtre, ils sont respectivement séparés dans une liste de masques de fichier et une liste de masques de dossier. Les masques de fichier sont appliqués uniquement aux noms de fichier. Les masques de dossier sont appliqués uniquement aux noms de dossier.
Lorsque la commande correspond à un nom de fichier ou de dossier, elle compare le nom à chaque masque du filtre dans l'ordre où il a été spécifié. Dès que le nom correspond à un masque, il est considéré comme une correspondance.
Si les masques de fichier du filtre contiennent un masque d'inclusion, les fichiers qui ne correspondent à aucun des masques de fichier sont exclus.
Si les masques de fichier du filtre contiennent uniquement des masques d'exclusion, les fichiers qui ne correspondent à aucun des masques de fichier sont inclus.
Si les masques de dossier du filtre contiennent un masque d'inclusion, les dossiers qui ne correspondent à aucun des masques de dossier sont exclus.
Si les masques de dossier du filtre contiennent uniquement des masques d'exclusion, les dossiers qui ne correspondent à aucun des masques de dossier sont inclus.
Voici quelques exemples de masques de filtre :
Masque |
Description |
---|---|
*.cs |
Correspond à tous les fichiers C#. |
My*.bmp |
Correspond à tous les fichiers bitmap qui commencent par "My". |
*.exe |
Exclut tous les fichiers exécutables. |
objd\ |
Exclut tous les répertoires objd. |
Voici quelques exemples de filtres :
Masque |
Description |
---|---|
*.cs;!objd\;!obj\;!bin\ |
Correspond à tous les fichiers C# et exclut les répertoires objd, obj et bin |
*.resx;!*.ini;!resources\;!*junk*\ |
Exclut tous les fichiers resx et ini, ainsi que les dossiers "ressources" ou ceux dont le nom contient "junk". |
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant compare les fichiers du dossier de serveur et d'un dossier local. Il organise les fichiers du dossier localFolder de manière récursive et affiche le résultat dans la fenêtre d'invite de commandes.
C:>tf folderdiff $/serverFolder F:\localFolder /recursive /noprompt
Voir aussi
Tâches
Comment : comparer deux dossiers
Comment : afficher les modifications de fichiers à l'aide des annotations
Comment : harmoniser les différences entre deux dossiers
Concepts
Filtres de comparaison de dossiers
Autres ressources
Comparaison de dossiers et de fichiers dans le contrôle de version