Parancssori opciók¶
A Professional Edition of TreeSize parancssori opciókat fogad el, amelyek lehetővé teszik, hogy ütemezett vizsgálatokat futtasson, vagy hogy a vizsgálat eredményei másnap reggel megjelenjenek a monitoron.
A Beolvasások ütemezése párbeszédpanel segít Önnek egy parancssor összeállításában az alábbi opciókkal.
Megjegyzés
Ezek az opciók csak a TreeSize Professional Edition verzióban érhetők el.
Minden opció¶
Treesize.exe [/OPTION] SCANPATH
/? vagy /HELP¶
Megjeleníti ezt a súgóoldalt.
/AGEOFFILES¶
A beolvasott könyvtár „Fájlok életkor” fülén található grafikon mentése bitmap, GIF, PNG, JPEG, Szöveg vagy CSV fájlba. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Az alábbi példa egy JPEG kép fájlt hoz létre a „Fájlok életkor” grafikonról a helyi C: meghajtón:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <érték>¶
Ezzel az opcióval kiválaszthatja, hogy a TreeSize exportáláskor, pl. a /TEXT használatával, hozzácsatolja-e a kimenetét a meglévő fájlokhoz. Válassza a „True” lehetőséget a csatoláshoz, illetve a „False” lehetőséget, ha a meglévő fájlokat felül kívánja írni.
Megjegyzés
Ez a paraméter nem működik exportált képek, XML-és PDF-fájlok esetén. Ezeket a fájlokat mindig felülírja. A /DATE kapcsolóval biztosítható, hogy minden generált jelentés egyedi fájlnevet kapjon.
A /EXCEL címen keresztül Excel-fájlba történő exportáláskor ez a paraméter a /SHEETNAME címmel együtt használható az adatoknak a megadott laphoz való csatolásához. Példa:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Ez az opció csak azokat a fájlokat tartalmazza, amelyeknél az archív bit be van állítva a beolvasások során. Ez az opció nagyon hasznos lehet, ha a biztonsági mentés méretét szeretné kiszámítani. Ebben az esetben létrehozhat egy parancsikont az asztalán vagy a Start menüben, amely automatikusan elindítja a biztonsági mentés méretének kiszámítását. Példa:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Ha meg van adva, az összes exportált fájl csatolva lesz az e-mailhez. Ha nincs megadva, a kifejezetten megadott elérési úttal rendelkező fájlok nincsenek csatolva. Ez hasznos, ha az XML vagy Excel fájlok meglehetősen nagyok, és megtöltik az e-mail fiókját.
Ez a példa Excel fájlba exportál, de nem csatolja az e-mailhez:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Ezek a példák csatolják az Excel fájlt az e-mailhez:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <fájlnév>¶
A beolvasott könyvtár oszlopdiagramját bitmap, GIF, PNG vagy JPEG fájlba menti. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Ez a példa egy PNG kép fájlt hoz létre az oszlopdiagramról a helyi C: meghajtón:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <fájlnév|elérési útvonal>¶
Összehasonlítja a beolvasott elérési utat egy mentett index fájllal. Az alábbi példa a C: meghajtót beolvassa, és az eredményt összehasonlítja a mentett XML jelentéssel erre a meghajtóra:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
Az indexfájl helyett egy elérési utat is használhat ezzel a parancssori paraméterrel. A megadott elérési utat a rendszer összehasonlítja az aktuális keresési eredménnyel. A következő példa a C:\ meghajtót vizsgálja, és ezen felül a D:Backup_of_C elérési útvonalat használja a kettő összehasonlításához:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Alternatív megoldásként összehasonlíthat két már meglévő indexfájlt, például a „c1.xml.zip” és „c2.xml.zip” fájlokat a következő parancs használatával:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
A /OPEN parancs a két fájl összehasonlítását úgy készíti elő, hogy az első fájlt („c1.xml.zip”) kibővíti egy keresőfájllá. A második fájl („c2.xml.zip”) összehasonlításra kerül ezzel a kibővített beolvasási fájllal, ugyanúgy, mintha a „c2.xml.zip”-et egy „valódi” beolvasással hasonlítanánk össze.
/COPY <útvonal>¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
A TreeSize fájlkeresés eredményeit a célhelyre másolja.
A következő parancs a helyi C: meghajtón keres a legújabb keresési beállításokkal, és a keresési eredményeket a „C:\temp\ObsoleteFiles” mappába másolja:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Lásd még: Kiválasztott fájlok áthelyezése
/CREATEDPASTDAYSONLY <n>¶
Ez az opció csak azokat a fájlokat fogja tartalmazni a vizsgálatokban, amelyeket a megadott számú nap alatt hoztak létre. A következő példában ez az opció csak az elmúlt nyolc napban létrehozott fájlokat fogja tartalmazni a vizsgálatban:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <drive>¶
Pillanatképet készít a parancssori paraméter után megadott meghajtókról. Példa:
Treesize /CREATESNAPSHOT "C:\" "D:\"
A pillanatfelvételek létrehozása rendszergazdai jogosultságokat igényelhet.
/CSV <fájlnév>¶
A vizsgálat vagy keresés befejezése után az eredményeket CSV fájlba menti. Az alkalmazás a mentés után automatikusan leáll. Ez a példa a helyi C: meghajtón végzett fájlkeresés eredményeit menti a legutolsó keresési beállításokkal egy CSV fájlba:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Ez a kapcsoló hozzáadja az aktuális dátumot és időt a parancssorban szereplő összes exportált fájl nevéhez. Ez akkor hasznos, ha rendszeresen, például minden este vagy minden hétvégén szeretne beolvasásokat végezni. A következő példa a „\\Host\Share” hálózati elérési útvonalat vizsgálja, és az eredményt a „C:\Scans\ ame_2013-08-14_17-18-24.xls” fájlba menti:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
A TreeSize duplikált fájlkeresés által talált duplikált fájlokat NTFS hardlinkekkel helyettesíti:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Véglegesen törli az összes fájlt, amelyet a TreeSize fájlkeresés eredményeként találtak. Példa:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Lásd még: Kiválasztott fájlok áthelyezése
/EMAIL <fogadó>¶
Az összegyűjtött adatokat a megadott e-mail címre küldi. Ez a paraméter csak egyszer használható a parancssorban, és csak egy e-mailt küld el az összes eredménnyel. Több címzett pontosvesszőkkel (;) vagy vesszőkkel választható el. Az e-mailek parancssoron keresztüli küldéséhez érvényes SMTP beállításokat kell megadni a TreeSize beállítások párbeszédpanel megfelelő oldalán. Példa:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Ha nem adtak meg más paramétereket, az e-mail a beállításokban megadott formátumban (HTML vagy sima szöveg) kerül elküldésre. Ha szeretné meghatározni a formátumot függetlenül a jelenlegi beállításoktól, használhatja a /TEXT vagy /HTML paramétereket a címzett címének meghatározása után. Példa:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
A paraméterek kombinálásával csatolmányokat is hozzáadhat az e-mailhez. Az alábbi példa egy Excel jelentést ad hozzá a vizsgálat csatolmányaként az e-mailhez:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Ez az opció csak a /SEARCH és a /EMAIL parancssori opcióval együtt használható. Ha ez a paraméter meg van adva, a TreeSize csak akkor küld e-mailt az aktuális keresési eredményekkel, ha a keresés során legalább egy fájlt vagy mappát találtak a megadott keresési típusok bármelyikével.
/EMPTYRECYCLEBIN¶
Ha ezt a lehetőséget használja, a TreeSize kiüríti a lomtárat a jelenlegi vizsgálat futtatása előtt. Példa:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Ez a paraméter lehetővé teszi a TreeSize fájlkeresés által talált fájlok átadását egy másik alkalmazásnak vagy szkriptnek. Ennek a paraméternek a lehetséges célpontja lehet egy kötegelt vagy egy powershell szkript. A következő példa a C:\ meghajtót keresi a legfrissebb keresési beállításokkal, és minden egyes megtalált fájlhoz meghívja az „Archive.bat” szkriptet. A fájl parancssori paraméterként kerül átadásra a szkriptnek:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Lásd még: Kiválasztott fájlok áthelyezése
/EXCEL <filepath>¶
Az összegyűjtött adatokat Microsoft Excel formátumban exportálja, és elmenti a megadott fájlútvonal alatt. Ha csak egy fájlnevet ad meg, a jelenlegi telepítési könyvtárat használja az export tárolására. A támogatott formátumok a hagyományos .XLS fájlformátum (Excel 97-2003) és az .XLSX formátum (amelyet az Excel 2007-ben vezettek be). A használt formátum a megadott fájlnév kiterjesztésétől függ. Az alkalmazás a mentés után automatikusan leáll. Példa:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Ha a fájl neve már létezik, a fájl megnyílik, és egy új munkalap kerül hozzáadásra.
Megjegyzés
A TreeSize File Search (/SEARCH) oldalon az egyes keresési típusok eredményei saját külön munkalapon kerülnek összegyűjtésre. Ha a megadott elérési útvonal alatti fájl már létezik, akkor ezek a lapok felülíródnak. Ennek megakadályozásához a /APPENDTOFILES parancssori opciót kell használni.
/EXCLUDE <minta1;minta2>¶
Ez a lehetőség lehetővé teszi, hogy megadja azokat a mintákat, amelyek a vizsgálatból ki kell zárni a fájlokat és mappákat. Több kizárási mintát pontosvesszővel (;) lehet elválasztani. Ha az egyik vagy több minta szóközöket tartalmaz, a teljes minta sztringet idézőjelekbe (”) kell tenni. Az alábbi példa figyelmen kívül hagyja azokat a fájlokat és mappákat, amelyek „.tmp” végződéssel rendelkeznek, vagy amelyek pontos neve „system”:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <szint|méret>¶
Ezzel a beállítással megadhatja, hogy a könyvtárfa hány szintje legyen kibontva a beolvasás után. Ha nem ad meg számot a beállítás után, akkor az összes mappa kibontásra kerül. A könyvtárszint helyett megadhat egy mennyiséget is megabájtban (MB). Ebben az esetben a megadott mennyiségnél nagyobb összes mappa kibontásra kerül. Az „MB” egységnek a szám után üres betű nélkül kell következnie. A következő példa a „H:\\User” mappát vizsgálja, kibővíti az összes 10 MB-nál nagyobb mappát, és az eredményt a „C:\\Results\Allusers.xlsx” Excel fájlba menti:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <érték>¶
Ha ezt a lehetőséget használja, az Excel exportok bővíthető/összecsukható csoportokat fognak használni, amelyek hasonlóan navigálhatók, mint a könyvtárfa.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <fájlnév>¶
Ez az opció lehetővé teszi a „Meghajtó lista” tartalmának exportálását Excel, Szöveg vagy CSV fájlba. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Példa:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Ha meg van adva, a fájlok minden exportálásba belekerülnek. Ez az opció egyenértékű a „Eszközök > Beállítások > Exportálás > * > Exportált elemek > Mappák és egyedi fájlok” opció aktiválásával.
/EXPORTGROUPSEXPANDED¶
Ha meg van adva, a kiterjesztések listájának exportálása tartalmazni fogja az összes információt a csoportokban található kiterjesztésekről.
/EXPORTPATHSLIST <fájlnév>¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Exportál egy egyszerű listát, amely tartalmazza az összes keresési eredményt. A lista csak a keresési eredmények teljes elérési útvonalait fogja tartalmazni, és semmilyen egyéb információt nem. A célfájl támogatott formátumai: .txt és .csv.
Ez a példa megkeresi és létrehoz egy listát az összes exe fájlról a C: meghajtón:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Használható egy korábbi keresés eredményeinek importálására a felhasználói felületbe a „Fájl > Elérési utak listája > Elérési út lista importálása” vagy a /IMPORT paraméter használatával.
Ha az „Eszközök > Beállítások > Exportálás > Duplikált csoportok belefoglalása” opció aktiválva van, ezt a funkciót a duplikált keresés eredményeinek csoportstruktúrával együtt történő exportálására és importálására is használhatja.
/EXPORTTITLE ¶
Használható a nyomtatott jelentés vagy exportált fájl címének megváltoztatására. Ez lehetővé teszi, hogy további információt adjon a felhasználónak, amikor a TreeSize-t automatizált környezetben használja. Környezeti változók használata is megengedett. Példa:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <fájlnév>¶
Ez az opció lehetővé teszi a fájlkiterjesztések / fájltípusok statisztikáinak mentését a beolvasott fájlrendszer ágra Excel, HTML, Szöveg vagy CSV fájlba. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Az exportált oszlopok azok lesznek, amelyeket a felhasználói felületen az „Kiterjesztések” fülön engedélyeztek, amikor utoljára használták, vagy amikor a /OPTIONS paraméterrel megadott konfigurációs fájl íródott.
A következő példa a C: meghajtót vizsgálja, és létrehoz egy „D:\\TreeSize Reports\\C_filetypes.xls” nevű Excel-fájlt az ezen a meghajtón található fájltípusok statisztikáival:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <fájlnév>¶
Ment egy kis grafikont, amely a „Kiterjesztések” oldal alján látható, egy képfájlba (bitmap, GIF, PNG vagy JPEG).
/EXTENSIONSPIECHART <fájlnév>¶
Ment egy kördiagramot, amely a „fájl kiterjesztések” eloszlását mutatja egy képfájlba (bitmap, GIF, PNG vagy JPEG).
/FILTER <minta1;minta2>¶
Beállít egy fájlszűrőt, amely csak bizonyos kiterjesztésű fájlokat számol, pl. „.mp3” vagy „.doc”. Több mintázat is megadható, pontosvesszővel (;) elválasztva. A következő példa MP3 és AVI fájlokat keres a szerver „Users” könyvtárában:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
A TreeSize fájlkeresés (/SEARCH) végrehajtásakor a /FILTER parancssori kapcsolót is használhatja a fejlett fájlkeresés mintáinak megadására. Összetettebb egyéni fájlkeresés végrehajtásához a keresési beállításokat egy fájlba kell menteni, és az így kapott XML-fájlt a /SEARCH után átadni a parancssornak.
/FOLLOWREPARSEPOINTS¶
Ha ezt a kapcsolót hozzáadja a parancssorhoz, a TreeSize követni fogja a csatolt pontokat és a külső szimbolikus linkeket a fájlrendszer fa bejárása során.
/GROUPSCANS¶
Ezzel a parancssori kapcsolóval az összes beolvasott könyvtárat egy virtuális gyökérmappa alá csoportosítja. Használja a /GROUPSCANS FALSE kapcsolót, ha azt szeretné, hogy ne használjon virtuális gyökérmappát.
/HIDESMALLFOLDERS <érték>¶
Lehetővé teszi a minimális méretnél kisebb objektumok elrejtését, ami hasznos az egyértelmű exportáláshoz. <VALUE> lehet egy méretérték egységgel, vagy egy egyszerű bájtérték egység nélkül. Nem használható a /EXPAND címmel együtt. Ebben a példában csak a legalább 50 MB méretű mappák kerülnek exportálásra:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <fájlnév>¶
A beolvasott könyvtár „Előzmények” fülén található grafikont bitmap, GIF, PNG vagy JPEG fájlba menti. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Ez a példa egy JPEG képet készít a C meghajtó előzménygrafikonjáról:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <fájlnév>¶
A begyűjtött adatokat HTML fájlba menti, amelyet bármely HTML böngészővel meg lehet tekinteni. Megadhatja, hogy a beolvasás mely információi kerüljenek bele az exportálásba a „Kezdőlap > Beállítások > Exportálás > HTML > Grafikonok és listák, amelyeket bele kell foglalni” menüpont alatt. Kiválaszthatja, hogy mely további listák vagy grafikonok kerüljenek az exportálásba. Ezek automatikusan beágyazódnak a beolvasás után létrehozott HTML fájlba.
A következő példa egy HTML-jelentést készít a C: meghajtóra, és a „D:\HTML” címre menti:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Ha azt szeretné, hogy egynél több vizsgálat legyen része a HTML-fájlnak, akkor a /GROUPSCANS parancssori kapcsolót kell hozzáadni. Ha HTML-be exportál, de nincs benne kép, akkor használhatja a /APPENDTOFILES kapcsolót is.Ha nincs ilyen jelző, akkor a HTML-fájl felülíródik.
/IMPORT <fájlnév>¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Betölti az útvonalak listáját a TreeSize fájlkeresés felhasználói felületére. A fájl lehet .txt vagy .csv formátumú. Ez a paraméter felhasználható egy korábbi keresés eredményeinek importálására. Az importált fájlok és mappák áthelyezhetők/lemásolhatók/törölhetők/archiválhatók, mint bármely „élő” keresési eredmény, a fájlműveleti párbeszédpanelen keresztül.
Példa:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Ezt a paramétert a /RECYCLE, /DELETE vagy /MOVE paraméterekkel is kombinálhatja a szövegfájlban található fájlok automatikus törléséhez vagy áthelyezéséhez. Példa:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <fájlnév>¶
Importálja a minták listáját egy File-ból. A File lehet egy egyszerű szöveges fájl a szűrőmintákból, pontosvesszővel elválasztva, vagy a felhasználói felület segítségével létrehozhat egy összetettebb mintakészletet, és az Exportálás funkcióval létrehozhatja a mintafájlt XML formátumban. A támogatott formátumok a CSV, TXT és XML.
Az importált minták szűrőként szolgálnak a vizsgálat során, hogy bizonyos File-eket és mappákat tartalmazzon vagy kizárjon.
A /SEARCH parancssori opcióval együtt használva ez a paraméter egy új, speciális keresést hoz létre, amely az importált fájlban található mintákat használja a keresés kritériumaként.
Ez a példa importálja a „C:\TreeSizeFiles\patterns.txt” alatt definiált szűrőmintákat, elindítja a C:\meghajtó keresését, és az eredményeket egy HTML-fájlba exportálásra küldi:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <fájlnév>¶
A keresési eredményeket egy SQLite File-ba menti, amely később betölthető az összehasonlításokhoz. Példa:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <szeparátor char>¶
Lehetővé teszi a szöveg- vagy CSV-fájlok exportálásakor használt elválasztójel meghatározását. A szöveges fájlok alapértelmezés szerint a tabulátor, a CSV-fájlok pedig a Windows vezérlőpult regionális beállításaiból származó listaelválasztót használják.
Kérjük, adjon meg egyetlen karaktert vagy a „TAB” karakterláncot tabulátornak a kapcsoló után. Példák:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <útvonal>¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
A TreeSize File Size keresés eredményeit áthelyezi egy másik helyre.
A következő parancs a helyi C: meghajtón keres a legújabb keresési beállításokkal, és a keresési eredményeket a „C:\Temp\ObsoleteFiles” mappába helyezi át:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Lásd még: Kiválasztott fájlok áthelyezése
/NOGUI¶
Nem jelenik meg ablak, és az alkalmazás nem jelenik meg a feladatsorban. Hasznos a háttérben végzett vizsgálatok vagy keresések végrehajtásához, vizuális visszajelzés nélkül.
Figyelem
Ezt a kapcsolót csak akkor használja, ha a többi parancssori opciót is tesztelte, mert ebben a módban nem jeleníthetők meg hibaüzenetek.
A hibák azonban naplózásra kerülnek a Windows eseménynaplójában.
/NOHEADERS¶
Kihagyja a beolvasási vagy keresési exportálási fájlok tetejére általában írt fejléc sorokat. Ez megkönnyíti a sima adatok fogadását az utófeldolgozáshoz.
/NOUNITS¶
Kihagyja a méretértékek után általában írt egységeket. Ez az opció a /SIZEUNIT 0-val kombinálva egyszerű bájtértékeket exportálásra kerül. Ez megkönnyíti a sima adatok fogadását az utófeldolgozáshoz.
Megjegyzés
Ez a parancssor csak a /TEXT, /EXCEL, /HTML, /EMAIL vagy /PRINT opciók használatával létrehozott könyvtárfa exportálására lesz hatással. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST, vagy /TOPFILESLIST nem lesz hatással.
/OPEN <fájlnév>¶
Megnyit egy mentett XML jelentést az alkalmazás indításakor. Példa:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <fájlnév>¶
Használja ezt a paramétert az exportált felhasználói beállítások alkalmazásához a TreeSize-ra. A felhasználói beállításokat a „File > Options > Export” menüpont alatt lehet exportálni. Példa:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Megjegyzés
Változtasson meg annyi beállítást, amennyit csak lehet a felhasználói felületen, mielőtt elmenti a beállításokat, hogy csökkentse a szükséges parancssori paraméterek számát.
/PDF¶
A vizsgálat vagy keresés befejezése után a találatokat PDF fájlba menti. Az alkalmazás a mentés után automatikusan leáll. Az alábbi példa a C: helyi meghajtó vizsgálatát végzi el, és a találatokat PDF fájlba menti:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <fájlnév>¶
A vizsgált könyvtár kördiagramját bitmap, GIF, PNG vagy JPEG fájlba menti. A fájl típusa a megadott fájlnév kiterjesztésétől függ. Az alábbi példa a C: meghajtót vizsgálja, és PNG formátumban exportál egy kördiagramot:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Jelentést nyomtat a vizsgált könyvtárfáról a rendszerbeállításokban konfigurált alapértelmezett nyomtató használatával. Az alkalmazás a nyomtatás után leáll. Példa:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <érték>¶
Ha az érték true-ra van állítva, ez az opció aktiválja az írásvédett módot, amelyben a fájlműveletek (pl. áthelyezés vagy törlés) le vannak tiltva, így csak jelentéskészítő eszközként használható.
Kezdje false értékkel az írásvédett mód ismételt deaktiválásához.
/RECYCLE¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Minden fájlt a lomtárba helyez, amelyet a TreeSize fájlkeresés eredményeként találtak. Példa:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Lásd még: Kiválasztott fájlok áthelyezése
/RESTRICTEDMODE <érték>¶
Ha az érték true-ra van állítva, ez az opció aktiválja a korlátozott módot, amelyben sok olyan funkció le van tiltva, amely nem érdekes a „normál” (nem adminisztrátor) felhasználók számára. A letiltott funkciók között szerepel: Frissítés ellenőrzése, A Windows Vezérlőpult szoftveralkalmazásának megnyitása, TreeSize vizsgálatok ütemezése, hálózati meghajtó csatlakoztatása, a Windows Rendszer-visszaállítás konfigurálása, Futtatás rendszergazdaként, exportálások és NTFS tömörítés alkalmazása. Megadhat egy elérési utat, amelyet vizsgálni kell, pl. a felhasználó otthoni könyvtárát, a parancssorban vagy egy mentett konfigurációs fájl Startup Paths részében.
Kezdje false értékkel a korlátozott mód ismételt deaktiválásához.
Ha ezen felül aktiválja a /READONLYMODE opciót, a felhasználó nem lesz képes fájlokat törölni vagy mozgatni a TreeSize-ban, így az csak jelentés eszközként lesz használható.
/SCAN <elérési út|fájlnév>¶
Meghatározza, hogy melyik meghajtót vagy elérési utat kell beolvasni. A beolvasási útvonalat kell értékként használni ehhez a paraméterhez.
Ha például a D:\ meghajtót kell beolvasni, használhatja a következőt:
Treesize /SCAN "D:\"
Ha nem szeretné beolvasni az egész meghajtót, akkor megadhat egy elérési utat is, amely a beolvasás kiindulópontjaként szolgál. Például:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Több beolvasási útvonal is megadható, ezeket egy szóköz választja el. A szóközt tartalmazó útvonalakat idézőjelek közé kell tenni („). Példa:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
A „*” és „?” helyettesítő karakterek megengedettek. Példa:
Treesize /SCAN "H:\users\A*"
Megad egy szöveges fájlt is, amely a beolvasandó elérési utak listáját tartalmazza. A TreeSize az összes olyan útvonalat be fogja vizsgálni, amely megtalálható a szöveges fájlban, amelyet a kapcsoló után ad meg. A szöveges fájlnak soronként egy útvonalat kell tartalmaznia. A következő példa a „D:\PathsToScan.txt” fájlban található összes elérési utat beolvassa, és minden egyes beolvasási eredményt egy Excel-fájl külön lapjára írja a mai dátummal:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
A TreeSize-t „for” ciklusban is meghívhatja, csak az egyik útvonalat használva, az alábbi példa szerint.
/SEARCH¶
Megnyitja a TreeSize File kereső ablakát. Ha ehhez a parancssori opcióhoz a „:Start” adódik, a keresés automatikusan elindul. Egy korábban elmentett, keresési beállításokat tartalmazó XML-fájlt lehet átadni, ezeket a beállításokat használja fel a keresés végrehajtásához.
Megjegyzés
A keresés során talált fájlok automatikusan be lesznek jelölve.
A következő példa a „SearchSettings.xml” fájlba korábban mentett beállításokkal végzi a keresést, és az eredményeket egy szövegfájlba menti:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Megjegyzés
Általában a legutóbbi keresési beállítások vagy egy korábbi mentett keresési beállításkészlet kerül felhasználásra. A /FILTER parancssori opcióval azonban megadhatja a keresési mintákat a speciális kereséshez.
/SHEETNAME ¶
Lehetővé teszi a /EXCEL parancssori kapcsoló használatakor annak a lapnak a nevének a megadását, amely hozzá lesz adva egy Excel-fájlhoz.
Megjegyzés
Egy Excel lap neve egyedinek kell lennie egy Excel fájlban, és bizonyos speciális karakterek, mint például a perjelek, visszaperjelek és kettőspontok tilosak. A TreeSize mindig egyedi lapnevet hoz létre az érvénytelen karakterek aláhúzással való helyettesítésével és szükség esetén dátum és idő hozzáadásával. Ha a megadott nevű lap már létezik a célfájlban, egy új, egyedi névvel rendelkező lap jön létre. Használja a /APPENDTOFILES parancssori opciót az adatok meglévő lapra való hozzáfűzéséhez.
/SHORTDATEFORMAT <format>¶
Megváltoztatja a rövid dátumformátumot ehhez a folyamathoz, amely a Windows vezérlőpult regionális beállításaiban konfigurálható. A TreeSize exportok ezt a formátumot fogják használni a dátumértékekhez. Példa:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Ez az opció lehetővé teszi a méretértékek megjelenítéséhez használt egység megadását: N értéke 0-tól 5-ig terjedhet, ami a következőket jelenti: 0 = Byte, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Automatikus egységek. Ezen opció nélkül a TreeSize legutóbb használt konfigurációja lesz érvényben.
/SORTBY <ColumnName>¶
Lehetővé teszi annak meghatározását, hogy a generált exportok milyen érték szerint legyenek rendezve. A lehetséges értékek olyan oszlopnevek, mint „Size” vagy „Name”. Alapértelmezés szerint a TreeSize felhasználói felületén utoljára használt rendezési típus lesz használva. Példa:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <fájlnév>¶
A keresési eredményeket egy SQLite File-ba menti, amely később betölthető az összehasonlításokhoz. Példa:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <tárgy>¶
Ez az opció lehetővé teszi, hogy testre szabja a vizsgálat végén küldött e-mailekhez használt tárgyat. Példa:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <fájlnév>¶
A vizsgálat vagy keresés befejezése után elmenti az eredményeket egy szöveg- vagy CSV-fájlba. Az alkalmazás a mentés után automatikusan leáll. Az alábbi példa végrehajt egy vizsgálatot a helyi C: meghajtón, és elmenti az eredményeket egy szövegfájlba:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
A szöveges formátum az emberi olvasóknak szánt táblázatos formátumot használ. Ha a fájlnév egy CSV-fájlra hivatkozik, akkor automatikusan a CSV formátumot használja. Ha kifejezetten CSV formátumot szeretne használni, javasoljuk a /CSV paraméter használatát.
/TITLE <title>¶
Használható a vizsgálat gyökérútjának helyettesítésére egy egyedi szöveggel. Ez lehetővé teszi, hogy például jelentésekhez érthetőbb neveket adjon az UNC utaknak, ezáltal növelve a jelentés olvashatóságát. A választott címet a jelentés címeként alkalmazzák a fájl exportálásakor. Példa:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
A TreeSize fájlkeresés kontextusában ez a paraméter használható egy fejlett keresés nevének megadására. Példa:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <fájlnév>¶
Ez az opció lehetővé teszi, hogy elmentse a legnagyobb fájlok listájának tartalmát Excel, HTML, Szöveg vagy CSV fájlba. A fájl típusa a megadott fájlnevének kiterjesztésétől függ. Példa:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <fájlnév>¶
Elmenti a beolvasott könyvtárfa Fatérkép grafikonját bitmap, GIF, PNG vagy JPEG fájl formátumban. A fájl típusa a megadott fájlnevének kiterjesztésétől függ. Példa:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
A felhasználói felület szintjének beállítása. A lehetséges értékek: Simple, Normal vagy Expert. Példa:
Treesize /UILevel "Simple"
/USERSLIST <fájlnév>¶
Ez az opció lehetővé teszi, hogy elmentse a felhasználónév szerint csoportosított eredményeket mutató statisztikákat Excel, HTML, Szöveg vagy CSV fájlba. A fájl típusa a megadott fájlnevének kiterjesztésétől függ. Az exportált oszlopok azok lesznek, amelyeket a felhasználói felületen az „Felhasználók” fülön engedélyeztek, amikor legutóbb használták, vagy amikor a /OPTIONS paraméterrel megadott konfigurációs fájl készült.
A következő példa a C: meghajtót vizsgálja, és létrehoz egy Excel-fájlt a „C:\Temp” könyvtárban az ezen a meghajtón lévő felhasználók statisztikáival:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <felhasználónév>¶
Megadja azt a felhasználónevet, amelyet a beolvasások hitelesítésére kell használni. Használja a /PASSWORD címet a felhasználónév jelszavának megadásához. Javasoljuk, hogy ehelyett a RUNAS Microsoft eszközt használja.
/USERFILTER <felhasználónév>¶
Ezzel a lehetőséggel csak a bizonyos felhasználó által birtokolt fájlok kerülnek figyelembevételre a vizsgálat során. Adja meg ennek a felhasználónak a nevét e kapcsoló után.
Megjegyzés
Itt nem használhat több felhasználónevet, de a „*” és „?” helyettesítő karakterek támogatottak.
Példa:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <fájlnév>¶
Ment egy kis grafikon, amely a „Felhasználók” oldal alján látható, egy képfájlba (bitmap, GIF, PNG vagy JPEG).
/USERSPIECHART <fájlnév>¶
Ment egy kördiagramot, amely a jelenlegi vizsgálat „felhasználói statisztikáit” mutatja, egy képfájlba (bitmap, GIF, PNG vagy JPEG).
/VIEWTYPE n¶
Meghatározza, hogy mely értékek alapján alapul a „Szülő százalék”, a „Növekedés” oszlopok és a „Fájlok kora” grafikon. Lehetséges értékek:
2: Méret 3: Lefoglalt hely (méret a lemezen) 7: Fájlok száma
/XML <fájlnév>¶
Ment a vizsgálati eredményeket egy XML fájlba, amely későbbi összehasonlításokhoz betölthető. Példa:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Ez az opció a /EXPAND kapcsolóval kombinálva korlátozhatja az exportált könyvtárakat.
Megjegyzés
Korlátozott XML export betöltésekor a TreeSize-ba nem navigálhat a teljes könyvtárágban, csak a kiexportált könyvtárakban.
/ZIP <fájlnév>¶
Ez az opció csak a /SEARCH parancssori opcióval együtt használható.
Minden fájl, amelyet a TreeSize fájlkeresés eredményeként találtak, egy zip archívumba lesz áthelyezve. Példa:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Lásd még: Kiválasztott fájlok áthelyezése
<SCANPATH>¶
A /SCAN paraméteren kívül a parancssor végén egy vagy több elérési utat is megadhat. Ez azonban már nem ajánlott a parancssor elemzése során fellépő hibák elkerülése érdekében.
Ez a példa a „Program Files” és a „Windows” mappát vizsgálja, és létrehoz egy szöveges jelentést a „C:\Reports\ScanResults.txt” alatt:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
Ha hiba lép fel, az a folyamat kilépési kódjában Windows hiba kód formájában kerül visszaadásra. Környezeti változók (pl. %APPDATA%) használhatók a fájlnevekben, valamint a vizsgált elérési utakban is.
Több Könyvtár Vizsgálata¶
Ha több könyvtárat kell vizsgálni, érdemes lehet több hívást egy Batch fájlba egyesíteni, például:
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"
A „START /WAIT” parancs biztosítja, hogy a feladatok sorozatosan induljanak. A feladatok párhuzamos indítása általában nem ajánlott, mivel egyetlen feladat jobban kihasználja a gyorsítótárakat és a rendszer erőforrásait. Az is lehetséges, hogy a vizsgálandó megosztásokat egy szöveges fájlban tárolja, és a Windows „for” parancsot használja így:
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"
Megjegyzés
A dupla százalék karakterek szükségesek a batch fájlokban, a parancssorban csak egyetlen százalékot használjon.
Ütemezett Indítás¶
A Windows Ütemezett Feladatok használatával a TreeSize-t bizonyos parancssori opciókkal naponta, hetente vagy havonta egy adott időpontban futtathatja. A Beolvasások ütemezése párbeszédablak segít az ütemezett feladat beállításában.
A SCHTASKS parancsot is használhatja ütemezett vizsgálatok végrehajtására. Ha például a C: és E: meghajtókat szeretné vizsgálni a következő éjszaka 03:00-kor, és az eredményeket egy Excel fájlba menteni, a következő parancssort használhatja:
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"
A SCHTASKS parancsról segítséget kaphat a Microsoft oldalain vagy a következő beírásával:
SCHTAKS /Create /?
Megjegyzés
Az ütemezett vizsgálatok során fellépő hibaüzenetek a Windows eseménynaplóban találhatók.
PowerShell¶
Windows PowerShell hasznos lehet a TreeSize címmel kombinálva. Ez a példa azt mutatja be, hogyan lehet keresni néhány távoli számítógépet, amelyeket az Active Directory (AD) LDAP lekérdezésével kérdezünk le:
$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
Kimenet Átirányítása¶
Ha nincs más exportálási cél megadva, a TreeSize egy rövid exportálást ír a vizsgálatról a standard kimenetre, és a vizsgálat során fellépő hibákat a standard hibakimenetre.
Ezeket a kimeneti folyamokat a parancssorban (cmd.exe) a pipe szimbólum használatával irányíthatja át, pl.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
A kimenet PowerShell-en történő átirányításához kérjük, használja a Start-Process parancsot, például:
Start-Process -FilePath „C:\Program Files\\JAM Software\TreeSize\Treesize.exe” -ArgumentList „/NOGUI /SCAN C:\" -RedirectStandardOutput „.\StdOut.txt” -RedirectStandardError „.\StdError.txt”
Windows Scripting Host¶
Ha a Windows Scripting Host (WSH) címet kívánja használni, a TreeSize indítására szolgáló parancs így fog kinézni:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Kilépési Kódok¶
Ha a művelet sikeresen befejeződött, a kilépési kód 0. Ha hiba történt, a TreeSize egy Windows hiba kódot ad vissza, ha elérhető, vagy 1-et, hogy általános hibát jelezzen.
Minden esetben a Windows Eseménynapló további információkat tartalmaz az „Alkalmazás” naplóban, az Eseményforrás „TreeSize”.