Options de ligne de commande

L’édition professionnelle de TreeSize accepte des options de ligne de commande vous permettant d’exécuter des analyses programmées ou d’afficher les résultats d’une analyse sur votre moniteur le lendemain matin.

La boîte de dialogue pour Planification des analyses vous aidera à compiler une ligne de commande avec les options ci-dessous.

Note

Ces options ne sont disponibles que dans le logiciel TreeSize Professional Edition.

Toutes les options

Treesize.exe [/OPTION] SCANPATH

/? ou /HELP

Affiche cette page d’aide.

/AGEOFFILES

Enregistre le graphique de 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 disque local C :

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

/APPENDTOFILES <value>

Avec cette option, vous pouvez sélectionner si TreeSize doit ou non ajouter sa sortie aux fichiers existants lors d’un export, par exemple lors de l’utilisation de /TEXT. Sélectionnez « True » pour ajouter et « False » si vous souhaitez écraser les fichiers existants.

Note

Ce paramètre ne fonctionnera pas avec les images exportées, les fichiers XML et PDF. Ces fichiers seront toujours écrasés. Vous pouvez utiliser l’option /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 /EXCEL, ce 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 inclura uniquement les fichiers pour lesquels le bit d’archive 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 commencera automatiquement à calculer la taille de votre sauvegarde. Exemple :

Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"

/ATTACH

Si spécifié, tous les fichiers exportés seront joints à l’e-mail. Si non spécifié, les fichiers avec un chemin explicitement donné ne sont pas joints. Cela est utile dans le cas où vos fichiers XML ou Excel deviennent assez volumineux et remplissent votre compte de messagerie.

Cet exemple exportera vers un fichier Excel mais ne l’attachera pas à l’e-mail :

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

Ces exemples attacheront 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 <filename>

Enregistre le graphique à barres du répertoire analysé 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 graphique à barres pour votre disque local C :

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

/COMPARE <filename|path>

Compare le chemin analysé avec un fichier d’index enregistré. L’exemple suivant analyse le disque C: et compare le résultat avec un rapport XML enregistré pour ce disque :

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

Au lieu d’un fichier d’index, vous pouvez également utiliser un chemin avec ce paramètre de ligne de commande. Le chemin donné sera comparé au résultat de l’analyse actuel. L’exemple suivant analyse le disque C:et utilise en plus le chemin D:Backup_of_C pour effectuer une comparaison entre les deux :

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

Alternativement, vous pouvez comparer deux fichiers d’index déjà existants, par exemple « c1.xml.zip » et « c2.xml.zip » en utilisant cette commande :

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

La commande /OPEN prépare la comparaison de 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é, tout comme cela se produirait si « c2.xml.zip » était comparé à une analyse « réelle ».

/COPIER <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 fichiers TreeSize vers l’emplacement cible.

La commande suivante recherchera sur votre disque local C: en utilisant les dernières options de recherche et copiera les résultats de la recherche dans le dossier « C:tempObsoleteFiles » :

Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"

Voir aussi : Déplacer les fichiers sélectionnés

/CREATEDPASTDAYSONLY <n>

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

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <drive>

Crée un instantané pour les lecteurs qui sont donné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 <filename>

Enregistre les résultats dans un fichier CSV après la fin de l’analyse ou de la recherche. L’application se terminera après l’enregistrement. Cet exemple enregistrera les résultats d’une recherche de fichiers sur votre lecteur local C: avec la dernière configuration 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. Cela est utile si vous souhaitez effectuer des analyses régulièrement, par exemple chaque nuit ou chaque week-end. L’exemple suivant analysera le chemin réseau « \HostShare » et enregistrera le résultat dans un fichier comme « C:Scansname_2013-08-14_17-18-24.xls » :

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

/DEDUPLICATE

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

Il remplacera les fichiers en double qui ont été trouvés par la recherche de fichiers en double de TreeSize par des liens durs 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 comme résultat d’une recherche de fichiers TreeSize. Exemple :

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

Voir aussi : Déplacer les fichiers sélectionnés

/EMAIL <destinataire>

Envoie les données collectées à l’adresse e-mail donnée. Ce paramètre ne peut être utilisé qu’une seule fois sur la ligne de commande, et un seul e-mail avec tous les résultats sera envoyé. Plusieurs destinataires peuvent être séparés par des points-virgules (;) ou des virgules. Pour envoyer des e-mails via la ligne de commande, vous devez spécifier des paramètres SMTP valides sur la page correspondante dans 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é, l’e-mail 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 (des) destinataire(s). Exemple :

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

En combinant des 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

/EMAILSIRESULTATS TROUVÉS

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 recherche actuels 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 actuelle. Exemple :

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXÉCUTER <nom de fichier>

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

Ce paramètre permet de passer des fichiers qui ont été trouvés par la recherche de fichiers TreeSize à une autre application ou script. Une cible possible pour ce paramètre peut être un script batch ou un script PowerShell. L’exemple suivant recherchera le lecteur C:avec les paramètres de recherche les plus récents et appellera le script « Archive.bat » pour chaque fichier qui a été trouvé. Le fichier sera passé au script en tant que paramètre de ligne de commande :

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

Voir aussi : Déplacer les fichiers sélectionnés

/EXCEL <chemin de fichier>

Exporte les données collectées au format Microsoft Excel et les enregistre sous le chemin de fichier saisi. Si seul un nom de fichier est spécifié, le répertoire d’installation est utilisé pour stocker l’exportation. Les formats pris en charge sont le format de fichier conventionnel .XLS (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 après l’enregistrement. Exemple :

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

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

Note

Dans la recherche de fichiers TreeSize (/SEARCH), les résultats de chaque type de recherche sont collectés dans leur propre feuille de calcul spécifique. 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.

/EXCLURE <modèle1;modèle2>

Cette option vous permet de spécifier des motifs pour les fichiers et 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 des motifs contiennent des espaces, la chaîne de motifs complète doit être mise entre guillemets (« ). L’exemple suivant ignorera les fichiers et 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 combien de niveaux dans l’arborescence des répertoires 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 un montant en mégaoctets (Mo). Dans ce cas, tous les dossiers supérieurs au montant donné seront développés. L’unité « Mo » doit suivre le nombre sans espace. L’exemple suivant analysera le dossier « H:User », développera tous les dossiers supérieurs à 10 Mo et enregistrera le résultat dans le fichier Excel « C:ResultsAllusers.xlsx » :

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

/RAPPORTEXPANDABLE <valeur>

Si cette option est utilisée, les exports Excel utiliseront des groupes extensibles/repliables qui peuvent être navigués de manière similaire à l’arborescence des répertoires.

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

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

/EXPORTDRIVESLIST <nom_de_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 spécifié, les fichiers seront inclus dans tous les exports. Donc, cette option est équivalente à l’activation de l’option « Outils > Options > Exporter > * > Éléments exportés > Dossiers et fichiers uniques ».

/EXPORTGROUPSEXPANDED

Si spécifié, l’export de la liste des extensions contiendra toutes les informations sur les extensions contenues dans les groupes.

/EXPORTERLISTEDEPATHS <nom de 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 recherche. La liste ne contiendra que les chemins complets des résultats de recherche et aucune autre information. Les formats pris en charge pour le fichier de destination sont .txt et .csv.

Cet exemple recherchera et créera 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 > Exporter > Inclure les groupes en double » 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.

/EXPORTERTITRE <titre>

Peut être utilisé pour changer le titre dans un rapport imprimé ou un fichier exporté. Cela vous permet de fournir des informations supplémentaires à l’utilisateur lors de l’utilisation de 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 <filename>

Cette option vous permet d’enregistrer les statistiques sur les extensions de fichiers / types de fichiers de la branche du système de fichiers analysé 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 ont été activées dans l’interface utilisateur dans 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 ReportsC_filetypes.xls » avec les statistiques des types de fichiers sur ce lecteur :

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

/GRAPHIQUEDEXTENSIONS <nom de fichier>

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

/EXTENSIONSPIECHART <nom_de_fichier>

Enregistre un diagramme circulaire montrant la répartition des « extensions de fichiers » dans un fichier image (bitmap, GIF, PNG ou JPEG).

/FILTER <pattern1;pattern2>

Définit un filtre de fichiers comptant uniquement les fichiers avec certaines extensions, par exemple « .mp3 » ou « .doc ». Plusieurs motifs peuvent être passés, séparés par un point-virgule (;). L’exemple suivant recherchera des fichiers MP3 et AVI dans le répertoire « Users » sur le serveur :

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

Lors de l’exécution d’une recherche de fichiers TreeSize (/SEARCH), vous pouvez également utiliser l’option de ligne de commande /FILTER pour spécifier les motifs de la recherche de fichiers avancée. Pour effectuer une recherche de fichiers personnalisée plus complexe, vous devez enregistrer les options de recherche dans un fichier et passer 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 d’un arbre de système de fichiers.

/GROUPSCANS

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

/HIDESMALLFOLDERS <value>

Permet de masquer les objets qui sont plus petits qu’une taille minimale, ce qui est utile pour obtenir des exports clairs. <value> peut être une valeur de taille avec unité, ou une valeur en octets sans unité. Ne peut pas ê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 <filename>

Enregistre le graphique de l’onglet « Historique » du répertoire analysé 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 d’historique pour le lecteur C :

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

/HTML <filename>

Enregistre les données collectées dans un fichier HTML visualisable avec n’importe quel navigateur HTML. Vous pouvez spécifier quelles informations de l’analyse seront incluses dans l’export via « Accueil > Options > Exporter > HTML > Graphiques et listes à inclure ». Vous pouvez sélectionner lesquelles des listes ou graphiques supplémentaires doivent être ajoutés à l’export. Ils seront automatiquement intégrés dans le fichier HTML généré après l’analyse.

L’exemple suivant générera un rapport HTML pour le lecteur C : et l’enregistrera 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 alternativement utiliser le commutateur /APPENDTOFILES. Sans l’un de ces drapeaux, le fichier HTML sera écrasé.

/IMPORT <filename>

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

Charge une liste de chemins 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/copier/supprimés/archivés, comme tout résultat de recherche « en direct », en utilisant 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 :

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

/IMPORTPATTERNS <filename>

Importe une liste de motifs à partir d’un fichier. Le fichier peut être un simple fichier texte contenant une liste de motifs de filtre, séparés par des points-virgules, ou vous pouvez utiliser l’interface utilisateur pour créer un ensemble de motifs plus complexe 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 motifs 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 utilise les motifs du fichier importé comme critères de recherche.

Cet exemple importera des motifs de filtre définis sous « C:TreeSizeFilespatterns.txt », lancera une analyse pour 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 <filename>

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

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

/LISTSEPARATOR <separator char>

Vous 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 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 <path>

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

Déplace les résultats d’une recherche de fichiers TreeSize vers un autre emplacement.

La commande suivante recherchera sur votre lecteur local C: en utilisant les dernières options de recherche et déplacera les résultats de la recherche vers le dossier « C:TempObsoleteFiles » :

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

Voir aussi : Déplacer les fichiers sélectionnés

/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.

Avertissement

Utilisez ce commutateur uniquement si vous avez testé le reste des options de ligne de commande, car les messages d’erreur ne peuvent pas être affichés dans ce mode.

Cependant, les erreurs seront enregistrées dans le journal des événements Windows.

/NOHEADERS

Omet les lignes d’en-tête généralement écrites en haut des fichiers d’exportation d’analyse ou de recherche. Cela facilite la réception de données brutes pour un post-traitement.

/NOUNITS

Omet les unités généralement écrites après les valeurs de taille. Cette option, combinée avec /SIZEUNIT 0, exportera des valeurs en octets bruts. Cela facilite la réception de données brutes pour le post-traitement.

Note

Cette ligne de commande n’affectera que les exports de l’arborescence du répertoire, générés en utilisant les options /TEXT, /EXCEL, /HTML, /EMAIL ou /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST ou /TOPFILESLIST ne seront pas affectés.

/OPEN <nom_de_fichier>

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

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

/OPTIONS <nom_de_fichier>

Utilisez ce paramètre pour appliquer les paramètres utilisateur exportés à TreeSize. Les paramètres utilisateur peuvent être exportés à « Fichier > Options > Exporter ». Exemple :

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

Note

Modifiez autant de paramètres que possible dans l’interface utilisateur avant d’enregistrer les options pour réduire le nombre de paramètres de ligne de commande dont vous avez besoin.

/PDF

Enregistre les résultats dans un fichier PDF après la fin de l’analyse ou de la recherche. L’application se terminera après l’enregistrement. L’exemple suivant exécutera une analyse de votre lecteur local C: et enregistrera les résultats dans un fichier PDF :

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

/GRAPHIQUEENPIE <nom de fichier>

Enregistre le graphique en secteurs du répertoire analysé 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 analysera le lecteur C: et exportera un graphique en secteurs au format PNG :

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

/IMPRIMER

Imprime un rapport pour l’arborescence du répertoire analysé en utilisant l’imprimante par défaut configurée dans les paramètres de votre système. L’application sera terminée après l’impression. Exemple :

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

/MODELISEENON <valeur>

Si la valeur est définie sur vrai, cette option active un mode lecture seule dans lequel les opérations sur les fichiers (par exemple, déplacer ou supprimer) sont désactivées, de sorte qu’elle ne pourra être utilisée que comme outil de rapport.

Commencez avec une valeur de faux 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 tous les fichiers vers la corbeille qui ont été trouvés à la suite d’une recherche de fichiers TreeSize. Exemple :

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

Voir aussi : Déplacer les fichiers sélectionnés

/RESTRICTEDMODE <valeur>

Si la valeur est définie sur vrai, cette option active un mode restreint dans lequel de nombreuses fonctionnalités sont désactivées et qui ne sont pas d’intérêt pour les utilisateurs « normaux » (non administrateurs). Parmi les fonctionnalités désactivées figurent : Vérifier les mises à jour, Ouvrir l’applet de logiciel du Panneau de configuration Windows, Planifier des analyses TreeSize, connecter un lecteur réseau, configurer la restauration du système Windows, Exécuter en tant qu’administrateur, exports et appliquer la compression NTFS. Vous pouvez fournir un chemin qui doit être analysé, 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 avec une valeur de faux pour désactiver à nouveau le mode restreint.

Si vous activez également l’option /READONLYMODE, l’utilisateur ne pourra pas supprimer ou déplacer des fichiers dans TreeSize, de sorte qu’il ne pourra être utilisé que comme outil de rapport.

/SCAN <chemin|nom_de_fichier>

Définit quel lecteur ou chemin doit être analysé. Le chemin d’analyse doit être utilisé comme valeur pour ce paramètre.

Si, par exemple, le lecteur D:doit ê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, qui sera utilisé comme point de départ pour l’analyse. Par exemple :

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

Plusieurs chemins de scan sont également possibles, ils sont séparés par un espace. Les chemins contenant un espace doivent être cités (« ). Exemple :

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

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

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

Vous pouvez également spécifier un fichier texte, qui contient une liste de chemins à scanner. TreeSize scannera tous les chemins trouvés dans le fichier texte, qui est spécifié après ce commutateur. Le fichier texte doit contenir un chemin par ligne. L’exemple suivant scanne tous les chemins trouvés dans le fichier « D:PathsToScan.txt » et écrit chaque résultat de scan dans 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 l’un des chemins uniquement, veuillez trouver un exemple ci-dessous.

/NOMDEFEUILLE <titre>

Vous 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.

Note

Un nom de feuille Excel doit être unique dans un fichier Excel et certains caractères spéciaux comme 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 invalides 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 courte pour ce processus, qui peut être configuré dans les options régionales du Panneau de configuration Windows. Les exports 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 peut être utilisée pour spécifier l’unité à utiliser pour afficher les valeurs de taille : N peut avoir les valeurs de 0 à 5, ce qui signifie : 0 = Octets, 1 = Ko, 2 = Mo, 3 = Go, 4 = To, 5 = Unités automatiques. Sans cette option, la dernière configuration utilisée dans TreeSize sera utilisée.

/SORTBY <ColumnName>

Vous permet de spécifier par quelle valeur les exports générés seront triés. Les valeurs possibles sont des noms de colonnes comme « Taille » ou « Nom ». Le dernier type de tri utilisé dans l’interface utilisateur de 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 <filename>

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

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

/SUBJECT <subject>

Cette option vous permet de personnaliser le sujet qui sera utilisé pour les e-mails envoyés à la fin de l’analyse. Exemple :

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

/TEXT <filename>

Enregistre les résultats dans un fichier texte ou CSV après que le scan ou la recherche soit terminé. L’application se terminera après l’enregistrement. L’exemple suivant exécutera un scan de votre disque local C: et enregistrera 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, le format CSV sera utilisé automatiquement à la place. Si vous souhaitez utiliser explicitement le format CSV, nous recommandons d’utiliser le paramètre /CSV.

/TITLE <title>

Peut être utilisé pour remplacer le chemin racine d’un scan par un texte personnalisé. Cela permet de fournir des noms plus significatifs pour les chemins UNC par exemple et ainsi d’augmenter la lisibilité d’un rapport. Le titre choisi sera appliqué comme titre du rapport lors de l’exportation d’un fichier. Exemple :

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

Dans le contexte d’une recherche de fichier 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 <filename>

Cette option vous permet d’enregistrer le contenu de la liste des fichiers principaux dans un fichier Excel, HTML, texte ou CSV. Le type de fichier dépend de l’extension du nom de fichier spécifié. Exemple :

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

/CARTEPROPORTIONNELLE <nomdefichier>

Enregistre le graphique de la carte proportionnelle de l’arborescence du répertoire scanné en tant que 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 :

Treesize /UILevel "Simple"

/LISTEUTILISATEURS <nomdefichier>

Cette option vous permet d’enregistrer les statistiques montrant les résultats regroupé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 dans l’onglet « Utilisateurs » lors de sa dernière utilisation, ou au moment où le fichier de configuration fourni via /OPTIONS a été écrit.

L’exemple suivant scanne 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_utilisateur>

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

/USERFILTER <nom_utilisateur>

Avec cette option, seuls les fichiers appartenant à un certain utilisateur seront pris en compte lors du scan. Fournissez le nom de cet utilisateur après ce commutateur.

Note

Vous ne pouvez pas utiliser plusieurs noms d’utilisateur ici, mais les caractères génériques « * » et « ? » sont pris en charge.

Exemple :

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

/USERSCHART <nom_fichier>

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

/USERSPIECHART <filename>

Enregistre un graphique en secteurs qui montre les « statistiques des utilisateurs » du scan actuel dans un fichier image (bitmap, GIF, PNG ou JPEG).

/VIEWTYPE n

Définit sur quelles valeurs sont basés le « Pourcentage du Parent », les colonnes « Croissance » et le graphique « Âge des Fichiers ». Les valeurs possibles sont :

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

/XML <nom_fichier>

Enregistre les résultats du scan dans un fichier XML qui peut être chargé pour des comparaisons ultérieures. 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.

Note

Lors du chargement d’un export XML limité dans TreeSize, vous ne pouvez pas naviguer à travers l’ensemble de la branche de répertoire, mais uniquement dans les répertoires exportés.

/ZIP <nom_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 recherche de fichiers TreeSize seront déplacés dans une archive zip. Exemple :

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

Voir aussi : Déplacer les fichiers sélectionnés

<CHEMINDESCAN>

En plus du paramètre /SCAN, vous pouvez également passer un ou plusieurs chemins à la fin de la ligne de commande. Cela n’est plus recommandé pour éviter des erreurs lors de l’analyse de la ligne de commande.

Cet exemple analyse le dossier « Program Files » et le dossier « Windows », et crée un rapport texte sous « C:ReportsScanResults.txt » :

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

En cas d’erreur, celle-ci 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 analysés.

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 commencent de manière séquentielle. Ne pas démarrer les tâches en parallèle est généralement préférable car une seule tâche tire davantage parti des caches et des ressources système. Il est également possible de stocker les partages à analyser dans un fichier texte et d’utiliser la commande « for » de Windows comme ceci :

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"

Note

Les doubles caractères de pourcentage sont requis dans les fichiers batch, sur la ligne de commande, utilisez un seul pourcentage seulement.

Démarrage planifié

Vous pouvez utiliser les tâches planifiées de Windows pour exécuter TreeSize avec certaines options de ligne de commande quotidiennement, hebdomadairement ou mensuellement à une certaine heure. La boîte de dialogue pour Planification des analyses vous aidera à configurer une tâche planifiée.

Vous pouvez également utiliser la commande SCHTASKS pour effectuer des analyses planifiées. Si vous souhaitez, par exemple, analyser les lecteurs C: et E: la nuit prochaine à 03h00 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"

Obtenez de l’aide sur la commande SCHTASKS sur les pages de Microsoft ou en tapant :

SCHTAKS /Create /?

Note

Les messages d’erreur survenant lors des analyses planifiées sont répertoriés dans le journal des événements Windows du système.

PowerShell

Windows PowerShell peut être utile en combinaison avec TreeSize. Cet exemple montre comment interroger quelques ordinateurs distants à 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 aucun autre cible d’exportation n’est spécifiée, TreeSize écrira un court export de l’analyse dans la sortie standard, et les erreurs survenues pendant l’analyse dans l’erreur standard.

Vous pouvez rediriger ces flux de sortie dans la ligne de commande (cmd.exe) en utilisant le symbole de pipe, par exemple

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

Pour rediriger la sortie en utilisant PowerShell, veuillez utiliser la commande Start-Process à la place, par exemple

Start-Process -FilePath « C:Program FilesJAM SoftwareTreeSizeTreesize.exe » -ArgumentList « /NOGUI /SCAN C:" -RedirectStandardOutput « .StdOut.txt » -RedirectStandardError « .StdError.txt »

Windows Scripting Host

Si vous avez l’intention d’utiliser l’hôte de script Windows (WSH), votre commande pour démarrer 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 a été complétée avec succès, le code de sortie est 0. Si une erreur s’est produite, TreeSize renverra un code d’erreur Windows comme code de sortie si disponible, ou 1 pour indiquer une erreur générale.

Dans tous les cas, le journal des événements Windows contiendra des informations supplémentaires dans le journal « Application », source d’événement « TreeSize ».