Opcje wiersza poleceń¶
Wersja Professional programu TreeSize akceptuje opcje wiersza poleceń umożliwiające uruchamianie zaplanowanych skanów lub wyświetlanie wyników skanowania na monitorze następnego dnia rano.
Okno dialogowe dla Planowanie skanowania pomoże ci skompilować wiersz poleceń z poniższymi opcjami.
Informacja
Te opcje są dostępne tylko w TreeSize Professional Edition.
Wszystkie opcje¶
Treesize.exe [/OPTION] SCANPATH
/? lub /HELP¶
Wyświetla tę stronę pomocy.
/AGEOFFILES¶
Zapisuje wykres na karcie „Age of Files” zeskanowanego katalogu do pliku bitmapy, GIF, PNG, JPEG, tekstowego lub CSV. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Poniższy przykład tworzy plik obrazu JPEG wykresu „Age of File” dla lokalnego dysku C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <wartość>¶
Za pomocą tej opcji można wybrać, czy TreeSize ma dołączać swoje dane wyjściowe do istniejących plików podczas wykonywania Eksportu, np. podczas korzystania z /TEXT. Wybierz „True”, aby dołączyć i „False”, jeśli chcesz nadpisać istniejące pliki.
Informacja
Ten parametr nie będzie działał z eksportowanymi obrazami, plikami XML i PDF. Pliki te zawsze będą nadpisywane. Można użyć przełącznika /DATE, aby zapewnić, że wszystkie wygenerowane raporty będą miały unikalną nazwę pliku.
Podczas eksportu do pliku Excel za pośrednictwem strony /EXCEL, parametr ten może być używany razem z /SHEETNAME w celu dołączenia danych do określonego arkusza. Przykład:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Ta opcja uwzględni tylko pliki, dla których w skanach ustawiono bit archiwizacji. Ta opcja może być bardzo przydatna, jeśli chcesz obliczyć rozmiar kopii zapasowej. W takim przypadku można utworzyć skrót na pulpicie lub w menu Start, który automatycznie rozpocznie obliczanie rozmiaru kopii zapasowej. Przykład:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Jeśli określono, wszystkie eksportowane pliki zostaną dołączone do wiadomości e-mail. Jeśli nie określono, pliki z jawnie podaną ścieżką nie są dołączane. Jest to przydatne w przypadku, gdy pliki XML lub Excel stają się dość duże i zapełniają konto e-mail.
Ten przykład wyeksportuje dane do pliku Excel, ale nie dołączy go do wiadomości:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Te przykłady dołączą plik Excel do wiadomości e-mail:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <nazwa pliku>¶
Zapisuje wykres słupkowy zeskanowanego katalogu do pliku bitmapy, GIF, PNG lub JPEG. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Ten przykład tworzy plik obrazu PNG wykresu słupkowego dla lokalnego dysku C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <nazwa pliku|ścieżka>¶
Porównuje zeskanowaną ścieżkę z zapisanym plikiem indeksu. Poniższy przykład skanuje dysk C: i porównuje wynik z zapisanym raportem XML dla tego dysku:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
Zamiast pliku indeksu można również użyć ścieżki z tym parametrem wiersza poleceń. Podana ścieżka zostanie porównana z bieżącym wynikiem skanowania. Poniższy przykład skanuje dysk C:\ i dodatkowo używa ścieżki D:Backup_of_C, aby wykonać porównanie między nimi:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Alternatywnie można porównać dwa już istniejące pliki indeksu, np. „c1.xml.zip” i „c2.xml.zip” za pomocą tego polecenia :
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
Polecenie /OPEN przygotowuje porównanie dwóch plików poprzez rozszerzenie pierwszego pliku („c1.xml.zip”) do pliku skanowania. Drugi plik („c2.xml.zip”) zostanie porównany z tym rozszerzonym plikiem skanu, tak jak miałoby to miejsce, gdyby „c2.xml.zip” został porównany z „prawdziwym” skanem.
/COPY <ścieżka>¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Kopiuje wyniki wyszukiwania plików TreeSize do lokalizacji docelowej.
Poniższe polecenie wyszuka na dysku lokalnym C: przy użyciu najnowszych opcji wyszukiwania i skopiuje wyniki wyszukiwania do folderu „C:\temp\ObsoleteFiles”:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Zobacz także: Przenoszenie sprawdzonych plików
/CREATEDPASTDAYSONLY <n>¶
Ta opcja spowoduje uwzględnienie w skanach tylko plików, które zostały utworzone w ciągu liczby dni wprowadzonej w argumencie. W poniższym przykładzie opcja ta uwzględni w skanowaniu tylko pliki utworzone w ciągu ostatnich ośmiu dni:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <napęd>¶
Tworzy migawkę dla dysków podanych po tym parametrze wiersza poleceń. Przykład:
Treesize /CREATESNAPSHOT "C:\" "D:\"
Tworzenie migawek może wymagać uprawnień administracyjnych.
/CSV <nazwa pliku>¶
Zapisuje wyniki do pliku CSV po zakończeniu skanowania lub wyszukiwania. Po zapisaniu aplikacja zakończy działanie. Ten przykład zapisze wyniki wyszukiwania File Search na lokalnym dysku C: z ostatnimi konfiguracjami wyszukiwania do pliku CSV:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Ten przełącznik doda bieżącą datę i godzinę do wszystkich nazw plików Eksportu w wierszu poleceń. Jest to przydatne, jeśli chcesz wykonywać skanowanie regularnie, np. każdej nocy lub w każdy weekend. Poniższy przykład przeskanuje ścieżkę sieciową „\\Host\Share” i zapisze wynik w pliku „C:\Scans\name_2013-08-14_17-18-24.xls”:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Spowoduje to zastąpienie zduplikowanych plików, które zostały znalezione przez wyszukiwanie duplikatów plików TreeSize, twardymi linkami NTFS:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Trwale usuwa wszystkie pliki, które zostały znalezione w wyniku wyszukiwania plików TreeSize. Przykład:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Zobacz także: Przenoszenie sprawdzonych plików
/EMAIL <odbiorca>¶
Wysyła zebrane dane na podany adres e-mail. Ten parametr może być użyty tylko raz w wierszu poleceń i zostanie wysłana tylko jedna wiadomość e-mail ze wszystkimi wynikami. Wielu odbiorców można oddzielić średnikami (;) lub przecinkami. Aby wysyłać wiadomości e-mail za pośrednictwem wiersza poleceń, należy określić prawidłowe ustawienia SMTP na odpowiedniej stronie w oknie dialogowym opcji TreeSize. Przykład:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Jeśli nie określono żadnych innych parametrów, wiadomość e-mail zostanie wysłana w formacie ustawionym w opcjach (HTML lub zwykły tekst). Jeśli chcesz zdefiniować format niezależny od bieżących opcji, możesz użyć parametrów /TEXT lub /HTML tuż za definicją adresów odbiorców. Przykład:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Łącząc parametry, można również dodawać załączniki do wiadomości e-mail. Poniższy przykład doda raport Excel ze skanowania jako załącznik do wiadomości e-mail:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Ta opcja może być używana tylko w połączeniu z opcjami wiersza poleceń /SEARCH i /EMAIL. Jeśli ten parametr jest określony, TreeSize wyśle wiadomość e-mail z aktualnymi wynikami wyszukiwania tylko wtedy, gdy co najmniej jeden plik lub folder został znaleziony podczas wyszukiwania przez którykolwiek z określonych typów wyszukiwania.
/EMPTYRECYCLEBIN¶
Jeśli użyjesz tej opcji, TreeSize opróżni kosz przed uruchomieniem bieżącego skanowania. Przykład:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Ten parametr umożliwia przekazywanie plików znalezionych przez wyszukiwanie plików TreeSize do innej aplikacji lub skryptu. Możliwym celem dla tego parametru może być skrypt wsadowy lub skrypt powershell. Poniższy przykład przeszuka dysk C:\ z najnowszymi ustawieniami wyszukiwania i wywoła skrypt „Archive.bat” dla każdego znalezionego pliku. File zostanie przekazany do skryptu jako parametr wiersza poleceń:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Zobacz także: Przenoszenie sprawdzonych plików
/EXCEL <ścieżka pliku>¶
Eksportuje zebrane dane w formacie Microsoft Excel i zapisuje je pod wprowadzoną ścieżką do pliku. Jeśli podana jest tylko nazwa pliku, do zapisu Eksportu używany jest bieżący katalog Instaluj. Obsługiwane formaty to konwencjonalny format .XLS File (Excel 97-2003), jak również format .XLSX (wprowadzony w Excel 2007). Używany format zależy od rozszerzenia określonej nazwy pliku. Aplikacja zakończy działanie po zapisaniu pliku. Przykład:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Jeśli nazwa pliku już istnieje, plik zostanie otwarty i dodany zostanie nowy arkusz.
Informacja
W witrynie TreeSize File Search (/SEARCH) wyniki każdego typu wyszukiwania są gromadzone w osobnym arkuszu. Jeśli plik pod podaną ścieżką już istnieje, arkusze te zostaną nadpisane. Aby temu zapobiec, należy użyć opcji wiersza poleceń /APPENDTOFILES.
/EXCLUDE <wzór1;wzór2>¶
Ta opcja umożliwia określenie wzorców dla plików i folderów, które powinny zostać wykluczone ze skanowania. Wiele wzorców wykluczeń można oddzielić średnikiem (;). Jeśli jeden lub więcej wzorców zawiera spacje, cały ciąg wzorca musi być ujęty w cudzysłów („). Poniższy przykład zignoruje pliki i foldery, które kończą się na „.tmp” lub których dokładna nazwa to „system”:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <poziom|rozmiar>¶
Ta opcja pozwala określić, ile poziomów w drzewie katalogów zostanie rozwiniętych po skanowaniu. Jeśli po tej opcji nie zostanie podana żadna liczba, rozszerzone zostaną wszystkie foldery. Zamiast poziomu katalogu można również podać ilość w megabajtach (MB). W takim przypadku wszystkie foldery większe niż podana ilość zostaną rozszerzone. Jednostka „MB” musi występować po liczbie bez spacji. Poniższy przykład przeskanuje folder „H:\User”, rozszerzy wszystkie foldery większe niż 10 MB i zapisze wynik w pliku Excel „C:\Results\Allusers.xlsx”:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <wartość>¶
Jeśli ta opcja jest używana, Eksport Excel będzie używał rozwijanych/zwijanych grup, które mogą być nawigowane podobnie do drzewa katalogów.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <nazwa pliku>¶
Ta opcja umożliwia wyeksportowanie zawartości „Listy dysków” do pliku Excel, tekstowego lub CSV. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Przykład:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Jeśli zostanie określona, pliki będą uwzględniane we wszystkich Eksportach. Opcja ta jest więc równoważna aktywacji opcji „Narzędzia > Opcje > Eksport > * > Eksportowane elementy > Foldery i pojedyncze pliki”.
/EXPORTGROUPSEXPANDED¶
Jeśli określono, Eksport listy Rozszerzeń będzie zawierał wszystkie informacje o rozszerzeniach zawartych w grupach.
/EXPORTPATHSLIST <nazwa pliku>¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Eksportuje prostą listę zawierającą wszystkie wyniki wyszukiwania. Lista będzie zawierać tylko pełne ścieżki wyników wyszukiwania i żadnych innych informacji. Obsługiwane formaty pliku docelowego to .txt i .csv.
Ten przykład wyszuka i utworzy listę wszystkich plików exe na dysku C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Można go użyć do zaimportowania wyników poprzedniego wyszukiwania z powrotem do interfejsu użytkownika za pomocą opcji „File > List of paths > Import path list” lub parametru /IMPORT.
Jeśli opcja „Narzędzia > Opcje > Eksport > Uwzględnij zduplikowane grupy” jest aktywna, można również użyć tej funkcji do eksportowania i importowania wyników wyszukiwania duplikatów wraz z ich strukturą grupową.
/EXPORTTITLE ¶
Może być używany do zmiany tytułu w drukowanym raporcie lub eksportowanym pliku. Pozwala to na dostarczenie dodatkowych informacji użytkownikowi podczas korzystania z TreeSize w zautomatyzowanym środowisku. Dozwolone jest również użycie zmiennych środowiskowych. Przykład:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <nazwa pliku>¶
Ta opcja umożliwia zapisanie statystyk dotyczących rozszerzeń plików / typów plików skanowanej gałęzi systemu plików w pliku Excel, HTML, tekstowym lub CSV. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Eksportowane kolumny będą tymi, które były włączone w interfejsie użytkownika na karcie „Rozszerzenia”, gdy była ona ostatnio używana lub w momencie zapisu pliku konfiguracyjnego dostarczonego za pośrednictwem /OPTIONS.
Poniższy przykład skanuje dysk C: i tworzy plik Excel o nazwie „D:\TreeSize Reports\C_filetypes.xls” ze statystykami typów plików na tym dysku:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <nazwa pliku>¶
Zapisuje mały wykres wyświetlany na dole strony „Rozszerzenia” w pliku obrazu (bitmapa, GIF, PNG lub JPEG).
/EXTENSIONSPIECHART <nazwa pliku>¶
Zapisuje wykres kołowy przedstawiający rozkład „Rozszerzenia pliku” do pliku obrazu (bitmapa, GIF, PNG lub JPEG).
/FILTER <wzór1;wzór2>¶
Ustawia filtr plików liczący tylko pliki z określonymi rozszerzeniami, np. „.mp3” lub „.doc”. Można przekazać wiele wzorców, oddzielając je średnikiem (;). Poniższy przykład wyszuka pliki MP3 i AVI w katalogu „Users” na serwerze:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Podczas wykonywania wyszukiwania plików TreeSize (/SEARCH) można również użyć przełącznika wiersza poleceń /FILTER, aby określić wzorce zaawansowanego wyszukiwania plików. Aby wykonać bardziej złożone niestandardowe wyszukiwanie plików, należy zapisać opcje wyszukiwania w pliku i przekazać wynikowy plik XML do wiersza poleceń po /SEARCH.
/FOLLOWREPARSEPOINTS¶
Jeśli ten przełącznik zostanie dodany do wiersza poleceń, TreeSize będzie śledzić punkty montowania i zewnętrzne dowiązania symboliczne podczas skanowania drzewa systemu plików.
/GROUPSCANS¶
Użycie tego przełącznika wiersza poleceń spowoduje zgrupowanie wszystkich skanowanych katalogów w wirtualnym folderze głównym. Użyj /GROUPSCANS FALSE, jeśli chcesz upewnić się, że nie jest używany żaden wirtualny folder główny.
/HIDESMALLFOLDERS <wartość>¶
Pozwala ukryć obiekty, które są mniejsze niż minimalny rozmiar, co jest przydatne do uzyskania przejrzystego Eksportu. <value> może być wartością rozmiaru z jednostką lub zwykłą wartością bajtu bez jednostki. Nie może być używane w połączeniu z /EXPAND. W tym przykładzie eksportowane będą tylko foldery o minimalnym rozmiarze 50 MB:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <nazwa pliku>¶
Zapisuje wykres na karcie „Historia” zeskanowanego katalogu do pliku bitmapy, GIF, PNG lub JPEG. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Ten przykład tworzy obraz JPEG wykresu historii dla dysku C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <nazwa pliku>¶
Zapisuje zebrane dane do pliku HTML, który można przeglądać za pomocą dowolnej przeglądarki HTML. Można określić, które informacje ze skanowania zostaną uwzględnione w eksporcie poprzez „Home > Options > Eksport > HTML > Charts and lists to include” (Strona główna > Opcje > Eksport > HTML > Wykresy i listy do uwzględnienia). Można wybrać, które z dodatkowych list lub Wykresów powinny zostać dodane do Eksportu. Zostaną one automatycznie osadzone w pliku HTML generowanym po skanowaniu.
Poniższy przykład wygeneruje raport HTML dla dysku C: i zapisze go w „D:\HTML”:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Jeśli chcesz, aby więcej niż jeden skan był częścią pliku HTML, powinieneś dodać przełącznik wiersza poleceń /GROUPSCANS. W przypadku eksportu do formatu HTML bez dołączonego obrazu można alternatywnie użyć przełącznika /APPENDTOFILES. Bez jednej z tych flag plik HTML zostanie nadpisany.
/IMPORT <nazwa pliku>¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Wczytuje listę ścieżek do interfejsu użytkownika wyszukiwania plików TreeSize. File może być w formacie .txt lub .csv. Ten parametr może być używany do importowania wyników poprzedniego wyszukiwania. Zaimportowane pliki i foldery mogą być przenoszone/kopiowane/usuwane/archiwizowane, tak jak każdy „rzeczywisty” wynik wyszukiwania, przy użyciu okna dialogowego operacji na plikach.
Przykład:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Można również połączyć ten parametr z parametrami /RECYCLE, /DELETE lub /MOVE w celu automatycznego usunięcia lub przeniesienia plików zawartych w pliku tekstowym. Przykład:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <nazwa pliku>¶
Importuje listę wzorców z pliku. Plik może być prostym plikiem tekstowym z listą wzorców filtrów, oddzielonych średnikami, lub można użyć interfejsu użytkownika do utworzenia bardziej złożonego zestawu wzorców i użyć funkcji eksportu do wygenerowania pliku wzorca w formacie XML. Obsługiwane formaty to CSV, TXT i XML.
Zaimportowane wzorce będą używane jako filtry do skanowania w celu uwzględnienia lub wykluczenia określonych plików i folderów.
Jeśli parametr ten zostanie użyty w połączeniu z opcją wiersza poleceń /SEARCH, utworzy on nowe wyszukiwanie zaawansowane, które wykorzystuje wzorce z zaimportowanego pliku jako kryteria wyszukiwania.
Ten przykład zaimportuje wzorce filtra zdefiniowane w „C:\TreeSizeFiles\patterns.txt”, rozpocznie skanowanie dysku C:\ i wyeksportuje wyniki do pliku HTML:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <nazwa pliku>¶
Zapisuje wyniki skanowania do pliku SQLite, który może zostać wczytany do porównania w późniejszym czasie. Przykład:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <znak rozdzielający>¶
Umożliwia zdefiniowanie separatora używanego podczas eksportu plików tekstowych lub CSV. Pliki tekstowe domyślnie używają Tabulatora, pliki CSV separatora listy z ustawień regionalnych panelu sterowania Windows.
Po tym przełączniku należy podać pojedynczy znak lub ciąg znaków „TAB” dla tabulatora. Przykłady:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <ścieżka>¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Przenosi wyniki wyszukiwania plików TreeSize do innej lokalizacji.
Poniższe polecenie przeszuka dysk lokalny C: przy użyciu najnowszych opcji wyszukiwania i przeniesie wyniki wyszukiwania do folderu „C:\Temp\ObsoleteFiles”:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Zobacz także: Przenoszenie sprawdzonych plików
/NOGUI¶
Nie zostanie wyświetlone żadne okno, a aplikacja nie pojawi się na pasku zadań. Przydatne do wykonywania skanowania lub wyszukiwania w tle, bez wizualnej informacji zwrotnej.
Ostrzeżenie
Tego przełącznika należy używać tylko po przetestowaniu pozostałych opcji wiersza poleceń, ponieważ w tym trybie nie można wyświetlać komunikatów o błędach.
Błędy będą jednak rejestrowane w dzienniku zdarzeń systemu Windows.
/NOHEADERS¶
Pomija linie nagłówka zwykle zapisywane na górze plików eksportu skanowania lub wyszukiwania. Ułatwia to odbieranie zwykłych danych do przetwarzania końcowego.
/NOUNITS¶
Pomija jednostki zwykle zapisywane po wartościach rozmiaru. Ta opcja w połączeniu z /SIZEUNIT 0 spowoduje eksport zwykłych wartości bajtowych. Ułatwia to otrzymywanie zwykłych danych do przetwarzania końcowego.
Informacja
Ten wiersz poleceń będzie miał wpływ tylko na Eksport drzewa katalogów, wygenerowany przy użyciu opcji /TEXT, /EXCEL, /HTML, /EMAIL, lub /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST lub /TOPFILESLIST nie będą miały wpływu.
/OPEN <nazwa pliku>¶
Otwiera zapisany raport XML przy uruchomieniu aplikacji. Przykład:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <nazwa pliku>¶
Użyj tego parametru, aby zastosować wyeksportowane ustawienia użytkownika do TreeSize. Ustawienia użytkownika można wyeksportować za pomocą opcji „File > Options > Eksport”. Przykład:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Informacja
Zmień jak najwięcej ustawień w interfejsie użytkownika przed zapisaniem opcji, aby zmniejszyć liczbę potrzebnych parametrów wiersza poleceń.
/PDF¶
Zapisuje wyniki do pliku PDF po zakończeniu skanowania lub wyszukiwania. Po zapisaniu aplikacja zakończy działanie. Poniższy przykład wykona skanowanie dysku lokalnego C: i zapisze wyniki do pliku PDF:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <nazwa pliku>¶
Zapisuje wykres kołowy zeskanowanego katalogu w pliku bitmapy, GIF, PNG lub JPEG. Typ pliku zależy od rozszerzenia określonej nazwy pliku. Poniższy przykład spowoduje zeskanowanie dysku C: i wyeksportowanie wykresu kołowego w formacie PNG:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Drukuje raport dla zeskanowanego drzewa katalogów przy użyciu domyślnej drukarki skonfigurowanej w ustawieniach systemu. Po wydrukowaniu aplikacja zostanie zamknięta. Przykład:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <wartość>¶
Jeśli wartość jest ustawiona na true, opcja ta aktywuje tryb tylko do odczytu, w którym operacje na plikach (np. przenoszenie lub usuwanie) są wyłączone, więc będzie on używany tylko jako narzędzie do raportowania.
Zacznij od wartości false, aby ponownie dezaktywować tryb tylko do odczytu.
/RECYCLE¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Przenosi wszystkie pliki do kosza, które zostały znalezione w wyniku wyszukiwania plików TreeSize. Przykład:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Zobacz także: Przenoszenie sprawdzonych plików
/RESTRICTEDMODE <wartość>¶
Jeśli wartość jest ustawiona na true, opcja ta aktywuje tryb ograniczony, w którym wyłączonych jest wiele funkcji, które nie są interesujące dla „normalnych” (nie-administratorów) użytkowników. Wśród wyłączonych funkcji są: Sprawdź aktualizację, Otwórz aplet Oprogramowanie w Panelu sterowania systemu Windows, Zaplanuj skanowanie TreeSize, Podłącz dysk sieciowy, Skonfiguruj przywracanie systemu Windows, Uruchom jako administrator, Eksport i Zastosuj kompresję NTFS. Ścieżkę, która powinna zostać przeskanowana, np. katalog domowy użytkownika, można podać w wierszu poleceń lub za pomocą opcji Startup Paths w zapisanym pliku konfiguracyjnym.
Zacznij od wartości false, aby ponownie dezaktywować tryb ograniczony.
Jeśli dodatkowo aktywujesz opcję /READONLYMODE, użytkownik nie będzie mógł usuwać ani przenosić File w TreeSize, więc będzie on użyteczny tylko jako narzędzie do raportowania.
/SCAN <ścieżka|nazwa pliku>¶
Określa, który dysk lub ścieżka powinny zostać przeskanowane. Ścieżka skanowania powinna być używana jako wartość tego parametru.
Jeśli na przykład skanowany ma być dysk D:\, można użyć opcji:
Treesize /SCAN "D:\"
Jeśli nie chcesz skanować całego dysku, możesz również określić ścieżkę, która będzie używana jako punkt początkowy skanowania. Na przykład:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Możliwych jest również wiele ścieżek skanowania, są one oddzielone spacją. Ścieżki zawierające spację muszą być ujęte w cudzysłów („). Przykład:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Dozwolone są symbole wieloznaczne „*” i „?”. Przykład:
Treesize /SCAN "H:\users\A*"
Można również określić plik tekstowy, który zawiera listę ścieżek, które powinny zostać przeskanowane. TreeSize przeskanuje wszystkie ścieżki znalezione w pliku tekstowym, który jest określony po tym przełączniku. File tekstowy musi zawierać jedną ścieżkę w wierszu. Poniższy przykład skanuje wszystkie ścieżki znalezione w pliku „D:\PathsToScan.txt” i zapisuje każdy wynik skanowania do osobnego arkusza w pliku Excel File z dzisiejszą datą:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Możesz również wywołać TreeSize w pętli „for” tylko z jedną ze ścieżek, przykład znajdziesz poniżej.
/SEARCH¶
Otwiera okno wyszukiwania File programu TreeSize. Jeśli do tej opcji wiersza poleceń zostanie dodane „:Start”, wyszukiwanie zostanie uruchomione automatycznie. Można przekazać wcześniej zapisany plik XML zawierający ustawienia wyszukiwania, które zostaną następnie użyte do przeprowadzenia wyszukiwania.
Informacja
File, które zostaną znalezione podczas tego wyszukiwania, są automatycznie sprawdzane.
Poniższy przykład przeprowadza wyszukiwanie z ustawieniami, które zostały wcześniej zapisane w pliku „SearchSettings.xml” i zapisuje wyniki w pliku tekstowym:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Informacja
Zasadniczo używane będą ostatnie ustawienia wyszukiwania lub poprzedni zapisany zestaw ustawień wyszukiwania. Można jednak również określić wzorce wyszukiwania dla wyszukiwania zaawansowanego za pomocą opcji wiersza poleceń /FILTER.
/SHEETNAME ¶
Umożliwia określenie nazwy arkusza, który zostanie dodany do pliku Excel podczas korzystania z przełącznika wiersza poleceń /EXCEL.
Informacja
Nazwa arkusza Excel musi być unikalna w pliku Excel, a niektóre znaki specjalne, takie jak ukośniki, ukośniki odwrotne i dwukropki są zabronione. TreeSize zawsze utworzy unikalną nazwę arkusza, zastępując nieprawidłowe znaki podkreślnikami i dodając datę i godzinę, jeśli to konieczne. Jeśli arkusz o podanej nazwie istnieje już w pliku docelowym, tworzony jest nowy arkusz o unikalnej nazwie. Użyj opcji wiersza poleceń /APPENDTOFILES, aby dołączyć dane do istniejącego arkusza.
/SHORTDATEFORMAT <format>¶
Zmienia krótki format daty dla tego procesu, który można skonfigurować w opcjach regionalnych Panelu sterowania systemu Windows. Eksport TreeSize będzie używał tego formatu dla wartości daty. Przykład:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Opcja ta może być używana do określenia jednostki używanej do wyświetlania wartości rozmiaru: N może mieć wartości od 0 do 5, które oznaczają: 0 = Bajty, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Jednostki automatyczne. Bez tej opcji zostanie użyta ostatnio używana konfiguracja w TreeSize.
/SORTBY <ColumnName>¶
Umożliwia określenie, według której wartości będą sortowane wygenerowane Eksporty. Możliwe wartości to nazwy kolumn, takie jak „Size” lub „Name”. Ostatnio używany typ sortowania w interfejsie użytkownika TreeSize będzie używany domyślnie. Przykład:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <nazwa pliku>¶
Zapisuje wyniki skanowania do pliku SQLite, który może zostać wczytany do porównania w późniejszym czasie. Przykład:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <podmiot>¶
Ta opcja umożliwia dostosowanie tematu, który będzie używany w wiadomościach e-mail wysyłanych po zakończeniu skanowania. Przykład:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <nazwa pliku>¶
Zapisuje wyniki do pliku tekstowego lub CSV po zakończeniu skanowania lub wyszukiwania. Aplikacja zakończy działanie po zapisaniu wyników. Poniższy przykład wykona skanowanie dysku lokalnego C: i zapisze wyniki do pliku tekstowego:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
Format tekstowy wykorzystuje format tabelaryczny skierowany do ludzkich czytelników. Jeśli nazwa pliku odwołuje się do pliku CSV, format CSV zostanie użyty automatycznie. Jeśli chcesz wyraźnie użyć formatu CSV, zalecamy użycie parametru /CSV.
/TITLE <title>¶
Może być użyty do zastąpienia głównej ścieżki skanowania niestandardowym tekstem. Pozwala to na przykład nadać bardziej znaczące nazwy ścieżkom UNC, a tym samym zwiększyć czytelność raportu. Wybrany tytuł zostanie zastosowany jako tytuł raportu podczas eksportu pliku. Przykład:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
W kontekście wyszukiwania plików TreeSize, parametr ten może być użyty do nazwania wyszukiwania zaawansowanego. Przykład:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <nazwa pliku>¶
Ta opcja umożliwia zapisanie zawartości listy Top files do pliku Excel, HTML, Text lub CSV. Typ pliku zależy od rozszerzenia podanej nazwy pliku. Przykład:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <nazwa pliku>¶
Zapisuje mapę drzewa zeskanowanego katalogu jako bitmapę, plik GIF, PNG lub JPEG. Typ pliku zależy od rozszerzenia podanej nazwy pliku. Przykład:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Ustawia poziom interfejsu użytkownika. Możliwe wartości to Simple, Normal lub Expert. Przykład:
Treesize /UILevel "Simple"
/USERSLIST <nazwa pliku>¶
Ta opcja umożliwia zapisanie statystyk przedstawiających wyniki pogrupowane według nazwy użytkownika do pliku Excel, HTML, tekstowego lub CSV. Typ pliku zależy od rozszerzenia podanej nazwy pliku. Eksportowane kolumny będą tymi, które były włączone w interfejsie użytkownika na karcie „Użytkownicy”, gdy był on ostatnio używany lub w czasie, gdy plik konfiguracyjny dostarczony przez /OPTIONS został zapisany.
Poniższy przykład skanuje dysk C: i tworzy plik Excel w „C:\Temp” ze statystykami użytkowników na tym dysku:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <nazwa użytkownika>¶
Określa nazwę użytkownika, która powinna być używana do uwierzytelniania podczas skanowania. Użyj /PASSWORD, aby określić hasło dla tej nazwy użytkownika. Zamiast tego zaleca się użycie narzędzia Microsoft RUNAS.
/USERFILTER <nazwa użytkownika>¶
Dzięki tej opcji tylko pliki należące do określonego użytkownika będą brane pod uwagę podczas skanowania. Po przełączeniu należy podać nazwę tego użytkownika.
Informacja
Nie można tu używać wielu nazw użytkowników, ale obsługiwane są symbole wieloznaczne „*” i „?”.
Przykład:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <nazwa pliku>¶
Zapisuje mały wykres wyświetlany na dole strony „Użytkownicy” do pliku obrazu (bitmapa, GIF, PNG lub JPEG).
/USERSPIECHART <nazwa pliku>¶
Zapisuje wykres kołowy przedstawiający „statystyki użytkownika” bieżącego skanowania w pliku obrazu (bitmapa, GIF, PNG lub JPEG).
/VIEWTYPE n¶
Określa, na jakich wartościach oparte są kolumny „Procent rodziców”, „Wzrost” i wykres „Wiek plików”. Możliwe wartości to:
2: Rozmiar 3: Allocated Space (Rozmiar na dysku) 7: Number of File (Liczba plików)
/XML <nazwa pliku>¶
Zapisuje wyniki skanowania w pliku XML, który można później wczytać w celu porównania. Przykład:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Opcja ta może być połączona z przełącznikiem /EXPAND w celu ograniczenia eksportowanych katalogów.
Informacja
Podczas ładowania ograniczonego eksportu XML do TreeSize nie można nawigować po całej gałęzi katalogów, a jedynie po wyeksportowanych katalogach.
/ZIP <nazwa pliku>¶
Opcja ta może być używana tylko w połączeniu z opcją wiersza poleceń /SEARCH.
Wszystkie pliki znalezione w wyniku wyszukiwania TreeSize zostaną przeniesione do archiwum zip. Przykład:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Zobacz także: Przenoszenie sprawdzonych plików
<SCANPATH>¶
Oprócz parametru /SCAN, można również przekazać jedną lub więcej ścieżek na końcu wiersza poleceń. Nie jest to już jednak zalecane, aby uniknąć błędów podczas analizowania wiersza poleceń.
Ten przykład skanuje folder „Program Files” oraz folder „Windows” i tworzy raport tekstowy w folderze „C:\Reports\ScanResults.txt”:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
W przypadku wystąpienia błędu, zostanie on zwrócony jako kod błędu systemu Windows w kodzie wyjścia procesu. Zmienne środowiskowe (np. %APPDATA%) mogą być używane w nazwach plików dla Eksportu, jak również w ścieżkach skanowania.
Skanowanie wielu katalogów¶
Jeśli konieczne jest skanowanie wielu katalogów, dobrym pomysłem może być na przykład połączenie kilku połączeń w Batch File:
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"
Polecenie „START /WAIT” zapewnia sekwencyjne uruchamianie zadań. Nierównoległe uruchamianie zadań jest zwykle lepsze, ponieważ pojedyncze zadanie lepiej wykorzystuje pamięć podręczną i zasoby systemowe. Możliwe jest również zapisanie udziałów, które powinny zostać przeskanowane w pliku tekstowym i użycie polecenia „for” systemu Windows w ten sposób:
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"
Informacja
Podwójne znaki procentu są wymagane w plikach wsadowych, w wierszu poleceń należy używać tylko pojedynczego procentu.
Zaplanowany start¶
Możesz użyć Zaplanowanych Zadań Windows, aby uruchamiać TreeSize z określonymi opcjami wiersza poleceń codziennie, co tydzień lub co miesiąc o określonej godzinie. Okno dialogowe dla Planowanie skanowania pomoże ci skonfigurować zaplanowane zadanie.
Można również użyć polecenia SCHTASKS, aby wykonać zaplanowane skanowanie. Jeśli na przykład chcesz przeskanować dyski C: i E: następnej nocy o 03:00 i zapisać wyniki w pliku Excel, możesz użyć następującego wiersza poleceń:
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"
Uzyskaj pomoc na temat polecenia SCHTASKS na stronach Microsoftu <https://technet.microsoft.com/en-us/library/ff356867.aspx?f=255&MSPPError=-2147217396>`_ lub wpisując:
SCHTAKS /Create /?
Informacja
Komunikaty o błędach pojawiające się podczas zaplanowanego skanowania są wyświetlane w dzienniku zdarzeń systemu Windows.
PowerShell¶
Windows PowerShell może być użyteczna w połączeniu z TreeSize. Ten przykład pokazuje, jak przeszukać kilka zdalnych komputerów, które są odpytywane za pomocą zapytania LDAP w usłudze 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
Przekierowanie wyjścia¶
Jeśli nie podano innego celu eksportu, TreeSize zapisze krótki eksport skanowania na standardowe wyjście, a błędy, które wystąpiły podczas skanowania, na standardowy błąd.
Można przekierować te strumienie wyjściowe w wierszu poleceń (cmd.exe) za pomocą symbolu potoku, np.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
Aby przekierować dane wyjściowe za pomocą PowerShell, należy zamiast tego użyć polecenia Start-Process, np.
Start-Process -FilePath „C:\Program Files\JAM Software\TreeSize\Treesize.exe” -ArgumentList „/NOGUI /SCAN C:" -RedirectStandardOutput „.\StdOut.txt” -RedirectStandardError „.\StdError.txt”
Windows Scripting Host¶
Jeśli zamierzasz korzystać z Windows Scripting Host (WSH), polecenie uruchomienia TreeSize będzie wyglądać następująco:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Kody wyjścia¶
Jeśli operacja została zakończona pomyślnie, kod wyjścia wynosi 0. Jeśli wystąpił błąd, TreeSize zwróci Kod błędu Windows jako kod wyjścia, jeśli jest dostępny, lub 1, aby wskazać ogólny błąd.
W każdym przypadku dziennik zdarzeń systemu Windows będzie zawierał dalsze informacje w dzienniku „Aplikacja”, źródło zdarzeń „TreeSize”.