Opzioni della riga di comando¶
L’edizione Professional di TreeSize accetta opzioni da riga di comando che consentono di eseguire scansioni programmate o di avere i risultati di una scansione sul monitor la mattina successiva.
La finestra di dialogo per Pianificazione delle scansioni ti aiuterà a compilare una riga di comando con le opzioni sottostanti.
Nota
Queste opzioni sono disponibili solo nell”Edizione Professionale di TreeSize.
Tutte le opzioni¶
Treesize.exe [/OPTION] SCANPATH
/? o /HELP¶
Mostra questa pagina di aiuto.
/AGEOFFILES¶
Salva il grafico nella scheda «Età dei file» della directory scansionata in un file bitmap, GIF, PNG, JPEG, Testo o CSV. Il tipo di file dipende dall’estensione del nome del file specificato. Il seguente esempio crea un file immagine JPEG del grafico «Età dei file» per il tuo disco locale C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <valore>¶
Con questa opzione è possibile selezionare se TreeSize deve aggiungere o meno il suo output ai file esistenti quando si effettua un’Esportazione, ad esempio quando si utilizza /TEXT. Selezionare «True» per aggiungere e «False», se si desidera sovrascrivere i file esistenti.
Nota
Questo parametro non funziona con le immagini esportate, i file XML e PDF. Questi file verranno sempre sovrascritti. È possibile utilizzare l’interruttore /DATE per garantire che tutti i rapporti generati abbiano un nome di file unico.
Quando si esporta in un file Excel tramite /EXCEL, questo parametro può essere utilizzato insieme a /SHEETNAME per aggiungere i dati al foglio specificato. Esempio:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Questa opzione includerà solo i file per i quali il bit di archivio è impostato nelle scansioni. Questa opzione può essere molto utile se desideri calcolare la dimensione di un backup. In questo caso, puoi creare un collegamento sul desktop o nel menu di avvio che avvierà automaticamente il calcolo della dimensione del tuo backup. Esempio:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Se specificato, tutti i file esportati verranno allegati all’email. Se non specificato, i file con un percorso esplicitamente fornito non vengono allegati. Questo è utile nel caso in cui i tuoi file XML o Excel stiano diventando piuttosto grandi e riempiano il tuo account email.
Questo esempio esporterà in un file Excel ma non lo allegherà all’email:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Questi esempi allegheranno il file Excel all’email:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <nome del file>¶
Salva il grafico a barre della directory scansionata in un file bitmap, GIF, PNG o JPEG. Il tipo di file dipende dall’estensione del nome del file specificato. Questo esempio crea un file immagine PNG del grafico a barre per il tuo disco locale C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <nome file|percorso>¶
Confronta il percorso scansionato con un file indice salvato. Il seguente esempio scansiona il disco C: e confronta il risultato con un rapporto XML salvato per questo disco:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
Invece di un file indice, puoi utilizzare anche un percorso con questo parametro della riga di comando. Il percorso fornito verrà confrontato con il risultato della scansione attuale. Il seguente esempio scansiona il disco C:\ utilizzando inoltre il percorso D:\Backup_di_C per eseguire un confronto tra i due:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
In alternativa, è possibile confrontare due file di indice già esistenti, ad esempio «c1.xml.zip» e «c2.xml.zip», utilizzando questo comando:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
Il comando /OPEN prepara il confronto dei due file espandendo il primo file («c1.xml.zip») in un file di scansione. Il secondo file («c2.xml.zip») verrà confrontato con questo file di scansione espanso, proprio come accadrebbe se «c2.xml.zip» fosse confrontato con una scansione «reale».
/COPY <percorso>¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Copia i risultati di una ricerca di file di TreeSize nella posizione di destinazione.
Il seguente comando cercherà sul tuo disco locale C: utilizzando le ultime opzioni di ricerca e copierà i risultati della ricerca nella cartella «C:\temp\ObsoleteFiles»:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Vedi anche: Sposta file selezionati
/CREATEDPASTDAYSONLY <n>¶
Questa opzione includerà solo i file nelle scansioni, che sono stati creati durante il numero di giorni inserito nell’argomento. Nell’esempio seguente, questa opzione includerà solo i file creati negli ultimi otto giorni nella scansione:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <drive>¶
Crea un’istantanea per i dischi forniti dopo questo parametro della riga di comando. Esempio:
Treesize /CREATESNAPSHOT "C:\" "D:\"
La creazione di istantanee potrebbe richiedere privilegi amministrativi.
/CSV <nome del file>¶
Salva i risultati in un file CSV dopo che la scansione o la ricerca è terminata. L’applicazione si chiuderà dopo il salvataggio. Questo esempio salverà i risultati di una ricerca di file sul tuo disco locale C: con le ultime configurazioni di ricerca in un file CSV:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Questo interruttore aggiungerà la data e l’ora correnti a tutti i nomi dei file di esportazione nella riga di comando. Questo è utile se si desidera eseguire scansioni regolarmente, ad esempio ogni notte o ogni fine settimana. Il seguente esempio eseguirà la scansione del percorso di rete «\Host\Share» e salverà il risultato in un file come «C:\Scans\nome_2013-08-14_17-18-24.xls»:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Sostituirà i file duplicati trovati dalla ricerca di file duplicati di TreeSize con collegamenti fisici NTFS:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Elimina permanentemente tutti i file che sono stati trovati come risultato di una ricerca di file di TreeSize. Esempio:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Vedi anche: Sposta file selezionati
/EMAIL <destinatario>¶
Invia i dati raccolti all’indirizzo e-mail indicato. Questo parametro può essere usato una sola volta sulla riga di comando e verrà inviata una sola e-mail con tutti i risultati. I destinatari multipli possono essere separati da punti e virgola (;) o da virgole. Per inviare le e-mail tramite la riga di comando, è necessario specificare impostazioni SMTP valide nella pagina corrispondente della finestra di dialogo delle opzioni di TreeSize. Esempio:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Se non sono stati specificati altri parametri, l’e-mail sarà inviata nel formato impostato nelle opzioni (HTML o testo normale). Se si desidera definire il formato indipendentemente dalle opzioni correnti, è possibile utilizzare i parametri /TEXT o /HTML subito dopo la definizione degli indirizzi dei destinatari. Esempio:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Combinando i parametri è possibile anche aggiungere allegati all’e-mail. L’esempio seguente aggiunge un rapporto Excel della scansione come allegato all’e-mail:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Questa opzione può essere usata solo in combinazione con le opzioni della riga di comando /SEARCH e /EMAIL. Se questo parametro è specificato, TreeSize invierà un’e-mail con i risultati di ricerca correnti solo se durante la ricerca è stato trovato almeno un file o una cartella, da uno qualsiasi dei tipi di ricerca specificati.
/EMPTYRECYCLEBIN¶
Se si utilizza questa opzione, TreeSize svuoterà il cestino prima di eseguire la scansione corrente. Esempio:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Questo parametro consente di passare i file trovati dalla ricerca dei file di TreeSize a un’altra applicazione o script. Un possibile obiettivo di questo parametro può essere un file batch o uno script powershell. L’esempio seguente cerca l’unità C:\ con le impostazioni di ricerca più recenti e chiama lo script «Archive.bat» per ogni file trovato. Il file verrà passato allo script come parametro della riga di comando:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Vedi anche: Sposta file selezionati
/EXCEL <percorso del file>¶
Esporta i dati raccolti in formato Microsoft Excel e li salva nel percorso del file inserito. Se viene specificato solo un nome di file, la directory di installazione corrente viene utilizzata per salvare l’Esportazione. I formati supportati sono il formato convenzionale .XLS (Excel 97-2003) e il formato .XLSX (introdotto con Excel 2007). Il formato utilizzato dipende dall’estensione del nome del file specificato. L’applicazione si chiude da sola dopo il salvataggio. Esempio:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Se il nome del file esiste già, il file viene aperto e viene aggiunto un nuovo foglio di lavoro.
Nota
Nel sito TreeSize File Search (/SEARCH) i risultati di ogni tipo di ricerca sono raccolti in un foglio di lavoro specifico. Se il file nel percorso indicato esiste già, questi fogli verranno sovrascritti. Per evitare ciò, è necessario utilizzare l’opzione della riga di comando /APPENDTOFILES.
/EXCLUDE <pattern1;pattern2>¶
Questa opzione consente di specificare i modelli di file e cartelle da escludere da una scansione. Più modelli di esclusione possono essere separati da un punto e virgola (;). Se uno o più modelli contengono spazi, la stringa completa del modello deve essere inserita tra virgolette («). L’esempio seguente ignora i file e le cartelle che terminano con «.tmp» o il cui nome esatto è «system»:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <livello|dimensione>¶
Questa opzione consente di specificare quanti livelli dell’albero delle directory verranno espansi dopo la scansione. Se non si specifica un numero dopo questa opzione, verranno espanse tutte le cartelle. Invece di un livello di directory, è possibile indicare una quantità in Mega Byte (MB). In questo caso, tutte le cartelle più grandi della quantità indicata verranno espanse. L’unità «MB» deve seguire il numero senza uno spazio vuoto. L’esempio seguente analizza la cartella «H:\User», espande tutte le cartelle più grandi di 10 MB e salva il risultato nel file Excel «C:\ResultsAllusers.xlsx»:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <valore>¶
Se si utilizza questa opzione, le esportazioni di Excel utilizzeranno gruppi espandibili/collegabili che possono essere navigati in modo simile all’albero delle directory.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <nome del file>¶
Questa opzione consente di esportare il contenuto dell“«Elenco unità» in un file Excel, di testo o CSV. Il tipo di file dipende dall’estensione del nome del file specificato. Esempio:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Se specificato, i file saranno inclusi in tutte le esportazioni. Questa opzione è quindi equivalente all’attivazione dell’opzione «Strumenti > Opzioni > Esportazione > * > Elementi esportati > Cartelle e singoli file»
/EXPORTGROUPSEXPANDED¶
Se specificato, l’Esportazione dell’elenco delle estensioni conterrà tutte le informazioni sulle estensioni contenute nei gruppi.
/EXPORTPATHSLIST <nome del file>¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Esporta un semplice elenco contenente tutti i risultati di ricerca. L’elenco conterrà solo i percorsi completi dei risultati di ricerca e nessun’altra informazione. I formati supportati per il file di destinazione sono .txt e .csv.
Questo esempio cercherà e creerà un elenco di tutti i file exe presenti sull’unità C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Può essere utilizzato per importare i risultati di una ricerca precedente nell’interfaccia utente, utilizzando «File > Elenco dei percorsi > Importa elenco dei percorsi» o il parametro /IMPORT.
Se l’opzione «Strumenti > Opzioni > Esporta > Includi gruppi di duplicati» è attivata, è possibile utilizzare questa funzione anche per esportare e importare i risultati della ricerca di duplicati, compresa la struttura dei gruppi.
/EXPORTTITLE ¶
Può essere utilizzato per modificare il titolo di un rapporto stampato o di un file esportato. Ciò consente di fornire informazioni aggiuntive all’utente quando si utilizza TreeSize in un ambiente automatizzato. È consentito l’uso anche di variabili d’ambiente. Esempio:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <nome del file>¶
Questa opzione consente di salvare le statistiche sulle estensioni dei file/tipi di file del ramo del sistema file scansionato in un file Excel, HTML, Testo o CSV. Il tipo di file dipende dall’estensione del nome del file specificato. Le colonne esportate saranno quelle che erano abilitate nell’interfaccia utente nella scheda «Estensioni» al momento dell’ultimo utilizzo, oppure al momento della scrittura del file di configurazione fornito tramite /OPZIONI.
L’esempio seguente scansiona l’unità C: e crea un file Excel chiamato «D:\TreeSize Reports\C_filetypes.xls» con le statistiche dei tipi di file presenti su questa unità:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <nome del file>¶
Salva il piccolo grafico visualizzato in fondo alla pagina «Estensioni» in un file immagine (bitmap, GIF, PNG o JPEG).
/EXTENSIONSPIECHART <nome del file>¶
Salva un diagramma a piattelli che mostra la distribuzione delle «estensioni di file» di un file immagine (bitmap, GIF, PNG o JPEG).
/FILTER <pattern1;pattern2>¶
Imposta un filtro che conta solo i file con determinate estensioni, ad esempio «.mp3» o «.doc». È possibile passare più modelli, separati da un punto e virgola (;). L’esempio seguente cerca i file MP3 e AVI nella directory «Utenti» del server:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Quando si esegue una ricerca di file TreeSize (/SEARCH), si può anche usare l’opzione della riga di comando /FILTER per specificare i modelli della ricerca avanzata dei file. Per eseguire una ricerca personalizzata più complessa, è necessario salvare le opzioni di ricerca in un file e passare il file XML risultante alla riga di comando dopo /SEARCH.
/FOLLOWREPARSEPOINTS¶
Se si aggiunge questo interruttore alla riga di comando, TreeSize seguirà i punti di montaggio e i collegamenti simbolici esterni durante la scansione della struttura del sistema file.
/GROUPSCANS¶
Utilizzando questa opzione della riga di comando, tutte le directory scansionate verranno raggruppate sotto una cartella radice virtuale. Utilizzate /GROUPSCANS FALSE se volete assicurarvi che non venga utilizzata alcuna cartella radice virtuale.
/HIDESMALLFOLDERS <valore>¶
Permette di nascondere gli oggetti più piccoli di una dimensione minima, utile per ottenere Esportazioni chiare. <valore> può essere un valore di dimensione con unità o un semplice valore di byte senza unità. Non può essere usato in combinazione con /EXPAND. In questo esempio verranno esportate solo le cartelle con una dimensione minima di 50 MB:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <nome del file>¶
Salva il grafico nella scheda «Storico» della directory scansionata in un file bitmap, GIF, PNG o JPEG. Il tipo di file dipende dall’estensione del nome del file specificato. Questo esempio crea un’immagine JPEG del grafico storico dell’unità C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <nome del file>¶
Salva i dati raccolti in un file HTML che può essere visualizzato con qualsiasi browser HTML. È possibile specificare quali informazioni della scansione saranno incluse nell’esportazione tramite «Base> Opzioni > Esportazione > HTML > Grafici ed elenchi da includere». È possibile selezionare quali elenchi o grafici aggiuntivi devono essere aggiunti all’esportazione. Questi saranno automaticamente incorporati nel file HTML generato dopo la scansione.
L’esempio seguente genera un rapporto HTML per l’unità C: e lo salva in «D:\HTML»:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Se si desidera che più di una scansione faccia parte del file HTML, è necessario aggiungere l’opzione della riga di comando /GROUPSCANS. Quando si esporta in HTML senza un’immagine inclusa, si può usare in alternativa l’interruttore /APPENDTOFILES. Senza uno di questi flag, il file HTML verrà sovrascritto.
/IMPORT <nome del file>¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Carica un elenco di percorsi nell’interfaccia utente della ricerca di file di TreeSize. Il file può essere in formato .txt o .csv. Questo parametro può essere usato per importare i risultati di una ricerca precedente. I file e le cartelle importati possono essere spostati/copiati/cancellati/archiviati, come qualsiasi risultato di ricerca «vivo», utilizzando la finestra di dialogo delle operazioni sui file.
Esempio:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
È anche possibile combinare questo parametro con i parametri /RECYCLE, /DELETE, o /MOVE per eliminare o spostare automaticamente i file contenuti nel file di testo. Esempio:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <nome del file>¶
Importa un elenco di modelli da un file. Il file può essere un semplice file di testo con una serie di modelli di filtro, separati da punto e virgola, oppure si può usare l’interfaccia utente per creare una serie più complessa di modelli e usare la funzione di esportazione per generare il file dei modelli nel formato XML. I formati supportati sono CSV, TXT e XML.
I modelli importati verranno utilizzati come filtri per la scansione per includere o escludere file e cartelle specifici.
Se usato in combinazione con l’opzione della riga di comando /SEARCH, questo parametro crea una nuova ricerca avanzata che utilizza i modelli del file importato come criteri di ricerca.
Questo esempio importerà i modelli di filtro definiti in «C:\TreeSizeFiles\patterns.txt», avvierà una scansione dell’unità C:\ ed esporterà i risultati in un file HTML:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <nome del file>¶
Salva i risultati della scansione in un file SQLite che può essere caricato per i confronti in un secondo momento. Esempio:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <carattere separatore>¶
Consente di definire il separatore utilizzato durante l’esportazione di file di testo o CSV. I file di testo utilizzano il tabulatore per impostazione predefinita, i file CSV il separatore di elenchi delle impostazioni regionali del pannello di controllo di Windows.
Specificare un singolo carattere o la stringa «TAB» per il tabulatore dopo questo interruttore. Esempi:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <percorso>¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Sposta i risultati di una ricerca di file TreeSize in un’altra posizione.
Il comando seguente esegue una ricerca nell’unità locale C: utilizzando le opzioni di ricerca più recenti e sposta i risultati della ricerca nella cartella «C:\Temp\ObsoleteFiles»:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Vedi anche: Sposta file selezionati
/NOGUI¶
Non viene visualizzata alcuna finestra e l’applicazione non appare nella barra delle applicazioni. Utile per eseguire scansioni o ricerche in background, senza alcun feedback visivo.
Avvertimento
Utilizzare questo interruttore solo se si sono testate le altre opzioni della riga di comando, perché in questa modalità non è possibile visualizzare i messaggi di errore.
Tuttavia, gli errori saranno registrati nel registro eventi di Windows.
/NOHEADERS¶
Omette le righe di intestazione solitamente scritte in cima ai file di esportazione di scansione o ricerca. In questo modo è più facile ricevere i dati semplici per la post-elaborazione.
/NOUNITS¶
Omette le unità solitamente scritte dopo i valori di dimensione. Questa opzione, in combinazione con /SIZEUNIT 0, consente di Esportare valori semplici di byte. In questo modo è più facile ricevere dati semplici per la postelaborazione.
Nota
Questa riga di comando ha effetto solo sulle Esportazioni dell’albero delle directory, generate utilizzando le opzioni /TEXT, /EXCEL, /HTML, /EMAIL, o /PRINT. /EXTENSIONSLIST Le opzioni /USERSLIST, /EXPORTDRIVESLIST o /TOPFILESLIST non hanno alcun effetto.
/OPEN <nome del file>¶
Apre un rapporto XML salvato all’avvio dell’applicazione. Esempio:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <nome del file>¶
Utilizza questo parametro per applicare le impostazioni utente esportate a TreeSize. Le impostazioni utente possono essere esportate in «File > Opzioni > Esporta». Esempio:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Nota
Modifica quante più impostazioni possibile nell’interfaccia utente prima di salvare le opzioni per ridurre il numero di parametri della riga di comando necessari.
/PDF¶
Salva i risultati in un file PDF dopo che la scansione o la ricerca è terminata. L’applicazione si chiuderà automaticamente dopo il salvataggio. Il seguente esempio eseguirà una scansione del tuo disco locale C: e salverà i risultati in un file PDF:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <nome del file>¶
Salva il grafico a torta della directory scansionata in un file bitmap, GIF, PNG o JPEG. Il tipo di file dipende dall’estensione del nome file specificato. Il seguente esempio scansionerà il disco C: ed esporterà un grafico a torta in formato PNG:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Stampa un rapporto per l’albero delle directory scansionato utilizzando la stampante predefinita configurata nelle impostazioni di sistema. L’applicazione verrà terminata dopo la stampa. Esempio:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <valore>¶
Se il valore è impostato su true, questa opzione attiva una modalità di sola lettura in cui le operazioni sui file (ad es. spostare o eliminare) sono disabilitate, quindi sarà utilizzabile solo come strumento di reporting.
Inizia con un valore di false per disattivare nuovamente la modalità di sola lettura.
/RECYCLE¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Sposta tutti i file nel cestino che sono stati trovati come risultato di una ricerca file di TreeSize. Esempio:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Vedi anche: Sposta file selezionati
/RESTRICTEDMODE <valore>¶
Se il valore è impostato su true, questa opzione attiva una modalità ristretta in cui molte funzionalità sono disabilitate e non sono di interesse per gli utenti «normali» (non amministratori). Tra le funzionalità disabilitate ci sono: Controlla aggiornamenti, Apri applet software del Pannello di controllo di Windows, Pianifica scansioni di TreeSize, collega unità di rete, configura Ripristino di sistema di Windows, Esegui come amministratore, esportazioni e applica compressione NTFS. Puoi fornire un percorso che dovrebbe essere scansionato, ad esempio la directory home dell’utente, nella riga di comando o utilizzando i Percorsi di avvio in un file di configurazione salvato.
Inizia con un valore di false per disattivare nuovamente la modalità ristretta.
Se si attiva anche l’opzione /READONLYMODE, l’utente non sarà in grado di eliminare o spostare i file in TreeSize, che sarà quindi utilizzabile solo come strumento di rapporto.
/SCAN <percorso|nome file>¶
Definisce quale unità o percorso deve essere scansionato. Il percorso di scansione deve essere utilizzato come valore per questo parametro.
Se, ad esempio, dev’essere scansionata l’unità D:\, puoi usare:
Treesize /SCAN "D:\"
Se non desideri scansionare l’intera unità, puoi anche specificare un percorso, che viene utilizzato come punto di partenza per la scansione. Ad esempio:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Sono possibili più percorsi di scansione, separati da uno spazio. I percorsi contenenti uno spazio devono essere racchiusi tra virgolette («). Esempio:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
I caratteri jolly «*» e «?» sono consentiti. Esempio:
Treesize /SCAN "H:\users\A*"
Puoi specificare anche un file di testo, che contiene un’elenco di percorsi che devono essere scansionati. TreeSize scansionerà tutti i percorsi trovati nel file di testo, che è specificato dopo questo interruttore. Il file di testo deve contenere un percorso per riga. Il seguente esempio scansiona tutti i percorsi trovati nel file «D:\PathsToScan.txt» e scrive ciascun risultato della scansione in un foglio separato in un file Excel con la data odierna:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Puoi anche chiamare TreeSize in un ciclo «for» con uno solo dei percorsi, trova un esempio qui sotto.
/SEARCH¶
Apre la finestra di ricerca dei file di TreeSize. Se a questa opzione della riga di comando viene aggiunto «:Start», la ricerca viene avviata automaticamente. È possibile passare un file XML precedentemente salvato contenente le impostazioni di ricerca, che verranno utilizzate per eseguire la ricerca.
Nota
I file trovati in questa ricerca vengono automaticamente selezionati.
Il seguente esempio esegue la ricerca con impostazioni che sono state precedentemente salvate nel file «SearchSettings.xml» e salva i risultati in un file di testo:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Nota
In generale, verranno utilizzate le ultime impostazioni di ricerca o un precedente set di impostazioni di ricerca salvato. Tuttavia, è possibile specificare i modelli di ricerca per la ricerca avanzata usando l’opzione della riga di comando /FILTER.
/SHEETNAME ¶
Consente di specificare il nome del foglio che verrà aggiunto a un file di Excel quando si utilizza l’opzione della riga di comando /EXCEL.
Nota
Un nome di foglio Excel deve essere unico in un file Excel e alcuni caratteri speciali come barre, barre rovesciate e due punti sono vietati. TreeSize creerà sempre un nome di foglio unico sostituendo i caratteri non validi con trattini bassi e aggiungendo data e ora se necessario. Se un foglio con il nome specificato esiste già nel file di destinazione, viene creato un nuovo foglio con un nome unico. Usa l’opzione della riga di comando /APPENDTOFILES per aggiungere i dati al foglio esistente.
/SHORTDATEFORMAT <formato>¶
Modifica il formato della data breve per questo processo, che può essere configurato nelle opzioni regionali del Pannello di controllo di Windows. Le esportazioni di TreeSize utilizzeranno questo formato per i valori di data. Esempio:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Questa opzione può essere utilizzata per specificare l’unità da utilizzare per visualizzare i valori di dimensione: N può avere i valori da 0 a 5 che significano: 0 = Byte, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Unità Automatiche. Senza questa opzione verrà utilizzata l’ultima configurazione utilizzata in TreeSize.
/SORTBY <NomeColonna>¶
Consente di specificare in base a quale valore verranno ordinate le Esportazioni generate. I valori possibili sono nomi di colonne come «Size» o «Name». Per impostazione predefinita, verrà utilizzato l’ultimo tipo di ordinamento utilizzato nell’interfaccia utente di TreeSize. Esempio:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <nome del file>¶
Salva i risultati della scansione in un file SQLite che può essere caricato per i confronti in un secondo momento. Esempio:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <soggetto>¶
Questa opzione ti consente di personalizzare l’oggetto che sarà utilizzato per le email inviate al termine della scansione. Esempio:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <nome del file>¶
Salva i risultati in un file di testo o CSV dopo che la scansione o la ricerca è terminata. L’applicazione si chiuderà automaticamente dopo il salvataggio. Il seguente esempio eseguirà una scansione del tuo disco locale C: e salverà i risultati in un file di testo:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
Il formato di testo utilizza un formato tabellare destinato ai lettori umani. Se il nome del file fa riferimento a un file CSV, il formato CSV verrà utilizzato automaticamente. Se si desidera utilizzare esplicitamente il formato CSV, si consiglia di utilizzare il parametro /CSV.
/TITLE <titolo>¶
Può essere utilizzato per sostituire il percorso radice di una scansione con un testo personalizzato. Questo consente di fornire nomi più significativi per i percorsi UNC, ad esempio, aumentando così la leggibilità di un rapporto. Il titolo scelto sarà applicato come titolo del rapporto durante l’esportazione di un file. Esempio:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
Nel contesto di una ricerca di file in TreeSize, questo parametro può essere utilizzato per nominare una ricerca avanzata. Esempio:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <nome del file>¶
Questa opzione ti consente di salvare i contenuti dell’elenco dei file principali in un file Excel, HTML, di testo o CSV. Il tipo di file dipende dall’estensione del nome del file specificato. Esempio:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <nome del file>¶
Salva il grafico Treemap dell’albero delle directory scansionato come file bitmap, GIF, PNG o JPEG. Il tipo di file dipende dall’estensione del nome del file specificato. Esempio:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Imposta il livello dell’interfaccia utente. I valori possibili sono Simple, Normal, o Expert. Esempio:
Treesize /UILevel "Simple"
/USERSLIST <nome del file>¶
Questa opzione ti consente di salvare le statistiche che mostrano i risultati raggruppati per nome utente in un file Excel, HTML, di testo o CSV. Il tipo di file dipende dall’estensione del nome del file specificato. Le colonne esportate saranno quelle che erano abilitate nell’interfaccia utente nella scheda «Users» quando è stata utilizzata l’ultima volta, o al momento in cui è stato scritto il file di configurazione fornito tramite /OPTIONS.
L’esempio seguente scansiona l’unità C: e crea un file Excel in «C:\Temp» con le statistiche degli utenti su questa unità:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <nome utente>¶
Specifica il nome utente da usare per autenticarsi per le scansioni. Utilizzare /PASSWORD per specificare una Password per questo nome utente. Si consiglia invece di utilizzare lo strumento Microsoft RUNAS.
/USERFILTER <nome utente>¶
Con questa opzione verranno presi in considerazione solo i file di proprietà di un determinato utente durante la scansione. Fornire il nome di questo utente dopo questo scambio.
Nota
Non è possibile utilizzare più nomi utente qui, ma i caratteri jolly «*» e «?» sono supportati.
Esempio:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <nome del file>¶
Salva il piccolo grafico mostrato in fondo alla pagina «Utenti» in un file immagine (bitmap, GIF, PNG o JPEG).
/USERSPIECHART <nome del file>¶
Salva un grafico a torta che mostra le «statistiche degli utenti» della scansione corrente in un file immagine (bitmap, GIF, PNG o JPEG).
/VIEWTYPE n¶
Definisce su quali valori si basano «Percentuale del parente», le colonne «Crescita» e il grafico «Età dei file». I valori possibili sono:
2: Dimensione 3: Spazio Allocato (Dimensione su disco) 7: Numero di File
/XML <nome del file>¶
Salva i risultati della scansione in un file XML che può essere caricato per confronti in una data successiva. Esempio:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Questa opzione può essere combinata con l’opzione /EXPAND per limitare le directory esportate.
Nota
Quando si carica un’esportazione XML limitata in TreeSize, non è possibile navigare attraverso l’intero ramo della directory, ma solo le directory esportate.
/ZIP <nome del file>¶
Questa opzione può essere utilizzata solo in combinazione con l’opzione della riga di comando /SEARCH.
Tutti i file trovati come risultato di una ricerca di file in TreeSize verranno spostati in un archivio zip. Esempio:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Vedi anche: Sposta file selezionati
<SCANPATH>¶
Oltre al parametro /SCAN, è possibile passare uno o più percorsi alla fine della riga di comando. Questa operazione non è più consigliata, tuttavia, per evitare errori durante l’analisi della riga di comando.
Questo esempio scansiona le cartelle «Program Files» e «Windows», e crea un rapporto di testo in «C:\Reports\ScanResults.txt»:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
In caso di errore, verrà restituito come codice di errore di Windows nel codice di uscita del processo. Le variabili di ambiente (ad es. %APPDATA%) possono essere utilizzate nei nomi dei file per l’esportazione così come nei percorsi scansionati.
Scansione di più directory¶
Se è necessario scansionare più directory, potrebbe essere una buona idea unire più chiamate in un file Batch, ad esempio:
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"
Il comando «START /WAIT» garantisce che i lavori inizino in sequenza. Non avviare i lavori in parallelo è solitamente meglio perché un singolo lavoro sfrutta maggiormente le cache e le risorse di sistema. È anche possibile memorizzare le condivisioni da scansionare in un file di testo e utilizzare il comando «for» di Windows in questo modo:
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"
Nota
I caratteri percentuali doppi sono richiesti nei file batch, mentre nella riga di comando utilizzare solo un singolo percento.
Avvio programmato¶
È possibile utilizzare le Attività Pianificate di Windows per eseguire TreeSize con determinate opzioni della riga di comando quotidianamente, settimanalmente o mensilmente a un orario specifico. La finestra di dialogo per Pianificazione delle scansioni ti aiuterà a impostare un’attività programmata.
È possibile utilizzare anche il comando SCHTASKS per eseguire scansioni programmate. Se, ad esempio, si desidera scansionare le unità C: ed E: la notte successiva alle 03:00 e salvare i risultati in un file Excel, si potrebbe utilizzare la seguente riga di comando:
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"
Ottieni aiuto sul comando SCHTASKS nelle pagine di Microsoft o digitando:
SCHTAKS /Create /?
Nota
I messaggi di errore che si verificano durante le scansioni programmate sono elencati nel registro eventi di Windows del sistema.
PowerShell¶
Windows PowerShell può essere utile in combinazione con TreeSize. Questo esempio mostra come cercare un paio di computer remoti interrogati con una query LDAP in 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
Reindirizzamento dell’output¶
Se non viene fornito alcun altro obiettivo di esportazione, TreeSize scriverà una breve esportazione della scansione nell’output standard e gli errori che si sono verificati durante la scansione nell’errore standard.
È possibile reindirizzare questi flussi di output nella riga di comando (cmd.exe) utilizzando il simbolo pipe, ad es.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
Per reindirizzare l’output utilizzando PowerShell, si prega di utilizzare invece il comando Start-Process, ad es.
Start-Process -FilePath «C:\Program Files\JAM Software\TreeSize\Treesize.exe» -ArgumentList «/NOGUI /SCAN C:\» -RedirectStandardOutput «.\StdOut.txt» -RedirectStandardError «.\StdError.txt»
Windows Scripting Host¶
Se si intende utilizzare il programma Windows Scripting Host (WSH), il comando per avviare TreeSize sarà simile a quello che si ottiene:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Codici di uscita¶
Se l’operazione è stata completata con successo, il codice di uscita è 0. Se si è verificato un errore, TreeSize restituirà un codice di errore di Windows come codice di uscita se disponibile, oppure 1 per indicare un errore generale.
In ogni caso, il registro eventi di Windows conterrà ulteriori informazioni nel registro «Applicazione», Sorgente Evento «TreeSize».