命令行选项

Professional 版的 TreeSize 接受命令行选项，使您可以运行计划扫描或在第二天早上在显示器上显示扫描结果。

调度扫描 的对话框将帮助您编写包含以下选项的命令行。

Note

这些选项仅在 TreeSize Professional Edition 中可用。

所有选项

Treesize.exe [/OPTION] SCANPATH

/或 /HELP

显示此帮助页面。

/AGEOFFILES

将扫描目录的“文件年龄”选项卡上的图形保存为位图、GIF、PNG、JPEG、文本或CSV文件。文件类型取决于指定文件名的扩展名。以下示例为本地驱动器C:创建“文件年龄”图形的JPEG图像文件：

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

/APPENDTOFILES <值

使用此选项，您可以选择 TreeSize 在导出时是否应将其输出附加到现有文件，例如在使用 /TEXT 时。选择 "True"可以追加，如果要覆盖现有文件，则选择 "False"。

Note

该参数不适用于导出的图像、XML 和 PDF 文件。这些文件总是会被覆盖。您可以使用开关 /DATE 来确保所有生成的报表都有唯一的文件名。

通过 /EXCEL 导出到 Excel 文件时，该参数可与 /SHEETNAME 一起使用，将数据追加到指定工作表。示例：

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

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

/ARCHIVEBITFILESONLY

此选项仅包括在扫描中设置了存档位的文件。如果您想计算备份的大小，此选项非常有用。在这种情况下，您可以在桌面或开始菜单上创建一个快捷方式，自动开始计算备份的大小。示例：

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

/ATTACH

如果指定，所有导出的文件将附加到电子邮件中。如果未指定，具有明确给定路径的文件将不附加。这在您的XML或Excel文件变得相当大并占满您的电子邮件帐户时非常有用。

此示例将导出到Excel文件，但不会将其附加到邮件中：

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

这些示例将Excel文件附加到电子邮件中：

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

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

/BARCHART <文件名

将扫描目录的条形图保存为位图、GIF、PNG或JPEG文件。文件类型取决于指定文件名的扩展名。此示例为本地驱动器C:创建条形图的PNG图像文件：

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

/COMPARE <文件名|路径

将扫描的路径与保存的索引文件进行比较。以下示例扫描驱动器C:并将结果与该驱动器的保存XML报告进行比较：

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

您也可以通过此命令行参数使用一个路径来代替索引文件。给定路径将与当前扫描结果进行比较。下面的示例扫描驱动器 C:\，并额外使用路径 D:Backup_of_C 对两者进行比较：

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

您可以通过使用以下命令比较两个已存在的索引文件，例如 "c1.xml.zip" 和 "c2.xml.zip"：

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

/OPEN 命令将第一个文件（"c1.xml.zip"）扩展为扫描文件，为两个文件的比较做准备。第二个文件（"c2.xml.zip"）将与扩展后的扫描文件进行比较，就像将 "c2.xml.zip "与 "真实 "扫描文件进行比较一样。

/COPY <路径

该选项只能与命令行选项 /SEARCH 结合使用。

将 TreeSize 文件搜索的结果复制到目标位置。

以下命令将使用最新的搜索选项在本地驱动器 C: 上进行搜索，并将搜索结果复制到 "C:\temp\ObsoleteFiles "文件夹：

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

另请参见： 移动选中的文件

/CREATEDPASTDAYSONLY <n>

此选项将仅包括在参数中输入的天数内创建的文件。在以下示例中，此选项将仅包括在过去八天内创建的文件：

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <驱动器

为该命令行参数后面给出的驱动器创建快照。示例

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

创建快照可能需要管理员权限。

/CSV <文件名

在扫描或搜索完成后将结果保存到 CSV 文件中。应用程序将在保存后自行终止。此示例将在您的本地驱动器 C: 上使用最后的搜索配置将文件搜索的结果保存到 CSV 文件中：

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

/DATE

此开关将在命令行中的所有导出文件名中添加当前日期和时间。如果你想定期进行扫描，例如每晚或每周末，这个功能就很有用。下面的示例将扫描网络路径"\\Host\Share"，并将结果保存到类似 "C:Scansname_2013-08-14_17-18-24.xls "的文件中：

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

/DEDUPLICATE

该选项只能与命令行选项 /SEARCH 结合使用。

它将用 NTFS 硬链接替换 TreeSize 重复文件搜索中找到的重复文件：

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

/DELETE

该选项只能与命令行选项 /SEARCH 结合使用。

永久删除所有作为 TreeSize 文件搜索结果找到的文件。示例：

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

另请参见： 移动选中的文件

/EMAIL <收件人

将收集到的数据发送到指定的电子邮件地址。此参数只能在命令行中使用一次，并且只会发送一封包含所有结果的电子邮件。多个收件人可以用分号（;）或逗号分隔。要通过命令行发送电子邮件，您需要在TreeSize选项对话框的相应页面上指定有效的SMTP设置。示例：

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

如果未指定其他参数，电子邮件将以选项中设置的格式发送（HTML或纯文本）。如果您希望独立于当前选项定义格式，可以在收件人地址定义后直接使用参数/TEXT或/HTML。示例：

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

通过组合参数，您还可以向电子邮件添加附件。以下示例将扫描的Excel报告作为附件添加到电子邮件中：

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

/EMAILIFRESULTSFOUND

该选项只能与命令行选项 /SEARCH 和 /EMAIL 结合使用。如果指定了该参数，TreeSize 只有在搜索过程中通过任何指定的搜索类型找到至少一个文件或文件夹时，才会发送包含当前搜索结果的电子邮件。

/EMPTYRECYCLEBIN

如果使用此选项，TreeSize将在运行当前扫描之前清空回收站。示例：

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE

该选项只能与命令行选项 /SEARCH 结合使用。

此参数允许将 TreeSize 文件搜索找到的文件传递给其他应用程序或脚本。该参数的可能目标可以是批处理或 powershell 脚本。下面的示例将使用最新的搜索设置搜索驱动器 C:\，并为找到的每个文件调用脚本 "Archive.bat"。文件将作为命令行参数传递给脚本：

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

另请参见： 移动选中的文件

/EXCEL <文件路径

以Microsoft Excel格式导出收集到的数据，并将其保存在输入的文件路径下。如果仅指定文件名，则使用当前安装目录来存储导出。支持的格式包括传统的.XLS文件格式（Excel 97-2003）以及.XLSX格式（Excel 2007引入）。所使用的格式取决于指定文件名的扩展名。应用程序将在保存后自行终止。示例：

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

如果文件名已存在，文件将被打开并添加一个新的工作表。

Note

在 TreeSize File Search (/SEARCH) 中，每种搜索类型的结果都收集在各自特定的工作表中。如果给定路径下的文件已经存在，这些工作表将被覆盖。要避免这种情况，需要使用命令行选项 /APPENDTOFILES 。

/EXCLUDE <pattern1;pattern2>

此选项使您能够指定应从扫描中排除的文件和文件夹的模式。多个排除模式可以用分号（;）分隔。如果一个或多个模式包含空格，则完整的模式字符串必须用引号（"）括起来。以下示例将忽略以“.tmp”结尾的文件和文件夹或名称完全为“system”的文件和文件夹：

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

/EXPAND <级别|大小

通过该选项可以指定扫描后将展开目录树的多少层。如果在该选项后不指定数字，则会展开所有文件夹。您也可以指定一个以百万字节（MB）为单位的数量来代替目录层级。在这种情况下，所有大于给定数量的文件夹都将被展开。单位 "MB "必须跟在数字后面，不能有空格。下面的示例将扫描文件夹 "H:\User"，展开所有大于 10 MB 的文件夹，并将结果保存到 Excel 文件 "C:\Resultsallusers.xlsx "中：

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

/EXPANDABLEREPORT <值

如果使用此选项，Excel导出将使用可展开/折叠的组，可以类似于目录树进行导航。

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

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

/EXPORTDRIVESLIST <文件名

此选项允许您将“驱动器列表”的内容导出到 Excel、文本或 CSV 文件。文件类型取决于指定文件名的扩展名。示例：

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

/EXPORTFILES

如果指定，文件将包含在所有导出中。因此，此选项相当于激活“工具 > 选项 > 导出 > * > 导出元素 > 文件夹和单个文件”选项。

/EXPORTGROUPSEXPANDED

如果指定，扩展列表的导出将包含有关组内包含的扩展的所有信息。

/EXPORTPATHSLIST <文件名

该选项只能与命令行选项 /SEARCH 结合使用。

导出一个简单列表，包含所有搜索结果。该列表将仅包含搜索结果的完整路径，而不包含其他信息。支持的目标文件格式为 .txt 和 .csv。

此示例将在 C 盘上搜索并创建所有 exe 文件的列表：

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

它可以用于通过“文件 > 路径列表 > 导入路径列表”或参数 /IMPORT 将先前搜索的结果导入回用户界面。

如果激活了“工具 > 选项 > 导出 > 包含重复组”选项，您还可以使用此功能导出和导入包括其组结构的重复搜索结果。

/EXPORTTITLE