Možnosti príkazového riadka¶
Verzia Professional Edition aplikácie TreeSize prijíma možnosti príkazového riadka, ktoré vám umožnia spúšťať plánované skenovanie alebo zobrazovať výsledky skenovania na monitore na druhý deň ráno.
Dialógové okno pre Plánovanie skenovania vám pomôže zostaviť príkazový riadok s nižšie uvedenými možnosťami.
Poznámka
Tieto možnosti sú k dispozícii len v TreeSize Professional Edition.
Všetky možnosti¶
Treesize.exe [/OPTION] SCANPATH
/? /HELP¶
Zobrazí túto stránku nápovedy.
/AGEOFFILES¶
Uloží graf na karte „Vek súborov“ v naskenovanom adresári do bitmapového, GIF, PNG, JPEG, textového alebo CSV súboru. Typ súboru závisí od prípony zadaného názvu súboru. Nasledujúci príklad vytvorí súborový obraz JPEG grafu „Vek Súborov“ pre miestnu jednotku C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <hodnota>¶
Pomocou tejto možnosti môžete vybrať, či má alebo nemá program TreeSize pri exporte pripojiť svoj výstup k existujúcim súborom, napr. pri použití stránky /TEXT. Vyberte „True“ na pripojenie a „False“, ak chcete prepísať existujúce súbory.
Poznámka
Tento parameter nebude fungovať pri exportovaných obrázkoch, súboroch XML a PDF. Tieto súbory budú vždy prepísané. Môžete použiť prepínač /DATE, aby ste zabezpečili, že všetky vygenerované reporty budú mať jedinečný názov súboru.
Pri exporte do súboru Excel prostredníctvom stránky /EXCEL možno tento parameter použiť spolu so stránkou /SHEETNAME na pripojenie údajov k zadanému listu. Príklad:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Táto možnosť zahrnie iba Súbory, pre ktoré je v prehľadávaní nastavený bit archívu. Táto možnosť môže byť veľmi užitočná, ak chcete vypočítať veľkosť zálohy. V takom prípade môžete na pracovnej ploche alebo v ponuke Štart vytvoriť zástupcu, ktorý automaticky spustí výpočet veľkosti zálohy. Príklad: V prípade, že chcete vytvoriť záložnú kópiu zálohy, môžete ju vytvoriť tak, že ju vložíte do záložnej kópie:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Ak je zadané, všetky exportované Súbory budú pripojené k e-mailu. Ak nie je zadané, Súbory s explicitne zadanou cestou sa nepripoja. To je užitočné v prípade, že vaše súbory XML alebo Excel sú dosť veľké a zaplnia vaše e-mailové konto.
Tento príklad umožní Export do súboru Excel, ale nepripojí ho k pošte:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
V týchto príkladoch sa k e-mailu pripojí súbor 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 <názov súboru>¶
Uloží graf naskenovaného adresára do bitovej mapy, formátu GIF, PNG alebo JPEG. Typ súboru závisí od prípony zadaného názvu súboru. Tento príklad vytvorí súbor PNG Graf pre miestnu jednotku C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <MENO súboru|cesta>¶
Porovná skenovanú cestu s uloženým indexovým súborom. Nasledujúci príklad skenuje jednotku C: a porovnáva výsledok s uloženou XML reportom pre túto jednotku:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
Namiesto indexového súboru môžete použiť aj cestu s týmto parametrom príkazového riadka. Zadaná cesta sa porovná s aktuálnym výsledkom skenovania. Nasledujúci príklad prehľadáva jednotku C:\ a navyše používa cestu D:Backup_of_C na vykonanie porovnania medzi nimi:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Prípadne môžete porovnať dva už existujúce indexové súbory, napr. „c1.xml.zip“ a „c2.xml.zip“ pomocou tohto príkazu :
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
Príkaz /OPEN pripraví porovnanie týchto dvoch súborov tak, že prvý súbor („c1.xml.zip“) rozšíri na súbor skenovania. Druhý súbor („c2.xml.zip“) sa porovná s týmto rozšíreným skenovacím súborom, rovnako ako by sa to stalo, keby sa súbor „c2.xml.zip“ porovnal so „skutočným“ skenovacím súborom.
/COPY <CESTA>¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Skopíruje výsledky vyhľadávania súborov TreeSize do cieľového umiestnenia.
Nasledujúci príkaz vyhľadá na vašom lokálnom disku C: s použitím najnovších možností vyhľadávania a skopíruje výsledky vyhľadávania do adresára „C:\temp\ObsoleteFiles“:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Pozri tiež: Presunutie skontrolovaných súborov
/CREATEDPASTDAYSONLY <n>¶
Táto možnosť zahrnie do skenovania iba Súbory, ktoré boli vytvorené počas počtu dní zadaného v argumente. V nasledujúcom príklade táto možnosť zahrnie do skenovania len Súbory vytvorené počas posledných ôsmich dní:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <drive>¶
Vytvorí snímku pre jednotky, ktoré sú zadané za týmto parametrom príkazového riadka. Príklad:
Treesize /CREATESNAPSHOT "C:\" "D:\"
Vytváranie snímok môže vyžadovať administrátorské oprávnenia.
/CSV <názov súboru>¶
Po skončení skenovania alebo vyhľadávania uloží výsledky do súboru CSV. Aplikácia sa po uložení ukončí. Tento príklad uloží výsledky vyhľadávania súborov na miestnej jednotke C: s poslednými konfiguráciami vyhľadávania do súboru CSV:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Tento prepínač pridá aktuálny dátum a čas do všetkých názvov exportných súborov v príkazovom riadku. Je to užitočné, ak chcete skenovanie vykonávať pravidelne, napr. každý večer alebo každý víkend. Nasledujúci príklad skontroluje sieťovú cestu „\\Host\Share“ a výsledok uloží do súboru typu „C:\Scansame_2013-08-14_17-18-24.xls“:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Nahradí duplicitné súbory, ktoré boli nájdené pomocou vyhľadávania duplicitných súborov v systéme TreeSize, pevnými odkazmi NTFS:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Trvalo odstráni všetky súbory, ktoré boli nájdené ako výsledok vyhľadávania súborov v systéme TreeSize. Príklad:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Pozri tiež: Presunutie skontrolovaných súborov
/EMAIL <príjemca>¶
Odošle zozbierané údaje na zadanú e-mailovú adresu. Tento parameter možno v príkazovom riadku použiť len raz a odošle sa len jeden e-mail so všetkými výsledkami. Viacero príjemcov možno oddeliť stredníkmi (;) alebo čiarkami. Ak chcete odoslať e-maily prostredníctvom príkazového riadka, musíte zadať platné nastavenia SMTP na príslušnej stránke v dialógovom okne možností TreeSize. Príklad:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Ak neboli zadané žiadne iné parametre, e-mail sa odošle vo formáte nastavenom v možnostiach (HTML alebo obyčajný text). Ak chcete definovať formát nezávisle od aktuálnych možností, môžete použiť parametre /TEXT alebo /HTML hneď za definíciou adresy (adries) príjemcu. Príklad:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Kombináciou parametrov môžete do e-mailu pridať aj prílohy. Nasledujúci príklad pridá do e-mailu ako prílohu report o skenovaní vo formáte Excel:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Túto možnosť možno použiť len v kombinácii s možnosťami príkazového riadka /SEARCH a /EMAIL. Ak je tento parameter zadaný, program TreeSize odošle e-mail s aktuálnymi výsledkami vyhľadávania len vtedy, ak sa počas vyhľadávania našiel aspoň jeden súbor alebo priečinok podľa niektorého zo zadaných typov vyhľadávania.
/EMPTYRECYCLEBIN¶
Ak použijete túto možnosť, program TreeSize pred spustením aktuálneho skenovania vyprázdni kôš. Príklad:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Tento parameter umožňuje odovzdať súbory, ktoré boli nájdené pomocou vyhľadávania súborov v TreeSize, inej aplikácii alebo skriptu. Možným cieľom pre tento parameter môže byť dávka alebo skript prostredia powershell. Nasledujúci príklad prehľadá jednotku C:\ s najnovšími nastaveniami vyhľadávania a zavolá skript „Archive.bat“ pre každý nájdený súbor. Súbor sa odovzdá skriptu ako parameter príkazového riadka:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Pozri tiež: Presunutie skontrolovaných súborov
/EXCEL <cesta k súboru>¶
Exportuje zozbierané údaje vo formáte Microsoft Excel a uloží ich pod zadanou cestou k súboru. Ak je zadaný len názov súboru, na uloženie exportu sa použije aktuálny inštalačný adresár. Podporované formáty sú bežný formát súboru .XLS (Excel 97-2003), ako aj formát .XLSX (zavedený v programe Excel 2007). Použitý formát závisí od prípony zadaného názvu súboru. Aplikácia sa po uložení ukončí. Príklad:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Ak názov súboru už existuje, súbor sa otvorí a pridá sa nový pracovný hárok.
Poznámka
Na stránke TreeSize File Search (/SEARCH) sú výsledky každého typu vyhľadávania zhromaždené v osobitnom pracovnom hárku. Ak súbor pod danou cestou už existuje, tieto hárky sa prepíšu. Ak tomu chcete zabrániť, musíte použiť voľbu príkazového riadka /APPENDTOFILES.
/EXCLUDE <vzor1;vzor2>¶
Táto možnosť umožňuje určiť vzory súborov a adresárov, ktoré by mali byť vylúčené z kontroly. Viacero vzorov vylúčenia možno oddeliť pomocou stredníka (;). Ak jeden alebo viacero vzorov obsahuje medzery, celý reťazec vzorov sa musí uviesť do úvodzoviek („). Nasledujúci príklad bude ignorovať súbory a adresáre, ktoré končia na „.tmp“ alebo ktorých presný názov je „system“:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <úroveň|veľkosť>¶
Táto možnosť umožňuje určiť, koľko úrovní v adresárovom strome sa po skenovaní rozšíri. Ak za touto voľbou nezadáte číslo, budú rozšírené všetky adresáre. Namiesto úrovne adresára môžete uviesť aj množstvo v megabajtoch (MB). V tomto prípade sa rozšíria všetky adresáre väčšie ako zadané množstvo. Za číslom musí nasledovať jednotka „MB“ bez medzery. Nasledujúci príklad skontroluje priečinok „H:\Používateľ“, rozšíri všetky priečinky väčšie ako 10 MB a výsledok uloží do súboru Excel „C:\Results\Allusers.xlsx“:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <hodnota>¶
Ak sa použije táto možnosť, pri exporte do programu Excel sa použijú rozbaliteľné/skladateľné skupiny, v ktorých sa dá pohybovať podobne ako v adresárovom strome.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <názov súboru>¶
Táto možnosť umožňuje exportovať obsah „Zoznamu jednotiek“ do súboru Excel, Text alebo CSV. Typ súboru závisí od prípony zadaného názvu súboru. Príklad:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Ak je zadané, súbory budú zahrnuté do všetkých exportov. Táto možnosť je teda ekvivalentná aktivácii možnosti „Nástroje > Možnosti > Export > * > Exportované prvky > Adresáre a jednotlivé súbory“.
/EXPORTGROUPSEXPANDED¶
Ak je zadané, Export zoznamu rozšírení bude obsahovať všetky informácie o rozšíreniach obsiahnutých v skupinách.
/EXPORTPATHSLIST <názov súboru>¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Exportuje jednoduchý zoznam, ktorý obsahuje všetky výsledky vyhľadávania. Zoznam bude obsahovať iba úplné cesty k výsledkom vyhľadávania a žiadne ďalšie informácie. Podporované formáty cieľového súboru sú .txt a .csv.
Tento príklad vyhľadá a vytvorí zoznam všetkých súborov exe na jednotke C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Možno ho použiť na import výsledkov predchádzajúceho vyhľadávania späť do používateľského rozhrania pomocou funkcie „File > List of paths > Import Path List“ alebo parametra /IMPORT.
Ak je aktivovaná možnosť „Nástroje > Možnosti > Export > Zahrnúť duplicitné skupiny“, môžete túto funkciu použiť aj na export a import výsledkov duplicitného vyhľadávania vrátane ich skupinovej štruktúry.
/EXPORTTITLE ¶
Môže sa použiť na zmenu názvu v rámci vytlačenej reportu alebo exportovaného súboru. To umožňuje poskytnúť používateľovi dodatočné informácie pri používaní systému TreeSize v automatizovanom prostredí. Povolené je aj použitie premenných prostredia. Príklad:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <názov súboru>¶
Táto možnosť umožňuje uložiť štatistiky o príponách súborov/typoch súborov skenovanej vetvy súborového systému do súboru Excel, HTML, Text alebo CSV. Typ súboru závisí od prípony zadaného názvu súboru. Exportované budú stĺpce, ktoré boli povolené v rozhraní používateľa na karte „Prípony“ (Prípony) pri jeho poslednom použití alebo v čase zápisu konfiguračného súboru dodaného prostredníctvom /OPTIONS (Možnosti).
Nasledujúci príklad skenuje disk C: a vytvorí súbor programu Excel s názvom „D:\TreeSize Reports\C_filetypes.xls“ so štatistikami typov súborov na tomto disku:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <názov súboru>¶
Uloží malý graf zobrazený v dolnej časti stránky „Prípony“ do obrazového súboru (bitová mapa, GIF, PNG alebo JPEG).
/EXTENSIONSPIECHART <názov súboru>¶
Uloží koláčový diagram, ktorý zobrazuje rozdelenie „prípon súborov“ do obrazového súboru (bitová mapa, GIF, PNG alebo JPEG).
/FILTER <vzor1;vzor2>¶
Nastaví filter súborov, ktorý počíta iba súbory s určitými príponami, napr. „.mp3“ alebo „.doc“. Možno odovzdať viacero vzorov oddelených bodkočiarkou (;). Nasledujúci príklad vyhľadá súbory MP3 a AVI v adresári „Používatelia“ na serveri:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Pri vyhľadávaní súborov TreeSize (/SEARCH) môžete použiť aj prepínač príkazového riadka /FILTER na určenie vzorov rozšíreného vyhľadávania súborov. Ak chcete vykonať zložitejšie vlastné vyhľadávanie súborov, mali by ste možnosti vyhľadávania uložiť do súboru a výsledný súbor XML odovzdať do príkazového riadka po adrese /SEARCH.
/FOLLOWREPARSEPOINTS¶
Ak je tento prepínač pridaný do príkazového riadka, program TreeSize bude pri skenovaní stromu súborového systému sledovať prípojné body a externé symbolické odkazy.
/GROUPSCANS¶
Použitím tohto prepínača príkazového riadka sa všetky skenované adresáre zoskupia do virtuálneho adresára. Ak chcete zabezpečiť, aby sa nepoužíval žiadny virtuálny koreňový priečinok, použite adresu /GROUPSCANS FALSE.
/HIDESMALLFOLDERS <hodnota>¶
Umožňuje skryť objekty, ktoré sú menšie ako minimálna veľkosť, čo je užitočné na získanie prehľadného exportu. <HODNOTA> môže byť hodnota veľkosti s jednotkou alebo obyčajná hodnota bajtu bez jednotky. Nemožno použiť v kombinácii s /EXPAND. V tomto príklade sa budú exportovať len adresáre s minimálnou veľkosťou 50 MB:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <názov súboru>¶
Uloží graf na karte „História“ v naskenovanom adresári do bitovej mapy, formátu GIF, PNG alebo JPEG. Typ súboru závisí od prípony zadaného názvu súboru. Tento príklad vytvorí obrázok JPEG grafu Histórie pre jednotku C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <názov súboru>¶
Uloží zozbierané údaje do súboru HTML, ktorý možno zobraziť pomocou ľubovoľného prehliadača HTML. Prostredníctvom položky „Domov > Možnosti > Export > HTML > Grafy a zoznamy, ktoré sa majú zahrnúť“ môžete určiť, ktoré informácie o skenovaní budú zahrnuté do exportu. Môžete vybrať, ktoré z ďalších zoznamov alebo grafov sa majú pridať do exportu. Budú automaticky vložené do súboru HTML, ktorý sa vytvorí po skenovaní.
Nasledujúci príklad vygeneruje report HTML pre jednotku C: a uloží ho do „D:\HTML“:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Ak chcete, aby súčasťou súboru HTML bolo viac ako jedno skenovanie, mali by ste pridať prepínač príkazového riadka /GROUPSCANS. Pri exporte do HTML bez zahrnutého obrázka môžete alternatívne použiť prepínač /APPENDTOFILES. Bez jedného z týchto príznakov sa súbor HTML prepíše.
/IMPORT <názov súboru>¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Načíta zoznam ciest do používateľského rozhrania vyhľadávania súborov TreeSize. Súbor môže byť vo formáte .txt alebo .csv. Tento parameter možno použiť na import výsledkov predchádzajúceho vyhľadávania. Importované súbory a adresáre je možné presunúť/kopírovať/vymazať/archivovať, ako každý „živý“ výsledok vyhľadávania, pomocou dialógového okna operácie so súbormi.
Príklad:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Tento parameter môžete tiež kombinovať s parametrami /RECYCLE, /DELETE alebo /MOVE, aby ste automaticky vymazali alebo presunuli súbory, ktoré sú obsiahnuté v textovom súbore. Príklad:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <názov súboru>¶
Importuje zoznam vzorov zo súboru File. File môže byť jednoduchý textový súbor so zoznamom filtrovacích vzorov oddelených bodkočiarkou alebo môžete pomocou používateľského rozhrania vytvoriť zložitejší súbor vzorov a pomocou funkcie Exportu vygenerovať súbor vzorov vo formáte XML. Podporované formáty sú CSV, TXT a XML.
Importované vzory sa použijú ako filtre na kontrolu, ktoré buď zahrnú, alebo vylúčia konkrétne súbory a adresáre.
Ak sa tento parameter použije v kombinácii s možnosťou príkazového riadka /SEARCH, vytvorí sa nové rozšírené vyhľadávanie, ktoré ako kritériá vyhľadávania použije vzory z importovaného súboru.
Tento príklad importuje vzory filtrov, ktoré sú definované v súbore „C:\TreeSizeFiles\patterns.txt“, spustí kontrolu jednotky C:\ a exportuje výsledky do súboru HTML:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <názov súboru>¶
Uloží výsledky skenovania do súboru SQLite, ktorý možno načítať na neskoršie porovnanie. Príklad:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <oddeľovací znak>¶
Umožňuje definovať oddeľovač použitý pri exporte textových súborov alebo súborov CSV. Pri súboroch sa predvolene používa oddeľovač tabulátora, pri súboroch CSV oddeľovač zoznamu z regionálnych nastavení ovládacieho panela systému Windows.
Za týmto prepínačom zadajte jeden znak alebo reťazec „TAB“ pre tabulátor. Príklady:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <CESTA>¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Presunie výsledky vyhľadávania v súbore TreeSize na iné miesto.
Nasledujúci príkaz vyhľadá na vašom lokálnom disku C: s použitím najnovších možností vyhľadávania a presunie výsledky vyhľadávania do adresára „C:\Temp\ObsoleteFiles“:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Pozri tiež: Presunutie skontrolovaných súborov
/NOGUI¶
Nezobrazí sa žiadne okno a aplikácia sa nezobrazí na paneli úloh. Užitočné na vykonávanie skenovania alebo vyhľadávania na pozadí bez vizuálnej spätnej väzby.
Varovanie
Tento prepínač použite len vtedy, ak ste otestovali ostatné možnosti príkazového riadka, pretože v tomto režime nie je možné zobraziť chybové hlásenia.
Chyby sa však zaznamenajú do protokolu udalostí systému Windows.
/NOHEADERS¶
Vynechá riadky záhlavia, ktoré sa zvyčajne píšu na začiatku skenovacích alebo vyhľadávacích exportných súborov. To uľahčuje prijímanie jednoduchých údajov na následné spracovanie.
/NOUNITS¶
Vynecháva jednotky, ktoré sa zvyčajne zapisujú za hodnoty veľkosti. Táto možnosť v kombinácii s /SIZEUNIT 0 vyexportuje obyčajné bajtové hodnoty. Uľahčuje to prijímanie jednoduchých údajov na následné spracovanie.
Poznámka
Tento príkazový riadok ovplyvní iba export adresárového stromu, ktorý bol vytvorený pomocou možností /TEXT, /EXCEL, /HTML, /EMAIL alebo /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST alebo /TOPFILESLIST nebudú ovplyvnené.
/OPEN <názov súboru>¶
Otvorí uložený report XML pri spustení aplikácie. Príklad:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <názov súboru>¶
Tento parameter použite na použitie exportovaných nastavení používateľov pre TreeSize. Používateľské nastavenia môžete exportovať v ponuke „File > Options > Export“. Príklad:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Poznámka
Pred uložením možností zmeňte čo najviac nastavení v používateľskom rozhraní, aby ste znížili počet potrebných parametrov príkazového riadka.
/PDF¶
Po skončení skenovania alebo vyhľadávania uloží výsledky do súboru PDF. Aplikácia sa po uložení ukončí. Nasledujúci príklad vykoná skenovanie lokálneho disku C: a výsledky uloží do súboru PDF:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <názov súboru>¶
Uloží koláčový graf naskenovaného adresára do bitovej mapy, formátu GIF, PNG alebo JPEG. Typ súboru závisí od prípony zadaného názvu súboru. Nasledujúci príklad naskenuje jednotku C: a vyexportuje koláčový graf vo formáte PNG:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Vytlačí report pre naskenovaný strom adresárov pomocou predvolenej tlačiarne nakonfigurovanej v nastaveniach systému. Po vytlačení sa aplikácia ukončí. Príklad:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <hodnota>¶
Ak je hodnota nastavená na true, táto možnosť aktivuje režim len na čítanie, v ktorom sú operácie so súbormi (napr. presun alebo vymazanie) zakázané, takže sa bude dať používať len ako nástroj na reportovanie.
Ak chcete režim len na čítanie opäť deaktivovať, zadajte hodnotu false.
/RECYCLE¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Presunie všetky súbory do koša, ktoré boli nájdené ako výsledok vyhľadávania súborov v systéme TreeSize. Príklad:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Pozri tiež: Presunutie skontrolovaných súborov
/RESTRICTEDMODE <hodnota>¶
Ak je hodnota nastavená na true, táto možnosť aktivuje obmedzený režim, v ktorom sú zakázané mnohé funkcie, ktoré nie sú zaujímavé pre „normálnych“ používateľov (bez administrátora). Medzi zakázané funkcie patria: Kontrola aktualizácií, Otvoriť applet Softvér v Ovládacom paneli systému Windows, Naplánovať skenovanie TreeSize, Pripojiť sieťovú jednotku, Konfigurácia obnovy systému Windows, Spustiť ako správca, Export a Aplikovať kompresiu NTFS. Cestu, ktorá sa má skontrolovať, napr. domovský adresár používateľa, môžete zadať v príkazovom riadku alebo pomocou položky Startup Paths v uloženom konfiguračnom súbore.
Ak chcete obmedzený režim opäť deaktivovať, zadajte hodnotu false.
Ak dodatočne aktivujete možnosť /READONLYMODE, používateľ nebude môcť odstraňovať ani presúvať súbory v programe TreeSize, takže ho bude možné používať len ako nástroj na vytváranie reportov.
/SCAN <CESTA|názov súboru>¶
Definuje, ktorá jednotka alebo cesta sa má skenovať. Ako hodnota tohto parametra by sa mala použiť skenovaná cesta.
Ak sa má skenovať napríklad jednotka D:\, môžete použiť:
Treesize /SCAN "D:\"
Ak nechcete skenovať celú jednotku, môžete zadať aj cestu, ktorá sa použije ako východiskový bod pre skenovanie. Napríklad:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Je možné použiť aj viacero ciest skenovania, ktoré sú oddelené prázdnym miestom. Cesty, ktoré obsahujú prázdne miesto, sa musia uviesť v úvodzovkách („). Príklad:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Zástupné znaky „*“ a „?“ sú povolené. Príklad:
Treesize /SCAN "H:\users\A*"
Môžete tiež zadať textový súbor, ktorý obsahuje zoznam ciest, ktoré sa majú skenovať. TreeSize prehľadá všetky cesty, ktoré sa nachádzajú v textovom súbore, ktorý je zadaný za týmto prepínačom. Textový súbor musí obsahovať jednu cestu na riadok. Nasledujúci príklad skenuje všetky cesty, ktoré sa nachádzajú v súbore „D:\PathsToScan.txt“, a každý výsledok skenovania zapíše do samostatného listu v súbore Excel s dnešným dátumom:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Funkciu TreeSize môžete zavolať aj v cykle „for“ len s jednou z ciest, príklad nájdete nižšie.
/SEARCH¶
Otvorí okno Vyhľadávanie súborov programu TreeSize. Ak je k tejto možnosti príkazového riadka pridaná adresa „:Start“, vyhľadávanie sa spustí automaticky. Môže sa odovzdať predtým uložený súbor XML obsahujúci nastavenia vyhľadávania, tieto nastavenia sa potom použijú na vykonanie vyhľadávania.
Poznámka
File nájdené pri tomto vyhľadávaní sa automaticky skontrolujú.
Nasledujúci príklad vykoná vyhľadávanie s nastaveniami, ktoré boli predtým uložené do súboru „SearchSettings.xml“, a výsledky uloží do textového súboru:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Poznámka
Vo všeobecnosti sa použijú posledné nastavenia vyhľadávania alebo predchádzajúca uložená sada nastavení vyhľadávania. Vzory vyhľadávania pre rozšírené vyhľadávanie však môžete určiť aj pomocou voľby príkazového riadka /FILTER.
/SHEETNAME ¶
Umožňuje zadať názov hárku, ktorý sa pridá do súboru Excel pri použití prepínača príkazového riadka /EXCEL.
Poznámka
Názov hárku programu Excel musí byť v súbore Excel jedinečný a niektoré špeciálne znaky, ako sú lomítka, spätné lomítka a dvojbodky, sú zakázané. Program TreeSize vždy vytvorí jedinečný názov hárku nahradením neplatného znaku podčiarkovníkom a v prípade potreby pridaním dátumu a času. Ak v cieľovom súbore už existuje hárok so zadaným názvom, vytvorí sa nový hárok s jedinečným názvom. Na pripojenie údajov k existujúcemu listu použite voľbu príkazového riadka /APPENDTOFILES.
/SHORTDATEFORMAT <formát>¶
Mení krátky formát dátumu pre tento proces, ktorý možno nakonfigurovať v regionálnych možnostiach Ovládacieho panela systému Windows. Pri exporte programu TreeSize sa bude pre hodnoty dátumu používať tento formát. Príklad:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Túto možnosť možno použiť na určenie jednotky, ktorá sa má použiť na zobrazenie hodnôt veľkosti: N môže mať hodnoty 0 až 5, čo znamená: 0 = bajty, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = automatické jednotky. Bez tejto možnosti sa použije posledná použitá konfigurácia v TreeSize.
/SORTBY <Názov stĺpca>¶
Umožňuje určiť, podľa ktorej hodnoty sa budú triediť vygenerované exporty. Možné hodnoty sú názvy stĺpcov ako „Size“ alebo „Name“. Predvolene sa použije posledný použitý typ triedenia v používateľskom rozhraní TreeSize. Príklad:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <názov súboru>¶
Uloží výsledky skenovania do súboru SQLite, ktorý možno načítať na neskoršie porovnanie. Príklad:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <predmet>¶
Táto možnosť umožňuje prispôsobiť predmet, ktorý sa použije pre e-maily odoslané na konci skenovania. Príklad:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <názov súboru>¶
Po skončení skenovania alebo vyhľadávania uloží výsledky do textového súboru alebo súboru CSV. Aplikácia sa po uložení ukončí. Nasledujúci príklad vykoná skenovanie miestnej jednotky C: a výsledky uloží do textového súboru:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
Textový formát používa tabuľkový formát zameraný na čitateľov. Ak názov súboru odkazuje na súbor CSV, automaticky sa použije formát CSV. Ak chcete explicitne použiť formát CSV, odporúčame použiť parameter /CSV.
/TITLE <title>¶
Môže sa použiť na nahradenie koreňovej cesty skenovania vlastným textom. To umožňuje napríklad poskytnúť zmysluplnejšie názvy ciest UNC, a tým zvýšiť čitateľnosť reportu. Zvolený názov sa použije ako názov reportu pri exporte súboru. Príklad:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
V kontexte vyhľadávania súborov TreeSize možno tento parameter použiť na pomenovanie rozšíreného vyhľadávania. Príklad:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <názov súboru>¶
Táto možnosť umožňuje uložiť obsah zoznamu Top súbory do súboru Excel, HTML, Text alebo CSV. Typ súboru závisí od prípony zadaného názvu súboru. Príklad:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <názov súboru>¶
Uloží Mapa stromu naskenovaného stromu adresárov ako bitmapu, súbor GIF, PNG alebo JPEG. Typ súboru závisí od prípony zadaného názvu súboru. Príklad:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Nastavuje úroveň používateľského rozhrania. Možné hodnoty sú Simple, Normal alebo Expert. Príklad:
Treesize /UILevel "Simple"
/USERSLIST <názov súboru>¶
Táto možnosť umožňuje uložiť štatistiky zobrazujúce výsledky zoskupené podľa používateľského mena do súboru Excel, HTML, Text alebo CSV. Typ súboru závisí od prípony zadaného názvu súboru. Exportované budú stĺpce, ktoré boli povolené v používateľskom rozhraní na karte Používatelia pri jeho poslednom použití alebo v čase zápisu konfiguračného súboru dodaného prostredníctvom /OPTIONS.
Nasledujúci príklad skenuje disk C: a vytvorí súbor Excel v „C:\Temp“ so štatistikami používateľov na tomto disku:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <užívateľské meno>¶
Určuje používateľské meno, ktoré sa má použiť na overovanie pri skenovaní. Na zadanie hesla pre toto používateľské meno použite adresu /PASSWORD. Namiesto toho sa odporúča použiť nástroj spoločnosti Microsoft RUNAS.
/USERFILTER <užívateľské meno>¶
Pomocou tejto možnosti sa pri skenovaní budú brať do úvahy len súbory, ktoré vlastní určitý používateľ. Po tomto prepínači uveďte meno tohto používateľa.
Poznámka
Nemôžete tu použiť viacero používateľských mien, ale sú podporované zástupné znaky „*“ a „?“.
Príklad:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <názov súboru>¶
Uloží malý graf zobrazený v dolnej časti stránky „Používatelia“ do súboru (bitová mapa, GIF, PNG alebo JPEG).
/USERSPIECHART <názov súboru>¶
Uloží koláčový graf, ktorý zobrazuje „Používateľské štatistiky“ aktuálneho skenovania, do súboru (bitová mapa, GIF, PNG alebo JPEG).
/VIEWTYPE n¶
Definuje, na akých hodnotách sú založené stĺpce „Percento rodiča“, „Rast“ a graf „Vek súborov“. Možné hodnoty sú:
2: Veľkosť 3: 7: Počet súborov Alokované
/XML <názov súboru>¶
Uloží výsledky skenovania do súboru XML, ktorý možno načítať na neskoršie porovnanie. Príklad:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Túto možnosť možno kombinovať s prepínačom /EXPAND na obmedzenie exportovaných adresárov.
Poznámka
Pri načítaní obmedzeného exportu XML do systému TreeSize nemôžete prechádzať cez celú vetvu adresárov, ale iba cez exportované adresáre.
/ZIP <názov súboru>¶
Túto možnosť možno použiť len v kombinácii s možnosťou príkazového riadka /SEARCH.
Všetky Súbory, ktoré boli nájdené ako výsledok vyhľadávania súborov TreeSize, sa presunú do archívu zip. Príklad:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Pozri tiež: Presunutie skontrolovaných súborov
<SCANPATH>¶
Okrem parametra /SCAN, môžete na konci príkazového riadku odovzdať aj jednu alebo viac ciest. To sa však už neodporúča, aby sa predišlo chybám pri analyzovaní príkazového riadka.
Tento príklad skenuje priečinok „Program Files“ a priečinok „Windows“ a vytvorí textovú report v priečinku „C:\Reports\ScanResults.txt“:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
V prípade výskytu chyby sa táto chyba vráti ako kód chyby systému Windows v kóde ukončenia procesu. Premenné prostredia (napr. %APPDATA%) možno použiť V názvoch súborov pre export, ako aj v skenovaných cestách.
Skenovanie viacerých adresárov¶
Ak potrebujete skenovať viacero adresárov, môže byť dobré zlúčiť niekoľko volaní napríklad do dávkového súboru:
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"
Príkaz „START /WAIT“ zabezpečuje postupné spúšťanie úloh. Nespúšťanie úloh paralelne je zvyčajne lepšie, pretože jedna úloha viac využíva vyrovnávaciu pamäť a systémové zdroje. Je tiež možné uložiť akcie, ktoré sa majú skenovať, do súboru File a použiť príkaz „for“ systému Windows takto:
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"
Poznámka
V súboroch sa vyžadujú dvojité znaky percent, v príkazovom riadku používajte len jedno percento.
Plánovaný začiatok¶
Pomocou naplánovaných úloh systému Windows môžete program TreeSize spúšťať s určitými možnosťami príkazového riadka denne, týždenne alebo mesačne v určitom čase. Dialógové okno pre Plánovanie skenovania vám pomôže nastaviť naplánovanú úlohu.
Na vykonanie plánovaného skenovania môžete použiť aj príkaz SCHTASKS. Ak chcete napríklad nabudúce v noci o 03:00 hod. skontrolovať disky C: a E: a výsledky uložiť do súboru Excel, môžete použiť nasledujúci príkazový riadok:
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"
Pomoc o príkaze SCHTASKS získate na stránkach spoločnosti Microsoft <https://technet.microsoft.com/en-us/library/ff356867.aspx?f=255&MSPPError=-2147217396>`_ alebo zadaním:
SCHTAKS /Create /?
Poznámka
Chyby, ktoré sa vyskytnú počas plánovaného skenovania, sú uvedené v systémovom protokole udalostí systému Windows.
PowerShell¶
Windows PowerShell môžu byť užitočné v kombinácii s TreeSize. Tento príklad ukazuje, ako prehľadávať niekoľko vzdialených počítačov, ktoré sú vyhľadávané pomocou dotazu LDAP v službe 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
Presmerovanie výstupu¶
Ak nie je zadaný iný cieľ exportu, program TreeSize zapíše krátky export skenovania na štandardný výstup a chyby, ktoré sa vyskytli počas skenovania, na štandardnú chybu.
Tieto výstupné prúdy môžete presmerovať na príkazovom riadku (cmd.exe) pomocou symbolu pipe, napr.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
Ak chcete presmerovať výstup pomocou prostredia PowerShell, použite namiesto toho príkaz Start-Process, napr.
Start-Process -FilePath „C:\Program Files\JAM Software\TreeSize\Treesize.exe“ -ArgumentList „/NOGUI /SCAN C:\“ -RedirectStandardOutput „.\StdOut.txt“ -RedirectStandardError „.\StdError.txt“
Windows Scripting Host¶
Ak máte v úmysle používať adresu Windows Scripting Host (WSH), váš príkaz na spustenie adresy TreeSize bude vyzerať takto:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Kódy odchodu¶
Ak bola operácia úspešne dokončená, výstupný kód je 0. Ak došlo k chybe, TreeSize vráti ako výstupný kód Chybový kód systému Windows, ak je k dispozícii, alebo 1, ktorý označuje všeobecnú chybu.
V každom prípade protokol udalostí systému Windows bude obsahovať ďalšie informácie v protokole „Aplikácia“, zdroj udalostí „Veľkosť stromu“.