Opdrachtregelopties

De Professional Edition van TreeSize accepteert opdrachtregelopties waarmee u geplande scans kunt uitvoeren of de resultaten van een scan de volgende ochtend op uw monitor kunt zien.

De dialoog voor Scans plannen helpt u een opdrachtregel samen te stellen met de onderstaande opties.

Notitie

Deze opties zijn alleen beschikbaar in de TreeSize Professional Edition.

Alle opties

Treesize.exe [/OPTION] SCANPATH

/? of /HELP

Toont deze help-pagina.

/AGEOFFILES

Slaat het diagram op het tabblad “Leeftijd van Bestanden” van de gescande directory op als een bitmap, GIF, PNG, JPEG, tekst of CSV-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Het volgende voorbeeld maakt een JPEG-afbeeldingsbestand van het diagram “Leeftijd van Bestanden” voor uw lokale schijf C:

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

/APPENDTOFILES <waarde>

Met deze optie kunt u selecteren of TreeSize zijn uitvoer moet toevoegen aan bestaande bestanden bij het exporteren, bijvoorbeeld bij gebruik van /TEXT. Selecteer “Waar” om toe te voegen en “Onwaar” als u bestaande bestanden wilt overschrijven.

Notitie

Deze parameter werkt niet met geëxporteerde afbeeldingen, XML- en PDF-bestanden. Deze bestanden zullen altijd worden overschreven. U kunt de schakelaar /DATE gebruiken om ervoor te zorgen dat alle gegenereerde rapporten een unieke bestandsnaam hebben.

Bij het exporteren naar een Excel-bestand via /EXCEL kan deze parameter samen met /SHEETNAME worden gebruikt om de gegevens aan het opgegeven blad toe te voegen. Voorbeeld:

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

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

/ARCHIVEBITFILESONLY

Deze optie omvat alleen bestanden waarvoor het archiefbit is ingesteld in de scans. Deze optie kan zeer nuttig zijn als u de grootte van een back-up wilt berekenen. In dit geval kunt u een snelkoppeling op uw bureaublad of in uw startmenu maken die automatisch de grootte van uw back-up begint te berekenen. Voorbeeld:

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

/ATTACH

Als opgegeven, worden alle geëxporteerde bestanden aan de e-mail gehecht. Als niet opgegeven, worden bestanden met een expliciet opgegeven pad niet aangehecht. Dit is nuttig in het geval dat uw XML- of Excel-bestanden behoorlijk groot worden en uw e-mailaccount vullen.

Dit voorbeeld exporteert naar een Excel-bestand maar hecht het niet aan de e-mail:

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

Deze voorbeelden hechten het Excel-bestand aan de 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 <bestandsnaam>

Slaat het staafdiagram, van de gescande directory op als een bitmap, GIF, PNG of JPEG-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Dit voorbeeld maakt een PNG-afbeeldingsbestand van het staafdiagram voor uw lokale schijf C:

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

/COMPARE <bestandsnaam|pad>

Vergelijkt het gescande pad met een opgeslagen indexbestand. Het volgende voorbeeld scant schijf C: en vergelijkt het resultaat met een opgeslagen XML-rapport voor deze schijf:

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

In plaats van een indexbestand kunt u ook een pad gebruiken met deze opdrachtregelparameter. Het opgegeven pad wordt vergeleken met het huidige scanresultaat. Het volgende voorbeeld scant schijf C:en gebruikt daarnaast het pad D:Backup_of_C om een vergelijking tussen de twee uit te voeren:

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

U kunt ook twee reeds bestaande indexbestanden vergelijken, bijvoorbeeld “c1.xml.zip” en “c2.xml.zip”, door deze opdracht te gebruiken:

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

De /OPEN-opdracht bereidt de vergelijking van de twee bestanden voor door het eerste bestand (“c1.xml.zip”) uit te pakken in een scanbestand. Het tweede bestand (“c2.xml.zip”) zal met dit uitgebreide scanbestand worden vergeleken, net zoals het zou gebeuren als “c2.xml.zip” met een “echt” scanbestand zou worden vergeleken.

/COPY <pad>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Kopieert de resultaten van een TreeSize-bestandszoekopdracht naar de doellocatie.

De volgende opdracht zal zoeken op uw lokale schijf C: met de nieuwste zoekopties en de zoekresultaten naar de map “C:tempObsoleteFiles” kopiëren:

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

Zie ook: Verplaats geselecteerde bestanden

/CREATEDPASTDAYSONLY <n>

Deze optie neemt alleen bestanden mee in de scans die zijn aangemaakt binnen het aantal dagen dat in het argument is ingevoerd. In het volgende voorbeeld omvat deze optie alleen bestanden die in de afgelopen acht dagen zijn aangemaakt in de scan:

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <schijf>

Maakt een snapshot voor de schijven die na deze opdrachtregelparameter zijn opgegeven. Voorbeeld:

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

Het maken van snapshots kan beheerdersrechten vereisen.

/CSV <bestandsnaam>

Slaat de resultaten op in een CSV-bestand nadat de scan of zoekopdracht is voltooid. De applicatie sluit zichzelf af na het opslaan. Dit voorbeeld slaat de resultaten van een bestandszoekopdracht op uw lokale schijf C: met de laatste zoekconfiguraties op in een CSV-bestand:

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

/DATE

Deze schakelaar voegt de huidige datum en tijd toe aan alle exportbestandsnamen in de opdrachtregel. Dit is nuttig als u regelmatig scans wilt uitvoeren, bijvoorbeeld elke nacht of elk weekend. Het volgende voorbeeld scant het netwerkpad “\HostShare” en slaat het resultaat op in een bestand zoals “C:Scansname_2013-08-14_17-18-24.xls”:

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

/DEDUPLICATE

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Het vervangt de dubbele bestanden die zijn gevonden door de TreeSize-zoekopdracht naar dubbele bestanden door NTFS-harde koppelingen:

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

/DELETE

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Verwijdert permanent alle bestanden die zijn gevonden als resultaat van een TreeSize-bestandszoekopdracht. Voorbeeld:

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

Zie ook: Verplaats geselecteerde bestanden

/EMAIL <ontvanger>

Verstuur de verzamelde gegevens naar het opgegeven e-mailadres. Deze parameter kan slechts één keer op de opdrachtregel worden gebruikt, en er zal slechts één e-mail met alle resultaten worden verzonden. Meerdere ontvangers kunnen worden gescheiden door puntkomma’s (;) of komma’s. Om e-mails via de opdrachtregel te verzenden, moet u geldige SMTP-instellingen op de overeenkomstige pagina in het TreeSize-optiesdialoogvenster opgeven. Voorbeeld:

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

Als er geen andere parameters zijn opgegeven, wordt de e-mail verzonden in het formaat dat is ingesteld in de opties (HTML of platte tekst). Als u het formaat onafhankelijk van de huidige opties wilt definiëren, kunt u de parameters /TEXT of /HTML direct achter de definitie van het(e) ontvanger(s) adres(sen) gebruiken. Voorbeeld:

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

Door parameters te combineren, kunt u ook bijlagen aan de e-mail toevoegen. Het volgende voorbeeld voegt een Excel-rapport van de scan als bijlage aan de e-mail toe:

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

/EMAILIFRESULTSFOUND

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregelopties /SEARCH en /EMAIL. Als deze parameter is opgegeven, zal TreeSize alleen een e-mail versturen met de huidige zoekresultaten, als er tijdens de zoekopdracht ten minste één bestand of map is gevonden, door een van de opgegeven zoektypen.

/EMPTYRECYCLEBIN

Als u deze optie gebruikt, zal TreeSize de prullenbak legen voordat de huidige scan wordt uitgevoerd. Voorbeeld:

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE <bestandsnaam>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Deze parameter maakt het mogelijk om bestanden die zijn gevonden door de TreeSize-bestandszoekopdracht door te geven aan een andere applicatie of script. Een mogelijke bestemming voor deze parameter kan een batch- of PowerShell-script zijn. Het volgende voorbeeld doorzoekt schijf C:met de meest recente zoekinstellingen en roept het script “Archive.bat” aan voor elk bestand dat is gevonden. Het bestand wordt als opdrachtregelparameter aan het script doorgegeven:

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

Zie ook: Verplaats geselecteerde bestanden

/EXCEL <bestandsnaam>

Exporteert de verzamelde gegevens in Microsoft Excel-formaat en slaat deze op onder het ingevoerde bestandspad. Als alleen een bestandsnaam is opgegeven, wordt de huidige installatiemap gebruikt om de export op te slaan. Ondersteunde formaten zijn het conventionele .XLS-bestandsformaat (Excel 97-2003) evenals het .XLSX-formaat (ingevoerd met Excel 2007). Het gebruikte formaat hangt af van de extensie van de opgegeven bestandsnaam. De applicatie beëindigt zichzelf na het opslaan. Voorbeeld:

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

Als de bestandsnaam al bestaat, wordt het bestand geopend en wordt er een nieuw werkblad toegevoegd.

Notitie

In de zoekopdracht (/SEARCH) worden de resultaten van elk zoektype verzameld in hun eigen specifieke werkblad. Als het bestand onder het opgegeven pad al bestaat, worden deze bladen overschreven. Om dit te voorkomen, moet u de opdrachtregeloptie /APPENDTOFILES gebruiken.

/EXCLUDE <patroon1;patroon2>

Deze optie stelt u in staat om patronen voor bestanden en mappen op te geven die moeten worden uitgesloten van een scan. Meerdere uitsluitpatronen kunnen worden gescheiden met een puntkomma (;). Als een of meer van de patronen spaties bevatten, moet de volledige patroonreeks tussen aanhalingstekens (”) worden geplaatst. Het volgende voorbeeld negeert bestanden en mappen die eindigen op “.tmp” of waarvan de exacte naam “system” is:

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

/EXPAND <niveau|grootte>

Deze optie stelt u in staat om op te geven hoeveel niveaus in de mappenstructuur zullen worden uitgebreid na het scannen. Als u geen getal na deze optie opgeeft, worden alle mappen uitgebreid. In plaats van een mapniveau kunt u ook een hoeveelheid in megabyte (MB) aangeven. In dit geval worden alle mappen groter dan de opgegeven grootte uitgebreid. De eenheid “MB” moet zonder spatie achter het nummer volgen. Het volgende voorbeeld scant de map “H:\User”, breidt alle mappen groter dan 10 MB uit en slaat het resultaat op in het Excel-bestand “C:\Results\Allusers.xlsx”:

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

/EXPANDABLEREPORT <waarde>

Als deze optie wordt gebruikt, zullen Excel-exporten uitbreidbare/samenvouwbare groepen gebruiken die vergelijkbaar zijn met de in TreeSize getoonde mappenboom.

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

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

/EXPORTDRIVESLIST <bestandsnaam>

Deze optie stelt u in staat om de inhoud van de “Schijflijst” te exporteren naar een Excel-, Tekst- of CSV-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Voorbeeld:

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

/EXPORTFILES

Indien opgegeven, worden bestanden opgenomen in alle exports. Deze optie is dus gelijk aan het activeren van de optie “Hulpmiddelen > Opties > Exporteren > * > Geëxporteerde elementen > Mappen en afzonderlijke bestanden”

/EXPORTGROUPSEXPANDED

Indien opgegeven, zal de export van de extensielijst alle informatie bevatten over de extensies die binnen groepen zijn opgenomen.

/EXPORTPATHSLIST <bestandsnaam>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Exporteert een eenvoudige lijst die alle zoekresultaten bevat. De lijst bevat alleen de volledige paden van de zoekresultaten en geen andere informatie. Ondersteunde formaten voor het bestemmingsbestand zijn .txt en .csv.

Dit voorbeeld zoekt naar en maakt een lijst van alle exe-bestanden op schijf C:

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

Het kan worden gebruikt om resultaten van een eerdere zoekopdracht terug te importeren in de gebruikersinterface, door “Bestand > Lijst van paden > Importeer padlijst” te gebruiken, of de parameter /IMPORT.

Als de optie “Hulpmiddelen > Opties > Exporteren > Inclusief dubbele groepen” is geactiveerd, kunt u deze functie ook gebruiken om resultaten van de duplicaatzoekopdracht te exporteren en importeren, inclusief hun groepsstructuur.

/EXPORTTITLE <titel>

Kan worden gebruikt om de titel binnen een afgedrukt rapport of geëxporteerd bestand te wijzigen. Dit stelt u in staat om aanvullende informatie aan de gebruiker te verstrekken bij het gebruik van TreeSize in een geautomatiseerde omgeving. Het gebruik van omgevingsvariabelen is ook toegestaan. Voorbeeld:

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

/EXTENSIONSLIST <bestandsnaam>

Deze optie stelt u in staat om de statistieken over bestandsextensies / bestandstypen van de gescande bestandssysteemtak op te slaan naar een Excel-, HTML-, Tekst- of CSV-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. De geëxporteerde kolommen zijn die welke waren ingeschakeld in de gebruikersinterface op het tabblad “Extensies” toen het voor het laatst werd gebruikt, of op het moment dat het configuratiebestand dat via /OPTIONS werd geleverd, werd geschreven.

Het volgende voorbeeld scant schijf C: en maakt een Excel-bestand genaamd “D:\TreeSize Reports\C_filetypes.xls” met de statistieken van de bestandstypen op deze schijf:

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

/EXTENSIONSCHART <bestandsnaam>

Slaat het kleine diagram dat onderaan de pagina “Extensies” wordt weergegeven op in een afbeeldingsbestand (bitmap, GIF, PNG of JPEG).

/EXTENSIONSPIECHART <bestandsnaam>

Slaat een cirkeldiagram op dat de verdeling van “bestandsextensies” toont in een afbeeldingsbestand (bitmap, GIF, PNG of JPEG).

/FILTER <patroon1;patroon2>

Stelt een bestandsfilter in dat alleen bestanden met bepaalde extensies telt, bijvoorbeeld “.mp3” of “.doc”. Er kunnen meerdere patronen worden doorgegeven, gescheiden door een puntkomma (;). Het volgende voorbeeld zoekt naar MP3- en AVI-bestanden in de map “Users” op de server:

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

Bij het uitvoeren van een TreeSize zoekopdracht (/SEARCH) kun je ook de /FILTER commandoregeloptie gebruiken om de patronen van de geavanceerde zoekopdracht op te geven. Om een meer complexe zoekopdracht uit te voeren, moet je de zoekopties opslaan in een bestand en het resulterende XML-bestand doorgeven aan de opdrachtregel na /SEARCH.

/FOLLOWREPARSEPOINTS

Als deze optie is toegevoegd aan de opdrachtregel, zal TreeSize koppelpunten en externe symbolische koppelingen volgen bij het scannen van een boomstructuur van een bestandssysteem.

/GROUPSCANS

Door deze opdrachtregeloptie te gebruiken, worden alle gescande mappen gegroepeerd onder een virtuele hoofdmap. Gebruik /GROUPSCANS FALSE als je ervoor wilt zorgen dat er geen virtuele hoofdmap wordt gebruikt.

/HIDESMALLFOLDERS <waarde>

Maakt het mogelijk om objecten te verbergen die kleiner zijn dan een minimumgrootte, wat handig is om duidelijke exports te krijgen. <waarde> kan een groottewaarde met eenheid zijn, of een gewone bytewaarde zonder eenheid. Kan niet worden gebruikt in combinatie met /EXPAND. In dit voorbeeld worden alleen mappen met een minimale grootte van 50 MB geëxporteerd:

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

/HISTORYCHART <bestandsnaam>

Slaat het diagram op het tabblad “Geschiedenis” van de gescande map op als een bitmap-, GIF-, PNG- of JPEG-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Dit voorbeeld maakt een JPEG-afbeelding van het geschiedenisdiagram voor station C:

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

/HTML <bestandsnaam>

Slaat de verzamelde gegevens op in een HTML-bestand dat met elke HTML-browser kan worden bekeken. Je kunt opgeven welke informatie van de scan moet worden opgenomen in de export via “Start > Opties > Exporteren > HTML > Diagrammen en lijsten opnemen”. U kunt selecteren welke extra lijsten of diagrammen moeten worden toegevoegd aan de export. Deze worden automatisch ingesloten in het HTML-bestand dat na de scan wordt gegenereerd.

Het volgende voorbeeld genereert een HTML-rapport voor station C: en slaat het op in “D:HTML”:

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

Als je wilt dat meer dan één scan deel uitmaakt van het HTML-bestand, moet je de opdrachtregeloptie /GROUPSCANS toevoegen. Als je exporteert naar HTML zonder een afbeelding, kun je ook de optie /APPENDTOFILES gebruiken. Zonder een van deze opties wordt het HTML-bestand overschreven.

/IMPORT <bestandsnaam>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Laadt een lijst met paden in de gebruikersinterface van de TreeSize Bestand Zoeken. Het bestand kan in .txt- of .csv-formaat zijn. Deze parameter kan worden gebruikt om resultaten van een vorige zoekopdracht te importeren. De geïmporteerde bestanden en mappen kunnen worden verplaatst/gekopieerd/verwijderd/gearchiveerd, zoals elk “live” zoekresultaat, met behulp van het dialoogvenster Bestandsbewerking.

Voorbeeld:

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

Je kunt deze parameter ook combineren met de parameters /RECYCLE, /DELETE of /MOVE om de bestanden in het tekstbestand automatisch te verwijderen of te verplaatsen. Voorbeeld:

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

/IMPORTPATTERNS <bestandsnaam>

Importeert een lijst met patronen uit een bestand. Het bestand kan een eenvoudig tekstbestand zijn met een reeks filterpatronen, gescheiden door een puntkomma, of je kunt de gebruikersinterface gebruiken om een complexere reeks patronen te maken en de exportfunctie gebruiken om het patroonbestand in XML-formaat te genereren. Ondersteunde formaten zijn CSV, TXT en XML.

De geïmporteerde patronen worden gebruikt als filters voor de scan om specifieke bestanden en mappen op te nemen of uit te sluiten.

Als deze parameter wordt gebruikt in combinatie met de opdrachtregeloptie /SEARCH, wordt een nieuwe geavanceerde zoekopdracht gemaakt die de patronen uit het geïmporteerde bestand gebruikt als criteria voor de zoekopdracht.

Dit voorbeeld importeert filterpatronen die zijn gedefinieerd onder “C:TreeSizeFilespatterns.txt”, start een scan van station C:en exporteert de resultaten naar een HTML-bestand:

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

/INDEXFILE <bestandsnaam>

Slaat de scanresultaten op in een SQLite-bestand dat later kan worden geladen voor vergelijkingen. Voorbeeld:

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

/LISTSEPARATOR <scheidingsteken>

Hiermee kun je het scheidingsteken definiëren dat wordt gebruikt bij het exporteren van tekst- of CSV-bestanden. Tekstbestanden gebruiken standaard de tabulator, CSV-bestanden het lijstscheidingsteken uit de regionale instellingen van het configuratiescherm van Windows.

Geef een enkel karakter of de tekenreeks “TAB” op voor tabulator na deze schakeloptie. Voorbeelden:

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

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

/MOVE <pad>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Hiermee worden de door een zoekopdracht gevonden bestanden verplaatst naar een andere locatie.

Het volgende commando zoekt op uw lokale station C: met de laatste zoekopties en verplaatst de zoekresultaten naar de map “C:TempObsoleteFiles”:

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

Zie ook: Verplaats geselecteerde bestanden

/NOGUI

Er wordt geen venster weergegeven en de toepassing verschijnt niet in de taakbalk. Handig om scans of zoekopdrachten op de achtergrond uit te voeren, zonder visuele feedback.

Waarschuwing

Gebruik deze optie alleen als je de rest van de commandoregelopties hebt getest, omdat foutmeldingen in deze modus niet kunnen worden weergegeven.

Fouten worden echter wel gelogd in het gebeurtenislogboek van Windows.

/NOHEADERS

Hiermee worden de kopregels weggelaten die meestal boven aan scan- of zoekexportbestanden worden geschreven. Dit maakt het eenvoudiger om gegevens te ontvangen voor nabewerking.

/NOUNITS

Laat de eenheden weg die gewoonlijk achter de groottewaarden worden geschreven. Deze optie in combinatie met /SIZEUNIT 0 exporteert gewone bytewaarden. Dit maakt het eenvoudiger voor nabewerking om de gegevens te interpreteren.

Notitie

Deze opdrachtregel heeft alleen invloed op exports van de mappenboom, gegenereerd met de opties /TEXT, /EXCEL, /HTML, /EMAIL of /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST of /TOPFILESLIST zullen niet worden beïnvloed.

/OPEN <bestandsnaam>

Opent een opgeslagen XML rapport bij het starten van de applicatie. Voorbeeld:

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

/OPTIONS <bestandsnaam>

Gebruik deze parameter om geëxporteerde gebruikersinstellingen toe te passen in TreeSize. Gebruikersinstellingen kunnen worden geëxporteerd via “Bestand > Opties > Export”. Voorbeeld:

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

Notitie

Wijzig zoveel mogelijk instellingen in de gebruikersinterface voordat je de opties opslaat om het aantal benodigde opdrachtregelparameters te verminderen.

/PDF

Slaat de resultaten op in een PDF-bestand nadat de scan of zoekopdracht is voltooid. De applicatie sluit zichzelf af na het opslaan. Het volgende voorbeeld voert een scan uit van je lokale schijf C: en slaat de resultaten op in een PDF-bestand:

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

/PIECHART <bestand>

Slaat de cirkeldiagram van de gescande directory op in een bitmap, GIF, PNG of JPEG-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Het volgende voorbeeld scant schijf C: en exporteert een cirkeldiagram in PNG-formaat:

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

/PRINT

Drukt een rapport af voor de gescande mappenboom met behulp van de standaardprinter die in je systeeminstellingen is geconfigureerd. De applicatie wordt beëindigd na het afdrukken. Voorbeeld:

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

/READONLYMODE <waarde>

Als de waarde is ingesteld op true, activeert deze optie een alleen-lezen modus waarin bestandsbewerkingen (bijv. verplaatsen of verwijderen) zijn uitgeschakeld, zodat het alleen als rapportagetool kan worden gebruikt.

Begin met een waarde van false om de alleen-lezen modus weer te deactiveren.

/RECYCLE

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Verplaatst alle gevonden bestanden naar de prullenbak. Voorbeeld:

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

Zie ook: Verplaats geselecteerde bestanden

/RESTRICTEDMODE <waarde>

Als de waarde is ingesteld op true, activeert deze optie een beperkte modus waarin veel functies zijn uitgeschakeld die niet van belang zijn voor “normale” (niet-beheerder) gebruikers. Onder de uitgeschakelde functies bevinden zich: Controleren op updates, openen van de Software-applet van het Configuratiescherm van Windows, plannen van TreeSize-scans, verbinden met een netwerkstation, configureren van Windows systeemherstel, uitvoeren als administrator, exporteren en toepassen van NTFS-compressie. U kunt een pad opgeven dat moet worden gescand, bijvoorbeeld de thuismap van de gebruiker, via de opdrachtregel of met de opstartpaden in een opgeslagen configuratiebestand.

Begin met een waarde van false om de beperkte modus weer te deactiveren.

Als u bovendien de optie /READONLYMODE activeert, kan de gebruiker geen bestanden verwijderen of verplaatsen in TreeSize, zodat het alleen als rapportagetool bruikbaar is.

/SCAN <pad|bestandsnaam>

Definieert welke schijf of pad gescand moet worden. Het scanpad moet als waarde voor deze parameter worden gebruikt.

Als bijvoorbeeld schijf D:gescand moet worden, kunt u het volgende gebruiken:

Treesize /SCAN "D:\"

Als u niet de hele schijf wilt scannen, kunt u ook een pad opgeven, dat als startpunt voor de scan wordt gebruikt. Bijvoorbeeld:

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

Meerdere scanpaden zijn ook mogelijk, ze worden gescheiden door een spatie. Paden die een spatie bevatten, moeten tussen aanhalingstekens (”) worden geplaatst. Voorbeeld:

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

De jokertekens “*” en “?” zijn toegestaan. Voorbeeld:

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

U kunt ook een tekstbestand opgeven dat een lijst van paden bevat die gescand moeten worden. TreeSize scant alle paden die in het tekstbestand worden gevonden, dat na deze schakeloptie is opgegeven. Het tekstbestand moet één pad per regel bevatten. Het volgende voorbeeld scant alle paden die in het bestand “D:PathsToScan.txt” worden gevonden en schrijft elk scanresultaat naar een apart blad in een Excel-bestand met de datum van vandaag:

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

U kunt TreeSize ook aanroepen in een “for”-lus met slechts een van de paden, zie hieronder een voorbeeld.

/SHEETNAME <titel>

Stelt u in staat om de naam van het blad op te geven dat aan een Excel-bestand zal worden toegevoegd bij het gebruik van de opdrachtregeloptie /EXCEL.

Notitie

Een Excel-bladnaam moet uniek zijn in een Excel-bestand en bepaalde speciale tekens zoals schuine strepen, omgekeerde schuine strepen en dubbele punten zijn verboden. TreeSize zal altijd een unieke bladnaam creëren door ongeldige tekens te vervangen door onderstrepingen en indien nodig datum en tijd toe te voegen. Als er al een blad met de opgegeven naam in het doelfile bestaat, wordt er een nieuw blad met een unieke naam aangemaakt. Gebruik de opdrachtregeloptie /APPENDTOFILES om de gegevens aan het bestaande blad toe te voegen.

/SHORTDATEFORMAT <formaat>

Wijzigt het korte datumformaat voor dit proces, dat kan worden geconfigureerd in de regionale opties van het Windows Configuratiescherm. Exporten van TreeSize zullen dit formaat voor datums gebruiken. Voorbeeld:

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

/SIZEUNIT <n>

Deze optie kan worden gebruikt om de eenheid op te geven die moet worden gebruikt voor het weergeven van groottewaarden: N kan de waarden 0 tot 5 hebben, wat betekent: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Automatische Eenheden. Zonder deze optie wordt de laatst gebruikte configuratie in TreeSize gebruikt.

/SORTBY <kolomnaam>

Stelt u in staat om op te geven op welke waarde de gegenereerde exports zullen worden gesorteerd. Mogelijke waarden zijn kolomnamen zoals “Grootte” of “Naam”. Het laatst gebruikte sorteertype in de TreeSize-gebruikersinterface wordt standaard gebruikt. Voorbeeld:

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

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

/SQLITE <bestandsnaam>

Slaat de scanresultaten op in een SQLite-bestand dat later kan worden geladen voor vergelijkingen. Voorbeeld:

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

/SUBJECT <onderwerp>

Deze optie stelt u in staat om het onderwerp aan te passen dat zal worden gebruikt voor e-mails die aan het einde van de scan worden verzonden. Voorbeeld:

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

/TEXT <bestandsnaam>

Slaat de resultaten op in een tekst- of CSV-bestand nadat de scan of zoekopdracht is voltooid. De applicatie sluit zichzelf af na het opslaan. Het volgende voorbeeld voert een scan uit van uw lokale schijf C: en slaat de resultaten op in een tekstbestand:

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

Het tekstformaat gebruikt een tabelvorm gericht op menselijke lezers. Als de bestandsnaam naar een CSV-bestand verwijst, wordt automatisch het CSV-formaat gebruikt. Als u het CSV-formaat expliciet wilt gebruiken, raden we aan om de /CSV-parameter te gebruiken.

/TITLE <titel>

Kan worden gebruikt om het rootpad van een scan te vervangen door een aangepaste tekst. Dit maakt het mogelijk om meer betekenisvolle namen voor UNC-paden te bieden en daarmee de leesbaarheid van een rapport te vergroten. De gekozen titel wordt toegepast als de titel van het rapport bij het exporteren van een bestand. Voorbeeld:

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

In de context van een TreeSize-zoekopdracht kan deze parameter worden gebruikt om een geavanceerde zoekopdracht een naam te geven. Voorbeeld:

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

/TOPFILESLIST <bestandsnaam>

Deze optie stelt u in staat om de inhoud van de Top-bestandenlijst op te slaan in een Excel-, HTML-, Tekst- of CSV-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Voorbeeld:

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

/TREEMAP <bestandsnaam>

Slaat het mappenboomdiagram van de gescande mappenboom op als bitmap-, GIF-, PNG- of JPEG-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. Voorbeeld:

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

/UILevel <Simple/Normal/Expert>

Stelt het niveau van de gebruikersinterface in. Mogelijke waarden zijn Simple, Normal of Expert. Voorbeeld:

Treesize /UILevel "Simple"

/USERSLIST <bestandsnaam>

Deze optie stelt u in staat om de statistieken op te slaan die de resultaten gegroepeerd per gebruikersnaam tonen in een Excel-, HTML-, Tekst- of CSV-bestand. Het bestandstype hangt af van de extensie van de opgegeven bestandsnaam. De geëxporteerde kolommen zijn die welke waren ingeschakeld in de gebruikersinterface op het tabblad “Gebruikers” toen het laatst werd gebruikt, of op het moment dat het configuratiebestand dat via /OPTIONS werd geleverd, werd geschreven.

Het volgende voorbeeld scant schijf C: en maakt een Excel-bestand aan in “C:Temp” met de statistieken van de gebruikers op deze schijf:

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

/USERNAME <gebruikersnaam>

Geeft de gebruikersnaam op die moet worden gebruikt voor authenticatie tijdens de scans. Gebruik /PASSWORD om een wachtwoord voor deze gebruikersnaam op te geven. Het wordt aanbevolen om in plaats daarvan de Microsoft-tool RUNAS te gebruiken.

/USERFILTER <gebruikersnaam>

Met deze optie worden alleen bestanden die eigendom zijn van een bepaalde gebruiker in aanmerking genomen tijdens het scannen. Geef de naam van deze gebruiker op na deze schakeloptie.

Notitie

U kunt hier niet meerdere gebruikersnamen gebruiken, maar de jokertekens “*” en “?” worden ondersteund.

Voorbeeld:

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

/USERSCHART <bestandsnaam>

Slaat het kleine diagram dat onderaan de pagina “Gebruikers”wordt weergegeven op als een afbeeldingsbestand (bitmap, GIF, PNG of JPEG).

/USERSPIECHART <bestandsnaam>

Slaat een cirkeldiagram op dat de “gebruikersstatistieken” van de huidige scan toont als een afbeeldingsbestand (bitmap, GIF, PNG of JPEG).

/VIEWTYPE n

Definieert op welke waarden de kolommen “Percentage van bovenliggende map”, de “Groei” kolommen en het diagram “Leeftijd van bestanden” zijn gebaseerd. Mogelijke waarden zijn:

2: Grootte 3: Toegewezen ruimte (Grootte op schijf) 7: Aantal Bestanden

/XML <bestandsnaam>

Slaat de scanresultaten op in een XML-bestand dat later kan worden geladen voor vergelijkingen. Voorbeeld:

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

Deze optie kan worden gecombineerd met de /EXPAND schakeloptie om de hoeveelheid geëxporteerde mappen te beperken.

Notitie

Bij het laden van een beperkte XML-export naar TreeSize kunt u niet door de volledige directorytak navigeren, maar alleen door de geëxporteerde mappen.

/ZIP <bestandsnaam>

Deze optie kan alleen worden gebruikt in combinatie met de opdrachtregeloptie /SEARCH.

Alle gevonden bestanden worden verplaatst naar een zip-archief. Voorbeeld:

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

Zie ook: Verplaats geselecteerde bestanden

<SCANPATH>

Naast de parameter /SCAN kunt u ook een of meer paden aan het einde van de opdrachtregel doorgeven. Dit wordt echter niet langer aanbevolen om fouten bij het parseren van de opdrachtregel te voorkomen.

Dit voorbeeld scant de “Program Files” en de “Windows” map en maakt een tekst rapport aan onder “C:ReportsScanResults.txt”:

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

In het geval dat er een fout optreedt, wordt deze geretourneerd als Windows-foutcode in de exitcode van het proces. Omgevingsvariabelen (bijv. %APPDATA%) kunnen worden gebruikt in bestandsnamen voor de export evenals in de gescande paden.

Meerdere mappen scannen

Als u meerdere mappen moet scannen, kan het een goed idee zijn om verschillende aanroepen te combineren in een batch-bestand, bijvoorbeeld:

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"

De opdracht “START /WAIT” zorgt ervoor dat de taken sequentieel starten. Het niet parallel starten van de taken is meestal beter omdat een enkele taak meer voordeel haalt uit caches en systeembronnen. Het is ook mogelijk om de shares die gescand moeten worden in een tekstbestand op te slaan en de Windows “for” opdracht als volgt te gebruiken:

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"

Notitie

De dubbele procenttekens zijn vereist in batchbestanden, gebruik op de opdrachtregel slechts een enkele procent.

Geplande start

U kunt de Windows Taakplanner gebruiken om TreeSize met bepaalde opdrachtregelopties dagelijks, wekelijks of maandelijks op een bepaald tijdstip uit te voeren. De dialoog voor Scans plannen helpt u bij het instellen van een geplande taak.

U kunt ook de SCHTASKS opdracht gebruiken om geplande scans uit te voeren. Als u bijvoorbeeld de schijven C: en E: de volgende nacht om 03:00 uur wilt scannen en de resultaten wilt opslaan in een Excel-bestand, kunt u de volgende opdrachtregel gebruiken:

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"

Krijg hulp over de SCHTASKS opdracht op Microsoft’s pagina’s of door te typen:

SCHTAKS /Create /?

Notitie

Foutmeldingen die optreden tijdens geplande scans worden vermeld in het Windows-systeemlogboek.

PowerShell

Windows PowerShell kan nuttig zijn in combinatie met TreeSize. Dit voorbeeld toont hoe u een paar externe computers kunt doorzoeken die worden opgevraagd met een LDAP-query in de 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

Uitvoer omleiden

Als er geen ander exportdoel is opgegeven, zal TreeSize een korte export van de scan naar de standaarduitvoer schrijven, en fouten die tijdens de scan zijn opgetreden naar de standaardfoutuitvoer.

U kunt deze uitvoerstromen op de opdrachtregel (cmd.exe) omleiden met behulp van het pijpsymbool, bijv.

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

Om de uitvoer met PowerShell om te leiden, gebruikt u in plaats daarvan de Start-Process opdracht, bijv.

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

Windows Scripting Host

Als u van plan bent om de Windows Scripting Host (WSH) te gebruiken, zal uw opdracht om TreeSize te starten er als volgt uitzien:

Set Shell = CreateObject("WScript.Shell")

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

Exitcodes

Als de bewerking succesvol is voltooid, is de exitcode 0. Als er een fout is opgetreden, zal TreeSize een Windows-foutcode als exitcode retourneren indien beschikbaar, of 1 om een algemene fout aan te geven.

In ieder geval zal het Windows gebeurtenislogboek verdere informatie bevatten in het “Toepassing” logboek, Evenementbron “TreeSize”.