Параметры командной строки

В Professional Edition TreeSize доступны параметры командной строки, позволяющие запускать сканирование по расписанию или выводить результаты сканирования на монитор на следующее утро.

Диалог для Запланированное сканирование поможет вам составить командную строку с указанными ниже параметрами.

Примечание

Эти настройки доступны только в версии TreeSize Professional Edition.

Все варианты

Treesize.exe [/OPTION] SCANPATH

/? или /HELP

Показывает эту страницу помощи.

/AGEOFFILES

Сохраняет график на вкладке «Возраст файлов» каталога сканирования в растровый, GIF, PNG, JPEG, текстовый или CSV-файл. Тип файла зависит от расширения указанного имени файла. В следующем примере создается файл изображения JPEG графика «Возраст файлов» для локального диска C:

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

/APPENDTOFILES <значение>

С помощью этого параметра вы можете выбрать, должен ли TreeSize добавлять свой вывод к существующим файлам при экспорте, например, при использовании /TEXT. Выберите «True» для добавления и «False», если вы хотите перезаписать существующие файлы.

Примечание

Этот параметр не работает с экспортированными изображениями, 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-файле. Тип файла зависит от расширения указанного имени файла. В этом примере создается файл изображения гистограммы в формате PNG для локального диска C:

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:\Scans\name_2013-08-14_17-18-24.xls»:

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

/DEDUPLICATE

Эта опция может использоваться только в сочетании с опцией командной строки /SEARCH.

Он заменит дубликаты файлов, найденные в результате поиска дубликатов файлов TreeSize, жесткими ссылками NTFS:

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

/DELETE

Эта опция может использоваться только в сочетании с опцией командной строки /SEARCH.

Удаляет все файлы, которые были найдены в результате поиска файлов TreeSize. Пример:

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

См. также: Файловые операции

/EMAIL <получатель

Отправляет собранные данные на указанный адрес электронной почты. Этот параметр может быть использован только один раз в командной строке, и будет отправлено только одно письмо со всеми результатами. Несколько получателей могут быть разделены точкой с запятой (;) или запятыми. Чтобы отправить электронное письмо через командную строку, необходимо указать правильные настройки SMTP на соответствующей странице диалога параметров TreeSize. Пример:

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:\ с последними настройками поиска и вызов сценария «Архивный.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"

Если имя файла уже существует, файл будет открыт и добавлен новый рабочий лист.

Примечание

На сайте TreeSize File Search (/SEARCH) результаты каждого типа поиска собираются в отдельном рабочем листе. Если файл по указанному пути уже существует, эти листы будут перезаписаны. Чтобы предотвратить эту ситуацию, необходимо использовать параметр командной строки /APPENDTOFILES.

/EXCLUDE <шаблон1;шаблон2>

Эта опция позволяет указать шаблоны для файлов и папок, которые следует исключить из сканирования. Несколько шаблонов исключений можно разделить точкой с запятой (;). Если один или несколько шаблонов содержат пробелы, всю строку шаблона необходимо заключить в кавычки («»). В следующем примере будут игнорироваться файлы и папки, заканчивающиеся на «.tmp» или имеющие точное имя «system»:

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

/EXPAND <уровень|size>

Этот параметр позволяет указать, на сколько уровней будет расширено дерево каталогов после сканирования. Если после этой опции не указать число, будут расширены все папки. Вместо уровня каталога вы также можете указать количество в мегабайтах (МБ). В этом случае все папки, превышающие указанную сумму, будут расширены. Единица измерения «МБ» должна следовать за номером без пробела. Следующий пример сканирует папку «H:\User», раскрывает все папки более 10 МБ и сохраняет результат в Excel-файл «C:\Results\Allusers.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.

В этом примере будет выполнен поиск и создан список всех exe-файлов на диске C:

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

С его помощью можно импортировать результаты предыдущего поиска обратно в пользовательский интерфейс, используя «Файл > Список путей > Импорт списка путей» или параметр /IMPORT.

Если активирована опция «Инструменты > Опции > Экспорт > Включить дубликаты групп», вы также можете использовать эту функцию для экспорта и импорта результатов поиска дубликатов, включая их групповую структуру.

/EXPORTTITLE <title>

Можно использовать для изменения названия распечатываемого или экспортируемого отчета или файла. Это позволяет предоставлять пользователю дополнительную информацию при использовании TreeSize в автоматизированной среде. Также допускается использование переменных окружения. Пример:

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

/EXTENSIONSLIST <имя файла>

Эта опция позволяет сохранить статистику по расширениям файлов / типам файлов сканируемой ветви файловой системы в Excel, HTML, Text или CSV-файл. Тип файла зависит от расширения указанного имени файла. Экспортируются те столбцы, которые были включены в пользовательском интерфейсе на вкладке «Расширения» при последнем использовании или на момент записи файла конфигурации, предоставленного через /Опции.

В следующем примере сканируется диск C: и создается Excel-файл с именем «D:\TreeSize Reports\C_filetypes.xls» со статистикой типов файлов на этом диске:

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

/EXTENSIONSCHART <имя файла>

Сохраняет небольшой график, показанный в нижней части страницы «Расширения», в файл изображения (растровый, GIF, PNG или JPEG).

/EXTENSIONSPIECHART <имя файла>

Сохраняет круговую диаграмму, показывающую распределение «расширений файлов» для файла изображения (растрового, GIF, PNG или JPEG).

/FILTER <шаблон1;шаблон2>

Устанавливает фильтр файлов, учитывающий только файлы с определенными расширениями, например «.mp3» или «.doc». Можно передавать несколько шаблонов, разделяя их точкой с запятой (;). В следующем примере будет выполнен поиск файлов MP3 и AVI в каталоге «Пользователи» на сервере:

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

При выполнении поиска файлов TreeSize (/SEARCH) вы также можете использовать ключ /FILTER командной строки, чтобы указать шаблоны расширенного поиска файлов. Для выполнения более сложного настраиваемого поиска файлов следует сохранить параметры поиска в файл и передать полученный XML-файл в командную строку после /SEARCH.

/FOLLOWREPARSEPOINTS

Если добавить этот переключатель в командную строку, TreeSize будет отслеживать точки монтирования и внешние символические ссылки при сканировании дерева файловой системы.

/GROUPSCANS

С помощью этого переключателя командной строки все сканированные каталоги будут сгруппированы в виртуальной корневой папке. Используйте /GROUPSCANS FALSE, если вы хотите убедиться, что ни одна виртуальная корневая папка не используется.

/HIDESMALLFOLDERS <значение>

Позволяет скрыть объекты, размер которых меньше минимального, что полезно для очистки экспорта. <Значение> может быть значением размера с единицей измерения или обычным значением байта без единицы измерения. Не может использоваться в сочетании с /EXPAND. В этом примере будут экспортированы только папки с минимальным размером 50 МБ:

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

/HISTORYCHART <имя файла>

Сохраняет график на вкладке «История» каталога сканирования в растровый файл, файл GIF, PNG или JPEG. Тип файла зависит от расширения указанного имени файла. В этом примере создается JPEG-изображение графика истории для диска C:

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

/HTML <имя файла>

Сохраняет собранные данные в HTML-файл, который можно просмотреть в любом HTML-браузере. Вы можете указать, какая информация о сканировании будет включена в экспорт через «Главная > Настройки > Экспорт > HTML > Диаграммы для экспорта». Вы можете выбрать, какие из дополнительных списков или диаграмм должны быть добавлены в экспорт. Они будут автоматически встроены в HTML-файл, создаваемый после сканирования.

Следующий пример создаст HTML-отчет для диска C: и сохранит его в папке «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 <разделитель char>

Позволяет определить разделитель, используемый при экспорте текстовых или 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

Окно не отображается, и приложение не появляется на панели задач. Используется для того, чтобы выполнить сканирование или поиск в фоновом режиме, без визуальной обратной связи.

Предупреждение

Используйте этот переключатель только в том случае, если вы проверили остальные параметры командной строки, поскольку сообщения об ошибках в этом режиме отображаться не могут.

Однако ошибки будут регистрироваться в журнале событий Windows.

/NOHEADERS

Опускает строки заголовков, которые обычно пишутся в верхней части файлов экспорта сканирования или поиска. Благодаря этой функции проще получить простые данные для постобработки.

/NOUNITS

Опускает единицы измерения, которые обычно пишутся после значений размеров. Эта опция в сочетании с /SIZEUNIT 0 экспортирует обычные байтовые значения. Благодаря этой опции проще получать обычные данные для последующей обработки.

Примечание

Эта командная строка влияет только на экспорт дерева каталогов, созданный с помощью опций /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"

Примечание

Измените как можно больше настроек в пользовательском интерфейсе перед сохранением параметров, чтобы уменьшить количество необходимых параметров командной строки.

/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"

Вы также можете вызвать TreeSize в цикле «for» только с одним из путей, пример приведен ниже.

/SHEETNAME <title>

Позволяет указать имя листа, который будет добавлен в файл Excel при использовании переключателя командной строки /EXCEL.

Примечание

Имя листа 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 = КБ, 2 = МБ, 3 = ГБ, 4 = ТБ, 5 = Автоматически Единицы. Без этой опции будет использована последняя конфигурация TreeSize.

/SORTBY <ColumnName>

Позволяет указать, по какому значению будет сортироваться создаваемый экспорт. Возможными значениями являются такие имена столбцов, как «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 <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 <имя файла>

Этот параметр позволяет сохранить содержимое списка Top files в Excel, HTML, Text или 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, Text или CSV. Тип файла зависит от расширения указанного имени файла. Экспортируются те столбцы, которые были включены в пользовательском интерфейсе на вкладке «Пользователи» при последнем использовании или на момент записи файла конфигурации, предоставленного через /OPTIONS.

Следующий пример сканирует диск C: и создает Excel-файл в папке «C:\Temp» со статистикой пользователей на этом диске:

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

/USERNAME <Имя пользователя>

Указывает имя пользователя, которое должно использоваться для аутентификации при сканировании. Используйте /PASSWORD, чтобы указать пароль для этой учетной записи. Вместо этого рекомендуется использовать инструмент Microsoft RUNAS.

/USERFILTER <Имя пользователя>

С помощью этого параметра при сканировании будут учитываться только файлы, принадлежащие определенному пользователю. Укажите имя этого пользователя после переключения.

Примечание

Здесь нельзя использовать несколько имен пользователей, но поддерживаются подстановочные знаки «*» и «?».

Пример:

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 для ограничения экспортируемых каталогов.

Примечание

При загрузке ограниченного экспорта XML в TreeSize вы не можете перемещаться по всей ветви каталога, а только по экспортированным каталогам.

/ZIP <имя файла>

Эта опция может использоваться только в сочетании с опцией командной строки /SEARCH.

Все файлы, которые были найдены в результате поиска файлов TreeSize, будут перемещены в zip-архив. Пример:

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

См. также: Файловые операции

<SCANPATH>

В дополнение к параметру /SCAN вы можете передать один или несколько путей в конце командной строки. Однако больше не рекомендуется передавать этот параметр, чтобы избежать ошибок при разборе командной строки.

Этот пример сканирует «Файлы программ» и папку «Windows» и создает текстовый отчет «C:\Reports\ScanResults.txt»:

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

В случае возникновения ошибки она будет возвращена в виде кода ошибки Windows в коде выхода процесса. Переменные окружения (например, %APPDATA%) могут использоваться в именах файлов для экспорта, а также в путях сканирования.

Сканирование нескольких каталогов

Если вам нужно сканировать несколько каталогов, то целесообразно объединить несколько вызовов, например, в BAT-файле:

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"

Примечание

Двойные символы процента необходимы в пакетных файлах, в командной строке используйте только одинарный процент.

Расписание запуска

Вы можете использовать запланированные задания Windows для запуска TreeSize с определенными параметрами командной строки ежедневно, еженедельно или ежемесячно в определенное время. Диалог для Запланированное сканирование поможет вам настроить запланированное задание.

Для выполнения сканирования по расписанию можно также использовать команду SCHTASKS. Например, если вы хотите просканировать диски C: и E: следующей ночью в 03:00 утра и сохранить результаты в 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 /?

Примечание

Сообщения об ошибках, возникающих во время сканирования по расписанию, заносятся в журнал событий системы Windows.

PowerShell

Windows PowerShell может быть полезен в сочетании с TreeSize. В этом примере показан поиск пары удаленных компьютеров, запрашиваемых с помощью LDAP-запроса в Активировать Каталог (AD):

$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) с помощью символа pipe, например.

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

Чтобы перенаправить вывод с помощью PowerShell, используйте команду Запуск-Process, например.

Запуск-Process -FilePath «C:\Файлы программ\JAM Software\TreeSize\Treesize.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».