Befehlszeilenoptionen

Die Professional Edition von TreeSize akzeptiert Befehlszeilenoptionen, die es Ihnen ermöglichen, geplante Scans auszuführen oder die Ergebnisse eines Scans am nächsten Morgen auf Ihrem Monitor anzuzeigen.

Der Dialog für Scans planen hilft Ihnen, eine Befehlszeile mit den folgenden Optionen zu erstellen.

Bemerkung

Diese Optionen sind nur in der TreeSize Professional Edition verfügbar.

Alle Optionen

Treesize.exe [/OPTION] SCANPATH

/? oder /HELP

Zeigt diese Hilfeseite an.

/AGEOFFILES

Das im Kontext-Reiter „Dateialter“ gezeigte Diagramm des gescannten Verzeichnisses wird in einer Bitmap-, GIF-, PNG-, JPEG-, Text- oder CSV-Datei gespeichert. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Das folgende Beispiel erstellt eine JPEG-Bilddatei des Diagramms „Dateialter“ für Ihr lokales Laufwerk C:

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

/APPENDTOFILES <Wert>

Mit dieser Option können Sie auswählen, ob TreeSize seine Ausgabe an vorhandene Dateien anhängen soll, wenn Sie einen Export durchführen, z. B. bei Verwendung von /TEXT. Wählen Sie „True“, um anzuhängen, und „False“, wenn Sie vorhandene Dateien überschreiben möchten.

Bemerkung

Dieser Parameter funktioniert nicht mit exportierten Bildern, XML- und PDF-Dateien. Diese Dateien werden immer überschrieben. Sie können den Schalter /DATE verwenden, um sicherzustellen, dass alle generierten Berichte einen eindeutigen Dateinamen haben.

Beim Exportieren in eine Excel-Datei über /EXCEL kann dieser Parameter zusammen mit /SHEETNAME verwendet werden, um die Daten an das angegebene Blatt anzuhängen. Beispiel:

Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"

Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"

/ARCHIVEBITFILESONLY

Diese Option umfasst nur Dateien, für die das Archivbit in den Scans gesetzt wurde. Diese Option kann sehr nützlich sein, wenn Sie die Größe eines Backups berechnen möchten. In diesem Fall können Sie eine Verknüpfung auf Ihrem Desktop oder im Startmenü erstellen, die automatisch die Größe Ihres Backups berechnet. Beispiel:

Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"

/ATTACH

Wenn angegeben, werden alle exportierten Dateien an die E-Mail angehängt. Wenn nicht angegeben, werden Dateien mit einem ausdrücklich angegebenen Pfad nicht angehängt. Dies ist nützlich, falls Ihre XML- oder Excel-Dateien recht groß werden und Ihr E-Mail-Konto füllen.

Dieses Beispiel exportiert in eine Excel-Datei, fügt sie jedoch nicht an die E-Mail an:

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"

Diese Beispiele fügen die Excel-Datei an die E-Mail an:

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"

/BARCHART <Dateiname>

Speichert das Balkendiagramm des gescannten Verzeichnisses in einer Bitmap-, GIF-, PNG- oder JPEG-Datei. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Dieses Beispiel erstellt eine PNG-Bilddatei des Balkendiagramms für Ihr lokales Laufwerk C:

Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"

/COMPARE <Dateiname|Pfad>

Vergleicht den gescannten Pfad mit einer gespeicherten Indexdatei. Das folgende Beispiel scannt das Laufwerk C: und vergleicht das Ergebnis mit einem gespeicherten XML-Bericht für dieses Laufwerk:

Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"

Anstelle einer Indexdatei können Sie auch einen Pfad mit diesem Befehlszeilenparameter verwenden. Der angegebene Pfad wird mit dem aktuellen Scanergebnis verglichen. Das folgende Beispiel scannt das Laufwerk C:und verwendet zusätzlich den Pfad D:Backup_of_C, um einen Vergleich zwischen den beiden durchzuführen:

Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"

Alternativ können Sie zwei bereits vorhandene Indexdateien, z.B. „c1.xml.zip“ und „c2.xml.zip“, mit diesem Befehl vergleichen:

Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"

Der Befehl /OPEN bereitet den Vergleich der beiden Dateien vor, indem die erste Datei („c1.xml.zip“) in eine Scan-Datei entpackt wird. Die zweite Datei („c2.xml.zip“) wird mit dieser entpackten Scan-Datei verglichen, so wie es geschehen würde, wenn „c2.xml.zip“ mit einem „echten“ Scan verglichen würde.

/COPY <Pfad>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Kopiert die Ergebnisse einer TreeSize-Dateisuche an den Zielort.

Der folgende Befehl sucht auf Ihrem lokalen Laufwerk C: unter Verwendung der neuesten Suchoptionen und kopiert die Suchergebnisse in den Ordner „C:tempObsoleteFiles“:

Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"

Siehe auch: Ausgewählte Dateien verschieben

/CREATEDPASTDAYSONLY <n>

Diese Option umfasst nur Dateien in den Scans, die während der im Argument eingegebenen Anzahl von Tagen erstellt wurden. Im folgenden Beispiel umfasst diese Option nur Dateien, die in den letzten acht Tagen im Scan erstellt wurden:

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <Laufwerk>

Erstellt einen Snapshot für die Laufwerke, die nach diesem Befehlszeilenparameter angegeben werden. Beispiel:

Treesize /CREATESNAPSHOT "C:\" "D:\"

Das Erstellen von Snapshots kann administrative Berechtigungen erfordern.

/CSV <Dateiname>

Speichert die Ergebnisse in einer CSV-Datei, nachdem der Scan oder die Suche abgeschlossen ist. Die Anwendung wird sich nach dem Speichern selbst beenden. Dieses Beispiel speichert die Ergebnisse einer Dateisuche auf Ihrem lokalen Laufwerk C: mit den letzten Suchkonfigurationen in einer CSV-Datei:

Treesize /SEARCH:Start /SCAN  "C:\" /CSV "C:\Results\C_search.csv"

/DATE

Dieser Schalter fügt allen Exportdateinamen in der Befehlszeile das aktuelle Datum und die aktuelle Uhrzeit hinzu. Dies ist nützlich, wenn Sie regelmäßig Scans durchführen möchten, z. B. jede Nacht oder jedes Wochenende. Das folgende Beispiel scannt den Netzwerkpfad „\HostShare“ und speichert das Ergebnis in einer Datei wie „C:Scansname_2013-08-14_17-18-24.xls“:

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

/DEDUPLICATE

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Es wird die Duplikatdateien, die durch die TreeSize-Duplikatsuche gefunden wurden, durch NTFS-Hardlinks ersetzt:

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

/DELETE

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Löscht dauerhaft alle Dateien, die als Ergebnis einer TreeSize-Dateisuche gefunden wurden. Beispiel:

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

Siehe auch: Ausgewählte Dateien verschieben

/EMAIL <recipient>

Sendet die gesammelten Daten an die angegebene E-Mail-Adresse. Dieser Parameter kann nur einmal in der Befehlszeile verwendet werden, und es wird nur eine E-Mail mit allen Ergebnissen gesendet. Mehrere Empfänger können durch Semikolons (;) oder Kommas getrennt werden. Um E-Mails über die Befehlszeile zu senden, müssen Sie gültige SMTP-Einstellungen auf der entsprechenden Seite im TreeSize-Optionsdialog angeben. Beispiel:

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"

Wenn keine anderen Parameter angegeben wurden, wird die E-Mail im Format gesendet, das in den Optionen festgelegt ist (HTML oder Nur-Text). Wenn Sie das Format unabhängig von den aktuellen Optionen festlegen möchten, können Sie die Parameter /TEXT oder /HTML direkt hinter der Definition der Empfängeradresse(n) verwenden. Beispiel:

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT

Durch die Kombination von Parametern können Sie auch Anhänge an die E-Mail hinzufügen. Das folgende Beispiel fügt einen Excel-Bericht des Scans als Anhang zur E-Mail hinzu:

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL

/EMAILIFRESULTSFOUND

Diese Option kann nur in Kombination mit den Befehlszeilenoptionen /SEARCH und /EMAIL verwendet werden. Wenn dieser Parameter angegeben ist, sendet TreeSize nur eine E-Mail mit den aktuellen Suchergebnissen, wenn während der Suche mindestens eine Datei oder ein Ordner gefunden wurde, durch einen der angegebenen Suchtypen.

/EMPTYRECYCLEBIN

Wenn Sie diese Option verwenden, leert TreeSize den Papierkorb, bevor der aktuelle Scan ausgeführt wird. Beispiel:

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE <Dateiname>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Dieser Parameter ermöglicht das Übergeben von Dateien, die durch die TreeSize-Dateisuche gefunden wurden, an eine andere Anwendung oder ein Skript. Ein mögliches Ziel für diesen Parameter kann eine Batch-Datei oder ein PowerShell-Skript sein. Das folgende Beispiel sucht auf dem Laufwerk C:mit den aktuellsten Suchparametern und ruft das Skript „Archive.bat“ für jede gefundene Datei auf. Die Datei wird als Befehlszeilenparameter an das Skript übergeben:

Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"

Siehe auch: Ausgewählte Dateien verschieben

/EXCEL <filepath>

Exportiert die gesammelten Daten im Microsoft Excel-Format und speichert sie unter dem eingegebenen Dateipfad. Wenn nur ein Dateiname angegeben ist, wird das aktuelle Installationsverzeichnis verwendet, um den Export zu speichern. Unterstützte Formate sind das herkömmliche .XLS-Dateiformat (Excel 97-2003) sowie das .XLSX-Format (eingeführt mit Excel 2007). Das verwendete Format hängt von der Erweiterung des angegebenen Dateinamens ab. Die Anwendung wird sich nach dem Speichern selbst beenden. Beispiel:

Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"

Wenn der Dateiname bereits existiert, wird die Datei geöffnet und ein neues Arbeitsblatt hinzugefügt.

Bemerkung

Im TreeSize File Search (/SEARCH) werden die Ergebnisse jedes Suchtyps in ihrem eigenen spezifischen Arbeitsblatt gesammelt. Wenn die Datei unter dem angegebenen Pfad bereits existiert, werden diese Blätter überschrieben. Um dies zu verhindern, müssen Sie die Befehlszeilenoption /APPENDTOFILES verwenden.

/EXCLUDE <pattern1;pattern2>

Diese Option ermöglicht es Ihnen, Muster für Dateien und Ordner anzugeben, die von einem Scan ausgeschlossen werden sollen. Mehrere Ausschlussmuster können durch ein Semikolon (;) getrennt werden. Wenn eines oder mehrere der Muster Leerzeichen enthalten, muss die gesamte Musterzeichenfolge in Anführungszeichen (“) gesetzt werden. Das folgende Beispiel ignoriert Dateien und Ordner, die mit „.tmp“ enden oder deren exakter Name „system“ ist:

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

/EXPAND <level|size>

Diese Option ermöglicht es Ihnen, anzugeben, wie viele Ebenen im Verzeichnisbaum nach dem Scannen erweitert werden. Wenn Sie keine Zahl nach dieser Option angeben, werden alle Ordner erweitert. Anstelle einer Verzeichnisebene können Sie auch einen Betrag in Megabyte (MB) angeben. In diesem Fall werden alle Ordner, die größer als der angegebene Betrag sind, erweitert. Die Einheit „MB“ muss ohne Leerzeichen hinter der Zahl folgen. Das folgende Beispiel scannt den Ordner „H:User“, erweitert alle Ordner, die größer als 10 MB sind, und speichert das Ergebnis in der Excel-Datei „C:ResultsAllusers.xlsx“:

Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB

/EXPANDABLEREPORT <Wert>

Wenn diese Option verwendet wird, verwenden Excel-Exporte erweiterbare/zusammenklappbare Gruppen, die ähnlich wie der Verzeichnisbaum navigiert werden können.

Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"

Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"

/EXPORTDRIVESLIST <dateiname>

Diese Option ermöglicht es Ihnen, den Inhalt der „Laufwerksliste“ in eine Excel-, Text- oder CSV-Datei zu exportieren. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Beispiel:

Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST

/EXPORTFILES

Wenn angegeben, werden Dateien in allen Exporten einbezogen. Diese Option entspricht der Aktivierung der Option „Extras > Optionen > Export > * > Exportierte Elemente > Ordner und einzelne Dateien“

/EXPORTGROUPSEXPANDED

Wenn angegeben, enthält der Export der Erweiterungsliste alle Informationen über die in Gruppen enthaltenen Erweiterungen.

/EXPORTPATHSLIST <Dateiname>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Exportiert eine einfache Liste, die alle Suchergebnisse enthält. Die Liste enthält nur die vollständigen Pfade der Suchergebnisse und keine weiteren Informationen. Unterstützte Formate für die Zieldatei sind .txt und .csv.

Dieses Beispiel sucht nach und erstellt eine Liste aller exe-Dateien auf Laufwerk C:

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

Es kann verwendet werden, um die Ergebnisse einer vorherigen Suche wieder in die Benutzeroberfläche zu importieren, indem Sie „Datei > Liste der Pfade > Pfadliste importieren“ oder den Parameter /IMPORT verwenden.

Wenn die Option „Extras > Optionen > Export > Duplikatgruppen einbeziehen“ aktiviert ist, können Sie diese Funktion auch verwenden, um die Ergebnisse der Duplikatsuche einschließlich ihrer Gruppenstruktur zu exportieren und zu importieren.

/EXPORTTITLE <titel>

Kann verwendet werden, um den Titel innerhalb eines gedruckten Berichts oder einer exportierten Datei zu ändern. Dies ermöglicht es Ihnen, dem Benutzer zusätzliche Informationen bereitzustellen, wenn Sie TreeSize in einer automatisierten Umgebung verwenden. Die Verwendung von Umgebungsvariablen ist ebenfalls erlaubt. Beispiel:

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

/EXTENSIONSLIST <Dateiname>

Mit dieser Option können Sie die Statistik über Dateierweiterungen/Dateitypen des gescannten Dateisystemzweigs in einer Excel-, HTML-, Text- oder CSV-Datei speichern. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Exportiert werden die Spalten, die in der Benutzeroberfläche auf dem Reiter „Erweiterungen“ bei der letzten Verwendung oder beim Schreiben der über /OPTIONS bereitgestellten Konfigurationsdatei aktiviert waren.

Das folgende Beispiel scannt Laufwerk C: und erstellt eine Excel-Datei mit dem Namen „D:TreeSize ReportsC_filetypes.xls“ mit den Statistiken der Dateitypen auf diesem Laufwerk:

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

/EXTENSIONSCHART <Dateiname>

Speichert das kleine Diagramm, das am unteren Rand der Seite „Erweiterungen“ angezeigt wird, in einer Bilddatei (Bitmap, GIF, PNG oder JPEG).

/EXTENSIONSPIECHART <filename>

Speichert ein Kreisdiagramm, das die Verteilung der „Dateierweiterungen“ in einer Bilddatei (Bitmap, GIF, PNG oder JPEG) anzeigt.

/FILTER <pattern1;pattern2>

Setzt einen Dateifilter, der nur Dateien mit bestimmten Erweiterungen zählt, z. B. „.mp3“ oder „.doc“. Mehrere Muster können über ein Semikolon (;) übergeben werden. Das folgende Beispiel sucht nach MP3- und AVI-Dateien im Verzeichnis „Users“ auf dem Server:

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

Bei der Durchführung einer TreeSize File Search (/SEARCH) können Sie auch den Befehlszeilen-Schalter /FILTER verwenden, um die Muster der erweiterten Dateisuche anzugeben. Um eine komplexere benutzerdefinierte Dateisuche durchzuführen, sollten Sie die Suchoptionen in einer Datei speichern und die resultierende XML-Datei nach /SEARCH an die Befehlszeile übergeben.

/FOLLOWREPARSEPOINTS

Wenn dieser Schalter zur Befehlszeile hinzugefügt wird, folgt TreeSize den Einhängepunkten und externen symbolischen Links beim Scannen eines Dateisystembaums.

/GROUPSCANS

Durch die Verwendung dieses Befehlszeilenschalters werden alle gescannten Verzeichnisse unter einem virtuellen Stammordner gruppiert. Verwenden Sie /GROUPSCANS FALSE, wenn Sie sicherstellen möchten, dass kein virtueller Stammordner verwendet wird.

/HIDESMALLFOLDERS <Wert>

Ermöglicht das Ausblenden von Objekten, die kleiner als eine Mindestgröße sind, was nützlich ist, um klare Exporte zu erhalten. <Wert> kann ein Größenwert mit Einheit oder ein einfacher Byte-Wert ohne Einheit sein. Kann nicht in Kombination mit /EXPAND verwendet werden. In diesem Beispiel werden nur Ordner mit einer Mindestgröße von 50 MB exportiert:

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

/HISTORYCHART <Dateiname>

Speichert das Diagramm aus dem Kontext-Reiter „Historie“ des gescannten Verzeichnisses in einer Bitmap-, GIF-, PNG- oder JPEG-Datei. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. In diesem Beispiel wird ein JPEG-Bild des Verlaufsdiagramms für Laufwerk C erstellt:

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

/HTML <Dateiname>

Speichert die gesammelten Daten in einer HTML-Datei, die mit jedem HTML-Browser angezeigt werden kann. Sie können angeben, welche Informationen des Scans in den Export aufgenommen werden sollen über „Start > Optionen > Export > HTML > Diagramme und Listen, die einbezogen werden sollen“. Sie können auswählen, welche der zusätzlichen Listen oder Diagramme dem Export hinzugefügt werden sollen. Diese werden automatisch in die HTML-Datei eingebettet, die nach dem Scan erstellt wird.

Das folgende Beispiel generiert einen HTML-Bericht für das Laufwerk C: und speichert ihn unter „D:HTML“:

Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"

Wenn Sie mehr als einen Scan in die HTML-Datei aufnehmen möchten, sollten Sie den Befehlszeilenschalter /GROUPSCANS hinzufügen. Beim Exportieren nach HTML ohne ein enthaltenes Bild könnten Sie alternativ den Schalter /APPENDTOFILES verwenden. Ohne einen dieser Schalter wird die HTML-Datei überschrieben.

/IMPORT <Dateiname>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Lädt eine Liste von Pfaden in die Benutzeroberfläche der TreeSize-Dateisuche. Die Datei kann im .txt- oder .csv-Format vorliegen. Dieses Parameter kann verwendet werden, um Ergebnisse einer vorherigen Suche zu importieren. Die importierten Dateien und Ordner können wie jedes „lebende“ Suchergebnis mit dem Dialogfeld für Dateioperationen verschoben/kopiert/gelöscht/archiviert werden.

Beispiel:

Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"

Sie können dieses Parameter auch mit den Parametern /RECYCLE, /DELETE oder /MOVE kombinieren, um die in der Textdatei enthaltenen Dateien automatisch zu löschen oder zu verschieben. Beispiel:

Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE

/IMPORTPATTERNS <Dateiname>

Importiert eine Liste von Mustern aus einer Datei. Die Datei kann eine einfache Textdatei mit einer Liste von Filtermustern sein, die durch Semikolons getrennt sind, oder Sie können die Benutzeroberfläche verwenden, um ein komplexeres Set von Mustern zu erstellen und die Exportfunktion zu nutzen, um die Musterdaten im XML-Format zu generieren. Unterstützte Formate sind CSV, TXT und XML.

Die importierten Muster werden als Filter für den Scan verwendet, um bestimmte Dateien und Ordner entweder einzuschließen oder auszuschließen.

Wenn dieser Parameter in Kombination mit der Befehlszeilenoption /SEARCH verwendet wird, erstellt er eine neue erweiterte Suche, die die Muster aus der importierten Datei als Kriterien für die Suche verwendet.

Dieses Beispiel importiert Filtermuster, die unter „C:TreeSizeFilespatterns.txt“ definiert sind, startet einen Scan für das Laufwerk C:und exportiert die Ergebnisse in eine HTML-Datei:

Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"

/INDEXFILE <filename>

Speichert die Scanergebnisse in einer SQLite-Datei, die später für Vergleiche geladen werden kann. Beispiel:

Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"

/LISTSEPARATOR <Trennzeichen>

Ermöglicht es Ihnen, das Trennzeichen zu definieren, das beim Exportieren von Text- oder CSV-Dateien verwendet wird. Textdateien verwenden standardmäßig den Tabulator, CSV-Dateien das Listentrennzeichen aus den regionalen Einstellungen der Windows-Systemsteuerung.

Bitte geben Sie ein einzelnes Zeichen oder die Zeichenfolge „TAB“ für den Tabulator nach diesem Schalter an. Beispiele:

Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"

Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"

/BEWEGEN <Pfad>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Es verschiebt die Ergebnisse einer TreeSize-Dateisuche an einen anderen Ort.

Der folgende Befehl sucht auf Ihrem lokalen Laufwerk C: unter Verwendung der neuesten Suchoptionen und verschiebt die Suchergebnisse in den Ordner „C:TempObsoleteFiles“:

Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"

Siehe auch: Ausgewählte Dateien verschieben

/NOGUI

Es wird kein Fenster angezeigt und die Anwendung erscheint nicht in der Taskleiste. Nützlich, um Scans oder Suchen im Hintergrund ohne visuelles Feedback auszuführen.

Warnung

Verwenden Sie diesen Schalter nur, wenn Sie die anderen Befehlszeilenoptionen getestet haben, da Fehlermeldungen in diesem Modus nicht angezeigt werden können.

Fehler werden jedoch im Windows-Ereignisprotokoll protokolliert.

/NOHEADERS

Lässt die Kopfzeilen weg, die normalerweise oben in Scan- oder Suchexportdateien geschrieben werden. Dies erleichtert den Erhalt von Rohdaten für die Nachbearbeitung.

/NOUNITS

Lässt die Einheiten weg, die normalerweise nach Größenwerten geschrieben werden. Diese Option in Kombination mit /SIZEUNIT 0 exportiert einfache Byte-Werte. Dies erleichtert den Erhalt einfacher Daten für die Nachbearbeitung.

Bemerkung

Dieser Befehl hat nur Auswirkungen auf Exporte des Verzeichnisbaums, die mit den Optionen /TEXT, /EXCEL, /HTML, /EMAIL oder /PRINT erstellt wurden. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST oder /TOPFILESLIST sind nicht betroffen.

/OPEN <Dateiname>

Öffnet einen gespeicherten XML-Bericht beim Start der Anwendung. Beispiel:

Treesize /OPEN "C:\Reports\Drive_C.xml.zip"

/OPTIONS <Dateiname>

Verwenden Sie diesen Parameter, um exportierte Benutzereinstellungen auf TreeSize anzuwenden. Benutzereinstellungen können unter „Datei > Optionen > Exportieren“ exportiert werden. Beispiel:

Treesize /OPTIONS "C:\Temp\User Settings.xml"

Bemerkung

Ändern Sie so viele Einstellungen wie möglich in der Benutzeroberfläche, bevor Sie die Optionen speichern, um die Anzahl der benötigten Befehlszeilenparameter zu reduzieren.

/PDF

Speichert die Ergebnisse in einer PDF-Datei, nachdem der Scan oder die Suche abgeschlossen ist. Die Anwendung wird sich nach dem Speichern selbst beenden. Das folgende Beispiel führt einen Scan Ihres lokalen Laufwerks C: durch und speichert die Ergebnisse in einer PDF-Datei:

Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"

/PIECHART <Dateiname>

Speichert das Kreisdiagramm des gescannten Verzeichnisses in einer Bitmap-, GIF-, PNG- oder JPEG-Datei. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Das folgende Beispiel scannt das Laufwerk C: und exportiert ein Kreisdiagramm im PNG-Format:

Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"

/PRINT

Druckt einen Bericht für den gescannten Verzeichnisbaum mit dem Standarddrucker, der in Ihren Systemeinstellungen konfiguriert ist. Die Anwendung wird nach dem Drucken beendet. Beispiel:

Treesize /SCAN "\\SERVER\USERS" /PRINT

/READONLYMODE <Wert>

Wenn der Wert auf true gesetzt ist, aktiviert diese Option einen Nur-Lese-Modus, in dem Dateioperationen (z. B. Verschieben oder Löschen) deaktiviert sind, sodass es nur als Berichtswerkzeug verwendet werden kann.

Beginnen Sie mit einem Wert von false, um den Nur-Lese-Modus wieder zu deaktivieren.

/RECYCLE

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Verschiebt alle Dateien in den Papierkorb, die als Ergebnis einer TreeSize-Dateisuche gefunden wurden. Beispiel:

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

Siehe auch: Ausgewählte Dateien verschieben

/RESTRICTEDMODE <Wert>

Wenn der Wert auf true gesetzt ist, aktiviert diese Option einen eingeschränkten Modus, in dem viele Funktionen deaktiviert sind, die für „normale“ (nicht-Admin-)Benutzer nicht von Interesse sind. Zu den deaktivierten Funktionen gehören: Nach Updates suchen, Software-Applet der Windows-Systemsteuerung öffnen, TreeSize-Scans planen, Netzlaufwerk verbinden, Windows-Systemwiederherstellung konfigurieren, Als Administrator ausführen, Exporte und NTFS-Komprimierung anwenden. Sie können einen Pfad angeben, der gescannt werden soll, z. B. das Benutzerverzeichnis, in der Befehlszeile oder über die Startpfade in einer gespeicherten Konfigurationsdatei.

Beginnen Sie mit einem Wert von false, um den eingeschränkten Modus wieder zu deaktivieren.

Wenn Sie zusätzlich die Option /READONLYMODE aktivieren, kann der Benutzer keine Dateien in TreeSize löschen oder verschieben, sodass es nur als Berichtstool verwendet werden kann.

/SCAN <Pfad|Dateiname>

Definiert, welches Laufwerk oder welcher Pfad gescannt werden soll. Der Scan-Pfad sollte als Wert für diesen Parameter verwendet werden.

Wenn beispielsweise das Laufwerk D:gescannt werden soll, können Sie Folgendes verwenden:

Treesize /SCAN "D:\"

Wenn Sie nicht das gesamte Laufwerk scannen möchten, können Sie auch einen Pfad angeben, der als Ausgangspunkt für den Scan verwendet wird. Zum Beispiel:

TreeSize /SCAN "\\Server\Share\MyDocuments"

Mehrere Scan-Pfade sind ebenfalls möglich, sie werden durch ein Leerzeichen getrennt. Pfade, die ein Leerzeichen enthalten, müssen in Anführungszeichen (“) gesetzt werden. Beispiel:

Treesize /SCAN "C:\Program Files\" "C:\Windows"

Die Platzhalter „*“ und „?“ sind erlaubt. Beispiel:

Treesize /SCAN "H:\users\A*"

Sie können auch eine Textdatei angeben, die eine Liste von Pfaden enthält, die gescannt werden sollen. TreeSize scannt alle Pfade, die in der Textdatei gefunden werden, die nach diesem Schalter angegeben ist. Die Textdatei muss einen Pfad pro Zeile enthalten. Das folgende Beispiel scannt alle Pfade, die in der Datei „D:PathsToScan.txt“ gefunden werden, und schreibt jedes Scanergebnis in ein separates Blatt in einer Excel-Datei mit dem heutigen Datum:

Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"

Sie können TreeSize auch in einer „for“-Schleife mit nur einem der Pfade aufrufen, ein Beispiel finden Sie unten.

/BLATTNAME <titel>

Ermöglicht es Ihnen, den Namen des Blattes anzugeben, das zu einer Excel-Datei hinzugefügt wird, wenn Sie den Befehl /EXCEL verwenden.

Bemerkung

Ein Excel-Blattname muss in einer Excel-Datei eindeutig sein, und bestimmte Sonderzeichen wie Schrägstriche, Rückwärtsschläge und Doppelpunkte sind verboten. TreeSize erstellt immer einen eindeutigen Blattnamen, indem ungültige Zeichen durch Unterstriche ersetzt und bei Bedarf Datum und Uhrzeit hinzugefügt werden. Wenn ein Blatt mit dem angegebenen Namen bereits in der Zieldatei vorhanden ist, wird ein neues Blatt mit einem eindeutigen Namen erstellt. Verwenden Sie die Befehlszeilenoption /APPENDTOFILES, um die Daten an das vorhandene Blatt anzuhängen.

/KURZDATUMFORMAT <format>

Ändert das Kurzdatumsformat für diesen Prozess, das in den regionalen Optionen der Windows-Systemsteuerung konfiguriert werden kann. Exporte von TreeSize verwenden dieses Format für Datumswerte. Beispiel:

Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"

/SIZEUNIT <n>

Diese Option kann verwendet werden, um die Einheit anzugeben, die für die Anzeige von Größenwerten verwendet werden soll: N kann die Werte 0 bis 5 annehmen, was bedeutet: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Automatische Einheiten. Ohne diese Option wird die zuletzt verwendete Konfiguration in TreeSize verwendet.

/SORTIEREN_NACH <Spaltenname>

Ermöglicht es Ihnen, anzugeben, nach welchem Wert die generierten Exporte sortiert werden. Mögliche Werte sind Spaltennamen wie „Größe“ oder „Name“. Der zuletzt verwendete Sortiertyp in der TreeSize-Benutzeroberfläche wird standardmäßig verwendet. Beispiel:

Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"

Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"

/SQLITE <dateiname>

Speichert die Scanergebnisse in einer SQLite-Datei, die später für Vergleiche geladen werden kann. Beispiel:

Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"

/SUBJECT <betreff>

Diese Option ermöglicht es Ihnen, den Betreff anzupassen, der für E-Mails verwendet wird, die am Ende des Scans gesendet werden. Beispiel:

Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"

/DATEI <dateiname>

Speichert die Ergebnisse in einer Text- oder CSV-Datei, nachdem der Scan oder die Suche abgeschlossen ist. Die Anwendung wird sich nach dem Speichern selbst beenden. Das folgende Beispiel führt einen Scan Ihres lokalen Laufwerks C: durch und speichert die Ergebnisse in einer Textdatei:

Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"

Das Textformat verwendet ein tabellarisches Format, das auf menschliche Leser abzielt. Wenn der Dateiname auf eine CSV-Datei verweist, wird automatisch das CSV-Format verwendet. Wenn Sie das CSV-Format ausdrücklich verwenden möchten, empfehlen wir die Verwendung des Parameters /CSV.

/TITEL <titel>

Kann verwendet werden, um den Stammverzeichnis-Pfad eines Scans mit einem benutzerdefinierten Text zu ersetzen. Dies ermöglicht es, aussagekräftigere Namen für UNC-Pfade bereitzustellen und dadurch die Lesbarkeit eines Berichts zu erhöhen. Der gewählte Titel wird als Titel des Berichts beim Exportieren einer Datei angewendet. Beispiel:

Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"

Im Kontext einer TreeSize-Dateisuche kann dieses Parameter verwendet werden, um eine erweiterte Suche zu benennen. Beispiel:

Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"

/TOPFILESLIST <dateiname>

Diese Option ermöglicht es Ihnen, den Inhalt der Liste der Top-Dateien in eine Excel-, HTML-, Text- oder CSV-Datei zu speichern. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Beispiel:

Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"

/TREEMAP <dateiname>

Speichert das Treemap-Diagramm des gescannten Verzeichnisbaums als Bitmap-, GIF-, PNG- oder JPEG-Datei. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Beispiel:

Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"

/UILevel <Einfach/Normal/Experte>

Legt die Ebene der Benutzeroberfläche fest. Mögliche Werte sind Einfach, Normal oder Experte. Beispiel:

Treesize /UILevel "Simple"

/USERSLIST <dateiname>

Diese Option ermöglicht es Ihnen, die Statistiken, welche die Ergebnisse nach Benutzernamen gruppiert anzeigen, in eine Excel-, HTML-, Text- oder CSV-Datei zu speichern. Der Dateityp hängt von der Erweiterung des angegebenen Dateinamens ab. Die exportierten Spalten sind diejenigen, die in der Benutzeroberfläche unter dem Kontext-Reiter „Benutzer“ aktiviert waren, als er zuletzt verwendet wurde, oder zu dem Zeitpunkt, als die Konfigurationsdatei, die über /OPTIONS bereitgestellt wurde, geschrieben wurde.

Das folgende Beispiel scannt das Laufwerk C: und erstellt eine Excel-Datei in „C:Temp“ mit den Statistiken der Benutzer auf diesem Laufwerk:

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

/ BENUTZERNAME <benutzername>

Gibt den Benutzernamen an, der zur Authentifizierung für die Scans verwendet werden soll. Verwenden Sie /PASSWORD, um ein Passwort für diesen Benutzernamen anzugeben. Es wird empfohlen, stattdessen das Microsoft-Tool RUNAS zu verwenden.

/ BENUTZERFILTER <benutzername>

Mit dieser Option werden nur Dateien berücksichtigt, die einem bestimmten Benutzer gehören, wenn der Scan durchgeführt wird. Geben Sie den Namen dieses Benutzers nach diesem Schalter an.

Bemerkung

Hier können Sie keine mehreren Benutzernamen verwenden, aber die Platzhalter „*“ und „?“ werden unterstützt.

Beispiel:

Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller

/USERSCHART <Dateiname>

Speichert das kleine Diagramm, das am unteren Rand der Seite „Benutzer“ angezeigt wird, in einer Bilddatei (Bitmap, GIF, PNG oder JPEG).

/ BENUTZERDIAGRAMM <dateiname>

Speichert ein Kreisdiagramm, das die „Benutzerstatistiken“ des aktuellen Scans in einer Bilddatei (Bitmap, GIF, PNG oder JPEG) anzeigt.

/VIEWTYPE n

Definiert, auf welchen Werten die „Prozent des Elternteils“, die „Wachstums“-Spalten und das „Alter der Dateien“-Diagramm basieren. Mögliche Werte sind:

2: Größe 3: Zuweisungsspeicher (Größe auf der Festplatte) 7: Anzahl der Dateien

/ XML <dateiname>

Speichert die Scanergebnisse in einer XML-Datei, die später für Vergleiche geladen werden kann. Beispiel:

Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"

Diese Option kann mit dem Schalter /EXPAND kombiniert werden, um die exportierten Verzeichnisse einzuschränken.

Bemerkung

Beim Laden eines eingeschränkten XML-Exports in TreeSize können Sie nicht durch den gesamten Verzeichnisbaum navigieren, sondern nur durch die exportierten Verzeichnisse.

/ZIP <dateiname>

Diese Option kann nur in Kombination mit der Befehlszeilenoption /SEARCH verwendet werden.

Alle Dateien, die als Ergebnis einer TreeSize-Dateisuche gefunden wurden, werden in ein ZIP-Archiv verschoben. Beispiel:

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

Siehe auch: Ausgewählte Dateien verschieben

<SCANPATH>

Neben dem Parameter /SCAN können Sie auch einen oder mehrere Pfade am Ende der Befehlszeile übergeben. Dies wird jedoch nicht mehr empfohlen, um Fehler beim Parsen der Befehlszeile zu vermeiden.

Dieses Beispiel scannt die Ordner „Program Files“ und „Windows“ und erstellt einen Textbericht unter „C:ReportsScanResults.txt“:

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

Falls ein Fehler auftritt, wird dieser als Windows-Fehlercode im Rückgabewert des Prozesses zurückgegeben. Umgebungsvariablen (z. B. %APPDATA%) können in Dateinamen für den Export sowie in den gescannten Pfaden verwendet werden.

Scannen mehrerer Verzeichnisse

Wenn Sie mehrere Verzeichnisse scannen müssen, kann es sinnvoll sein, mehrere Aufrufe in einer Batch-Datei zusammenzuführen, zum Beispiel:

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"

Der Befehl „START /WAIT“ stellt sicher, dass die Jobs nacheinander gestartet werden. Das parallele Starten der Jobs ist in der Regel besser, da ein einzelner Job mehr von Caches und Systemressourcen profitiert. Es ist auch möglich, die Freigaben, die gescannt werden sollen, in einer Textdatei zu speichern und den Windows-Befehl „for“ wie folgt zu verwenden:

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"

Bemerkung

Die doppelten Prozentzeichen sind in Batch-Dateien erforderlich, in der Befehlszeile verwenden Sie nur ein einzelnes Prozentzeichen.

Geplanter Start

Sie können die Windows-Taskplanung verwenden, um TreeSize mit bestimmten Befehlszeilenoptionen täglich, wöchentlich oder monatlich zu einer bestimmten Zeit auszuführen. Der Dialog für Scans planen hilft Ihnen, eine geplante Aufgabe einzurichten.

Sie können auch den Befehl SCHTASKS verwenden, um geplante Scans durchzuführen. Wenn Sie beispielsweise die Laufwerke C: und E: in der nächsten Nacht um 03:00 Uhr scannen und die Ergebnisse in einer Excel-Datei speichern möchten, könnten Sie die folgende Befehlszeile verwenden:

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"

Holen Sie sich Hilfe zum Befehl SCHTASKS auf den Seiten von Microsoft oder indem Sie eingeben:

SCHTAKS /Create /?

Bemerkung

Fehlermeldungen, die während geplanter Scans auftreten, werden im Windows-Ereignisprotokoll des Systems aufgeführt.

PowerShell

Windows PowerShell kann in Kombination mit TreeSize nützlich sein. Dieses Beispiel zeigt, wie man einige Remote-Computer abfragt, die mit einer LDAP-Abfrage im Active Directory (AD) abgefragt werden:

$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

Ausgabe umleiten

Wenn kein anderes Exportziel angegeben ist, schreibt TreeSize einen kurzen Export des Scans in die Standardausgabe und Fehler, die während des Scans aufgetreten sind, in die Standardfehlerausgabe.

Sie können diese Ausgabeströme in der Eingabeaufforderung (cmd.exe) mit dem Pipe-Symbol umleiten, z. B.

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

Um die Ausgabe mit PowerShell umzuleiten, verwenden Sie bitte stattdessen den Befehl Start-Process, z.B.

Start-Process -FilePath „C:Program FilesJAM SoftwareTreeSizeTreesize.exe“ -ArgumentList „/NOGUI /SCAN C:" -RedirectStandardOutput „.StdOut.txt“ -RedirectStandardError „.StdError.txt“

Windows Scripting Host

Wenn Sie den Windows Scripting Host (WSH) verwenden möchten, sieht Ihr Befehl zum Starten von TreeSize folgendermaßen aus:

Set Shell = CreateObject("WScript.Shell")

Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""

Exit-Codes

Wenn der Vorgang erfolgreich abgeschlossen wurde, beträgt der Exit-Code 0. Wenn ein Fehler aufgetreten ist, gibt TreeSize einen Windows-Fehlercode als Exit-Code zurück, falls verfügbar, oder 1, um einen allgemeinen Fehler anzuzeigen.

In jedem Fall enthält das Windows-Ereignisprotokoll weitere Informationen im „Anwendungs“-Protokoll, Ereignisquelle „TreeSize“.