Trend Analysis Parameters

These command line parameters allow you to run trend analyses from previously generated snapshot data and export the results.

TrendAnalysis

The "trendanalysis" parameter instructs FolderSizes to launch the Trend Analyzer and import snapshot data from the specified path. When using trend analysis from the command line, the /path parameter should reference a folder (or folders) containing previously generated snapshot files (.fssx and/or .xml).

foldersizes.exe /path:"d:\snapshots" /trendanalysis /trendreport:"subfolderchange" /export:"d:\reports\growth.csv" /exit

TrendReport

The "trendreport" parameter specifies which trend report(s) to generate and export. The following report types are supported:

• "history" - snapshot history detail report
• "subfolderchange" - subfolder growth/change report
• "ownerhistory" - file owner history detail report
• "historybysizechart" - history by size chart (image export)
• "historybycountchart" - history by file count chart (image export)
• "diskhistorychart" - disk space history chart (image export)
• "ownerhistorychart" - owner history chart (image export)

To generate multiple trend reports at once, separate the report type names and their corresponding export paths with pipe ("|") symbols, like this:

foldersizes.exe /path:"d:\snapshots" /trendanalysis /trendreport:"subfolderchange|historybysizechart" /export:"d:\reports\growth.csv|d:\reports\size_trend.png" /exit

ViewRoot

The "viewroot" parameter can be used to select a specific node in the trend folder tree prior to exporting. Without this parameter, the root node is selected by default. This is particularly useful when exporting subfolder change data for a specific path. The value should match the full path of the node as it appears in the trend folder tree.

foldersizes.exe /path:"d:\snapshots" /trendanalysis /trendreport:"subfolderchange" /viewroot:"C:\Users" /export:"d:\reports\users_growth.csv" /exit

Import Options

The following optional parameters control how trend data files are discovered and imported:

• /recursesubfolders - search for snapshot files in subfolders of the specified path. To explicitly disable subfolder recursion, use /norecursesubfolders instead.
• /importxml - include .xml snapshot files during import.
• /importfssx - include .fssx snapshot files during import.
• /singlethreadedimport - use a single thread for data import (may be useful for troubleshooting or when importing from slower storage).

If neither /importxml nor /importfssx is specified, the import format defaults to whatever is configured in the Trend Analyzer settings (which defaults to .fssx). When either flag is explicitly specified, only the requested format(s) will be included. Both flags can be combined to import both formats.

foldersizes.exe /path:"d:\snapshots" /trendanalysis /trendreport:"subfolderchange" /viewroot:"C:\temp" /export:"d:\reports\growth.csv" /importxml /norecursesubfolders /date /exit

Other Supported Parameters

The /sort, /viscols, /date, /email, /saveeventlog, and /exit parameters are all supported for trend analysis and work the same as they do for other command line task types.