Kommando-linjeindstillinger¶
Professional -udgaven af TreeSize accepterer indstillinger på kommandolinjen, så du kan køre planlagte scanninger eller have resultaterne af en scanning på din skærm næste morgen.
Dialogen for Planlægning af scanninger vil hjælpe dig med at sammensætte en kommando-linje med de nedenstående indstillinger.
Bemærk
Disse indstillinger er kun tilgængelige i TreeSize Professional Edition.
Alle indstillinger¶
Treesize.exe [/OPTION] SCANPATH
/? eller /HELP¶
Viser denne hjælpeside.
/AGEOFFILES¶
Gemmer diagrammet på fanen »Alder af filer« i den scannede mappe som en bitmap, GIF, PNG, JPEG, tekst eller CSV-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Det følgende eksempel opretter en JPEG-billedfil af diagrammet »Alder af filer« for din lokale drev C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <værdi>¶
Med denne indstilling kan du vælge, om TreeSize skal føje sit output til eksisterende filer eller ej, når du laver en eksport, f.eks. når du bruger /TEXT. Vælg »True« for at vedhæfte og »False«, hvis du vil overskrive eksisterende filer.
Bemærk
Denne parameter fungerer ikke med eksporterede billeder, XML- og PDF-filer. Disse filer vil altid blive overskrevet. Du kan bruge kontakten /DATE for at sikre, at alle genererede rapporter har et unikt filnavn.
Når du eksporterer til en Excel- file via /EXCEL, kan denne parameter bruges sammen med /SHEETNAME til at tilføje dataene til det angivne ark. Eksempel:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Denne indstilling vil kun inkludere filer, for hvilke arkivbit er indstillet i scanningen. Denne indstilling kan være meget nyttig, hvis du vil beregne størrelsen på en sikkerhedskopi. I dette tilfælde kan du oprette en genvej på dit skrivebord eller i din startmenu, der automatisk starter beregningen af størrelsen på din sikkerhedskopi. Eksempel:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Hvis angivet, vil alle eksporterede filer blive vedhæftet e-mailen. Hvis ikke angivet, vedhæftes filer med en eksplicit angivet sti ikke. Dette er nyttigt, hvis dine XML- eller Excel-filer bliver ret store og fylder din e-mailkonto.
Dette eksempel vil eksportere til en Excel-fil, men ikke vedhæfte den til mailen:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Disse eksempler vil vedhæfte Excel-filen til e-mailen:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <filnavn>¶
Gemmer søjlediagrammet for den scannede mappe som en bitmap, GIF, PNG eller JPEG-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Dette eksempel opretter en PNG-billedfil af søjlediagrammet for dit lokale drev C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <filnavn|sti>¶
Sammenligner den scannede sti med en gemt indeksfil. Det følgende eksempel scanner drev C: og sammenligner resultatet med en gemt XML-rapport for dette drev:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
I stedet for en indeksfil kan du også bruge en sti med denne kommandolinjeparameter. Den angivne sti vil blive sammenlignet med det nuværende scanningsresultat. Det følgende eksempel scanner drev C:\ og bruger desuden stien D:Backup_of_C til at udføre en sammenligning mellem de to:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Alternativt kan du sammenligne to allerede eksisterende indeksfiler f.eks. »c1.xml.zip« og »c2.xml.zip« ved at bruge denne kommando:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
Kommandoen /OPEN forbereder sammenligningen af de to filer ved at udvide den første fil (»c1.xml.zip«) til en scanningsfil. Den anden file (»c2.xml.zip«) bliver sammenlignet med denne udvidede scanningsfil, ligesom det ville ske, hvis »c2.xml.zip« blev sammenlignet med en »rigtig« scanning.
/COPY <sti>¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Kopierer resultaterne af en TreeSize fil søgning til destinationsplaceringen.
Den følgende kommando vil søge på din lokale drev C: ved hjælp af de nyeste søgeindstillinger og kopiere søgeresultaterne til mappen »C:\temp\ObsoleteFiles«:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Se også: Flyt markerede filer
/CREATEDPASTDAYSONLY <n>¶
Denne mulighed vil kun inkludere filer i scanningen, som blev oprettet i løbet af det antal dage, der er indtastet i argumentet. I det følgende eksempel vil denne mulighed kun inkludere filer, der blev oprettet i løbet af de sidste otte dage i scanningen:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <drev>¶
Opretter et snapshot for de drev, der er angivet efter denne kommandolinjeparameter. Eksempel:
Treesize /CREATESNAPSHOT "C:\" "D:\"
Oprettelse af snapshots kan kræve administrative rettigheder.
/CSV <filnavn>¶
Gemmer resultaterne til en CSV-fil, efter scanningen eller søgningen er afsluttet. Applikationen vil afslutte sig selv efter gemning. Dette eksempel vil gemme resultaterne af en fil søgning på dit lokale drev C: med de seneste søgeindstillinger til en CSV-fil:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Denne switch vil tilføje den aktuelle dato og tid til alle eksportfilnavne i kommandolinjen. Dette er nyttigt, hvis du ønsker at udføre scanninger regelmæssigt, f.eks. hver nat eller hver weekend. Det følgende eksempel vil scanne netværksstien »\\Host\Share« og gemme resultatet til en fil som »C:\Scans\name_2013-08-14_17-18-24.xls«:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Det vil erstatte de dublerede filer, der blev fundet af TreeSize dublerede fil søgning med NTFS hardlinks:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Sletter permanent alle filer, der er blevet fundet som resultat af en TreeSize fil søgning. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Se også: Flyt markerede filer
/EMAIL <modtager>¶
Sender de indsamlede data til den angivne e-mailadresse. Denne parameter kan kun bruges én gang på kommandolinjen, og kun én e-mail med alle resultater vil blive sendt. Flere modtagere kan adskilles med semikolon (;) eller kommaer. For at sende e-mails via kommandolinjen skal du angive gyldige SMTP-indstillinger på den tilsvarende side i TreeSize-indstillingsdialogen. Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Hvis der ikke er angivet andre parametre, vil e-mailen blive sendt i det format, der er indstillet i indstillingerne (HTML eller almindelig tekst). Hvis du ønsker at definere formatet uafhængigt af de nuværende indstillinger, kan du bruge parametrene /TEXT eller /HTML lige efter definitionen af modtageradresse(rne). Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Ved at kombinere parametre kan du også tilføje vedhæftede filer til e-mailen. Følgende eksempel vil tilføje en Excel-rapport af scanningen som en vedhæftet fil til e-mailen:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingerne /SEARCH og /EMAIL. Hvis denne parameter er angivet, sender TreeSize kun en e-mail med de aktuelle søgeresultater, hvis der er fundet mindst én fil eller mappe under søgningen med en af de angivne søgetyper.
/EMPTYRECYCLEBIN¶
Hvis du bruger denne mulighed, vil TreeSize tømme papirkurven, før den kører den aktuelle scanning. Eksempel:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Denne parameter tillader at overføre filer, der er blevet fundet af TreeSize filsøgen, til en anden applikation eller script. Et muligt mål for denne parameter kan være et batch- eller PowerShell-script. Følgende eksempel vil søge på drev C:\ med de nyeste søgeindstillinger og kalde scriptet »Archive.bat« for hver fil, der er blevet fundet. Filen vil blive sendt til scriptet som kommandolinjeparameter:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Se også: Flyt markerede filer
/EXCEL <filsti>¶
Eksporterer de indsamlede data i Microsoft Excel-format og gemmer dem under den indtastede filsti. Hvis der kun angives et filnavn, bruges den aktuelle installationsmappe til at gemme eksporten. Understøttede formater er det konventionelle .XLS filformat (Excel 97-2003) samt .XLSX formatet (introduceret med Excel 2007). Det anvendte format afhænger af udvidelsen af det angivne filnavn. Applikationen vil afslutte sig selv efter gemning. Eksempel:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Hvis filnavnet allerede findes, vil filen blive åbnet, og et nyt regneark vil blive tilføjet.
Bemærk
På TreeSize File Search (/SEARCH) samles resultaterne af hver søgetype i deres eget specifikke regneark. Hvis filen under den givne sti allerede findes, vil disse ark blive overskrevet. For at forhindre dette skal du bruge kommandolinjeindstillingen /APPENDTOFILES.
/EXCLUDE <mønster1;mønster2>¶
Denne mulighed giver dig mulighed for at angive mønstre for filer og mapper, der skal udelukkes fra en scanning. Flere udelukkede mønstre kan adskilles med et semikolon (;). Hvis et eller flere af mønstrene indeholder mellemrum, skal den komplette mønsterstreng sættes i citationstegn (»). Følgende eksempel vil ignorere filer og mapper, der ender med ».tmp« eller hvor det præcise navn er »system«:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <niveau|størrelse>¶
Denne indstilling lader dig angive, hvor mange niveauer i mappetræet der skal udvides efter scanning. Hvis du ikke angiver et nummer efter denne indstilling, vil alle mapper blive udvidet. I stedet for et mappeniveau kan du også angive et antal i Mega Byte (MB). I dette tilfælde vil alle mapper, der er større end det angivne antal, blive udvidet. Enheden »MB« skal følge nummeret uden mellemrum. Følgende eksempel vil scanne mappen »H:\User«, udvide alle mapper større end 10 MB og gemme resultatet i Excel-filen »C:\Results\Allusers.xlsx«:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <værdi>¶
Hvis denne mulighed bruges, vil Excel-eksporter bruge udvidelige/kolapsbare grupper, der kan navigeres på en måde, der ligner mappetræet.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <filnavn>¶
Denne mulighed giver dig mulighed for at eksportere indholdet af »Drevliste« til en Excel-, tekst- eller CSV-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Eksempel:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Hvis angivet, vil filer blive inkluderet i alle eksporter. Så denne mulighed svarer til at aktivere indstillingen »Værktøjer > Indstillinger > Eksporter > * > Eksporterede elementer > Mapper og enkeltfiler«
/EXPORTGROUPSEXPANDED¶
Hvis angivet, vil eksporten af udvidelseslisten indeholde alle oplysninger om de udvidelser, der er indeholdt i grupper.
/EXPORTPATHSLIST <filnavn>¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Eksporterer en simpel liste, der indeholder alle søgeresultater. Listen vil kun indeholde de fulde stier til søgeresultaterne og ingen andre oplysninger. Understøttede formater for destinationsfilen er .txt og .csv.
Dette eksempel vil søge efter og oprette en liste over alle exe-filer på drev C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Det kan bruges til at importere resultaterne af en tidligere søgning tilbage i brugergrænsefladen ved at bruge »Fil > Liste over stier > Importer stiliste« eller parameteren /IMPORT.
Hvis indstillingen »Værktøjer > Indstillinger > Eksporter > Inkluder duplikerede grupper« er aktiveret, kan du også bruge denne funktion til at eksportere og importere resultaterne af duplikatsøgningen, inklusive deres gruppestruktur.
/EXPORTTITLE ¶
Kan bruges til at ændre titlen i en trykt rapport eller eksporteret fil. Dette giver dig mulighed for at give yderligere oplysninger til brugeren, når du bruger TreeSize i et automatiseret miljø. Brug af miljøvariabler er også tilladt. Eksempel:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <filnavn>¶
Denne mulighed giver dig mulighed for at gemme statistikker om filudvidelser / filtyper af den scannede filsystemgren til en Excel-, HTML-, tekst- eller CSV-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. De eksporterede kolonner vil være dem, der var aktiveret i brugergrænsefladen på fanen »Udvidelser«, da den sidst blev brugt, eller på det tidspunkt, hvor konfigurationsfilen, der blev leveret via /OPTIONS, blev skrevet.
Følgende eksempel scanner drev C: og opretter en Excel-fil med navnet »D:\TreeSize Reports\C_filetypes.xls« med statistikker over filtyperne på dette drev:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <filnavn>¶
Gemmer det lille diagram, der vises nederst på siden »Udvidelser«, til en billedfil (bitmap, GIF, PNG eller JPEG).
/EXTENSIONSPIECHART <filnavn>¶
Gemmer et cirkeldiagram, der viser fordelingen af »filudvidelser«, til en billedfil (bitmap, GIF, PNG eller JPEG).
/FILTER <mønster1;mønster2>¶
Sætter en filfilter, der kun tæller filer med bestemte udvidelser, f.eks. ».mp3« eller ».doc«. Flere mønstre kan angives, adskilt af semikolon (;). Følgende eksempel vil søge efter MP3- og AVI-filer i »Users«-mappen på serveren:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Når du udfører en TreeSize File Search (/SEARCH), kan du også bruge kommandolinjekontakten /FILTER til at angive mønstrene for den avancerede filsøgning. Hvis du vil udføre en mere kompleks brugerdefineret filsøgning, skal du gemme søgeindstillingerne i en fil og sende den resulterende XML-fil til kommandolinjen efter /SEARCH.
/FOLLOWREPARSEPOINTS¶
Hvis denne parameter tilføjes til kommandolinjen, vil TreeSize følge monteringspunkter og eksterne symbolske links, når der scannes et filsystemtræ.
/GROUPSCANS¶
Hvis du bruger denne kommandolinje-switch, grupperes alle scannede mapper under en virtuel rodmappe. Brug /GROUPSCANS FALSE, hvis du vil sikre, at der ikke bruges en virtuel rodmappe.
/HIDESMALLFOLDERS <værdi>¶
Gør det muligt at skjule objekter, der er mindre end en minimumsstørrelse, hvilket er nyttigt for at få klare eksporter. <value> kan være en størrelsesværdi med enhed eller en almindelig byteværdi uden enhed. Kan ikke bruges i kombination med /EXPAND. I dette eksempel vil kun mapper med en minimumsstørrelse på 50 MB blive eksporteret:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <filnavn>¶
Gemmer grafen på »Historik«-fanen for den scannede mappe som en bitmap, GIF, PNG eller JPEG-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Dette eksempel opretter et JPEG-billede af historikgrafen for drev C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <filnavn>¶
Gemmer de indsamlede data til en HTML-fil, som kan vises med enhver HTML-browser. Du kan specificere, hvilken information fra scanningen der skal inkluderes i eksporten via »Hjem > Indstillinger > Eksporter > HTML > Diagrammer og lister, der skal inkluderes. Du kan vælge, hvilke af de yderligere lister eller diagrammer der skal tilføjes til eksporten. De vil automatisk blive indlejret i den HTML-fil, der genereres efter scanningen.
Følgende eksempel vil generere en HTML-rapport for drev C: og gemme den til »D:\HTML«:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Hvis du ønsker, at mere end én scanning skal være en del af HTML-filen, skal du tilføje kommandolinjeswitchen /GROUPSCANS. Når du eksporterer til HTML uden et inkluderet billede, kan du alternativt bruge kontakten /APPENDTOFILES. Uden et af disse flag vil HTML-filen blive overskrevet.
/IMPORT <filnavn>¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Indlæser en liste over stier i brugergrænsefladen for TreeSize fil-søgning. Filen kan være i .txt- eller .csv-format. Denne parameter kan bruges til at importere resultaterne af en tidligere søgning. De importerede filer og mapper kan flyttes/kopieres/slettes/arkiveres, ligesom ethvert »live« søgeresultat, ved hjælp af dialogen til filoperationer.
Eksempel:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Du kan også kombinere denne parameter med parametrene /RECYCLE, /DELETE eller /MOVE for automatisk at slette eller flytte de filer, der er indeholdt i tekstfilen. Et eksempel:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <filnavn>¶
Importerer en liste af mønstre fra en fil. Filen kan være en simpel tekstfil med en ist af filtermønstre, adskilt af semikolon, eller du kan bruge brugergrænsefladen til at oprette et mere komplekst sæt mønstre og bruge eksportfunktionen til at generere mønsterfilen i XML-format. Understøttede formater er CSV, TXT og XML.
De importerede mønstre vil blive brugt som filtre til scanningen for enten at inkludere eller ekskludere specifikke filer og mapper.
Hvis den bruges i kombination med kommandolinjeindstillingen /SEARCH, vil denne parameter oprette en ny avanceret søgning, der bruger mønstrene fra den importerede fil som kriterier for søgningen.
Dette eksempel importerer filtermønstre, der er defineret under »C:\TreeSizeFiles\patterns.txt«, starter en scanning af drev C:\ og eksporterer resultaterne til en HTML-fil:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <filnavn>¶
Gemmer scanningsresultaterne i en SQLite-fil, som kan indlæses til sammenligninger på et senere tidspunkt. Et eksempel:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <separator-tegn>¶
Giver dig mulighed for at definere den separator, der bruges, når du eksporterer tekst- eller CSV-filer. Tekstfiler bruger som standard tabulatoren, CSV-filer listeseparatoren fra de regionale indstillinger i Windows-kontrolpanelet.
Angiv et enkelt tegn eller strengen »TAB« for tabulator efter denne switch. Eksempler på dette:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <sti>¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Den flytter resultaterne af en TreeSize-filsøgning til en anden placering.
Følgende kommando søger på dit lokale drev C: ved hjælp af de nyeste søgemuligheder og flytter søgeresultaterne til mappen »C:\Temp\ObsoleteFiles«:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Se også: Flyt markerede filer
/NOGUI¶
Der vises ikke noget vindue, og programmet vises ikke på proceslinjen. Nyttigt til at udføre scanninger eller søgninger i baggrunden uden visuel feedback.
Advarsel
Brug kun denne switch, hvis du har testet resten af kommandolinjens indstillinger, fordi der ikke kan vises fejlmeddelelser i denne tilstand.
Fejl vil dog blive logget i Windows‹ hændelseslog.
/NOHEADERS¶
Udelader de header-linjer, der normalt skrives oven på scannings- eller søgeeksportfiler. Det gør det lettere at modtage almindelige data til efterbehandling.
/NOUNITS¶
Udelader de enheder, der normalt skrives efter størrelsesværdier. Denne indstilling i kombination med /SIZEUNIT 0 vil eksportere almindelige byte-værdier. Det gør det lettere at modtage almindelige data til efterbehandling.
Bemærk
Denne kommandolinje vil kun påvirke eksporten af katalogtræet, som er genereret ved hjælp af indstillingerne /TEXT, /EXCEL, /HTML, /EMAIL eller /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST, eller /TOPFILESLIST vil ikke blive påvirket.
/OPEN <filnavn>¶
Åbner en gemt XML rapport ved applikationens opstart. Eksempel:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <filnavn>¶
Brug denne parameter til at anvende eksporterede brugerindstillinger til TreeSize. Brugerindstillinger kan eksporteres under »File > Options > Export«. Eksempel:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Bemærk
Ændre så mange indstillinger som muligt i brugergrænsefladen, før du gemmer indstillingerne for at reducere antallet af kommandolinjeparametre, du har brug for.
/PDF¶
Gemmer resultaterne til en PDF-fil, efter scanningen eller søgningen er afsluttet. Applikationen vil afslutte sig selv efter gemning. Følgende eksempel vil udføre en scanning af din lokale drev C: og gemme resultaterne til en PDF-fil:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <filnavn>¶
Gemmer cirkeldiagrammet af det scannede bibliotek til en bitmap, GIF, PNG eller JPEG-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Følgende eksempel vil scanne drev C: og eksportere et cirkeldiagram i PNG-format:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Printer en rapport for det scannede bibliotekstræ ved hjælp af den standardprinter, der er konfigureret i dine systemindstillinger. Applikationen vil blive afsluttet efter udskrivning. Eksempel:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <værdi>¶
Hvis værdien er indstillet til sand, aktiverer denne indstilling en skrivebeskyttet tilstand, hvor filoperationer (f.eks. flytning eller sletning) er deaktiveret, så den kun kan bruges som rapporteringsværktøj.
Start med en værdi af falsk for at deaktivere skrivebeskyttet tilstand igen.
/RECYCLE¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Flytter alle filer til papirkurven, der er blevet fundet som resultat af en TreeSize fil søgning. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Se også: Flyt markerede filer
/RESTRICTEDMODE <værdi>¶
Hvis værdien er indstillet til sand, aktiverer denne indstilling en begrænset tilstand, hvor mange funktioner er deaktiveret, som ikke er af interesse for »normale« (ikke-administrator) brugere. Blandt de deaktiverede funktioner er: Tjek for opdatering, Åbn software applet i Windows kontrolpanel, Planlæg TreeSize scanninger, tilslut netværksdrev, konfigurere Windows Systemgendannelse, Kør som administrator, eksporter og anvend NTFS-komprimering. Du kan angive en sti, der skal scannes, f.eks. brugerens hjemmemappe, ved kommandolinjen eller ved hjælp af opstartsstier i en gemt konfigurationsfil.
Start med en værdi af falsk for at deaktivere den begrænsede tilstand igen.
Hvis du desuden aktiverer indstillingen /READONLYMODE, vil brugeren ikke kunne slette eller flytte filer i TreeSize, så det vil kun være brugbart som rapportværktøj.
/SCAN <sti|filnavn>¶
Definerer hvilken drev eller sti der skal scannes. Scanningsstien skal bruges som værdi for denne parameter.
Hvis for eksempel drev D:\ skal scannes, kan du bruge:
Treesize /SCAN "D:\"
Hvis du ikke ønsker at scanne hele drevet, kan du også angive en sti, som bruges som udgangspunkt for scanningen. For eksempel:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Flere scanningsstier er også mulige, de adskilles af et mellemrum. Stier, der indeholder et mellemrum, skal være i citationstegn (»). Eksempel:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Wildcard-tegnene »*« og »?« er tilladt. Eksempel:
Treesize /SCAN "H:\users\A*"
Du kan også angive en tekstfil, der indeholder en liste over stier, der skal scannes. TreeSize vil scanne alle stier, der findes i tekstfilen, som er angivet efter denne switch. Tekstfilen skal indeholde én sti pr. linje. Det følgende eksempel scanner alle stier, der findes i filen »D:\PathsToScan.txt« og skriver hvert scanningsresultat til et separat ark i en Excel-fil med dagens dato:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Du kan også kalde TreeSize i en »for«-løkke med kun en af stierne, se venligst et eksempel nedenfor.
/SEARCH¶
Åbner vinduet File Search i TreeSize. Hvis »:Start« tilføjes til denne kommandolinjeindstilling, startes søgningen automatisk. En tidligere gemt XML-fil, der indeholder søgeindstillinger, kan sendes, og disse indstillinger vil så blive brugt til at udføre søgningen.
Bemærk
Filer, der findes i denne søgning, bliver automatisk markeret.
Det følgende eksempel udfører søgningen med indstillinger, der tidligere er gemt i filen »SearchSettings.xml« og gemmer resultaterne i en tekstfil:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Bemærk
Generelt vil de sidste søgeindstillinger eller et tidligere gemt sæt søgeindstillinger blive brugt. Du kan dog også angive søgemønstrene for den avancerede søgning ved hjælp af kommandolinjeindstillingen /FILTER.
/SHEETNAME ¶
Giver dig mulighed for at angive navnet på det ark, der tilføjes til en Excel-fil, når du bruger kommandolinjekontakten /EXCEL.
Bemærk
Et Excel-arknavn skal være unikt i en Excel-fil, og visse specialtegn som skråstreger, omvendte skråstreger og kolon er forbudte. TreeSize vil altid oprette et unikt arknavn ved at erstatte ugyldige tegn med understregninger og ved at tilføje dato og tid, hvis det er nødvendigt. Hvis et ark med det angivne navn allerede findes i målfilen, oprettes et nyt ark med et unikt navn. Brug kommandolinjeindstillingen /APPENDTOFILES for at tilføje data til det eksisterende ark.
/SHORTDATEFORMAT <format>¶
Ændrer det korte datoformat for denne proces, som kan konfigureres i de regionale indstillinger i Windows Kontrolpanel. Eksporter af TreeSize vil bruge dette format til datoværdier. Eksempel:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Denne mulighed kan bruges til at specificere den enhed, der skal bruges til at vise størrelsesværdier: N kan have værdierne 0 til 5, hvilket betyder: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Automatiske enheder. Uden denne mulighed vil den sidst brugte konfiguration i TreeSize blive anvendt.
/SORTBY <Kolonnenavn>¶
Gør det muligt at angive, efter hvilken værdi de genererede eksporter skal sorteres. Mulige værdier er kolonnenavne som »Size« eller »Name«. Den sidst anvendte sorteringstype i TreeSize-brugergrænsefladen vil blive brugt som standard. Eksempel:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <filnavn>¶
Gemmer scanningsresultaterne i en SQLite-fil, som kan indlæses til sammenligninger på et senere tidspunkt. Et eksempel:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <emne>¶
Denne mulighed giver dig mulighed for at tilpasse emnet, der vil blive brugt til e-mails, der sendes ved afslutningen af scanningen. Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <filnavn>¶
Gemmer resultaterne til en tekst- eller CSV-fil, efter scanningen eller søgningen er afsluttet. Applikationen afslutter sig selv efter gemning. Følgende eksempel vil udføre en scanning af din lokale drev C: og gemme resultaterne til en tekstfil:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
Tekstformatet bruger et tabelformat, der er rettet mod menneskelige læsere. Hvis filnavnet refererer til en CSV-fil, bruges CSV-formatet automatisk i stedet. Hvis du udtrykkeligt vil bruge CSV-formatet, anbefaler vi, at du bruger parameteren /CSV.
/TITLE <titel>¶
Kan bruges til at erstatte rodstien for en scanning med en brugerdefineret tekst. Dette gør det muligt at give mere meningsfulde navne til UNC-stier for eksempel og dermed øge læsbarheden af en rapport. Den valgte titel vil blive anvendt som titlen på rapporten, når en fil eksporteres. Eksempel:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
I forbindelse med en TreeSize fil-søgning kan denne parameter bruges til at navngive en avanceret søgning. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <filnavn>¶
Denne mulighed gør det muligt at gemme indholdet af Top files-listen til en Excel-, HTML-, tekst- eller CSV-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Eksempel:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <filnavn>¶
Gemmer trækortdiagrammet af den scannede bibliotekstræ som bitmap, GIF, PNG eller JPEG-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. Eksempel:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Indstiller niveauet for brugergrænsefladen. Mulige værdier er Simple, Normal eller Expert. Eksempel:
Treesize /UILevel "Simple"
/USERSLIST <filnavn>¶
Denne mulighed gør det muligt at gemme statistikker, der viser resultaterne grupperet efter brugernavn, til en Excel-, HTML-, tekst- eller CSV-fil. Filtypen afhænger af udvidelsen af det angivne filnavn. De eksporterede kolonner vil være dem, der var aktiveret i brugergrænsefladen på fanen »Users«, da den sidst blev brugt, eller på det tidspunkt, hvor konfigurationsfilen, der blev leveret via /OPTIONS, blev skrevet.
Det følgende eksempel scanner drev C: og opretter en Excel-fil i »C:\Temp« med statistikkerne for brugerne på dette drev:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <brugernavn>¶
Angiver det brugernavn, der skal bruges til at godkende scanningerne. Brug /PASSWORD til at angive en Adgangskode til dette brugernavn. Det anbefales i stedet at bruge Microsoft-værktøjet RUNAS.
/USERFILTER <brugernavn>¶
Med denne mulighed vil kun filer ejet af en bestemt bruger blive taget i betragtning under scanning. Angiv navnet på denne bruger efter denne switch.
Bemærk
Du kan ikke bruge flere brugernavne her, men jokertegnene »*« og »?« understøttes.
Eksempel:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <filnavn>¶
Gemmer det lille diagram, der vises nederst på »Brugere«-siden, som en billedfil (bitmap, GIF, PNG eller JPEG).
/USERSPIECHART <filnavn>¶
Gemmer et cirkeldiagram, der viser »brugerstatistikkerne« for den aktuelle scanning, som en billedfil (bitmap, GIF, PNG eller JPEG).
/VIEWTYPE¶
Definerer, hvilke værdier »Procent af forælder«, »Vækst«-kolonnerne og »Alderen på filer«-diagrammet er baseret på. Mulige værdier er:
2: Størrelse 3: Allokeret plads (Størrelse på disk) 7: Antal filer
/XML <filnavn>¶
Gemmer scanningsresultaterne til en XML-fil, der kan indlæses til sammenligninger på et senere tidspunkt. Eksempel:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Denne indstilling kan kombineres med kontakten /EXPAND for at begrænse de eksporterede mapper.
Bemærk
Når du indlæser en begrænset XML-eksport til TreeSize, kan du ikke navigere gennem den komplette mappestruktur, men kun de eksporterede mapper.
/ZIP <filnavn>¶
Denne indstilling kan kun bruges i kombination med kommandolinjeindstillingen /SEARCH.
Alle filer, der er blevet fundet som resultat af en TreeSize fil-søgning, vil blive flyttet til et zip-arkiv. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Se også: Flyt markerede filer
<SCANPATH>¶
Ud over parameteren /SCAN kan du også sende en eller flere stier i slutningen af kommandolinjen. Dette anbefales dog ikke længere for at undgå fejl, når kommandolinjen analyseres.
Dette eksempel scanner »Program Files« og »Windows«-mappen og opretter en tekstrapport under »C:\Reports\ScanResults.txt«:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
Hvis der opstår en fejl, returneres den som Windows-fejlkode i procesens exitkode. Miljøvariabler (f.eks. %APPDATA%) kan bruges i filnavne til eksport samt i de scannede stier.
Scanning af flere mapper¶
Hvis du har brug for at scanne flere mapper, kan det være en god idé at samle flere opkald i en batchfil, for eksempel:
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"
Kommandoen »START /WAIT« sikrer, at opgaverne starter sekventielt. At undgå at starte opgaverne parallelt er normalt bedre, fordi en enkelt opgave drager mere fordel af caches og systemressourcer. Det er også muligt at gemme de delte mapper, der skal scannes, i en tekstfil og bruge Windows »for«-kommandoen på denne måde:
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"
Bemærk
De dobbelte procenttegn er nødvendige i batchfiler; på kommandolinjen bruges kun et enkelt procenttegn.
Planlagt start¶
Du kan bruge Windows Planlagte opgaver til at køre TreeSize med bestemte kommandolinjeindstillinger dagligt, ugentligt eller månedligt på et bestemt tidspunkt. Dialogen for Planlægning af scanninger vil hjælpe dig med at opsætte en planlagt opgave.
Du kan også bruge kommandoen SCHTASKS til at udføre planlagte scanninger. Hvis du for eksempel ønsker at scanne drev C: og E: næste nat kl. 03:00 og gemme resultaterne i en Excel-fil, kan du bruge følgende kommandolinje:
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"
Få hjælp til SCHTASKS-kommandoen på Microsofts sider eller ved at skrive:
SCHTAKS /Create /?
Bemærk
Fejlmeddelelser, der opstår under planlagte scanninger, listes i systemets Windows-hændelseslog.
PowerShell¶
Windows PowerShell kan være nyttig i kombination med TreeSize. Dette eksempel viser, hvordan man søger på et par fjerncomputere, der er forespurgt ved hjælp af en LDAP-forespørgsel i 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
Omdirigering af output¶
Hvis der ikke angives noget andet eksportmål, vil TreeSize skrive en kort eksport af scanningen til standardoutput og fejl, der opstod under scanningen, til standardfejl.
Du kan omdirigere disse outputstrømme på kommandolinjen (cmd.exe) ved hjælp af pipe-symbolet, f.eks.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
For at omdirigere output ved hjælp af PowerShell, skal du i stedet bruge Start-Process-kommandoen, f.eks.
Start-Process -FilePath »C:\Program Files\JAM Software\TreeSize\Treesize.exe« -ArgumentList »/NOGUI /SCAN C:\« -RedirectStandardOutput ».\StdOut.txt« -RedirectStandardError ».\StdError.txt«
Windows Scripting Host¶
Hvis du har tænkt dig at bruge Windows Scripting Host (WSH), vil din kommando til at starte TreeSize se sådan ud:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Afslutningskoder¶
Hvis operationen blev gennemført med succes, er afslutningskoden 0. Hvis der opstod en fejl, vil TreeSize returnere en Windows-fejlkode som afslutningskode, hvis det er tilgængeligt, eller 1 for at angive en generel fejl.
I alle tilfælde vil Windows Event Log indeholde yderligere information i »Applikation« loggen, hændelseskilde »TreeSize«.