Search Parameters

These command line parameters allow you to execute file searches from saved search job files and control their behavior.

Search

Causes FolderSizes to initiate a search from an existing search job definition file. Important: when using the "search" command line argument, the purpose of the /path argument changes. For searches, the "path" argument must reference a fully qualified search job file path. You must also include the "search" command line argument, like this:

foldersizes.exe /path:"d:\search_job.xml" /search /export:"d:\search_out.html" /exit

The example above loads a search job file that already exists in the "d:\search_job.xml" path. You must create the search job file in advance (please see this topic for additional information) in order to execute a search from the command line.

It is possible to execute a search and then export the results in multiple formats at once. See the Advanced Uses topic for additional details. Note that search results can be exported in one of three formats: HTML (.html), comma separated values (.csv), and tab delimited text (.txt).

SearchPath

When using the "/search" command line option (described above), this parameter allows you to override the search paths associated with the search job file. In other words, the search paths that are saved along with the job will be ignored in favor of those passed in via this parameter.

foldersizes.exe /path:"d:\search_job.xml" /search /searchpath:"c:\temp" /export:"d:\search_out.html" /exit

Multiple search job paths can be separated with pipe symbols.

NoEmptyEmail

This option applies only to searches initiated via the command line that send search results via email (see the /email command line argument). When specified, it will suppress email transmission if no search results were found.

Note that search export files will still be generated and retained even if no email is sent.

foldersizes.exe /path:"d:\search_job.xml" /search /searchpath:"c:\temp" /export:"d:\search_out.html" /email:"user@domain.com" /noemptyemail /exit