Options de ligne de commande

<< Click to Display Table of Contents >>

Options de ligne de commande

L'édition professionnelle de TreeSize accepte les options de ligne de commande vous permettant d'exécuter des analyses planifiées ou d'afficher les résultats d'une analyse sur votre écran le lendemain matin. La boîte de dialogue Planifier vous aidera à compiler une ligne de commande avec les options ci-dessous. Remarque : ces options ne sont pas disponibles dans l'édition personnelle.

Treesize.exe [/OPTION] SCANPATH

 

/ ? ou /HELP

Affiche cette page d'aide.

/AGEOFFILES

Enregistre le graphique dans l'onglet "Âge des fichiers" du répertoire analysé dans un fichier bitmap, GIF, PNG, JPEG, texte ou CSV. Le type de fichier dépend de l'extension du nom de fichier spécifié. L'exemple suivant crée un fichier image JPEG du graphique "Âge des fichiers" pour votre lecteur local C :

Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"

/APPENDTOFILES <valeur>

Cette option vous permet de choisir si TreeSize doit ou non ajouter ses résultats aux fichiers existants lors d'une exportation, par exemple lors de l'utilisation de /TEXT. Sélectionnez "True" pour ajouter et "False"si vous souhaitez écraser les fichiers existants.

Remarque : ce paramètre ne fonctionne pas avec les images exportées, les fichiers XML et PDF. Ces fichiers seront toujours écrasés. Vous pouvez utiliser le commutateur /DATE pour vous assurer que tous les rapports générés auront un nom de fichier unique.

Lors de l'exportation vers un fichier Excel via /EXCELce paramètre peut être utilisé avec /SHEETNAME pour ajouter les données à la feuille spécifiée. Exemple :

Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"

Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"

/ARCHIVEBITFILESONLY

Cette option n'inclura que les fichiers pour lesquels le bit d'archivage est défini dans les analyses. Cette option peut être très utile si vous souhaitez calculer la taille d'une sauvegarde. Dans ce cas, vous pouvez créer un raccourci sur votre bureau ou dans votre menu de démarrage qui lancera automatiquement le calcul de la taille de votre sauvegarde. Exemple de raccourci :

Treesize /ARCHIVEBITFILESONLY /SCAN "\\NServer\NBackup\NThis"

/ATTACH

Si cette option est spécifiée, tous les fichiers exportés seront joints à l'e-mail. S'il n'est pas spécifié, les fichiers dont le chemin d'accès est explicitement indiqué ne sont pas joints. Ceci est utile dans le cas où vos fichiers XML ou Excel deviennent assez volumineux et remplissent votre compte de messagerie.

Cet exemple exporte vers un fichier Excel mais ne le joint pas à l'e-mail :

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"

Ces exemples joindront le fichier Excel à l'e-mail :

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"

/BARCHART <fichier>

Enregistre le diagramme à barres du répertoire numérisé dans un fichier bitmap, GIF, PNG ou JPEG. Le type de fichier dépend de l'extension du nom de fichier spécifié. Cet exemple crée un fichier image PNG du diagramme à barres pour votre lecteur local C :

Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"

/COMPARE <nom de fichier|chemin>

Compare le chemin d'accès numérisé à un fichier d'index enregistré. L'exemple suivant analyse le lecteur C : et compare le résultat avec un rapport XML enregistré pour ce lecteur :

Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"

Au lieu d'un fichier d'index, vous pouvez également utiliser un chemin d'accès avec ce paramètre de ligne de commande. Le chemin d'accès donné sera comparé au résultat de l'analyse en cours. L'exemple suivant analyse le lecteur C:\Net utilise en outre le chemin d'accès D:\NSauvegarde_de_C pour effectuer une comparaison entre les deux :

Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"

Vous pouvez également comparer deux fichiers d'index existants, par exemple "c1.xml.zip" et "c2.xml.zip", à l'aide de cette commande :

Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"

La commande /OPEN prépare la comparaison des deux fichiers en développant le premier fichier ("c1.xml.zip") en un fichier d'analyse. Le second fichier ("c2.xml.zip") sera comparé à ce fichier d'analyse développé, comme cela se produirait si "c2.xml.zip" était comparé à une "vraie" analyse.

/COPY <chemin>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Copie les résultats d'une recherche de fichier TreeSize à l'emplacement cible.
La commande suivante effectue une recherche sur le lecteur local C : en utilisant les dernières options de recherche et copie les résultats de la recherche dans le dossier "C:\temp\NObsoleteFiles" :

Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\NtemporaireObsoleteFiles"

Voir aussi : Opérations sur les fichiers

/CREATEDPASTDAYSONLY <n>

Cette option n'inclura dans l'analyse que les fichiers qui ont été créés pendant le nombre de jours indiqué dans l'argument. Dans l'exemple suivant, cette option n'inclura dans l'analyse que les fichiers créés au cours des huit derniers jours :

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <drive>

Crée un instantané pour les lecteurs indiqués après ce paramètre de ligne de commande. Exemple :

Treesize /CREATESNAPSHOT "C:\" "D:\"

La création d'instantanés peut nécessiter des privilèges administratifs.

/CSV <fichier>

Enregistre les résultats dans un fichier CSV une fois l'analyse ou la recherche terminée. L'application s'arrêtera d'elle-même après l'enregistrement. Cet exemple permet d'enregistrer les résultats d'une recherche de fichiers sur le lecteur local C : avec les dernières configurations de recherche dans un fichier CSV :

Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"

/DATE

Ce commutateur ajoutera la date et l'heure actuelles à tous les noms de fichiers d'exportation dans la ligne de commande. Cette option est utile si vous souhaitez effectuer des analyses régulièrement, par exemple tous les soirs ou tous les week-ends. L'exemple suivant analyse le chemin d'accès au réseau "\Host\Share" et enregistre le résultat dans un fichier tel que "C:\Scans\Nom_2013-08-14_17-18-24.xls" :

Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\Nnom.xls"

/DEDUPLICATE

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Elle remplacera les fichiers en double qui ont été trouvés par la recherche de fichiers en double sur TreeSize par des liens en dur NTFS:

Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE

/DELETE

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Supprime définitivement tous les fichiers qui ont été trouvés à la suite d'une recherche de fichiers sur TreeSize. Exemple :

Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE

Voir aussi : Opérations sur les fichiers

/EMAIL <destinataire>

Envoie les données collectées à l'adresse électronique indiquée. Ce paramètre ne peut être utilisé qu'une seule fois sur la ligne de commande, et un seul courriel contenant tous les résultats sera envoyé. Les destinataires multiples peuvent être séparés par des points-virgules ( ;) ou des virgules. Pour envoyer des courriels via la ligne de commande, vous devez spécifier des paramètres SMTP valides sur la page correspondante de la boîte de dialogue des options de TreeSize. Exemple :

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"

Si aucun autre paramètre n'a été spécifié, le courriel sera envoyé dans le format défini dans les options (HTML ou texte brut). Si vous souhaitez définir le format indépendamment des options actuelles, vous pouvez utiliser les paramètres /TEXT ou /HTML juste après la définition de l'adresse ou des adresses du destinataire. Exemple :

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT

En combinant les paramètres, vous pouvez également ajouter des pièces jointes à l'e-mail. L'exemple suivant ajoutera un rapport Excel de l'analyse en tant que pièce jointe à l'e-mail :

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL

/EMAILIFRESULTSFOUND

Cette option ne peut être utilisée qu'en combinaison avec les options de ligne de commande /SEARCH et /EMAIL. Si ce paramètre est spécifié, TreeSize n'enverra un e-mail avec les résultats de la recherche en cours que si au moins un fichier ou un dossier a été trouvé pendant la recherche, par l'un des types de recherche spécifiés.

/EMPTYRECYCLEBIN

Si vous utilisez cette option, TreeSize videra la corbeille avant d'exécuter l'analyse en cours. Exemple :

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE <fichier>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Ce paramètre permet de transmettre à une autre application ou à un script les fichiers qui ont été trouvés par la recherche de fichiers sur le site TreeSize. La cible possible de ce paramètre peut être un lot ou un script. powershell script. L'exemple suivant recherche le lecteur C:\Navec les paramètres de recherche les plus récents et appelle le script "Archive.bat"pour chaque fichier trouvé. Le fichier sera transmis au script en tant que paramètre de ligne de commande :

Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"

Voir aussi : Opérations sur les fichiers

/EXCEL <filepath>

Exporte les données collectées au format Microsoft Excel et les enregistre sous le chemin d'accès saisi. Si seul un nom de fichier est spécifié, le répertoire d'installation actuel est utilisé pour stocker l'exportation. Les formats pris en charge sont le format de fichier .XLS conventionnel (Excel 97-2003) ainsi que le format .XLSX (introduit avec Excel 2007). Le format utilisé dépend de l'extension du nom de fichier spécifié. L'application se terminera d'elle-même après l'enregistrement. Exemple :

Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"

Si le nom du fichier existe déjà, le fichier sera ouvert et une nouvelle feuille de calcul sera ajoutée.

Remarque : dans l'application TreeSize File Search (/SEARCH) les résultats de chaque type de recherche sont rassemblés dans leur propre feuille de travail. Si le fichier sous le chemin donné existe déjà, ces feuilles seront écrasées. Pour éviter cela, vous devez utiliser l'option de ligne de commande /APPENDTOFILES.

/EXCLUDE <motif1;motif2>

Cette option vous permet de spécifier des motifs pour les fichiers et les dossiers qui doivent être exclus d'une analyse. Plusieurs motifs d'exclusion peuvent être séparés par un point-virgule ( ;). Si un ou plusieurs motifs contiennent des espaces, la chaîne de motifs complète doit être mise entre guillemets ("). L'exemple suivant ignore les fichiers et les dossiers qui se terminent par ".tmp" ou dont le nom exact est "system" :

Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"

/EXPAND <niveau|taille>

Cette option vous permet de spécifier le nombre de niveaux de l'arborescence du répertoire qui seront développés après l'analyse. Si vous ne spécifiez pas de nombre après cette option, tous les dossiers seront développés. Au lieu d'un niveau de répertoire, vous pouvez également indiquer une quantité en mégaoctets (Mo). Dans ce cas, tous les dossiers dont la taille est supérieure à la valeur indiquée seront développés. L'unité "MB" doit suivre le nombre sans espace. L'exemple suivant analyse le dossier "H:\NUtilisateur", développe tous les dossiers de plus de 10 Mo et enregistre le résultat dans le fichier Excel "H:\NUtilisateur" : "H:\NUtilisateur" : "H:\NUtilisateur".C:\Results\Allusers.xlsx" :

Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB

/EXPANDABLEREPORT <valeur>

Si cette option est utilisée, Excel Si cette option est utilisée, les exportations utiliseront des groupes extensibles/collapables dans lesquels on peut naviguer comme dans l'arborescence d'un répertoire.

Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"

Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"

/EXPORTDRIVESLIST <fichier>

Cette option vous permet d'exporter le contenu de la "Liste des lecteurs" vers un fichier Excel, texte ou CSV. Le type de fichier dépend de l'extension du nom de fichier spécifié. Exemple :

Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST

/EXPORTFILES

Si l'option est spécifiée, les fichiers seront inclus dans toutes les exportations. Cette option est donc équivalente à l'activation de l'option "Outils > Options > Exportation > * > Eléments exportés > Dossiers et fichiers uniques"

/EXPORTGROUPSEXPANDED

si spécifié, l'exportation de la liste des extensions contiendra toutes les informations sur les extensions contenues dans les groupes.

/EXPORTPATHSLIST <fichier>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.

Exporte une liste simple contenant tous les résultats de la recherche. La liste ne contient que les chemins d'accès complets des résultats de la recherche et aucune autre information. Les formats supportés pour le fichier de destination sont .txt et .csv.

Cet exemple permet de rechercher et de créer une liste de tous les fichiers exe sur le lecteur C :

Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"

Il peut être utilisé pour importer les résultats d'une recherche précédente dans l'interface utilisateur, en utilisant "Fichier > Liste des chemins > Importer la liste des chemins", ou le paramètre /IMPORT ..

Si l'option "Outils > Options > Exportation > Inclure les groupes de doublons" est activée, vous pouvez également utiliser cette fonction pour exporter et importer les résultats de la recherche de doublons, y compris leur structure de groupe.

/EXPORTTITLE <title>

Peut être utilisé pour modifier le titre d'un rapport imprimé ou d'un fichier exporté. Cela vous permet de fournir des informations supplémentaires à l'utilisateur lorsque vous utilisez TreeSize dans un environnement automatisé. L'utilisation de variables d'environnement est également autorisée. Exemple :

Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT

/EXTENSIONSLIST <fichier>

Cette option vous permet d'enregistrer les statistiques sur les extensions et les types de fichiers de la branche du système de fichiers analysée dans un fichier Excel, HTML, texte ou CSV. Le type de fichier dépend de l'extension du nom de fichier spécifié. Les colonnes exportées seront celles qui étaient activées dans l'interface utilisateur sur l'onglet "Extensions" lors de sa dernière utilisation, ou au moment où le fichier de configuration fourni via /OPTIONS a été écrit.

L'exemple suivant analyse le lecteur C : et crée un fichier Excel nommé "D:\TreeSize Reports\C_filetypes.xls" avec les statistiques des types de fichiers sur ce lecteur :

Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"

/EXTENSIONSCHART <nom du fichier>

Enregistre le petit graphique affiché au bas de la page "Extensions" dans un fichier image (bitmap, GIF, PNG ou JPEG).

/EXTENSIONSPIECHART <fichier>

Enregistre dans un fichier image (bitmap, GIF, PNG ou JPEG) un camembert qui montre la répartition des "extensions de fichiers" .

/FILTER <pattern1;pattern2>

Définit un filtre de fichier qui ne prend en compte que les fichiers ayant certaines extensions, par exemple ".mp3" ou ".doc". Plusieurs motifs peuvent être transmis, séparés par un point-virgule ( ;). L'exemple suivant recherche les fichiers MP3 et AVI dans le répertoire "Users" du serveur :

Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"

Lorsque vous effectuez une recherche sur TreeSize File Search (/SEARCH)vous pouvez également utiliser le commutateur de ligne de commande /FILTER pour spécifier les motifs de la recherche avancée de fichiers. Pour effectuer une recherche de fichiers personnalisée plus complexe, vous devez enregistrer les options de recherche dans un fichier et transmettre le fichier XML résultant à la ligne de commande après /SEARCH.

/FOLLOWREPARSEPOINTS

Si ce commutateur est ajouté à la ligne de commande, TreeSize suivra les points de montage et les liens symboliques externes lors de l'analyse de l'arborescence du système de fichiers.

/GROUPSCANS

L'utilisation de ce commutateur de ligne de commande regroupera tous les répertoires analysés dans un dossier racine virtuel. Utilisez /GROUPSCANS FALSE si vous voulez vous assurer qu'aucun dossier racine virtuel n'est utilisé.

/HIDESMALLFOLDERS <valeur>

Permet de masquer les objets dont la taille est inférieure à une taille minimale, ce qui est utile pour obtenir des exportations claires. <valeur> peut être une valeur de taille avec unité, ou une simple valeur d'octet sans unité. Ne peut être utilisé en combinaison avec /EXPAND. Dans cet exemple, seuls les dossiers ayant une taille minimale de 50 Mo seront exportés :

TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\

/HISTORYCHART <fichier>

Enregistre le graphique de l'onglet "Historique" du répertoire scanné dans un fichier bitmap, GIF, PNG ou JPEG. Le type de fichier dépend de l'extension du nom de fichier spécifié. Cet exemple crée une image JPEG du graphique de l'historique pour le lecteur C :

Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"

/HTML <nom de fichier>

Enregistre les données collectées dans un fichier HTML qui peut être visualisé avec n'importe quel navigateur HTML. Vous pouvez spécifier quelles informations de l'analyse seront incluses dans l'exportation via "Accueil > Options > Exporter > HTML > Graphiques et listes à inclure". Vous pouvez sélectionner les listes ou les graphiques supplémentaires à ajouter à l'exportation. Ils seront automatiquement intégrés dans le fichier HTML généré après l'analyse.

L'exemple suivant génère un rapport HTML pour le lecteur C : et l'enregistre dans "D:\HTML" :

Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"

Si vous souhaitez que plus d'une analyse fasse partie du fichier HTML, vous devez ajouter le commutateur de ligne de commande /GROUPSCANS. Lors de l'exportation vers HTML sans image incluse, vous pouvez également utiliser le commutateur / .APPENDTOFILESSans l'une de ces options, le fichier HTML sera écrasé.

/IMPORT <fichier>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.

Charge une liste de chemins d'accès dans l'interface utilisateur de la recherche de fichiers TreeSize. Le fichier peut être au format .txt ou .csv. Ce paramètre peut être utilisé pour importer les résultats d'une recherche précédente. Les fichiers et dossiers importés peuvent être déplacés/copiés/supprimés/archivés, comme n'importe quel résultat de recherche "en direct", à l'aide de la boîte de dialogue d'opération de fichier.

Exemple :

Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"

Vous pouvez également combiner ce paramètre avec les paramètres /RECYCLE, /DELETE ou /MOVE pour supprimer ou déplacer automatiquement les fichiers contenus dans le fichier texte. Exemple : /RECYCLE, /DELETE ou /MOVE

Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE

/IMPORTPATTERNS <fichier>

Importe une liste de motifs à partir d'un fichier. Le fichier peut être un simple fichier texte contenant une liste de motifs de filtrage, séparés par des points-virgules, ou vous pouvez utiliser l'interface utilisateur pour créer un ensemble plus complexe de motifs et utiliser la fonction d'exportation pour générer le fichier de motifs au format XML. Les formats pris en charge sont CSV, TXT et XML.

Les modèles importés seront utilisés comme filtres pour l'analyse afin d'inclure ou d'exclure des fichiers et des dossiers spécifiques.

S'il est utilisé en combinaison avec l'option de ligne de commande /SEARCH, ce paramètre créera une nouvelle recherche avancée qui utilisera les modèles du fichier importé comme critères de recherche.

 

Cet exemple importera les motifs de filtrage définis sous "C:\TreeSizeFiles\patterns.txtCet exemple importera les motifs de filtrage définis sous "C:\", lancera une recherche sur le lecteur C:\ et exportera les résultats dans un fichier HTML :

Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"

/INDEXFILE <fichier>

Enregistre les résultats de l'analyse dans un fichier SQLite qui peut être chargé ultérieurement pour des comparaisons. Exemple :

Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"

/LISTSEPARATOR <caractère séparateur>

Permet de définir le séparateur utilisé lors de l'exportation de fichiers texte ou CSV. Les fichiers texte utilisent par défaut le tabulateur, les fichiers CSV le séparateur de liste des paramètres régionaux du panneau de configuration de Windows. Veuillez spécifier un seul caractère ou la chaîne "TAB" pour le tabulateur après ce commutateur. Exemples :

Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"

Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"

/MOVE <chemin>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Elle déplace les résultats d'une recherche de TreeSize vers un autre emplacement.

La commande suivante effectue une recherche sur le lecteur local C : en utilisant les dernières options de recherche et déplace les résultats de la recherche dans le dossier "C:\Temp\NObsoleteFiles" :

Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\NObsoleteFiles"

Voir aussi : Opérations sur les fichiers

/NOGUI

Aucune fenêtre ne sera affichée et l'application n'apparaîtra pas dans la barre des tâches. Utile pour exécuter des analyses ou des recherches en arrière-plan, sans retour visuel.

Attention: N'utilisez ce commutateur que si vous avez testé les autres options de la ligne de commande, car les messages d'erreur ne peuvent pas être affichés dans ce mode.
Toutefois, les erreurs seront consignées dans le journal des événements de Windows.

/NOHEADERS

Omettre les lignes d'en-tête habituellement écrites en haut des fichiers d'exportation d'analyse ou de recherche. Il est ainsi plus facile de recevoir des données brutes pour le post-traitement.

/NOUNITS

Supprime les unités généralement écrites après les valeurs de taille. Cette option, combinée à /SIZEUNIT 0 permet d'exporter des valeurs d'octets simples. Il est ainsi plus facile de recevoir des données brutes pour le post-traitement.

Remarque : cette ligne de commande n'a d'effet que sur les exportations de l'arborescence des répertoires, générée par l'utilisation des options /TEXT, /EXCEL, /HTML, /EMAILou /PRINT ou de l'option /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLISTou /TOPFILESLIST ne seront pas affectées.

/OPEN <fichier>

Ouvre un rapport XML enregistré au démarrage de l'application. Exemple :

Treesize /OPEN "C:\Reports\Drive_C.xml.zip"

/OPTIONS <filename>

Ce paramètre permet d'appliquer les paramètres utilisateur exportés à TreeSize. Les paramètres utilisateur peuvent être exportés via "Fichier > Options > Exporter". Exemple : / <filename> Utilisez ce paramètre pour appliquer les paramètres utilisateur exportés à :

Treesize /OPTIONS "C:\Temp\User Settings.xml"

Conseil : modifiez autant de paramètres que possible dans l'interface utilisateur avant d'enregistrer les options afin de réduire le nombre de paramètres de ligne de commande dont vous avez besoin.

/PDF

Enregistre les résultats dans un fichier PDF une fois la numérisation ou la recherche terminée. L'application s'arrêtera d'elle-même après l'enregistrement. L'exemple suivant exécute une numérisation du lecteur local C : et enregistre les résultats dans un fichier PDF :

Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"

/PIECHART <fichier>

Enregistre le diagramme circulaire du répertoire numérisé dans un fichier bitmap, GIF, PNG ou JPEG. Le type de fichier dépend de l'extension du nom de fichier spécifié. L'exemple suivant permet de numériser le lecteur C : et d'exporter un diagramme circulaire au format PNG :

Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"

/PRINT

Imprime un rapport sur l'arborescence analysée à l'aide de l'imprimante par défaut configurée dans les paramètres de votre système. L'application se terminera après l'impression. L'application se terminera après l'impression :

Treesize /SCAN "\\SERVER\USERS" /PRINT

/READONLYMODE <valeur>

Si la valeur est fixée à true, cette option active un mode lecture seule dans lequel les opérations sur les fichiers (par exemple, déplacement ou suppression) sont désactivées, de sorte que l'application ne peut être utilisée que comme outil de création de rapports.

Commencez par la valeur false pour désactiver à nouveau le mode lecture seule.

/RECYCLE

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH ..
Déplace dans la corbeille tous les fichiers qui ont été trouvés à la suite d'une recherche de fichiers. TreeSize recherche de fichiers. Exemple :

Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE

Voir aussi : Opérations sur les fichiers

/RESTRICTEDMODE <valeur>

Si la valeur est fixée à true, cette option active un mode restreint dans lequel de nombreuses fonctionnalités sont désactivées et ne présentent pas d'intérêt pour les utilisateurs "normaux" (non-administrateurs). Parmi les fonctions désactivées figurent : Vérifier la mise à jour, Ouvrir l'applet Logiciel du Panneau de configuration de Windows, Planifier les analyses TreeSize, connecter le lecteur réseau, configurer la restauration du système Windows, Exécuter en tant qu'administrateur, exporter et appliquer la compression NTFS. Vous pouvez fournir un chemin à analyser, par exemple le répertoire personnel de l'utilisateur, à la ligne de commande ou en utilisant les chemins de démarrage dans un fichier de configuration enregistré.

Commencez par la valeur false pour désactiver à nouveau le mode restreint.

Si vous activez en plus l'option /READONLYMODE, l'utilisateur ne pourra pas supprimer ou déplacer des fichiers dans TreeSize, qui ne sera donc utilisable que comme outil de rapport.

/SCAN <chemin|nom de fichier>

Définit le lecteur ou le chemin à analyser. Le chemin d'accès à l'analyse doit être utilisé comme valeur pour ce paramètre.

Si, par exemple, le lecteur D:\Ndoit être analysé, vous pouvez utiliser :

Treesize /SCAN "D:\"

Si vous ne souhaitez pas analyser l'ensemble du lecteur, vous pouvez également spécifier un chemin d'accès qui servira de point de départ à l'analyse. Par exemple, il est possible de spécifier plusieurs chemins d'analyse :

TreeSize /SCAN "\\Server\Share\MyDocuments"

Il est également possible de définir plusieurs chemins d'accès à l'analyse, séparés par un espace. Les chemins d'accès contenant un blanc doivent être mis entre guillemets ("). Exemple :

Treesize /SCAN "C:\Program Files\" "C:\Windows"

Les caractères génériques "*" et " ?" sont autorisés. Exemple : Les caractères génériques "*" et " ?" sont autorisés :

Treesize /SCAN "H:\users\A*"

 

Vous pouvez également spécifier un fichier texte contenant une liste de chemins d'accès à analyser. TreeSize analysera tous les chemins d'accès trouvés dans le fichier texte spécifié après ce commutateur. Le fichier texte doit contenir un chemin d'accès par ligne. L'exemple suivant analyse tous les chemins d'accès trouvés dans le fichier "D:\PathsToScan.txt"et écrit chaque résultat de l'analyse sur une feuille séparée d'un fichier Excel avec la date du jour :

Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"

Vous pouvez également appeler TreeSize dans une boucle "for" avec un seul des chemins d'accès.

/SEARCH

Ouvre la fenêtre de recherche de fichiers de TreeSize. Si " :Start" est ajouté à cette option de ligne de commande, la recherche est lancée automatiquement. Un fichier XML contenant les paramètres de recherche, préalablement enregistré, peut être transmis ; ces paramètres seront alors utilisés pour effectuer la recherche. Veuillez noter que les fichiers trouvés lors de cette recherche sont automatiquement vérifiés. L'exemple suivant effectue la recherche avec les paramètres précédemment enregistrés dans le fichier "SearchSettings.xml" et enregistre les résultats dans un fichier texte :

Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"

Conseil : en général, les derniers paramètres de recherche ou un ensemble de paramètres de recherche sauvegardés précédemment seront utilisés. Cependant, vous pouvez également spécifier les modèles de recherche pour la recherche avancée à l'aide de l'option de ligne de commande /FILTER à l'aide de l'option de ligne de commande /.

/SHEETNAME <titre>

Permet de spécifier le nom de la feuille qui sera ajoutée à un fichier Excel lors de l'utilisation de l'option de ligne de commande /EXCEL. Veuillez noter qu'un nom de feuille Excel doit être unique dans un fichier Excel et que certains caractères spéciaux tels que les barres obliques, les barres obliques inversées et les deux points sont interdits. TreeSize créera toujours un nom de feuille unique en remplaçant les caractères non valides par des traits de soulignement et en ajoutant la date et l'heure si nécessaire. Si une feuille avec le nom spécifié existe déjà dans le fichier cible, une nouvelle feuille avec un nom unique est créée. Utilisez l'option de ligne de commande /APPENDTOFILES pour ajouter les données à la feuille existante.

/SHORTDATEFORMAT <format>

Modifie le format de date court pour ce processus, qui peut être configuré dans les options régionales du panneau de configuration de Windows. Les exportations de TreeSize utiliseront ce format pour les valeurs de date. Exemple :

Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"

/SIZEUNIT <n>

Cette option permet de spécifier l'unité à utiliser pour l'affichage des valeurs de taille : N peut avoir les valeurs 0 à 5, ce qui signifie : 0 = octets, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = unités automatiques. Sans cette option, la dernière configuration utilisée dans TreeSize sera utilisée.

/SORTBY <Nom de colonne>

Permet de spécifier la valeur par laquelle les exportations générées seront triées. Les valeurs possibles sont des noms de colonnes comme "Size" ou "Name". Le dernier type de tri utilisé dans l'interface utilisateur TreeSize sera utilisé par défaut. Exemple :

Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"

Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"

/SQLITE <fichier>

Enregistre les résultats de l'analyse dans un fichier SQLite qui peut être chargé ultérieurement pour des comparaisons. Exemple :

Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"

/SUBJECT <sujet>

Cette option vous permet de personnaliser l'objet qui sera utilisé pour les courriels envoyés à la fin de l'analyse. Exemple : / <subject> :

Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"

/TEXT <fichier>

Enregistre les résultats dans un fichier texte ou CSV une fois l'analyse ou la recherche terminée. L'application s'arrêtera d'elle-même après l'enregistrement. L'exemple suivant exécute une analyse du lecteur local C : et enregistre les résultats dans un fichier texte :

Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"

Le format texte utilise un format tabulaire destiné aux lecteurs humains. Si le nom de fichier fait référence à un fichier CSV, ce dernier sera automatiquement utilisé. Si vous souhaitez utiliser explicitement le format CSV, nous vous recommandons d'utiliser le  paramètre/CSV.

/TITLE <title>

Peut être utilisé pour remplacer le chemin racine d'une analyse par un texte personnalisé. Cela permet de fournir des noms plus significatifs pour les chemins UNC, par exemple, et d'améliorer ainsi la lisibilité d'un rapport. Le titre choisi sera appliqué comme titre du rapport lors de l'exportation d'un fichier. Exemple : dans le contexte d'un fichier , le titre choisi sera appliqué en tant que titre du rapport :

Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"

Dans le contexte d'une recherche de fichiers sur TreeSize, ce paramètre peut être utilisé pour nommer une recherche avancée. Exemple :

Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"

/TOPFILESLIST <fichier>

Cette option vous permet d'enregistrer le contenu de la liste Top files dans un fichier Excel, HTML, texte ou CSV. Le type de fichier dépend de l'extension du nom de fichier spécifié. Exemple : / <fichier> :

Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"

/TREEMAP <fichier>

Enregistre le plan de l'arborescence du répertoire numérisé sous forme de fichier bitmap, GIF, PNG ou JPEG. Le type de fichier dépend de l'extension du nom de fichier spécifié. Exemple :

Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"

/UILevel <Simple/Normal/Expert>

Définit le niveau de l'interface utilisateur. Les valeurs possibles sont Simple, Normal ou Expert. Exemple : <Simple/Normal/Expert> Définit le niveau de l'interface utilisateur :

Treesize /UILevel "Simple"

/USERSLIST <fichier>

Cette option vous permet d'enregistrer les statistiques montrant les résultats groupés par nom d'utilisateur dans un fichier Excel, HTML, texte ou CSV. Le type de fichier dépend de l'extension du nom de fichier spécifié. Les colonnes exportées seront celles qui étaient activées dans l'interface utilisateur sur l'onglet "Utilisateurs" lors de sa dernière utilisation, ou lors de l'écriture du fichier de configuration fourni via /OPTIONS.

L'exemple suivant analyse le lecteur C : et crée un fichier Excel dans "C:\Temp" avec les statistiques des utilisateurs sur ce lecteur :

Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"

/USERNAME <nom d'utilisateur>

Spécifie le nom d'utilisateur qui doit être utilisé pour s'authentifier lors des analyses. Utilisez /PASSWORD pour spécifier un mot de passe pour ce nom d'utilisateur. Il est recommandé d'utiliser l'outil Microsoft l'outil RUNAS.

/USERFILTER <nom d'utilisateur>

Avec cette option, seuls les fichiers appartenant à un certain utilisateur seront pris en compte lors de l'analyse. Indiquez le nom de cet utilisateur après cette option. Veuillez noter que vous ne pouvez pas utiliser plusieurs noms d'utilisateur ici, mais que les caractères génériques "*" et " ?" sont pris en charge. Exemple :

Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller

/USERSCHART <fichier>

Enregistre le petit graphique affiché au bas de la page"Utilisateurs" dans un fichier image (bitmap, GIF, PNG ou JPEG).

/USERSPIECHART <fichier>

Enregistre dans un fichier image (bitmap, GIF, PNG ou JPEG) un diagramme circulaire qui montre les "statistiques des utilisateurs" de la numérisation en cours.

/VIEWTYPE n

Définit les valeurs sur lesquelles sont basées les colonnes "Pourcentage de parents", "Croissance" et le graphique "Âge des fichiers". Les valeurs possibles sont les suivantes

2 : Taille
3 : Espace alloué (taille sur le disque)
7 : Nombre de fichiers

/XML <fichier>

Enregistre les résultats de l'analyse dans un fichier XML qui peut être chargé ultérieurement pour des comparaisons. Exemple :

Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"

Cette option peut être combinée avec le commutateur /EXPAND pour limiter les répertoires exportés.
Remarque : lors du chargement d'une exportation XML limitée à TreeSize, vous ne pouvez pas naviguer dans la branche de répertoire complète, mais seulement dans les répertoires exportés.

/ZIP <fichier>

Cette option ne peut être utilisée qu'en combinaison avec l'option de ligne de commande /SEARCH.
Tous les fichiers qui ont été trouvés à la suite d'une TreeSize recherche de fichiers seront placés dans une archive zip. Exemple :

Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"

Voir aussi : Opérations sur les fichiers

<SCANPATH>

En plus du paramètre /SCANvous pouvez également indiquer un ou plusieurs chemins d'accès à la fin de la ligne de commande. Cela n'est cependant plus recommandé afin d'éviter les erreurs lors de l'analyse de la ligne de commande.
Cet exemple analyse les dossiers "Program Files" et "Windows" et crée un rapport texte sous "C:\Reports\ScanResults.txt" :

Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"

Si une erreur se produit, elle sera renvoyée sous forme de code d'erreur Windows dans le code de sortie du processus. Les variables d'environnement (par exemple %APPDATA%) peuvent être utilisées dans les noms de fichiers pour l'exportation ainsi que dans les chemins d'accès à l'analyse.

Analyse de plusieurs répertoires

Si vous devez analyser plusieurs répertoires, il peut être judicieux de fusionner plusieurs appels dans un fichier Batch, par exemple :

START /WAIT "TreeSize" "C:\Program Files\JAM Software\TreeSize\Treesize.exe" /SCAN "\\Server\Share1" /EXCEL "D:\Share1.xls"

START /WAIT "TreeSize" "C:\Program Files\JAM Software\TreeSize\Treesize.exe" /SCAN "\\Server\Share2" /EXCEL "D:\Share2.xls"

START /WAIT "TreeSize" "C:\Program Files\JAM Software\TreeSize\Treesize.exe" /SCAN "\\Server\Share3" /EXCEL "D:\Share3.xls"

La commande "START /WAIT"garantit que les tâches démarrent de manière séquentielle. Il est généralement préférable de ne pas lancer les tâches en parallèle, car une tâche unique profite davantage des caches et des ressources du système. Il est également possible de stocker les partages à analyser dans un fichier texte et d'utiliser la commande Windows "for" comme suit :

FOR /F %%p IN (Paths.txt) DO START /WAIT Treesize.exe /SCAN "%%p" /EXCEL "c:\temp\TreeSize-Reports-%DATE%.xls"

FOR /F "tokens=1" %%i IN (Shares.txt) DO START /WAIT Treesize.exe /SCAN "\\Server\%%i" /EXCEL "c:\temp\%%i.xls"

Remarque : les doubles pourcentages sont nécessaires dans les fichiers batch ; sur la ligne de commande, n'utilisez qu'un seul pourcent.

Démarrage programmé

Vous pouvez utiliser les tâches planifiées de Windows pour lancer TreeSize avec certaines options de ligne de commande tous les jours, toutes les semaines ou tous les mois à une heure donnée. Laboîte de dialogue"Schedule Dialog" de TreeSize vous aidera à configurer une tâche programmée.

Vous pouvez également utiliser la commande "SCHTASKS"pour effectuer des analyses programmées. Si, par exemple, vous souhaitez analyser les lecteurs C : et E : la nuit prochaine à 3 heures du matin et enregistrer les résultats dans un fichier Excel, vous pouvez utiliser la ligne de commande suivante :

SCHTASKS /Create /SC DAILY /ST 03:00 /TN TreeSizeScan /TR "'C:\Program Files\JAM Software\TreeSize\Treesize.exe' /SCAN C:\ E:\ /EXCEL C:\Temp\tsp.xls /EXPAND 2"

Pour obtenir de l'aide sur la commande "SCHTASKS"sur les pages de Microsoft ou en tapant :

SCHTAKS /Create /?

Remarque : les messages d'erreur survenant au cours des analyses programmées sont répertoriés dans le journal des événements du système Windows.

PowerShell

Windows PowerShell peut être utile en combinaison avec TreeSize. Cet exemple montre comment rechercher un couple d'ordinateurs distants qui sont interrogés à l'aide d'une requête LDAP dans l'Active Directory (AD) :

$computer = Get-ADComputer -SearchBase "ou=client computers,ou=intranet,dc=intranet,dc=jam-software,dc=com" -Filter *
foreach ($comp in $computer.name)
{
$path = "\\$comp\C$\Windows"
Add-Content Scan.txt "$path"
}
#debug
Get-Content -Path Scan.txt
# start TreeSize with the collected paths
&"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /SEARCH:Start /SCAN Scan.txt /FILTER *.exe /Export FoundFiles.txt

Redirection de la sortie

Si aucune autre cible d'exportation n'est indiquée, TreeSize écrira une courte exportation de l'analyse sur la sortie standard, et les erreurs survenues au cours de l'analyse sur l'erreur standard.

Vous pouvez rediriger ces flux de sortie sur la ligne de commande (cmd.exe) à l'aide du symbole pipe, par exemple

"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt

 

Pour rediriger la sortie à l'aide du symbole PowerShellveuillez utiliser la commande Start-Process à la place, par exemple

Start-Process -FilePath "C:\Program Files\JAM Software\TreeSize\Treesize.exe" -ArgumentList "/NOGUI /SCAN C:\" -RedirectStandardOutput ".\StdOut.txt" -RedirectStandardError ".\StdError.txt"

Windows Scripting Host

Si vous avez l'intention d'utiliser le symbole Windows Scripting Host (WSH)votre commande de démarrage de TreeSize ressemblera à ceci :

Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""

Codes de sortie

Si l'opération s'est terminée avec succès, le code de sortie est 0. Si une erreur s'est produite, TreeSize renvoie un code d'erreur Windows comme code de sortie s'il est disponible, ou 1 pour indiquer une erreur générale. Dans tous les cas, le journal des événements de Windows contiendra des informations supplémentaires dans le journal "Application"Source de l'événement "TreeSize".