Befehlszeilenoptionen

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

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 bestehende Dateien anhängen soll, wenn Sie einen Exportieren, z.B. mit /TEXT. Wählen Sie „True“ zum Anhängen und „False“, wenn Sie bestehende Dateien überschreiben wollen.

Bemerkung

Dieser Parameter funktioniert nicht bei 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“) zu einer Scan-Datei eingeblendet wird. Die zweite Datei („c2.xml.zip“) wird mit dieser erweiterten Scan-Datei verglichen, genau 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 Kommandozeilenoption /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:\temp\ObsoleteFiles“:

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 <Antrieb>

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 „\\Host\Share“ und speichert das Ergebnis in einer Datei wie „C:\Scans\name_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 Kommandozeilenoption /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 Kommandozeilenoption /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 <Empfänger>

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 Kommandozeilenoptionen /SEARCH und /EMAIL verwendet werden. Wenn dieser Parameter angegeben wird, sendet TreeSize nur dann eine E-Mail mit den aktuellen Suchergebnissen, wenn mindestens eine Datei oder ein Ordner während der Suche gefunden wurde, und zwar über 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

Diese Option kann nur in Kombination mit der Kommandozeilenoption /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 <Dateipfad>

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

In der TreeSize File Search (/SEARCH) werden die Ergebnisse jeder Suchart in einem eigenen Arbeitsblatt gesammelt. Wenn die Datei unter dem angegebenen Pfad bereits existiert, werden diese Blätter überschrieben. Um dies zu verhindern, müssen Sie die Kommandozeilenoption /APPENDTOFILES verwenden.

/EXCLUDE <Muster1;Muster2>

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 <Niveau|Größe>

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:\Results\Allusers.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 Kommandozeilenoption /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