Opciones de línea de comando¶
La edición Professional de TreeSize acepta opciones de línea de comandos que le permiten ejecutar análisis programados o tener los resultados de un análisis en su monitor a la mañana siguiente.
El diálogo para Programación de análisis le ayudará a compilar una línea de comandos con las opciones a continuación.
Nota
Estas opciones solo están disponibles en la TreeSize Professional Edition.
Todas las opciones¶
Treesize.exe [/OPTION] SCANPATH
/? o /HELP¶
Muestra esta página de ayuda.
/AGEOFFILES¶
Guarda el gráfico en la pestaña «Edad de Archivos» de la carpeta analizada en un archivo de bitmap, GIF, PNG, JPEG, Texto o CSV. El tipo de archivo depende de la extensión del nombre de archivo especificado. El siguiente ejemplo crea un archivo de imagen JPEG del gráfico «Edad de Archivos» para su unidad local C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <valor>¶
Con esta opción, puede seleccionar si TreeSize debe o no anexar su salida a los archivos existentes al hacer una exportación, por ejemplo, cuando se utiliza /TEXT. Seleccione «True» para añadir y «False», si desea sobrescribir los archivos existentes.
Nota
Este parámetro no funcionará con imágenes exportadas, archivos XML y PDF. Esos archivos siempre se sobrescribirán. Puede utilizar el modificador /DATE para asegurarse de que todos los informes generados tendrán un único nombre de archivo.
Al exportar a un archivo Excel a través de /EXCEL, este parámetro puede utilizarse junto con /SHEETNAME para añadir los datos a la hoja especificada. Ejemplo:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Esta opción incluirá solo archivos para los cuales se estableció el bit de archivo en los análisis. Esta opción puede ser muy útil si desea calcular el tamaño de una copia de seguridad. En este caso, puede crear un acceso directo en su escritorio o en su menú de inicio que comenzará automáticamente a calcular el tamaño de su copia de seguridad. Ejemplo:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Si se especifica, todos los archivos exportados se adjuntarán al correo electrónico. Si no se especifica, los archivos con una ruta explícitamente dada no se adjuntan. Esto es útil en caso de que sus archivos XML o Excel sean bastante grandes y llenen su cuenta de correo electrónico.
Este ejemplo exportará a un archivo de Excel pero no lo adjuntará al correo:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Estos ejemplos adjuntarán el archivo de Excel al correo electrónico:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <nombre de fichero>¶
Guarda el gráfico de barras de la carpeta analizada en un archivo bitmap, GIF, PNG o JPEG. El tipo de archivo depende de la extensión del nombre de archivo especificado. Este ejemplo crea un archivo de imagen PNG del gráfico de barras para su unidad local C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <nombre de archivo|ruta>¶
Compara la ruta analizada con un archivo de índice guardado. El siguiente ejemplo analiza la unidad C: y compara el resultado con un informe XML guardado para esta unidad:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
En lugar de un archivo de índice, también puede usar una ruta con este parámetro de línea de comandos. La ruta dada se comparará con el resultado del análisis actual. El siguiente ejemplo analiza la unidad C:\ y además utiliza la ruta D:Backup_of_C para realizar una comparación entre las dos:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Alternativamente, puede comparar dos archivos de índice ya existentes, por ejemplo, «c1.xml.zip» y «c2.xml.zip» utilizando este comando:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
El comando /OPEN prepara la comparación de los dos archivos expandiendo el primer archivo («c1.xml.zip») en un archivo de análisis. El segundo archivo («c2.xml.zip») se comparará con este archivo de análisis expandido, al igual que ocurriría, si «c2.xml.zip» se comparara con un análisis «real».
/COPY <ruta>¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Copia los resultados de una búsqueda de archivos de TreeSize a la ubicación de destino.
El siguiente comando buscará en su unidad local C: utilizando las últimas opciones de búsqueda y copiará los resultados de búsqueda a la carpeta «C:\temp\ObsoleteFiles»:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Véase también: Mover archivos seleccionados
/CREATEDPASTDAYSONLY <n>¶
Esta opción incluirá solo archivos en los análisis que fueron creados durante el número de días ingresados en el argumento. En el siguiente ejemplo, esta opción solo incluirá archivos creados durante los últimos ocho días en el análisis:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <unidad>¶
Crea una instantánea para las unidades que se dan después de este parámetro de línea de comandos. Ejemplo:
Treesize /CREATESNAPSHOT "C:\" "D:\"
La creación de instantáneas puede requerir privilegios administrativos.
/CSV <nombre de fichero>¶
Guarda los resultados en un archivo CSV después de que se complete el análisis o la búsqueda. La aplicación se cerrará automáticamente después de guardar. Este ejemplo guardará los resultados de una búsqueda de archivos en su unidad local C: con las últimas configuraciones de búsqueda en un archivo CSV:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Este interruptor añadirá la fecha y hora actuales a todos los nombres de archivos de exportación en la línea de comandos. Esto es útil si desea realizar análisis regularmente, por ejemplo, cada noche o cada fin de semana. El siguiente ejemplo analizará la ruta de red «\Host\Share» y guardará el resultado en un archivo como «C:\Scans\name_2013-08-14_17-18-24.xls»:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Reemplazará los archivos duplicados que fueron encontrados por la búsqueda de archivos duplicados de TreeSize con enlaces duros NTFS:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Elimina permanentemente todos los archivos que han sido encontrados como resultado de una búsqueda de archivos de TreeSize. Ejemplo:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Véase también: Mover archivos seleccionados
/EMAIL <receptor>¶
Envía los datos recopilados a la dirección de correo electrónico proporcionada. Este parámetro solo se puede usar una vez en la línea de comandos, y solo se enviará un correo electrónico con todos los resultados. Los destinatarios múltiples pueden separarse con punto y coma (;) o comas. Para enviar correos electrónicos a través de la línea de comandos, debe especificar configuraciones SMTP válidas en la página correspondiente del cuadro de diálogo de opciones de TreeSize. Ejemplo:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Si no se han especificado otros parámetros, el correo electrónico se enviará en el formato que se establece en las opciones (HTML o texto plano). Si desea definir el formato independientemente de las opciones actuales, puede usar los parámetros /TEXTO o /HTML justo detrás de la definición de la(s) dirección(es) del destinatario. Ejemplo:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Al combinar parámetros, también puede agregar archivos adjuntos al correo electrónico. El siguiente ejemplo añadirá un informe de Excel del análisis como un archivo adjunto al correo electrónico:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Esta opción sólo puede utilizarse en combinación con las opciones de línea de comandos /SEARCH y /EMAIL. Si se especifica este parámetro, TreeSize sólo enviará un Email con los resultados de la búsqueda actual, si al menos un archivo o carpeta ha sido encontrado durante la búsqueda, por cualquiera de los tipos de búsqueda especificados.
/EMPTYRECYCLEBIN¶
Si utiliza esta opción, TreeSize vaciará la papelera de reciclaje antes de ejecutar el análisis actual. Ejemplo:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Este parámetro permite pasar archivos que han sido encontrados por la búsqueda de archivos de TreeSize a otra aplicación o script. Un posible destino para este parámetro puede ser un script batch o un script de PowerShell. El siguiente ejemplo buscará en la unidad C:\ con las configuraciones de búsqueda más recientes y llamará al script «Archive.bat» para cada archivo que se haya encontrado. El archivo se pasará al script como parámetro de línea de comandos:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Véase también: Mover archivos seleccionados
/EXCEL <ruta de archivo>¶
Exporta los datos recopilados en formato Microsoft Excel y los guarda en la ruta de archivo ingresada. Si solo se especifica un nombre de archivo, se utiliza el directorio de instalación actual para almacenar la exportación. Los formatos admitidos son el formato de archivo convencional .XLS (Excel 97-2003) así como el formato .XLSX (introducido con Excel 2007). El formato utilizado depende de la extensión del nombre de archivo especificado. La aplicación se cerrará automáticamente después de guardar. Ejemplo:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Si el nombre del archivo ya existe, se abrirá el archivo y se añadirá una nueva hoja de cálculo.
Nota
En TreeSize File Search (/SEARCH) los resultados de cada tipo de búsqueda se recogen en su propia hoja de cálculo específica. Si el archivo de la ruta indicada ya existe, estas hojas se sobrescribirán. Para evitarlo, es necesario utilizar la opción de línea de comandos /APPENDTOFILES.
/EXCLUDE <patrón1;patrón2>¶
Esta opción le permite especificar patrones para archivos y carpetas que deben ser excluidos de un análisis. Varios patrones de exclusión pueden ser separados utilizando un punto y coma (;). Si uno o más de los patrones contienen espacios, la cadena de patrón completa debe estar entre comillas («). El siguiente ejemplo ignorará archivos y carpetas que terminen con «.tmp» o donde el nombre exacto sea «system»:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <nivel|tamaño>¶
Esta opción le permite especificar cuántos niveles en el árbol de directorios se expandirán después del análisis. Si no especifica un número después de esta opción, se expandirán todas las carpetas. En lugar de un nivel de directorio, también puede indicar una cantidad en Megabytes (MB). En este caso, todas las carpetas que sean más grandes que la cantidad dada se expandirán. La unidad «MB» debe seguir al número sin un espacio. El siguiente ejemplo analizará la carpeta «H:\User», expandirá todas las carpetas que sean mayores de 10 MB y guardará el resultado en el archivo de Excel «C:\Reports\Allusers.xlsx»:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <valor>¶
Si se utiliza esta opción, las exportaciones a Excel utilizarán grupos expandibles/colapsables que se pueden navegar de manera similar al árbol de directorios.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <nombre de fichero>¶
Esta opción le permite exportar el contenido de la «Lista de unidades» a un archivo de Excel, Texto o CSV. El tipo de archivo depende de la extensión del nombre de archivo especificado. Ejemplo:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Si se especifica, los archivos se incluirán en todas las exportaciones. Por lo tanto, esta opción es equivalente a activar la opción «Herramientas > Opciones > Exportar > * > Elementos exportados > Carpetas y archivos individuales»
/EXPORTGROUPSEXPANDED¶
Si se especifica, la exportación de la lista de extensiones contendrá toda la información sobre las extensiones contenidas dentro de los grupos.
/EXPORTPATHSLIST <nombre de fichero>¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Exporta una lista simple que contiene todos los resultados de búsqueda. La lista contendrá solo las rutas completas de los resultados de búsqueda y ninguna otra información. Los formatos admitidos para el archivo de destino son .txt y .csv.
Este ejemplo buscará y creará una lista de todos los archivos exe en la unidad C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Se puede utilizar para importar los resultados de una búsqueda anterior de nuevo en la interfaz de usuario, utilizando «Archivo > Lista de rutas > Importar lista de rutas», o el parámetro /IMPORT.
Si la opción «Herramientas > Opciones > Exportar > Incluir grupos duplicados» está activada, también puede utilizar esta función para exportar e importar resultados de la búsqueda de duplicados, incluyendo su estructura de grupo.
/EXPORTTITLE ¶
Se puede utilizar para cambiar el título dentro de un informe impreso o archivo exportado. Esto le permite proporcionar información adicional al usuario al utilizar TreeSize en un entorno automatizado. También se permite el uso de variables de entorno. Ejemplo:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <nombre de fichero>¶
Esta opción le permite guardar las estadísticas sobre las extensiones de archivo / tipos de archivo del sistema de archivos escaneado en un archivo de Excel, HTML, Texto o CSV. El tipo de archivo depende de la extensión del nombre de archivo especificado. Las columnas exportadas serán aquellas que se habilitaron en la interfaz de usuario en la pestaña «Extensiones» cuando se utilizó por última vez, o en el momento en que se escribió el archivo de configuración proporcionado a través de /OPTIONS.
El siguiente ejemplo analiza la unidad C: y crea un archivo de Excel llamado «D:\TreeSize Reports\C_filetypes.xls» con las estadísticas de los tipos de archivo en esta unidad:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <nombre de fichero>¶
Guarda el pequeño gráfico mostrado en la parte inferior de la página «Extensiones» en un archivo de imagen (bitmap, GIF, PNG o JPEG).
/EXTENSIONSPIECHART <nombre de fichero>¶
Guarda un gráfico circular que muestra la distribución de «extensiones de archivo» en un archivo de imagen (bitmap, GIF, PNG o JPEG).
/FILTER <patrón1;patrón2>¶
Establece un filtro de archivos que cuenta solo los archivos con ciertas extensiones, por ejemplo, «.mp3» o «.doc». Se pueden pasar múltiples patrones, separados por punto y coma (;). El siguiente ejemplo buscará archivos MP3 y AVI en la carpeta «Users» en el servidor:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Al realizar una búsqueda de archivos TreeSize (/SEARCH), también puede utilizar el modificador de línea de comandos /FILTER para especificar los patrones de la búsqueda avanzada de archivos. Para realizar una búsqueda de archivos personalizada más compleja, debe guardar las opciones de búsqueda en un archivo y pasar el archivo XML resultante a la línea de comandos después de /SEARCH.
/FOLLOWREPARSEPOINTS¶
Si este interruptor se agrega a la línea de comandos, TreeSize seguirá los puntos de montaje y los enlaces simbólicos externos al escanear un árbol de sistema de archivos.
/GROUPSCANS¶
Utilizando este modificador de línea de comandos se agruparán todas las carpetas analizadas bajo una carpeta raíz virtual. Utilice /GROUPSCANS FALSE si desea asegurarse de que no se utiliza ninguna carpeta raíz virtual.
/HIDESMALLFOLDERS <valor>¶
Permite ocultar objetos que son más pequeños que un tamaño mínimo, lo que es útil para obtener exportaciones claras. <valor> puede ser un valor de tamaño con unidad, o un valor de byte plano sin unidad. No puede utilizarse en combinación con /EXPAND. En este ejemplo, sólo se exportarán las carpetas que tengan un tamaño mínimo de 50 MB:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <nombre de fichero>¶
Guarda el gráfico en la pestaña «Historial» del directorio escaneado en un archivo bitmap, GIF, PNG o JPEG. El tipo de archivo depende de la extensión del nombre de archivo especificado. Este ejemplo crea una imagen JPEG del gráfico de historial para la unidad C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <nombre de fichero>¶
Guarda los datos recopilados en un archivo HTML que se puede visualizar con cualquier navegador HTML. Puede especificar qué información del análisis se incluirá en la exportación a través de «Inicio > Opciones > Exportar > HTML > Gráficos y listas a incluir». Puede seleccionar cuáles de las listas adicionales o gráficos deben añadirse a la exportación. Se incrustarán automáticamente en el archivo HTML que se genera después del análisis.
El siguiente ejemplo generará un informe HTML para la unidad C: y lo guardará en «D:\HTML»:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Si desea que más de un Análisis forme parte del archivo HTML, debe añadir el modificador de línea de comandos /GROUPSCANS. Al exportar a HTML sin una imagen incluida, también puede utilizar el modificador /APPENDTOFILES. Sin una de estas opciones, el archivo HTML se sobrescribirá.
/IMPORT <nombre de fichero>¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Carga una lista de rutas en la interfaz de usuario de la búsqueda de archivos de TreeSize. El archivo puede estar en formato .txt o .csv. Este parámetro se puede utilizar para importar los resultados de una búsqueda anterior. Los archivos y carpetas importados se pueden mover/copiar/eliminar/archivar, como cualquier resultado de búsqueda «en vivo», utilizando el cuadro de diálogo de operaciones de archivo.
Ejemplo:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
También puede combinar este parámetro con los parámetros /RECYCLE, /DELETE, o /MOVE para borrar o mover automáticamente los archivos que contiene el archivo de texto. Ejemplo:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <nombre de fichero>¶
Importa una lista de patrones desde un archivo. El archivo puede ser un archivo de texto simple con una lista de patrones de filtro, separados por punto y coma, o puede utilizar la interfaz de usuario para crear un conjunto más complejo de patrones y usar la función de exportación para generar el archivo de patrones en formato XML. Los formatos admitidos son CSV, TXT y XML.
Los patrones importados se utilizarán como filtros para el análisis para incluir o excluir archivos y carpetas específicos.
Si se utiliza en combinación con la opción de línea de comandos /SEARCH, este parámetro creará una nueva búsqueda avanzada que utilizará los patrones del archivo importado como criterios para la búsqueda.
Este ejemplo importará patrones de filtro que están definidos en «C:\TreeSizeFiles\patterns.txt», iniciará un análisis para la unidad C:\ y exportará los resultados a un archivo HTML:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <nombre de fichero>¶
Guarda los resultados del análisis en un archivo SQLite que se puede cargar para comparaciones en una fecha posterior. Ejemplo:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <carácter separador>¶
Le permite definir el separador utilizado al exportar archivos de texto o CSV. Los archivos de texto utilizan el tabulador por defecto, los archivos CSV el separador de lista de la configuración regional del panel de control de Windows.
Por favor, especifique un solo carácter o la cadena «TAB» para el tabulador después de este modificador. Ejemplos:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <ruta>¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Mueve los resultados de una búsqueda de archivos de TreeSize a otra ubicación.
El siguiente comando buscará en su unidad local C: utilizando las opciones de búsqueda más recientes y moverá los resultados de la búsqueda a la carpeta «C:\Temp\ObsoleteFiles»:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Véase también: Mover archivos seleccionados
/NOGUI¶
No se mostrará ninguna ventana y la aplicación no aparecerá en la barra de tareas. Útil para ejecutar análisis o búsquedas en segundo plano, sin retroalimentación visual.
Advertencia
Utilice este interruptor solo si ha probado el resto de las opciones de la línea de comandos, ya que los mensajes de error no se pueden mostrar en este modo.
Sin embargo, los errores se registrarán en el registro de eventos de Windows.
/NOHEADERS¶
Omite las líneas de encabezado que normalmente se escriben en la parte superior de los archivos de exportación de análisis o búsqueda. Esto facilita la recepción de datos en bruto para el postprocesamiento.
/NOUNITS¶
Omite las unidades que suelen escribirse después de los valores de tamaño. Esta opción, en combinación con /SIZEUNIT 0, exportará valores de bytes sin formato. Esto facilita la recepción de datos sin formato para su posprocesamiento.
Nota
Esta línea de comandos sólo afectará a las exportaciones del árbol de directorios, generadas mediante las opciones /TEXT, /EXCEL, /HTML, /EMAIL, o /PRINT. /EXTENSIONSLIST Las opciones /USERSLIST, /EXPORTDRIVESLIST, o /TOPFILESLIST no se verán afectadas.
/OPEN <nombre de fichero>¶
Abre un informe XML guardado al iniciar la aplicación. Ejemplo:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <nombre de fichero>¶
Utilice este parámetro para aplicar configuraciones de usuario exportadas a TreeSize. Las configuraciones de usuario se pueden exportar en «Archivo > Opciones > Exportar». Ejemplo:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Nota
Cambie tantas configuraciones como sea posible en la interfaz de usuario antes de guardar las opciones para reducir la cantidad de parámetros de línea de comandos que necesita.
/PDF¶
Guarda los resultados en un archivo PDF después de que se complete el análisis o la búsqueda. La aplicación se cerrará automáticamente después de guardar. El siguiente ejemplo ejecutará un análisis de su unidad local C: y guardará los resultados en un archivo PDF:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <nombre de fichero>¶
Guarda el gráfico circular del directorio analizado en un archivo bitmap, GIF, PNG o JPEG. El tipo de archivo depende de la extensión del nombre de archivo especificado. El siguiente ejemplo escaneará la unidad C: y exportará un gráfico circular en formato PNG:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Imprime un informe del árbol de directorios escaneado utilizando la impresora predeterminada configurada en los ajustes del sistema. La aplicación se cerrará tras la impresión. Ejemplo:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <valor>¶
Si el valor es verdadero, esta opción activa un modo de sólo lectura en el que las operaciones con archivos (por ejemplo, mover o eliminar) están deshabilitadas, por lo que sólo se podrá utilizar como herramienta de informes.
Comience con un valor de false para desactivar de nuevo el modo de sólo lectura.
/RECYCLE¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Mueve todos los archivos a la papelera de reciclaje que se han encontrado como resultado de una búsqueda de archivos TreeSize. Ejemplo:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Véase también: Mover archivos seleccionados
/RESTRICTEDMODE <valor>¶
Si el valor es verdadero, esta opción activa un modo restringido en el que se desactivan muchas funciones que no son de interés para los usuarios «normales» (no administradores). Entre las funciones deshabilitadas se encuentran: Comprobar actualizaciones, Abrir el applet de Software del Panel de Control de Windows, Programar Análisis TreeSize, Conectar unidad de red, Configurar la Restauración del Sistema de Windows, Ejecutar como administrador, Exportar y Aplicar compresión NTFS. Puede proporcionar una ruta que debe ser analizada, por ejemplo, el directorio de inicio del usuario, en la línea de comandos o utilizando las rutas de inicio en un archivo de configuración guardado.
Comience con un valor de false para desactivar de nuevo el modo restringido.
Si además activa la opción /READONLYMODE, el usuario no podrá borrar o mover archivos en TreeSize, por lo que sólo podrá utilizarlo como herramienta de informes.
/SCAN <ruta|nombre de archivo>¶
Define qué unidad o ruta debe analizarse. La ruta de análisis debe utilizarse como valor para este parámetro.
Si, por ejemplo, debe analizarse la unidad D:\, puede utilizar:
Treesize /SCAN "D:\"
Si no desea analizar toda la unidad, también puede especificar una ruta, que se utilizará como punto de partida para el análisis. Por ejemplo:
TreeSize /SCAN "\\Server\Share\MyDocuments"
También son posibles varias rutas de Análisis, separadas por un espacio en blanco. Las rutas que contienen un espacio en blanco deben ir entre comillas («). Ejemplo:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Los comodines «*» y «?» están permitidos. Ejemplo:
Treesize /SCAN "H:\users\A*"
También puede especificar un archivo de texto, que contiene una lista de rutas que deben ser analizadas. TreeSize analizará todas las rutas que se encuentran en el archivo de texto, que se especifica después de esta opción. El archivo de texto debe contener una ruta por línea. El siguiente ejemplo analiza todas las rutas que se encuentran en el archivo «D:\PathsToScan.txt» y escribe cada resultado del análisis en una hoja separada de un archivo Excel con la fecha de hoy:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
También puede llamar TreeSize en un bucle «for» con una de las rutas solamente, por favor, encuentre un ejemplo a continuación.
/SEARCH¶
Abre la ventana de Búsqueda de Archivos de TreeSize. Si se añade «:Start» a esta opción de línea de comandos, la búsqueda se inicia automáticamente. Un archivo XML previamente guardado que contiene la configuración de búsqueda puede ser pasado, estos ajustes se utilizarán para realizar la búsqueda.
Nota
Los archivos encontrados en esta búsqueda se comprueban automáticamente.
El siguiente ejemplo realiza la búsqueda con los ajustes que se han guardado previamente en el archivo «SearchSettings.xml» y guarda los resultados en un archivo de texto:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Nota
En general, se utilizará la última configuración de búsqueda o un conjunto anterior de configuraciones de búsqueda guardadas. Sin embargo, también puede especificar los patrones de búsqueda para la búsqueda avanzada utilizando la opción de línea de comandos /FILTER.
/SHEETNAME ¶
Permite especificar el nombre de la hoja que se añadirá a un archivo de Excel cuando se utilice el modificador de línea de comandos /EXCEL.
Nota
Un nombre de hoja de Excel debe ser único en un archivo de Excel y ciertos caracteres especiales como barras, barras invertidas y dos puntos están prohibidos. TreeSize siempre creará un nombre de hoja único reemplazando caracteres inválidos con guiones bajos y añadiendo la fecha y hora si es necesario. Si ya existe una hoja con el nombre especificado en el archivo de destino, se crea una nueva hoja con un nombre único. Utilice la opción de línea de comandos /APPENDTOFILES para agregar los datos a la hoja existente.
/SHORTDATEFORMAT <formato>¶
Cambia el formato de fecha corta para este proceso, que se puede configurar en las opciones regionales del Panel de Control de Windows. Las exportaciones de TreeSize utilizarán este formato para los valores de fecha. Ejemplo:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Esta opción se puede utilizar para especificar la unidad que se utilizará para mostrar los valores de tamaño: N puede tener los valores de 0 a 5 que significan: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Unidades Automáticas. Sin esta opción, se utilizará la última configuración utilizada en TreeSize.
/SORTBY <NombreColumna>¶
Permite especificar por qué valor se ordenarán las exportaciones generadas. Los valores posibles son nombres de columna como «Size» o «Name». Por defecto se utilizará el último tipo de ordenación utilizado en la interfaz de usuario de TreeSize. Ejemplo:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <nombre de fichero>¶
Guarda los resultados del análisis en un archivo SQLite que se puede cargar para comparaciones en una fecha posterior. Ejemplo:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <asunto>¶
Esta opción le permite personalizar el asunto que se utilizará para los correos electrónicos que se envían al final del análisis. Ejemplo:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <nombre de fichero>¶
Guarda los resultados en un archivo de texto o CSV después de que se complete el análisis o la búsqueda. La aplicación se cerrará automáticamente después de guardar. El siguiente ejemplo ejecutará un análisis de su unidad local C: y guardará los resultados en un archivo de texto:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
El formato de texto utiliza un formato tabular dirigido a lectores humanos. Si el nombre de archivo hace referencia a un archivo CSV, se utilizará automáticamente el formato CSV. Si desea utilizar explícitamente el formato CSV, le recomendamos que utilice el parámetro /CSV.
/TITLE <title>¶
Se puede utilizar para reemplazar la ruta raíz de un análisis con un texto personalizado. Esto permite proporcionar nombres más significativos para las rutas UNC, por ejemplo, y así aumentar la legibilidad de un informe. El título elegido se aplicará como el título del informe al exportar un archivo. Ejemplo:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
En el contexto de una búsqueda de archivos de TreeSize, este parámetro se puede utilizar para nombrar una búsqueda avanzada. Ejemplo:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <nombre de fichero>¶
Esta opción le permite guardar el contenido de la lista de archivos principales en un archivo de Excel, HTML, Texto o CSV. El tipo de archivo depende de la extensión del nombre de archivo especificado. Ejemplo:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <nombre de fichero>¶
Guarda el gráfico de árbol del directorio escaneado como un archivo bitmap, GIF, PNG o JPEG. El tipo de archivo depende de la extensión del nombre de archivo especificado. Ejemplo:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Establece el nivel de la interfaz de usuario. Los valores posibles son Simple, Normal, o Expert. Ejemplo:
Treesize /UILevel "Simple"
/USERSLIST <nombre de fichero>¶
Esta opción le permite guardar las estadísticas que muestran los resultados agrupados por nombre de usuario en un archivo de Excel, HTML, Texto o CSV. El tipo de archivo depende de la extensión del nombre de archivo especificado. Las columnas exportadas serán aquellas que estaban habilitadas en la interfaz de usuario en la pestaña «Usuarios» cuando se utilizó por última vez, o en el momento en que se escribió el archivo de configuración proporcionado a través de /OPTIONS.
El siguiente ejemplo analiza la unidad C: y crea un archivo de Excel en «C:\Temp» con las estadísticas de los usuarios en esta unidad:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <nombre de usuario>¶
Especifica el nombre de usuario que debe utilizarse para autenticarse en los análisis. Utilice /PASSWORD para especificar una Contraseña para este nombre de usuario. Se recomienda utilizar en su lugar la herramienta de Microsoft RUNAS.
/USERFILTER <nombre de usuario>¶
Con esta opción, solo se tendrán en cuenta los archivos propiedad de un cierto usuario al escanear. Proporcione el nombre de este usuario después de este conmutador.
Nota
No puede utilizar múltiples nombres de usuario aquí, pero se admiten los comodines «*» y «?».
Ejemplo:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <nombre de fichero>¶
Guarda el pequeño gráfico mostrado en la parte inferior de la página «Usuarios» en un archivo de imagen (bitmap, GIF, PNG o JPEG).
/USERSPIECHART <nombre de fichero>¶
Guarda un gráfico circular que muestra las «estadísticas de usuarios» del análisis actual en un archivo de imagen (bitmap, GIF, PNG o JPEG).
/VIEWTYPE n¶
Define sobre qué valores se basan el «Porcentaje del Padre», las columnas de «Crecimiento» y el gráfico de «Edad de Archivos». Los valores posibles son:
2: Tamaño 3: Espacio Asignado (Tamaño en disco) 7: Número de Archivos
/XML <nombre de fichero>¶
Guarda los resultados del análisis en un archivo XML que se puede cargar para comparaciones en una fecha posterior. Ejemplo:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Esta opción puede combinarse con el modificador /EXPAND para limitar las carpetas exportadas.
Nota
Al cargar una exportación XML limitada en TreeSize, no se puede navegar a través de la rama completa de la carpeta, sino solo por las carpetas exportadas.
/ZIP <nombre de fichero>¶
Esta opción sólo puede utilizarse en combinación con la opción de línea de comandos /SEARCH.
Todos los archivos que se han encontrado como resultado de una búsqueda de archivos en TreeSize se moverán a un archivo zip. Ejemplo:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Véase también: Mover archivos seleccionados
<RUTADEANALISIS>¶
Además del parámetro /SCAN, también puede pasar una o más rutas al final de la línea de órdenes. Sin embargo, esto ya no se recomienda para evitar errores al analizar la línea de comandos.
Este ejemplo analiza la carpeta «Program Files» y la carpeta «Windows», y crea un informe de texto en «C:\Reports\ScanResults.txt»:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
En caso de que ocurra un error, se devolverá como código de error de Windows en el código de salida del proceso. Las variables de entorno (por ejemplo, %APPDATA%) se pueden usar en los nombres de archivos para la exportación, así como en las rutas analizadas.
Análisis de Múltiples Carpetas¶
Si necesita analizar múltiples carpetas, podría ser una buena idea combinar varias llamadas en un archivo por lotes, por ejemplo:
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"
El comando «START /WAIT» asegura que los trabajos comiencen secuencialmente. No iniciar los trabajos en paralelo suele ser mejor porque un solo trabajo aprovecha más las cachés y los recursos del sistema. También es posible almacenar las comparticiones que deben ser analizadas en un archivo de texto y usar el comando «for» de Windows de esta manera:
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
Los caracteres de porcentaje dobles son necesarios en los archivos por lotes; en la línea de comandos, use solo un porcentaje.
Inicio Programado¶
Puede usar las Tareas Programadas de Windows para ejecutar TreeSize con ciertas opciones de línea de comandos diariamente, semanalmente o mensualmente a una hora determinada. El diálogo para Programación de análisis le ayudará a configurar una tarea programada.
También puede usar el comando SCHTASKS para realizar análisis programados. Si, por ejemplo, desea analizar las unidades C: y E: la próxima noche a las 03:00 a.m. y guardar los resultados en un archivo de Excel, podría usar la siguiente línea de comandos:
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"
Obtenga ayuda sobre el comando SCHTASKS en las páginas de Microsoft o escribiendo:
SCHTAKS /Create /?
Nota
Los mensajes de error que ocurren durante los análisis programados se enumeran en el registro de eventos de Windows del sistema.
PowerShell¶
Windows PowerShell puede ser útil en combinación con TreeSize. Este ejemplo muestra cómo buscar en un par de ordenadores remotos que se consultan mediante una consulta LDAP en el Directorio Activo (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
Redirigir Salida¶
Si no se proporciona otro destino de exportación, TreeSize escribirá una breve exportación del análisis en la salida estándar y los errores que ocurrieron durante el análisis en el error estándar.
Puede redirigir estos flujos de salida en la línea de comandos (cmd.exe) utilizando el símbolo de tubería, por ejemplo.
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
Para redirigir la salida utilizando PowerShell, utilice el comando Start-Process en su lugar, por ejemplo.
Start-Process -FilePath «C:\Program Files\JAM Software\TreeSize\Treesize.exe» -ArgumentList «/NOGUI /SCAN C:\» -RedirectStandardOutput «.\StdOut.txt» -RedirectStandardError «.\StdError.txt»
Windows Scripting Host¶
Si pretende utilizar el Windows Scripting Host (WSH), su comando para iniciar TreeSize tendrá el siguiente aspecto:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
Códigos de Salida¶
Si la operación se completó con éxito, el código de salida es 0. Si ocurrió un error, TreeSize devolverá un código de error de Windows como código de salida si está disponible, o 1 para indicar un error general.
En cualquier caso, el Registro de Eventos de Windows contendrá información adicional en el registro «Aplicación», Fuente del Evento «TreeSize».