Skip to content
Back to top

# 命令行选项

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 <标题

可用于更改打印报告或导出文件中的标题。这使您能够在自动化环境中使用 TreeSize 时向用户提供附加信息。也允许使用环境变量。示例：

    Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT

### /EXTENSIONSLIST <文件名

此选项允许您将扫描的文件系统分支的文件扩展名/文件类型统计信息保存到 Excel、HTML、文本或 CSV 文件中。文件类型取决于指定文件名的扩展名。导出的列将是上次在“扩展”选项卡中启用的列，或在通过 /OPTIONS 提供的配置文件写入时的列。

下面的示例扫描了驱动器 C:，并创建了名为 "D:\TreeSize ReportsC_filetypes.xls" 的 Excel 文件，其中包含该驱动器上文件类型的统计信息：

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

### /EXTENSIONSCHART <文件名

将“扩展”页面底部显示的小图表保存为图像文件（位图、GIF、PNG 或 JPEG）。

### /EXTENSIONSPIECHART <文件名

将显示“文件扩展名”分布的饼图保存为图像文件（位图、GIF、PNG 或 JPEG）。

### /FILTER <pattern1;pattern2>

设置文件过滤器，仅计算具有特定扩展名的文件，例如 ".mp3" 或 ".doc"。可以传递多个模式，以分号 (;) 分隔。以下示例将在服务器的 "Users" 目录中搜索 MP3 和 AVI 文件：

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

执行 TreeSize 文件搜索 (/SEARCH) 时，还可以使用 /FILTER 命令行开关来指定高级文件搜索的模式。要执行更复杂的自定义文件搜索，应将搜索选项保存到文件中，并在 /SEARCH 后将生成的 XML 文件传递到命令行。

### /FOLLOWREPARSEPOINTS

如果将此开关添加到命令行，TreeSize 将在扫描文件系统树时跟随挂载点和外部符号链接。

### /GROUPSCANS

使用此命令行开关将把所有扫描目录归入一个虚拟根文件夹。如果要确保不使用虚拟根文件夹，请使用 /GROUPSCANS FALSE 。

### /HIDESMALLFOLDERS <值

允许隐藏小于最小尺寸的对象，这对获得清晰的导出非常有用。 <value> 可以是带单位的尺寸值，也可以是不带单位的普通字节值。不能与 /EXPAND 结合使用。在本示例中，只导出最小大小为 50MB 的文件夹：

    TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\

### /HISTORYCHART <文件名

将扫描目录的 "历史" 选项卡上的图表保存为位图、GIF、PNG 或 JPEG 文件。文件类型取决于指定文件名的扩展名。此示例为驱动器 C 创建历史图表的 JPEG 图像：

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

### /HTML <文件名

将收集的数据保存为 HTML 文件，可以使用任何 HTML 浏览器查看。您可以通过 "主页 > 选项 > 导出 > HTML > 包含的图表和列表" 指定扫描中将包含哪些信息。您可以选择要添加到导出的附加列表或图表。它们将自动嵌入到扫描后生成的 HTML 文件中。

下面的示例将为驱动器 C: 生成 HTML 报表，并将其保存到 "D:\HTML"：

    Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"

如果希望 HTML 文件中包含某些扫描结果，则应添加命令行开关 /GROUPSCANS 。导出 HTML 文件时，如果不包含图像，也可以使用开关 /APPENDTOFILES.Without one of these flags, the HTML file will get overwitten.没有这些标志，HTML 文件将被覆盖。

### /IMPORT <文件名

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

将路径列表加载到 TreeSize 文件搜索的用户界面中。文件可以是 .txt 或 .csv 格式。此参数可用于导入先前搜索的结果。导入的文件和文件夹可以像任何 "实时" 搜索结果一样使用文件操作对话框进行移动/复制/删除/归档。

示例：

    Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"

还可以将此参数与 /RECYCLE 、/DELETE 或 /MOVE 参数结合使用，自动删除或移动文本文件中包含的文件。示例：

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

### /IMPORTPATTERNS <文件名

从文件导入模式列表。该文件可以是一个简单的文本文件，包含以分号分隔的过滤模式列表，或者您可以使用用户界面创建更复杂的模式集，并使用导出功能生成XML格式的模式文件。支持的格式有CSV、TXT和XML。

导入的模式将用作扫描的过滤器，以包含或排除特定的文件和文件夹。

如果与命令行选项 /SEARCH 结合使用，该参数将创建一个新的高级搜索，使用导入文件中的模式作为搜索条件。

此示例将导出在 "C:TreeSizeFiles\patterns.txt "下定义的筛选模式，开始扫描驱动器 C:\，并将结果导出为 HTML 文件：

    Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"

### /INDEXFILE <文件名

将扫描结果保存到SQLite文件中，以便在以后进行比较。示例：

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

### /LISTSEPARATOR <分隔符字符

允许您定义导出文本或CSV文件时使用的分隔符。文本文件默认使用制表符，CSV文件使用Windows控制面板的区域设置中的列表分隔符。

请在此开关后指定一个单字符或字符串"TAB"以表示制表符。示例：

    Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"

    Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"

### /MOVE <路径

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

它将TreeSize文件搜索的结果移动到另一个位置。

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

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

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

### /NOGUI

将不显示窗口，应用程序也不会出现在任务栏中。适合在后台执行扫描或搜索，而无需视觉反馈。

Warning

仅在您测试了其余命令行选项后使用此开关，因为在此模式下无法显示错误消息。

但是，错误将记录在Windows事件日志中。

### /NOHEADERS

省略通常写在扫描或搜索导出文件顶部的标题行。这使得接收用于后处理的纯数据更容易。

### /NOUNITS

省略通常写在大小值后面的单位。该选项与 /SIZEUNIT 0 结合使用将导出纯字节值。这样可以更方便地接收纯数据进行后处理。

Note

该命令行只影响使用 /TEXT, /EXCEL, /HTML, /EMAIL 或 /PRINT 选项导出的目录树。/EXTENSIONSLIST, /USERSLIST 、/EXPORTDRIVESLIST 或 /TOPFILESLIST 将不受影响。

### /OPEN <文件名

在应用程序启动时打开保存的 XML 报告。示例：

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

### /OPTIONS <文件名

使用此参数将导出的用户设置应用于 TreeSize。用户设置可以在“文件 > 选项 > 导出”中导出。示例：

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

Note

在保存选项之前，尽可能多地更改用户界面中的设置，以减少所需的命令行参数数量。

### /PDF

在扫描或搜索完成后将结果保存为 PDF 文件。保存后，应用程序将自行终止。以下示例将扫描本地驱动器 C: 并将结果保存为 PDF 文件：

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

### /PIECHART <文件名

将扫描目录的饼图保存为位图、GIF、PNG 或 JPEG 文件。文件类型取决于指定文件名的扩展名。以下示例将扫描驱动器 C: 并以 PNG 格式导出饼图：

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

### /PRINT

使用系统设置中配置的默认打印机打印扫描的目录树报告。打印后，应用程序将被终止。示例：

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

### /READONLYMODE <值

如果值设置为 true，则此选项激活只读模式，在该模式下，文件操作（例如移动或删除）被禁用，因此它将仅用作报告工具。

以 false 的值开始以再次停用只读模式。

### /RECYCLE

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

将所有在 TreeSize 文件搜索中找到的文件移动到回收站。示例：

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

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

### /RESTRICTEDMODE <值

如果值设置为 true，则此选项激活受限模式，在该模式下，许多对“普通”（非管理员）用户不感兴趣的功能被禁用。被禁用的功能包括：检查更新、打开 Windows 控制面板的软件小程序、安排 TreeSize 扫描、连接网络驱动器、配置 Windows 系统还原、以管理员身份运行、导出和应用 NTFS 压缩。您可以在命令行中或使用保存的配置文件中的启动路径提供应扫描的路径，例如用户的主目录。

以 false 的值开始以再次停用受限模式。

如果另外激活 /READONLYMODE 选项，用户将无法在 TreeSize 中删除或移动文件，因此它只能作为报表工具使用。

### /SCAN <路径|文件名

定义应扫描的驱动器或路径。扫描路径应作为此参数的值使用。

例如，如果要扫描驱动器 D:\，可以使用

    Treesize /SCAN "D:\"

如果您不想扫描整个驱动器，也可以指定一个路径，该路径将作为扫描的起点。例如：

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

多个扫描路径也是可能的，它们用空格分隔。包含空格的路径必须用引号（"）括起来。示例：

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

允许使用通配符 "*" 和 "?"。示例：

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

您也可以指定一个文本文件，其中包含应扫描的路径列表。TreeSize 会扫描在此开关后指定的文本文件中找到的所有路径。文本文件必须每行包含一个路径。下面的示例扫描了在文件 "D:\PathsToScan.txt "中找到的所有路径，并将每个扫描结果写入 Excel 文件中的单独工作表，并注明今天的日期：

    Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"

您还可以在 "for" 循环中调用 TreeSize，仅使用其中一个路径，以下是示例。

### /SEARCH

打开 TreeSize 的文件搜索窗口。如果在此命令行选项中添加了 ":Start" ，搜索将自动启动。可以传递先前保存的包含搜索设置的 XML 文件，然后将使用这些设置执行搜索。

Note

在此搜索中找到的文件将自动被选中。

以下示例使用先前保存到文件 "SearchSettings.xml" 的设置执行搜索，并将结果保存到文本文件中：

    Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"

Note

一般情况下，将使用上次的搜索设置或以前保存的搜索设置。不过，也可以使用 /FILTER 命令行选项指定高级搜索的搜索模式。

### /SHEETNAME <标题

使用 /EXCEL 命令行开关时，可以指定将添加到 Excel 文件中的工作表名称。

Note

Excel 工作表名称在 Excel 文件中必须是唯一的，并且某些特殊字符如斜杠、反斜杠和冒号是禁止的。TreeSize 将始终通过用下划线替换无效字符并在必要时添加日期和时间来创建唯一的工作表名称。如果目标文件中已存在指定名称的工作表，则会创建一个具有唯一名称的新工作表。使用命令行选项 /APPENDTOFILES 将数据附加到现有工作表。

### /SHORTDATEFORMAT <格式

更改此过程的短日期格式，该格式可以在 Windows 控制面板的区域选项中配置。TreeSize 的导出将使用此格式表示日期值。示例：

    Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"

### /SIZEUNIT <n>

此选项可用于指定显示大小值时使用的单位：N 可以取值 0 到 5，分别表示：0 = 字节，1 = KB，2 = MB，3 = GB，4 = TB，5 = 自动单位。没有此选项时，将使用 TreeSize 中最后使用的配置。

### /SORTBY <列名

使您能够指定按哪个值对生成的导出内容进行排序的方式。可能的值是列名，如 "Size" 或 "Name"。默认使用 TreeSize 用户界面中最后使用的排序方式。示例

    Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"

    Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"

### /SQLITE <文件名

将扫描结果保存到SQLite文件中，以便在以后进行比较。示例：

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

### /SUBJECT <主题

此选项允许您自定义将在扫描结束时发送的电子邮件的主题。示例：

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

### /TEXT <文件名

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

    Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"

文本格式采用针对人类读者的表格格式。如果文件名引用的是 CSV 文件，则会自动使用 CSV 格式。如果要明确使用 CSV 格式，建议使用 /CSV 参数。

### /TITLE <标题

可用于用自定义文本替换扫描的根路径。这允许为 UNC 路径提供更有意义的名称，从而提高报告的可读性。所选标题将在导出文件时作为报告的标题应用。示例：

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

在 TreeSize 文件搜索的上下文中，此参数可用于命名高级搜索。示例：

    Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"

### /TOPFILESLIST <文件名

此选项使您能够将顶部文件列表的内容保存为 Excel、HTML、文本或 CSV 文件。文件类型取决于指定文件名的扩展名。示例：

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

### /TREEMAP <文件名

将扫描的目录树的树图图表保存为位图、GIF、PNG 或 JPEG 文件。文件类型取决于指定文件名的扩展名。示例：

    Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"

### /UILevel <Simple|Normal|Expert>

设置用户界面的级别。可能的值是 Simple, Normal, 或 Expert 。示例:

    Treesize /UILevel "Simple"

### /USERSLIST <文件名

此选项使您能够将按用户名分组的结果统计信息保存为 Excel、HTML、文本或 CSV 文件。文件类型取决于指定文件名的扩展名。导出的列将是上次使用时在“用户”选项卡中启用的列，或在通过 /OPTIONS 提供的配置文件编写时的列。

下面的示例扫描了驱动器 C:，并在 "C:\Temp "中创建了一个 Excel 文件，其中包含该驱动器上用户的统计信息：

    Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"

### /USERNAME <用户名

指定用于验证扫描的用户名。使用 /PASSWORD 为该用户名指定密码。建议使用 Microsoft 工具 RUNAS 。

### /USERFILTER <用户名

使用此选项时，仅会考虑由特定用户拥有的文件进行扫描。在此开关后提供该用户的名称。

Note

您不能在此处使用多个用户名，但支持通配符 "*" 和 "?"。

示例：

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

### /USERSCHART <文件名

将 "用户" 页面底部显示的小图表保存为图像文件（位图、GIF、PNG 或 JPEG）。

### /USERSPIECHART <文件名

将当前扫描的 "用户统计" 显示为饼图并保存为图像文件（位图、GIF、PNG 或 JPEG）。

### /VIEWTYPE n

定义 "父级百分比"、"增长" 列和 "文件年龄" 图表所基于的值。可能的值为：

2: 大小 3: 分配空间（磁盘上的大小） 7: 文件数量

### /XML <文件名

将扫描结果保存到 XML 文件中，以便在稍后进行比较。示例：

    Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"

该选项可与 /EXPAND 开关结合使用，以限制导出的目录。

Note

在将有限的 XML 导出加载到 TreeSize 时，您无法浏览完整的目录分支，而只能浏览导出的目录。

### /ZIP <文件名

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

所有作为 TreeSize 文件搜索结果找到的文件将被移动到一个 zip 存档中。示例：

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

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

### <SCANPATH>

除了参数 /SCAN 之外，还可以在命令行末尾传递某些路径。不过，为了避免在解析命令行时出错，不再推荐这样做。

本示例扫描 "Program Files "和 "Windows "文件夹，并在 "C:eportsScanResults.txt "下创建文本报表：

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

如果发生错误，将作为 Windows 错误代码返回，并在进程的退出代码中显示。文件名中可以使用环境变量（例如 %APPDATA%），同样适用于扫描路径。

## 扫描多个目录

如果您需要扫描多个目录，合并多个调用到一个批处理文件中可能是个好主意，例如：

    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"

命令“START /WAIT”确保作业按顺序启动。通常不并行启动作业更好，因为单个作业可以更好地利用缓存和系统资源。也可以将要扫描的共享存储在文本文件中，并使用 Windows 的“for”命令，如下所示：

    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

在批处理文件中需要使用双百分号字符，而在命令行中只需使用单个百分号。

## 计划启动

您可以使用 Windows 计划任务以特定的命令行选项每天、每周或每月在特定时间运行 TreeSize。用于 调度扫描 的对话框将帮助您设置计划任务。

您还可以使用 `SCHTASKS` 命令执行计划扫描。例如，如果您想在下一个晚上 03:00 扫描 C: 和 E: 驱动器并将结果保存到 Excel 文件中，可以使用以下命令行：

    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"

有关 `SCHTASKS` 命令的帮助，请访问 Microsoft 的页面 或通过输入以下内容：

    SCHTAKS /Create /?

Note

在计划扫描期间发生的错误消息会列在系统的 Windows 事件日志中。

## PowerShell

Windows PowerShell 可与 TreeSize 结合使用。本示例展示了如何搜索在 Active Directory（AD）中使用 LDAP 查询的几台远程计算机：

    $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

## 重定向输出

如果未指定其他导出目标，TreeSize 将把扫描的简短导出写入标准输出，并将扫描过程中发生的错误写入标准错误。

您可以在命令行 (cmd.exe) 中使用管道符重定向这些输出流，例如：

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

要使用 PowerShell 重定向输出，请使用 Start-Process 命令，例如：

Start-Process -FilePath "C:Program Files\JAM SoftwareTreeSizeTreesize.exe" -ArgumentList "/NOGUI /SCAN C:" -RedirectStandardOutput ".StdOut.txt" -RedirectStandardError ".StdError.txt"

## Windows Scripting Host

如果您打算使用 Windows Scripting Host (WSH) ，启动 TreeSize 的命令将如下所示：

    Set Shell = CreateObject("WScript.Shell")

    Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""

## 退出代码

如果操作成功完成，退出代码为 0。如果发生错误，TreeSize 将返回一个 Windows 错误代码 作为退出代码（如果可用），或返回 1 以指示一般错误。

无论如何，Windows 事件日志将在“应用程序”日志中包含更多信息，事件源为“TreeSize”。