Command line options

The Professional Edition of TreeSize accepts command line options enabling you to run scheduled scans or to have the results of a scan on your monitor the next morning.

The dialog for Scheduling scans will help you compile a command line with the options below.

Note

These option are only available in the TreeSize Professional Edition.

All options

Treesize.exe [/OPTION] SCANPATH

/? or /HELP

Shows this help page.

/AGEOFFILES

Saves the graph on the “Age of Files” tab of the scanned directory to a bitmap, GIF, PNG, JPEG, Text, or CSV file. The file type depends on the extension of the specified file name. The following example creates a JPEG image file of the”Age of Files” graph for your local drive C:

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

/APPENDTOFILES <value>

With this option, you can select whether or not TreeSize should append its output to existing files when doing an export, e.g. when using /TEXT. Select “True” to append and “False”, if you want to overwrite existing files.

Note

This parameter will not work with exported images, XML and PDF files. Those files always will be overwritten. You can use the switch /DATE to ensure that all generated reports will have a unique file name.

When exporting to an Excel file via /EXCEL, this parameter can be used together with /SHEETNAME to append the data to the specified sheet. Example:

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

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

/ARCHIVEBITFILESONLY

This option will include only files for which the archive bit set in the scans. This option can be very useful if you want to calculate the size of a backup. In this case, you can create a shortcut on your desktop or in your start menu that will automatically start calculating the size of your backup. Example:

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

/ATTACH

If specified, all exported files will be attached to the email. If not specified, files with an explicitly given path are not attached. This is useful in case you XML or Excel files are getting quite large and fill up you email account.

This example will export to an Excel file but not attach it to the mail:

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

These examples will attach the Excel file to the email:

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>

Saves the bar chart of the scanned directory to a bitmap, GIF, PNG, or JPEG file. The file type depends on the extension of the specified file name. This example creates a PNG image file of the bar chart for your local drive C:

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

/COMPARE <filename|path>

Compares the scanned path with a saved index file. The following example scans drive C: and compares the result with a saved XML report for this drive:

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

Instead of an index file, you can also use a path with this command line parameter. The given path will be compared with the current scan result. The following example scans drive C:\ and additionally uses the path D:Backup_of_C to perform a comparison between the two:

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

Alternatively, you can compare two already existing index files e.g. “c1.xml.zip” and “c2.xml.zip” by using this command :

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

The /OPEN command prepares the comparison of the two files by expanding the first file (“c1.xml.zip”) into a scan file. The second file (“c2.xml.zip”) will be compared to this expanded scan file, just like it would happen, if “c2.xml.zip” was compared to a “real” scan.

/COPY <path>

This option can only be used in combination with the command line option /SEARCH.

Copies the results of a TreeSize file search to the target location.

The following command will search on your local drive C: using the latest search options and copies the search results to the folder “C:\temp\ObsoleteFiles”:

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

See also: Move checked files

/CREATEDPASTDAYSONLY <n>

This option will include only files in the scans, which were created during the number of days entered in the argument. In the following example, this option will only include only files created during the last eight days in the scan:

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <drive>

Creates a snapshot for the drives that are given after this command line parameter. Example:

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

Creating snapshots may require administrative privileges.

/CSV <filename>

Saves the results to a CSV file after the scan or search is finished. The application will terminate itself after saving. This example will save the results of a File Search on your local drive C: with the last search configurations to a CSV file:

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

/DATE

This switch will add the current date and time to all export file names in the command line. This is useful if you want to do scans regularly, e.g. every night or every weekend. The following example will scan the network path “\\Host\Share” and save the result to a file like “C:\Scans\name_2013-08-14_17-18-24.xls”:

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

/DEDUPLICATE

This option can only be used in combination with the command line option /SEARCH.

It will replace the duplicate files that were found by the TreeSize duplicate file search with NTFS hardlinks:

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

/DELETE

This option can only be used in combination with the command line option /SEARCH.

Permanently deletes all files that have been found as result of a TreeSize file search. Example:

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

See also: Move checked files

/EMAIL <recipient>

Sends the collected data to the given email address. This parameter can be used only once on the command line, and only one email with all results will be sent. Multiple recipients can be separated with semicolons (;) or commas. To send emails via the command line, you need to specify valid SMTP settings on the corresponding page in the TreeSize options dialog. Example:

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

If no other parameters have been specified, the email will be sent in the format that is set in the options (HTML or plain text). If you would like to define the format independent from the current options, you can use the parameters /TEXT or /HTML right behind the definition of the recipient address(es). Example:

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

By combining parameters you can also add attachments to the email. The following example will add an Excel report of the scan as an attachment to the email:

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

/EMAILIFRESULTSFOUND

This option can only be used in combination with the command line options /SEARCH and /EMAIL. If this parameter is specified, TreeSize will only send an email with the current search results, if at least one file or folder has been found during the search, by any of the specified search types.

/EMPTYRECYCLEBIN

If you use this option, TreeSize will empty the recycle bin before running the current scan. Example:

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE

This option can only be used in combination with the command line option /SEARCH.

This parameter allows passing files that have been found by the TreeSize file search to another application or script. A possible target for this parameter can be a batch, or a powershell script. The following example will search drive C:\ with the most recent search settings and call the script “Archive.bat” for each file that has been found. The file will be passed to the script as command line parameter:

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

See also: Move checked files

/EXCEL <filepath>

Exports the collected data in Microsoft Excel format and saves it under the entered file path. If only a file name is specified, the current installation directory is used to store the export. Supported formats are the conventional .XLS file format (Excel 97-2003) as well as the .XLSX format (introduced with Excel 2007). The used format depends on the extension of the specified file name. The application will terminate itself after saving. Example:

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

If the file name already exists, the file will be opened and a new worksheet will be added.

Note

In the TreeSize File Search (/SEARCH) the results of each search type are collected in their own specific worksheet. If the file under the given path already exists, these sheets will be overwritten. To prevent this, you need to use the command line option /APPENDTOFILES.

/EXCLUDE <pattern1;pattern2>

This option enables you to specify patterns for files and folders that should be excluded from a scan. Multiple exclude patterns can be separated using a semicolon (;). If one or more of the patterns contain spaces, the complete pattern string must be set into quotes (“). The following example will ignore files and folders that end with “.tmp” or where the exact name is “system”:

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

/EXPAND <level|size>

This option lets you specify how many levels in the directory tree will be expanded after scanning. If you don’t specify a number after this option, all folders will be expanded. Instead of a directory level you can also indicate an amount in Mega Byte (MB). In this case all folders larger than the given amount will be expanded. The unit “MB” must follow the number without a blank. The following example will scan the folder “H:\User”, expand all folders larger than 10 MB and save the result to the Excel file “C:\Results\Allusers.xlsx”:

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

/EXPANDABLEREPORT <value>

If this option is used, Excel exports will use expandable/collapsible groups that can be navigated similar to the directory tree.

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

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

/EXPORTDRIVESLIST <filename>

This option enables you to export the contents of the “Drive List” to an Excel, Text, or CSV file. The file type depends on the extension of the specified file name. Example:

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

/EXPORTFILES

If specified, files will be included in all exports. So this option is equivalent to activating the option “Tools > Options > Export > * > Exported elements > Folders and single files”

/EXPORTGROUPSEXPANDED

If specified, the export of the extensions list will contain all information about the extensions contained within groups.

/EXPORTPATHSLIST <filename>

This option can only be used in combination with the command line option /SEARCH.

Exports a simple list that contains all search results. The list will contain only the full paths of the search results and no other information. Supported formats for the destination file are .txt and .csv.

This example will search for, and create a list of all exe files on drive C:

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

It can be used to import results of a previous search back into the user interface, by using “File > List of paths > Import path list”, or the parameter /IMPORT.

If the option “Tools > Options > Export > Include duplicate groups” is activated, you can also use this function to export and import results of the duplicate search including their group structure.

/EXPORTTITLE