Kommandolinjealternativer¶
Professional -utgaven av TreeSize godtar kommandolinjealternativer som gjør det mulig å kjøre planlagte skanninger eller å ha resultatene av en skanning på skjermen neste morgen.
Dialogboksen for Planlegging av skanninger vil hjelpe deg med å sette sammen en kommandolinje med alternativene nedenfor.
Note
Disse alternativene er kun tilgjengelige i TreeSize Professional Edition.
Alle alternativer¶
Treesize.exe [/OPTION] SCANPATH
/? eller /HELP¶
Viser denne hjelpesiden.
/AGEOFFILES¶
Lagrer grafen på fanen «Alder på filer» i den skannede katalogen til en bitmap, GIF, PNG, JPEG, tekst eller CSV-fil. Filtypen avhenger av filnavnets spesifiserte utvidelse. Følgende eksempel lager en JPEG-bildefil av grafen «Alder på filer» for din lokale stasjon C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <verdi>¶
Med dette alternativet kan du velge om TreeSize skal legge til utdataene i eksisterende filer når du eksporterer, f.eks. når du bruker /TEXT. Velg «True» for å legge til og «False» hvis du vil overskrive eksisterende filer.
Note
Denne parameteren fungerer ikke med eksporterte bilder, XML- og PDF-filer. Disse filene vil alltid bli overskrevet. Du kan bruke bryteren /DATE for å sikre at alle genererte rapporter har et unikt filnavn.
Når du eksporterer til en Excel-fil via /EXCEL, kan denne parameteren brukes sammen med /SHEETNAME for å legge til dataene i det angitte arket. Eksempel:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Dette alternativet vil inkludere kun filer for hvilke arkivbiten er satt i skanningene. Dette alternativet kan være svært nyttig hvis du ønsker å beregne størrelsen på en sikkerhetskopi. I dette tilfellet kan du opprette en snarvei på skrivebordet eller i startmenyen som automatisk vil begynne å beregne størrelsen på sikkerhetskopien din. Eksempel:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Hvis spesifisert, vil alle eksporterte filer bli vedlagt e-posten. Hvis ikke spesifisert, blir filer med en eksplisitt angitt bane ikke vedlagt. Dette er nyttig i tilfelle XML- eller Excel-filer blir ganske store og fyller opp e-postkontoen din.
Dette eksemplet vil eksportere til en Excel-fil, men ikke vedlegge den til e-posten:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Disse eksemplene vil vedlegge Excel-filen til e-posten:
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>¶
Lagrer stolpediagrammet av den skannede katalogen til en bitmap, GIF, PNG eller JPEG-fil. Filtypen avhenger av filnavnets spesifiserte utvidelse. Dette eksemplet lager en PNG-bildefil av stolpediagrammet for din lokale stasjon C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <filnavn|sti>¶
Sammenligner den skannede banen med en lagret indeksfil. Følgende eksempel skanner stasjon C: og sammenligner resultatet med en lagret XML-rapport for denne stasjonen:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
I stedet for en indeksfil kan du også bruke en bane med denne kommandolinjeparameteren. Den angitte banen vil bli sammenlignet med det gjeldende skanneresultatet. Følgende eksempel skanner stasjonen C:\ og bruker i tillegg banen D:Backup_of_C for å utføre en sammenligning mellom 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 å bruke denne kommandoen:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
Kommandoen /OPEN forbereder sammenligningen av de to filene ved å utvide den første filen («c1.xml.zip») til en skannefil. Den andre filen («c2.xml.zip») sammenlignes med denne utvidede skannefilen, akkurat som det ville skjedd hvis «c2.xml.zip» ble sammenlignet med en «ekte» skanning.
/COPY <sti>¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Kopierer resultatene av et TreeSize filsøke til målplasseringen.
Følgende kommando søker på den lokale stasjonen C: ved hjelp av de nyeste søkealternativene og kopierer søkeresultatene til mappen «C:\temp\ObsoleteFiles»:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Se også: Flytt merkede filer
/CREATEDPASTDAYSONLY <n>¶
Dette alternativet vil inkludere kun filer i skanningene som ble opprettet i løpet av antall dager som er angitt i argumentet. I følgende eksempel vil dette alternativet kun inkludere filer opprettet i løpet av de siste åtte dagene i skanningen:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <stasjon>¶
Oppretter et øyeblikksbilde for stasjonene som er angitt etter denne kommandolinjeparameteren. Eksempel
Treesize /CREATESNAPSHOT "C:\" "D:\"
Oppretting av øyeblikksbilder kan kreve administrative rettigheter.
/CSV <filnavn>¶
Lagrer resultatene til en CSV-fil etter at skanningen eller søket er fullført. Applikasjonen vil avslutte seg selv etter lagring. Dette eksemplet vil lagre resultatene av et filsøke på din lokale stasjon C: med de siste søkeinnstillingene til en CSV-fil:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Denne bryteren legger til gjeldende dato og klokkeslett i alle eksportfilnavn på kommandolinjen. Dette er nyttig hvis du ønsker å utføre skanninger regelmessig, f.eks. hver kveld eller hver helg. Følgende eksempel vil skanne nettverksbanen «\\Host\Share» og lagre resultatet i en fil som «C:\Scans\name_2013-08-14_17-18-24.xls»:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Det vil erstatte de dupliserte filene som ble funnet av TreeSize duplikatfil-søket med NTFS-hardlenker:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Sletter permanent alle filer som har blitt funnet som resultat av et TreeSize filsøke. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Se også: Flytt merkede filer
/EMAIL <mottaker>¶
Sender de innsamlede dataene til den angitte e-postadressen. Denne parameteren kan kun brukes én gang på kommandolinjen, og kun én e-post med alle resultater vil bli sendt. Flere mottakere kan skilles med semikolon (;) eller komma. For å sende e-poster via kommandolinjen, må du spesifisere gyldige SMTP-innstillinger på den tilsvarende siden i TreeSize-alternativdialogen. Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Hvis ingen andre parametere er spesifisert, vil e-posten bli sendt i det formatet som er angitt i alternativene (HTML eller ren tekst). Hvis du ønsker å definere formatet uavhengig av de nåværende alternativene, kan du bruke parameterne /TEXT eller /HTML rett etter definisjonen av mottakeradressen(e). Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Ved å kombinere parametere kan du også legge ved vedlegg til e-posten. Følgende eksempel vil legge til en Excel-rapport av skanningen som et vedlegg til e-posten:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativene /SEARCH og /EMAIL. Hvis denne parameteren er angitt, vil TreeSize bare sende en e-post med de aktuelle søkeresultatene hvis minst én fil eller mappe har blitt funnet under søket, med en av de angitte søketypene.
/EMPTYRECYCLEBIN¶
Hvis du bruker dette alternativet, vil TreeSize tømme papirkurven før den nåværende skanningen kjøres. Eksempel:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Denne parameteren gjør det mulig å sende filer som har blitt funnet av TreeSize-filsøket, til et annet program eller skript. Et mulig mål for denne parameteren kan være en batch eller et powershell-skript. Følgende eksempel vil søke i stasjonen C:\ med de nyeste søkeinnstillingene og kalle opp skriptet «Archive.bat» for hver fil som er funnet. Filen sendes til skriptet som en kommandolinjeparameter:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Se også: Flytt merkede filer
/EXCEL <filsti>¶
Eksporterer de innsamlede dataene i Microsoft Excel-format og lagrer dem under den angitte filbanen. Hvis kun et filnavn er spesifisert, brukes den nåværende installasjonskatalogen til å lagre eksporten. Støttede formater er det konvensjonelle .XLS filformatet (Excel 97-2003) samt .XLSX formatet (innført med Excel 2007). Det brukte formatet avhenger av filnavnets utvidelse. Applikasjonen vil avslutte seg selv etter lagring. Eksempel:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Hvis filnavnet allerede eksisterer, vil filen bli åpnet og et nytt regneark vil bli lagt til.
Note
På TreeSize File Search (/SEARCH) samles resultatene av hver søketype i hvert sitt spesifikke regneark. Hvis filen under den angitte banen allerede finnes, vil disse arkene bli overskrevet. For å forhindre dette må du bruke kommandolinjealternativet /APPENDTOFILES.
/EXCLUDE <mønster1;mønster2>¶
Dette alternativet gjør det mulig å spesifisere mønstre for filer og mapper som skal ekskluderes fra en skanning. Flere ekskluderingsmønstre kan skilles med semikolon (;). Hvis ett eller flere av mønstrene inneholder mellomrom, må hele mønsterstrengen settes i anførselstegn («). Følgende eksempel vil ignorere filer og mapper som slutter med «.tmp» eller der det eksakte navnet er «system»:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <nivå|størrelse>¶
Med dette alternativet kan du angi hvor mange nivåer i katalogtreet som skal utvides etter skanning. Hvis du ikke angir et tall etter dette alternativet, vil alle mapper bli utvidet. I stedet for et katalognivå kan du også angi en mengde i Mega Byte (MB). I dette tilfellet vil alle mapper som er større enn det angitte beløpet, bli utvidet. Enheten «MB» må følge etter tallet uten et blanktegn. Følgende eksempel skanner mappen «H:\User», utvider alle mapper som er større enn 10 MB, og lagrer resultatet i Excel-filen «C:\Results\Allusers.xlsx»:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <verdi>¶
Hvis dette alternativet brukes, vil Excel-eksporter bruke utvidbare/kollapsbare grupper som kan navigeres på lignende måte som katalogtreet.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <filnavn>¶
Med dette alternativet kan du eksportere innholdet i «Drive List» til en Excel-, tekst- eller CSV-fil. Filtypen avhenger av filtypen til det angitte filnavnet. Eksempel:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Hvis dette alternativet er angitt, vil filene bli inkludert i all eksport. Dette alternativet tilsvarer altså å aktivere alternativet «Verktøy > Alternativer > Eksporter > * > Eksporterte elementer > Mapper og enkeltfiler»
/EXPORTGROUPSEXPANDED¶
Hvis dette er angitt, vil eksporten av utvidelseslisten inneholde all informasjon om utvidelsene som finnes i gruppene.
/EXPORTPATHSLIST <filnavn>¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Eksporterer en enkel liste som inneholder alle søkeresultatene. Listen inneholder bare de fullstendige banene til søkeresultatene og ingen annen informasjon. Formater som støttes for målfilen, er .txt og .csv.
Dette eksemplet vil søke etter og opprette en liste over alle exe-filer på stasjon C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Den kan brukes til å importere resultater fra et tidligere søk tilbake til brukergrensesnittet, ved å bruke «File > List of paths > Import path list», eller parameteren /IMPORT.
Hvis alternativet «Verktøy > Alternativer > Eksporter > Inkluder duplikatgrupper» er aktivert, kan du også bruke denne funksjonen til å eksportere og importere resultatene av duplikatsøket, inkludert gruppestrukturen.
/EXPORTTITLE ¶
Kan brukes til å endre tittelen i en utskrevet rapport eller eksportert fil. Dette gir deg mulighet til å gi tilleggsinformasjon til brukeren når du bruker TreeSize i et automatisert miljø. Det er også mulig å bruke miljøvariabler. Eksempel:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <filnavn>¶
Med dette alternativet kan du lagre statistikken over filtyper/ filtyper for den skannede filsystemgrenen i en Excel-, HTML-, tekst- eller CSV-fil. Filtypen avhenger av filtypen til det angitte filnavnet. De eksporterte kolonnene vil være de som var aktivert i brukergrensesnittet på fanen «Utvidelser» da den sist ble brukt, eller på det tidspunktet da konfigurasjonsfilen som ble levert via /OPTIONS ble skrevet.
Følgende eksempel skanner stasjon C: og oppretter en Excel-fil med navnet «D:\TreeSize Reports\C_filetypes.xls» med statistikk over filtypene på denne stasjonen:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <filnavn>¶
Lagrer den lille grafen som vises nederst på siden «Utvidelser» til en bildefil (bitmap, GIF, PNG eller JPEG).
/EXTENSIONSPIECHART <filnavn>¶
Lagrer et kakediagram som viser fordelingen av «filtyper» til en bildefil (bitmap, GIF, PNG eller JPEG).
/FILTER <mønster1;mønster2>¶
Setter en filfilter som teller kun filer med bestemte utvidelser, f.eks. «.mp3» eller «.doc». Flere mønstre kan sendes, adskilt med semikolon (;). Følgende eksempel vil søke etter MP3- og AVI-filer i «Brukere»-katalogen på serveren:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Når du utfører et TreeSize-filsøk (/SEARCH), kan du også bruke kommandolinjebryteren /FILTER til å spesifisere mønstrene for det avanserte filsøket. Hvis du vil utføre et mer komplekst tilpasset filsøk, bør du lagre søkealternativene i en fil og sende den resulterende XML-filen til kommandolinjen etter /SEARCH.
/FOLLOWREPARSEPOINTS¶
Hvis denne parameteren legges til kommandolinjen, vil TreeSize følge monteringspunkter og eksterne symbolske lenker når den skanner et filsystemtre.
/GROUPSCANS¶
Hvis du bruker denne kommandolinjebryteren, grupperes alle skannede kataloger under en virtuell rotmappe. Bruk /GROUPSCANS FALSE hvis du vil sikre at ingen virtuell rotmappe brukes.
/HIDESMALLFOLDERS <verdi>¶
Gjør det mulig å skjule objekter som er mindre enn en minimumsstørrelse, noe som er nyttig for å få oversiktlig eksport. <verdi> kan være en størrelsesverdi med enhet, eller en ren byteverdi uten enhet. Kan ikke brukes i kombinasjon med /EXPAND. I dette eksemplet vil bare mapper med en minimumsstørrelse på 50 MB bli eksportert:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <filnavn>¶
Lagrer grafen på «Historikk»-fanen i den skannede katalogen til en bitmap, GIF, PNG eller JPEG-fil. Filtypen avhenger av utvidelsen til det spesifiserte filnavnet. Dette eksemplet lager et JPEG-bilde av historikkgrafen for stasjon C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <filnavn>¶
Lagrer de innsamlede dataene til en HTML-fil som kan vises med hvilken som helst HTML-nettleser. Du kan spesifisere hvilken informasjon fra skanningen som skal inkluderes i eksporten via «Hjem > Alternativer > Eksport > HTML > Diagrammer og lister som skal inkluderes». Du kan velge hvilke av de ekstra listene eller diagrammene som skal legges til eksporten. De vil automatisk bli innebygd i HTML-filen som genereres etter skanningen.
Følgende eksempel genererer en HTML-rapport for stasjonen C: og lagrer den i «D:\HTML»:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Hvis du vil at mer enn én skanning skal være en del av HTML-filen, bør du legge til kommandolinjebryteren /GROUPSCANS. Når du eksporterer til HTML uten et inkludert bilde, kan du alternativt bruke bryteren /APPENDTOFILES. Uten et av disse flaggene vil HTML-filen bli overskrevet.
/IMPORT <filnavn>¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Laster en liste over stier inn i brukergrensesnittet til TreeSize filsøket. Filen kan være i .txt eller .csv-format. Denne parameteren kan brukes til å importere resultater fra et tidligere søk. De importerte filene og mappene kan flyttes/kopieres/slettes/arkiveres, som ethvert «live» søkresultat, ved hjelp av dialogboksen for filoperasjoner.
Eksempel:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Du kan også kombinere denne parameteren med parameterne /RECYCLE, /DELETE eller /MOVE for automatisk å slette eller flytte filene som finnes i tekstfilen. Eksempel:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <filnavn>¶
Importerer en liste med mønstre fra en fil. Filen kan være en enkel tekstfil med en liste over filtermønstre, atskilt med semikolon, eller du kan bruke brukergrensesnittet til å opprette et mer komplekst sett med mønstre og bruke eksportfunksjonen til å generere mønsterfilen i XML-format. Formatene som støttes, er CSV, TXT og XML.
De importerte mønstrene brukes som filtre for skanningen, slik at spesifikke filer og mapper enten inkluderes eller ekskluderes.
Hvis denne parameteren brukes i kombinasjon med kommandolinjealternativet /SEARCH, opprettes det et nytt avansert søk som bruker mønstrene fra den importerte filen som kriterier for søket.
Dette eksemplet importerer filtermønstre som er definert under «C:\TreeSizeFiles\patterns.txt», starter en skanning etter stasjon C:\ og eksporterer resultatene til en HTML-fil:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <filnavn>¶
Lagrer skanneresultatene i en SQLite-fil som kan lastes inn for sammenligninger på et senere tidspunkt. Eksempel:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <skilletegn tegn>¶
Gjør det mulig å definere separatoren som brukes ved eksport av tekst- eller CSV-filer. Tekstfiler bruker tabulator som standard, CSV-filer listeseparatoren fra de regionale innstillingene i Windows-kontrollpanelet.
Angi et enkelt tegn eller strengen «TAB» for tabulator etter denne bryteren. Eksempler:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <sti>¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Den flytter resultatene av et TreeSize-filsøk til en annen plassering.
Følgende kommando søker på den lokale stasjonen C: ved hjelp av de nyeste søkealternativene og flytter søkeresultatene til mappen «C:\Temp\ObsoleteFiles»:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Se også: Flytt merkede filer
/NOGUI¶
Det vises ikke noe vindu, og programmet vises ikke i oppgavelinjen. Nyttig for å utføre skanninger eller søk i bakgrunnen, uten visuell tilbakemelding.
Warning
Bruk denne bryteren bare hvis du har testet resten av kommandolinjealternativene, fordi feilmeldinger ikke kan vises i denne modusen.
Feil vil imidlertid bli loggført i hendelsesloggen i Windows.
/NOHEADERS¶
Utelater overskriftslinjene som vanligvis skrives på toppen av skanne- eller søkeeksportfiler. Dette gjør det enklere å motta rene data for etterbehandling.
/NOUNITS¶
Utelater enhetene som vanligvis skrives etter størrelsesverdier. Dette alternativet i kombinasjon med /SIZEUNIT 0 vil eksportere rene byteverdier. Dette gjør det enklere å motta rene data for etterbehandling.
Note
Denne kommandolinjen vil bare påvirke eksport av katalogtreet som er generert ved hjelp av alternativene /TEXT, /EXCEL, /HTML, /EMAIL eller /PRINT. /EXTENSIONSLIST, /USERSLIST, /EXPORTDRIVESLIST, eller /TOPFILESLIST vil ikke bli påvirket.
/OPEN <filnavn>¶
Åpner en lagret XML-rapport ved oppstart av applikasjonen. Eksempel:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <filnavn>¶
Bruk dette parameteret for å anvende eksporterte brukerinnstillinger til TreeSize. Brukerinnstillinger kan eksporteres under «Fil > Alternativer > Eksporter». Eksempel:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Note
Endre så mange innstillinger som mulig i brukergrensesnittet før du lagrer alternativene for å redusere antall kommandolinjeparametere du trenger.
/PDF¶
Lagrer resultatene til en PDF-fil etter at skanningen eller søket er fullført. Applikasjonen vil avslutte seg selv etter lagring. Følgende eksempel vil utføre en skanning av din lokale stasjon C: og lagre resultatene til en PDF-fil:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <filnavn>¶
Lagrer sektordiagrammet av den skannede katalogen til en bitmap-, GIF-, PNG- eller JPEG-fil. Filtypen avhenger av filnavnets utvidelse. Følgende eksempel vil skanne stasjon C: og eksportere et sektordiagram i PNG-format:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Skriver ut en rapport for det skannede katalogtreet ved hjelp av standard skriver konfigurert i systeminnstillingene dine. Applikasjonen vil bli avsluttet etter utskrift. Eksempel:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <verdi>¶
Hvis verdien er satt til true, aktiverer dette alternativet en skrivebeskyttet modus der filoperasjoner (f.eks. flytt eller slett) er deaktivert, slik at den kun kan brukes som rapporteringsverktøy.
Start med en verdi av false for å deaktivere skrivebeskyttet modus igjen.
/RECYCLE¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Flytter alle filer til papirkurven som har blitt funnet som resultat av et TreeSize fil-søk. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Se også: Flytt merkede filer
/RESTRICTEDMODE <verdi>¶
Hvis verdien er satt til true, aktiverer dette alternativet en begrenset modus der mange funksjoner er deaktivert som ikke er av interesse for «vanlige» (ikke-admin) brukere. Blant de deaktiverte funksjonene er: Sjekk for oppdatering, Åpne programmet for programvare i Windows Kontrollpanel, Planlegg TreeSize-skanninger, koble til nettverksstasjon, konfigurere Windows Systemgjenoppretting, Kjør som administrator, eksportere og anvende NTFS-komprimering. Du kan oppgi en sti som skal skannes, f.eks. brukerens hjemmekatalog, ved kommandolinjen eller ved å bruke oppstartsstier i en lagret konfigurasjonsfil.
Start med en verdi av false for å deaktivere den begrensede modusen igjen.
Hvis du i tillegg aktiverer alternativet /READONLYMODE, vil brukeren ikke kunne slette eller flytte filer i TreeSize, slik at det kun kan brukes som rapporteringsverktøy.
/SCAN <sti|filnavn>¶
Definerer hvilken stasjon eller sti som skal skannes. Skanningsstien skal brukes som verdi for dette parameteret.
Hvis for eksempel stasjonen D:\ skal skannes, kan du bruke
Treesize /SCAN "D:\"
Hvis du ikke ønsker å skanne hele stasjonen, kan du også spesifisere en sti, som brukes som startpunkt for skanningen. For eksempel:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Flere skanningsstier er også mulig, de er adskilt med et mellomrom. Stier som inneholder et mellomrom må settes i anførselstegn («). Eksempel:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Jokertegnene «*» og «?» er tillatt. Eksempel:
Treesize /SCAN "H:\users\A*"
Du kan også angi en tekstfil som inneholder en liste over stier som skal skannes. TreeSize vil skanne alle stier som finnes i tekstfilen, som er spesifisert etter denne bryteren. Tekstfilen må inneholde én bane per linje. Følgende eksempel skanner alle baner som finnes i filen «D:\PathsToScan.txt», og skriver hvert skanneresultat til et eget ark i en Excel-fil med dagens dato:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Du kan også kalle TreeSize i en «for»-løkke med kun en av stiene, vennligst se et eksempel nedenfor.
/SEARCH¶
Åpner File Search-vinduet i TreeSize. Hvis «:Start» legges til i dette kommandolinjealternativet, startes søket automatisk. En tidligere lagret XML-fil med søkeinnstillinger kan sendes inn, og disse innstillingene vil da bli brukt til å utføre søket.
Note
Filer som finnes i dette søket blir automatisk sjekket.
Følgende eksempel utfører søket med innstillinger som tidligere har blitt lagret til filen «SearchSettings.xml» og lagrer resultatene til en tekstfil:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Note
Vanligvis vil de siste søkeinnstillingene eller et tidligere lagret sett med søkeinnstillinger bli brukt. Du kan imidlertid også spesifisere søkemønstrene for det avanserte søket ved hjelp av kommandolinjealternativet /FILTER.
/SHEETNAME ¶
Gjør det mulig å angi navnet på arket som skal legges til i en Excel-fil når du bruker kommandolinjebryteren /EXCEL.
Note
Et Excel-arknavn må være unikt i en Excel-fil, og visse spesialtegn som skråstreker, bakoverstreker og kolon er forbudt. TreeSize vil alltid opprette et unikt arknavn ved å erstatte ugyldige tegn med understreker og ved å legge til dato og tid om nødvendig. Hvis et ark med det spesifiserte navnet allerede finnes i målfilen, opprettes et nytt ark med et unikt navn. Bruk kommandolinjealternativet /APPENDTOFILES for å legge til dataene til det eksisterende arket.
/SHORTDATEFORMAT <format>¶
Endrer formatet for kort dato for denne prosessen, som kan konfigureres i de regionale alternativene i Windows Kontrollpanel. Eksporter fra TreeSize vil bruke dette formatet for datoverdier. Eksempel:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Dette alternativet kan brukes til å spesifisere enheten som skal brukes for å vise størrelsesverdier: N kan ha verdiene 0 til 5 som betyr: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Automatiske enheter. Uten dette alternativet vil den sist brukte konfigurasjonen i TreeSize bli brukt.
/SORTBY <Kolonnenavn>¶
Gjør det mulig å angi hvilken verdi den genererte eksporten skal sorteres etter. Mulige verdier er kolonnenavn som «Size» eller «Name». Den sist brukte sorteringstypen i TreeSize-brukergrensesnittet vil bli brukt som standard. Eksempel:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <filnavn>¶
Lagrer skanneresultatene i en SQLite-fil som kan lastes inn for sammenligninger på et senere tidspunkt. Eksempel:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <subject>¶
Dette alternativet lar deg tilpasse emnet som skal brukes for e-poster som sendes på slutten av skanningen. Eksempel:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <filnavn>¶
Lagrer resultatene til en tekst- eller CSV-fil etter at skanningen eller søket er fullført. Applikasjonen vil avslutte seg selv etter lagring. Følgende eksempel vil utføre en skanning av din lokale stasjon C: og lagre resultatene til en tekstfil:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
Tekstformatet bruker et tabellformat som er rettet mot menneskelige lesere. Hvis filnavnet refererer til en CSV-fil, brukes CSV-formatet automatisk i stedet. Hvis du ønsker å bruke CSV-formatet eksplisitt, anbefaler vi at du bruker parameteren /CSV.
/TITLE <tittel>¶
Kan brukes til å erstatte rotstien til en skanning med en tilpasset tekst. Dette gjør det mulig å gi mer meningsfulle navn for UNC-stier for eksempel, og dermed øke lesbarheten av en rapport. Den valgte tittelen vil bli brukt som tittelen på rapporten når en fil eksporteres. Eksempel:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
I konteksten av et TreeSize fil-søk kan dette parameteret brukes til å navngi et avansert søk. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <filnavn>¶
Dette alternativet gjør det mulig å lagre innholdet i listen over toppfiler til en Excel-, HTML-, tekst- eller CSV-fil. Filtypen avhenger av filnavnets utvidelse. Eksempel:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <filnavn>¶
Lagrer treemap-diagrammet av den skannede katalogtreet som bitmap, GIF, PNG eller JPEG-fil. Filtypen avhenger av filnavnets utvidelse. Eksempel:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Angir nivået på brukergrensesnittet. Mulige verdier er Simple, Normal, eller Expert. Eksempel:
Treesize /UILevel "Simple"
/USERSLIST <filnavn>¶
Dette alternativet gjør det mulig å lagre statistikken som viser resultatene gruppert etter brukernavn til en Excel-, HTML-, tekst- eller CSV-fil. Filtypen avhenger av filnavnets utvidelse. De eksporterte kolonnene vil være de som var aktivert i brukergrensesnittet på fanen «Brukere» da det sist ble brukt, eller på tidspunktet da konfigurasjonsfilen som ble levert via /OPTIONS ble skrevet.
Følgende eksempel skanner stasjon C: og oppretter en Excel-fil i «C:\Temp» med statistikk over brukerne på denne stasjonen:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <brukernavn>¶
Angir brukernavnet som skal brukes til å autentisere for skanningene. Bruk /PASSWORD for å angi et passord for dette brukernavnet. Det anbefales at du i stedet bruker Microsoft-verktøyet RUNAS.
/USERFILTER <brukernavn>¶
Med dette alternativet vil kun filer eid av en bestemt bruker bli tatt med i skanningen. Oppgi navnet på denne brukeren etter denne bryteren.
Note
Du kan ikke bruke flere brukernavn her, men jokertegnene «*» og «?» støttes.
Eksempel:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <filnavn>¶
Lagrer det lille diagrammet som vises nederst på «Brukere»-siden til en bildefil (bitmap, GIF, PNG eller JPEG).
/USERSPIECHART <filnavn>¶
Lagrer et sektordiagram som viser «brukerstatistikk» fra den nåværende skanningen til en bildefil (bitmap, GIF, PNG eller JPEG).
/VIEWTYPE n¶
Definerer hvilke verdier «Prosent av forelder», «Vekst»-kolonnene og «Alder på filer»-diagrammet er basert på. Mulige verdier er:
2: Størrelse 3: Tildelt plass (Størrelse på disk) 7: Antall filer
/XML <filnavn>¶
Lagrer skanneresultatene til en XML-fil som kan lastes inn for sammenligninger på et senere tidspunkt. Eksempel:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Dette alternativet kan kombineres med bryteren /EXPAND for å begrense antallet kataloger som eksporteres.
Note
Når du laster inn en begrenset XML-eksport til TreeSize, kan du ikke navigere gjennom hele katalogtreet, men kun de eksporterte katalogene.
/ZIP <filnavn>¶
Dette alternativet kan bare brukes i kombinasjon med kommandolinjealternativet /SEARCH.
Alle filer som er funnet som resultat av et TreeSize-fil søk vil bli flyttet til et zip-arkiv. Eksempel:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Se også: Flytt merkede filer
<SCANPATH>¶
I tillegg til parameteren /SCAN kan du også sende en eller flere stier på slutten av kommandolinjen. Dette anbefales imidlertid ikke lenger for å unngå feil når kommandolinjen analyseres.
Dette eksemplet skanner «Program Files» og «Windows»-mappen, og oppretter en tekstrapport under «C:\Reports\ScanResults.txt»:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
Hvis det oppstår en feil, vil den bli returnert som Windows-feilkode i prosessens exitkode. Miljøvariabler (f.eks. %APPDATA%) kan brukes i filnavn for eksport samt i de skannede stiene.
Skanning av flere kataloger¶
Hvis du trenger å skanne flere kataloger, kan det være en god idé å slå sammen flere kall i en Batch-fil, 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 jobbene starter sekvensielt. Å ikke starte jobbene parallelt er vanligvis bedre fordi en enkelt jobb drar mer nytte av hurtigbuffer og systemressurser. Det er også mulig å lagre delene som skal skannes i en tekstfil og bruke Windows «for»-kommandoen slik:
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"
Note
De doble prosenttegnene er nødvendige i batch-filer, på kommandolinjen brukes kun ett prosenttegn.
Planlagt start¶
Du kan bruke Windows Planlagte oppgaver for å kjøre TreeSize med bestemte kommandolinjealternativer daglig, ukentlig eller månedlig på et bestemt tidspunkt. Dialogboksen for Planlegging av skanninger vil hjelpe deg med å sette opp en planlagt oppgave.
Du kan også bruke kommandoen SCHTASKS for å utføre planlagte skanninger. Hvis du for eksempel ønsker å skanne stasjonene C: og E: neste natt kl. 03:00 og lagre resultatene i en Excel-fil, kan du bruke 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å hjelp om SCHTASKS-kommandoen på Microsofts sider eller ved å skrive:
SCHTAKS /Create /?
Note
Feilmeldinger som oppstår under planlagte skanninger, listes i systemets Windows hendelseslogg.
PowerShell¶
Windows PowerShell kan være nyttig i kombinasjon med TreeSize. Dette eksemplet viser hvordan du søker på et par eksterne datamaskiner som er forespurt ved hjelp av en LDAP-spørring 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 av utdata¶
Hvis ingen annen eksportmål er angitt, vil TreeSize skrive en kort eksport av skanningen til standardutgangen, og feil som oppstod under skanningen til standardfeilen.
Du kan omdirigere disse utdataene på kommandolinjen (cmd.exe) ved å bruke pipe-symbolet, f.eks.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
For å omdirigere utdataene ved hjelp av PowerShell, vennligst bruk Start-Process-kommandoen i stedet, 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 tenkt å bruke Windows Scripting Host (WSH), vil kommandoen for å starte TreeSize se slik ut:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Avslutningskoder¶
Hvis operasjonen ble fullført med suksess, er avslutningskoden 0. Hvis det oppstod en feil, vil TreeSize returnere en Windows-feilkode som avslutningskode hvis tilgjengelig, eller 1 for å indikere en generell feil.
I alle tilfeller vil Windows-hendelsesloggen inneholde ytterligere informasjon i «Applikasjon»-loggen, Hendelseskilde «TreeSize».