Skip to content
Back to top

# 命令行选项

Professional 版的 TreeSize 接受命令行选项，使您能够运行计划扫描或在第二天早晨查看扫描结果。

计划扫描 对话框将帮助您使用以下选项编译命令行。

Note

这些选项仅在`TreeSize Professional Edition<https://www.jam-software.com/treesize/editions.shtml>`_ 中提供。

## 所有选项

    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>

该选项将只把在参数中输入的天数内创建的文件包含在扫描中。在下面的示例中，该选项将只把最近 8 天内创建的文件包含在扫描中：

    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、Text 或 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"。可以传递多个模式，用分号 (;) 分隔。下面的示例将搜索服务器上 "用户 "目录下的 MP3 和 AVI 文件：

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

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

### /FOLLOWREPARSEPOINTS

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

### /GROUPSCANS

使用此命令行开关将把所有扫描的目录 agrup 在一个虚拟根文件夹下。如果您想确保不使用虚拟根文件夹，请使用 /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。在没有这些标志的情况下，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:\Temp\ObsoleteFiles "文件夹：

    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 = 自动单位：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 文件搜索找到的所有文件都将移入一个压缩包。例如

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

另见：移动已检查的文件

### <SCANPATH>

除了参数 /SCAN 之外，您还可以在命令行的末尾传递一个或多个路径。然而，为了避免解析命令行时出现错误，不再推荐这样做。

本例扫描 "Program Files "和 "Windows "文件夹，并在 "C:\ReportsScanResults.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's pages 或通过输入以下内容：

    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 错误代码<https://msdn.microsoft.com/en-us/library/windows/desktop/ms681381(v=vs.85).aspx>`_ 作为退出代码（如果有），或者返回 1 表示一般错误。

无论如何，Windows 事件日志都会在 "应用程序 "日志、事件源 "TreeSize "中包含更多信息。