Опции за команден ред¶
Изданието Professional на TreeSize приема опции от командния ред, които ви позволяват да стартирате сканиране по график или да видите резултатите от сканирането на монитора си на следващата сутрин.
Диалоговият прозорец за Планиране на сканирания ще ви помогне да съставите команден ред с опциите по-долу.
Note
Тези опции са налични само в TreeSize Professional Edition.
Всички опции¶
Treesize.exe [/OPTION] SCANPATH
/? или /HELP¶
Показва тази помощна страница.
/AGEOFFILES¶
Запазва графиката на таба „Възраст на файловете“ на сканираната директория в bitmap, GIF, PNG, JPEG, текстов или CSV файл. Типът файл зависи от разширението на зададеното име на файла. Следният пример създава JPEG изображение на графиката „Възраст на файловете“ за вашия локален диск C:
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 <име на файл>¶
Запазва диаграмата с ленти на сканираната директория в bitmap, 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.
Копира резултатите от търсене на File в целевото местоположение.
Следната команда ще извърши търсене в локалния диск 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 файл след завършване на сканирането или търсенето. Приложението ще се затвори след запазване. Този пример ще запази резултатите от търсене на File на вашия локален диск 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.
Постоянно изтрива всички файлове, които са били намерени като резултат от търсене на File с 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:\ с най-новите настройки за търсене и ще извика скрипта „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 <шаблон1;шаблон2>¶
Тази опция ви позволява да зададете шаблони за файлове и папки, които трябва да бъдат изключени от сканиране. Няколко шаблона за изключване могат да бъдат разделени с точка и запетая (;). Ако един или повече от шаблоните съдържат интервали, целият низ от шаблони трябва да се постави в кавички („). Следващият пример ще игнорира файлове и папки, които завършват с „.tmp“ или в които точното име е „system“:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <ниво|размер>¶
Тази опция ви позволява да зададете колко нива в дървото на директориите ще бъдат разширени след сканиране. Ако не посочите число след тази опция, всички папки ще бъдат разширени. Вместо ниво на директорията можете да посочите и количество в мегабайти (MB). В този случай всички папки, по-големи от посоченото количество, ще бъдат разширени. Единицата „MB“ трябва да следва числото без празно място. Следващият пример ще сканира папката „H:\User“, ще разшири всички папки, по-големи от 10 MB, и ще запише резултата във файла 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 ¶
Може да се използва за промяна на заглавието в отпечатан доклад или експортиран файл. Това ви позволява да предоставите допълнителна информация на потребителя, когато използвате TreeSize в автоматизирана среда. Позволено е и използването на променливи на средата. Пример:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <име на файл>¶
Тази опция ви дава възможност да запишете статистиката за файловите разширения/типове файлове на сканирания клон на файловата система в Excel, HTML, Text или CSV файл. Типът на файла зависи от разширението на посоченото име на файла. Експортираните колони ще бъдат тези, които са били разрешени в потребителския интерфейс в раздела „Разширения“, когато е бил използван за последен път, или по времето, когато е бил записан конфигурационният файл, предоставен чрез /OPTIONS.
Следващият пример сканира устройство 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 файлове в директорията „Users“ на сървъра:
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 MB:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <име на файл>¶
Запазва графиката на таба „История“ на сканираната директория в bitmap, 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 <отделителен символ>¶
Позволява ви да определите разделителя, използван при експортиране на текстови или 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. Потребителските настройки могат да бъдат експортирани от „File > Options > Export“. Пример:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Note
Променете колкото се може повече настройки в потребителския интерфейс, преди да запазите опциите, за да намалите броя на параметрите на командния ред, от които се нуждаете.
/PDF¶
Записва резултатите в PDF файл след завършване на сканирането или търсенето. Приложението ще се затвори след запазване. Следният пример ще извърши сканиране на локалния ви диск C: и ще запази резултатите в PDF файл:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <име на файл>¶
Записва диаграмата на секторите на сканираната директория в bitmap, 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“ с един от пътищата, моля, намерете пример по-долу.
/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 <format>¶
Променя формата на кратката дата за този процес, който може да бъде конфигуриран в регионалните опции на контролния панел на 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 <Име на колона>¶
Позволява ви да посочите по коя стойност ще се сортират генерираните експорти. Възможните стойности са имена на колони като „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 <име на файл>¶
Тази опция ви позволява да запазите съдържанието на списъка с топ файлове в Excel, HTML, текстов или CSV файл. Типът файл зависи от разширението на зададеното име на файл. Пример:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <име на файл>¶
Записва диаграмата на дървото на директориите, която е сканирана, като bitmap, GIF, PNG или JPEG файл. Типът файл зависи от разширението на зададеното име на файл. Пример:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Задава нивото на потребителския интерфейс. Възможните стойности са Simple, Normal или Expert. Пример:
Treesize /UILevel "Simple"
/USERSLIST <име на файл>¶
Тази опция ви позволява да запазите статистиката, показваща резултатите, групирани по потребителско име, в Excel, HTML, текстов или CSV файл. Типът файл зависи от разширението на зададеното име на файл. Експортираните колони ще бъдат тези, които са били активирани в потребителския интерфейс на таба „Потребители“, когато е бил използван за последен път, или в момента, когато конфигурационният файл, предоставен чрез /OPTIONS, е бил написан.
Следващият пример сканира устройство C: и създава Excel файл в „C:\Temp“ със статистиката на потребителите на това устройство:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <име на потребителя>¶
Посочва потребителското име, което трябва да се използва за удостоверяване на сканирането. Използвайте /PASSWORD, за да зададете парола за това потребителско име. Препоръчва се вместо това да се използва инструментът на Microsoft RUNAS.
/USERFILTER <име на потребителя>¶
С тази опция ще бъдат взети предвид само файловете, притежавани от определен потребител, при сканирането. Посочете името на този потребител след този превключвател.
Note
Не можете да използвате множество потребителски имена тук, но се поддържат символите за замяна „*“ и „?“.
Пример:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <име на файл>¶
Записва малката диаграма, показана в долната част на страницата „Потребители“, в изображение (bitmap, GIF, PNG или JPEG).
/USERSPIECHART <име на файл>¶
Записва диаграма с пай, която показва „потребителската статистика“ на текущото сканиране в изображение (bitmap, 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:\Reports\ScanResults.txt“:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
В случай че възникне грешка, тя ще бъде върната като код на грешка на Windows в изходния код на процеса. Променливи на средата (например %APPDATA%) могат да се използват в имената на файловете за експортиране, както и в сканираните пътища.
Сканиране на множество директории¶
Ако трябва да сканирате множество директории, може да е добра идея да обедините няколко извиквания в Batch файл, например:
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“ осигурява, че задачите стартират последователно. Не стартирането на задачите паралелно обикновено е по-добро, тъй като една единствена задача извлича повече ползи от кешовете и системните ресурси. Също така е възможно да се съхраняват споделянето, които трябва да бъдат сканирани, в текстов файл и да се използва командата „for“ на Windows по следния начин:
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
Двойните проценти са задължителни в batch файлове, в командния ред използвайте само един процент.
Планирано стартиране¶
Можете да използвате Планирани задачи на 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 /?
Note
Съобщенията за грешки, които възникват по време на планирани сканирания, са изброени в системния журнал на Windows.
PowerShell¶
Windows PowerShell може да бъде полезен в комбинация с TreeSize. Този пример показва как да се търси в няколко отдалечени компютъра, които са търсени чрез LDAP заявка в Active Directory (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), използвайки символа за тръба, напр.
"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 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 error code като код за изход, ако е наличен, или 1, за да посочи обща грешка.
Във всеки случай Windows Event Log ще съдържа допълнителна информация в логовете на „Приложението“, Източник на събития „TreeSize“.