Opções da linha de comandos¶
A edição Professional do TreeSize aceita opções de linha de comandos que lhe permitem executar análises agendadas ou ter os resultados de uma análise no seu monitor na manhã seguinte.
A caixa de diálogo para Agendamento de análises ajudará você a compor uma linha de comandos com as opções abaixo.
Nota
Essas opções estão disponíveis apenas na Edição Profissional do TreeSize.
Todas as opções¶
Treesize.exe [/OPTION] SCANPATH
/? ou /HELP¶
Mostra esta página de ajuda.
/AGEOFFILES¶
Salva o gráfico na aba «Idade dos Ficheiros» do diretório analisado em um arquivo bitmap, GIF, PNG, JPEG, Texto ou CSV. O tipo de arquivo depende da extensão do nome de arquivo especificado. O seguinte exemplo cria um arquivo de imagem JPEG do gráfico «Idade dos Ficheiros» para o seu disco local C:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <valor>¶
Com esta opção, pode selecionar se o TreeSize deve ou não adicionar a sua saída aos ficheiros existentes ao efetuar uma exportação, por exemplo, ao utilizar /TEXT. Selecione «True» para adicionar e «False», se pretender substituir ficheiros existentes.
Nota
Este parâmetro não funciona com imagens exportadas, ficheiros XML e PDF. Esses ficheiros serão sempre substituídos. Pode utilizar a opção /DATE para garantir que todos os relatórios gerados terão um nome de ficheiro único.
Ao exportar para um ficheiro Excel através de /EXCEL, este parâmetro pode ser utilizado juntamente com /SHEETNAME para adicionar os dados à folha especificada. Exemplo:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
Esta opção incluirá apenas arquivos para os quais o bit de arquivo está definido nas análises. Esta opção pode ser muito útil se você quiser calcular o tamanho de um backup. Nesse caso, você pode criar um atalho na sua área de trabalho ou no seu menu iniciar que iniciará automaticamente o cálculo do tamanho do seu backup. Exemplo:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
Se especificado, todos os arquivos exportados serão anexados ao e-mail. Se não especificado, arquivos com um caminho explicitamente dado não são anexados. Isso é útil caso seus arquivos XML ou Excel estejam ficando bastante grandes e preencham sua conta de e-mail.
Este exemplo exportará para um arquivo Excel, mas não o anexará ao e-mail:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
Estes exemplos anexarão o arquivo Excel ao e-mail:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <nome do ficheiro>¶
Salva o gráfico de barras do diretório analisado em um arquivo bitmap, GIF, PNG ou JPEG. O tipo de arquivo depende da extensão do nome de arquivo especificado. Este exemplo cria um arquivo de imagem PNG do gráfico de barras para o seu disco local C:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <nome do ficheiro|caminho>¶
Compara o caminho analisado com um arquivo de índice salvo. O seguinte exemplo analisa o disco C: e compara o resultado com um relatório XML salvo para este disco:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
Em vez de um ficheiro de índice, também pode utilizar um caminho com este parâmetro da linha de comandos. O caminho fornecido será comparado com o resultado da análise atual. O exemplo seguinte analisa a disco C:\e utiliza adicionalmente o caminho D:Backup_of_C para efetuar uma comparação entre os dois:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
Alternativamente, você pode comparar dois ficheiros de índice já existentes, por exemplo, «c1.xml.zip» e «c2.xml.zip», utilizando este comando:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
O comando /OPEN prepara a comparação dos dois ficheiros expandindo o primeiro ficheiro («c1.xml.zip») num ficheiro de análise. O segundo ficheiro («c2.xml.zip») será comparado com este ficheiro de análise expandido, tal como aconteceria se «c2.xml.zip» fosse comparado com uma análise «real».
/COPY <caminho>¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Copia os resultados de uma pesquisa de ficheiros do TreeSize para a localização alvo.
O seguinte comando irá procurar no disco local C: utilizando as opções de pesquisa mais recentes e copia os resultados da pesquisa para a pasta «C:\temp\ObsoleteFiles»:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
Veja também: Mover ficheiros selecionados
/CREATEDPASTDAYSONLY <n>¶
Esta opção incluirá apenas ficheiros nas análises que foram criados durante o número de dias inserido no argumento. No exemplo a seguir, esta opção incluirá apenas ficheiros criados durante os últimos oito dias na análise:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <disco>¶
Cria um instantâneo para os discos que são dados após este parâmetro da linha de comandos. Exemplo:
Treesize /CREATESNAPSHOT "C:\" "D:\"
A criação de cópias instantâneas podem necessitar de privilégios administrativos.
/CSV <nome do ficheiro>¶
Salva os resultados em um ficheiro CSV após a análise ou pesquisa ser concluída. A aplicação se encerrará após salvar. Este exemplo salvará os resultados de uma pesquisa de Ficheiros no seu disco local C: com as últimas configurações de pesquisa em um ficheiro CSV:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
Esta opção adicionará a data e hora actuais a todos os nomes de ficheiros exportados na linha de comandos. Isto é útil se quiser fazer análises regularmente, por exemplo, todas as noites ou todos os fins-de-semana. O exemplo seguinte irá analisar o caminho de rede «\\Host\Share» e guardar o resultado num ficheiro como «C:Scans\name_2013-08-14_17-18-24.xls»:
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Substituirá os ficheiros duplicados que foram encontrados pela pesquisa de ficheiros duplicados do TreeSize por links duros NTFS:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Elimina permanentemente todos os ficheiros que foram encontrados como resultado de uma pesquisa de ficheiros do TreeSize. Exemplo:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
Veja também: Mover ficheiros selecionados
/EMAIL <recipiente>¶
Envia os dados coletados para o endereço de e-mail fornecido. Este parâmetro pode ser usado apenas uma vez na linha de comandos, e apenas um e-mail com todos os resultados será enviado. Vários destinatários podem ser separados por ponto e vírgula (;) ou vírgulas. Para enviar e-mails via linha de comandos, é necessário especificar configurações SMTP válidas na página correspondente no diálogo de opções do TreeSize. Exemplo:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
Se nenhum outro parâmetro tiver sido especificado, o e-mail será enviado no formato definido nas opções (HTML ou texto simples). Se você desejar definir o formato independentemente das opções atuais, pode usar os parâmetros /TEXT ou /HTML logo após a definição do(s) endereço(s) do destinatário. Exemplo:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
Ao combinar parâmetros, você também pode adicionar anexos ao e-mail. O seguinte exemplo adicionará um relatório do Excel da análise como um anexo ao e-mail:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
Esta opção só pode ser utilizada em combinação com as opções de linha de comandos /SEARCH e /EMAIL. Se este parâmetro for especificado, o TreeSize só enviará um e-mail com os resultados da pesquisa atual, se pelo menos um ficheiro ou pasta tiver sido encontrado durante a pesquisa, por qualquer um dos tipos de pesquisa especificados.
/EMPTYRECYCLEBIN¶
Se você usar esta opção, o TreeSize esvaziará a lixeira antes de executar a análise atual. Exemplo:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Este parâmetro permite passar ficheiros que tenham sido encontrados pelo TreeSize File Search para outra aplicação ou script. Um alvo possível para este parâmetro pode ser um lote ou um script do PowerShell. O exemplo seguinte pesquisará o disco C:\ com as definições de pesquisa mais recentes e chamará o script «Archive.bat» para cada ficheiro encontrado. O ficheiro será passado para o script como parâmetro da linha de comandos:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
Veja também: Mover ficheiros selecionados
/EXCEL <caminho do ficheiro>¶
Exporta os dados coletados no formato Microsoft Excel e os salva no caminho de arquivo inserido. Se apenas um nome de arquivo for especificado, o diretório de instalação atual será usado para armazenar a exportação. Os formatos suportados são o formato de arquivo convencional .XLS (Excel 97-2003) e o formato .XLSX (introduzido com o Excel 2007). O formato utilizado depende da extensão do nome do arquivo especificado. A aplicação se encerrará após salvar. Exemplo:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
Se o nome do arquivo já existir, o arquivo será aberto e uma nova planilha será adicionada.
Nota
No sítio TreeSize File Search (/SEARCH), os resultados de cada tipo de procura são reunidos na sua própria folha de cálculo específica. Se o ficheiro no caminho indicado já existir, estas folhas serão substituídas. Para o evitar, é necessário utilizar a opção da linha de comandos /APPENDTOFILES.
/EXCLUDE <padrão1;padrão2>¶
Esta opção permite especificar padrões para ficheiros e pastas que devem ser excluídos de uma análise. Vários padrões de exclusão podem ser separados usando um ponto e vírgula (;). Se um ou mais dos padrões contiverem espaços, a string completa do padrão deve ser colocada entre aspas («). O seguinte exemplo ignorará ficheiros e pastas que terminam com «.tmp» ou cujo nome exato é «system»:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <nível|tamanho>¶
Esta opção permite-lhe especificar quantos níveis da árvore de diretórios serão expandidos após a análise. Se não especificar um número após esta opção, todas as pastas serão expandidas. Em vez de um nível de diretório, também pode indicar uma quantidade em Mega Byte (MB). Neste caso, todas as pastas maiores do que a quantidade indicada serão expandidas. A unidade «MB» deve seguir o número sem um espaço em branco. O exemplo seguinte analisará a pasta «H:\User», expandirá todas as pastas com mais de 10 MB e guardará o resultado no ficheiro Excel «C:\Results\Allusers.xlsx»:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <valor>¶
Se esta opção for usada, as exportações do Excel utilizarão grupos expansíveis/recolhíveis que podem ser navegados de forma semelhante à árvore de diretórios.
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <nome do ficheiro>¶
Esta opção permite-lhe exportar o conteúdo da «Lista de discos» para um ficheiro Excel, Texto ou CSV. O tipo de ficheiro depende da extensão do nome do ficheiro especificado. Exemplo:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
Se especificado, os ficheiros serão incluídos em todas as exportações. Assim, esta opção é equivalente a ativar a opção «Ferramentas > Opções > Exportar > * > Elementos exportados > Pastas e ficheiros individuais»
/EXPORTGROUPSEXPANDED¶
Se especificado, a exportação da lista de extensões conterá todas as informações sobre as extensões contidas nos grupos.
/EXPORTPATHSLIST <nome do ficheiro>¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Exporta uma lista simples que contém todos os resultados da procura. A lista conterá apenas os caminhos completos dos resultados da pesquisa e nenhuma outra informação. As formatações suportadas para o ficheiro de destino são .txt e .csv.
Este exemplo irá procurar e criar uma lista de todos os ficheiros exe no disco C:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
Pode ser utilizado para importar os resultados de uma pesquisa anterior para a interface do utilizador, utilizando «File > Listada de caminhos > Importar lista de caminhos», ou o parâmetro /IMPORT.
Se a opção «Ferramentas > Opções > Exportar > Incluir grupos duplicados» estiver ativada, também pode utilizar esta função para exportar e importar resultados da procura de duplicados, incluindo a respetiva estrutura de grupo.
/EXPORTTITLE ¶
Pode ser usado para alterar o título num relatório impresso ou num ficheiro exportado. Isso permite fornecer informações adicionais ao utilizador ao usar o TreeSize num ambiente automatizado. O uso de variáveis de ambiente também é permitido. Exemplo:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <nome do ficheiro>¶
Esta opção permite-lhe guardar as estatísticas sobre Extensões de ficheiros / Tipos de ficheiros da ramificação do sistema de ficheiros analisado num ficheiro Excel, HTML, Texto ou CSV. O tipo de ficheiro depende da extensão do nome do ficheiro especificado. As colunas exportadas serão aquelas que estavam activadas na interface do utilizador no separador «Extensões» quando foi utilizado pela última vez, ou no momento em que o ficheiro de configuração fornecido via /OPTIONS foi escrito.
O exemplo seguinte analisa a unidade C: e cria um ficheiro Excel com o nome «D:\TreeSize Reports\C_filetypes.xls» com as estatísticas dos tipos de ficheiros nesta disco:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <nome do ficheiro>¶
Guarda o pequeno gráfico mostrado na parte inferior da página «Extensões» num ficheiro de imagem (bitmap, GIF, PNG ou JPEG).
/EXTENSIONSPIECHART <nome do ficheiro>¶
Guarda um gráfico circular que mostra a distribuição de «Extensões de ficheiros» para um ficheiro de imagem (bitmap, GIF, PNG ou JPEG).
/FILTER <padrão1;padrão2>¶
Define um filtro de ficheiros contando apenas ficheiros com determinadas Extensões, por exemplo, «.mp3» ou «.doc». Podem ser passados vários padrões, separados por ponto e vírgula (;). O exemplo seguinte irá procurar ficheiros MP3 e AVI no diretório «Users» no servidor:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
Ao efetuar uma Procurar de Ficheiros TreeSize (/SEARCH), pode também utilizar a opção de linha de comandos /FILTER para especificar os padrões da procura avançada de ficheiros. Para executar uma procura de ficheiros personalizada mais complexa, deve guardar as opções de procura num ficheiro e passar o ficheiro XML resultante para a linha de comandos após /SEARCH.
/FOLLOWREPARSEPOINTS¶
Se esta opção for adicionada à linha de comandos, o TreeSize seguirá os pontos de montagem e as ligações simbólicas externas ao analisar a árvore de um sistema de ficheiros.
/GROUPSCANS¶
A utilização desta opção de linha de comandos agrupará todos os diretórios analisados numa pasta raiz virtual. Utilize /GROUPSCANS FALSE se quiser garantir que não é utilizada nenhuma pasta raiz virtual.
/HIDESMALLFOLDERS <valor>¶
Permite ocultar objectos que são mais pequenos do que um tamanho mínimo, o que é útil para obter exportações claras. <value> pode ser um valor de tamanho com unidade, ou um valor de byte simples sem unidade. Não foi possível ser usado em combinação com /EXPAND. Neste exemplo, apenas as pastas com um tamanho mínimo de 50 MB serão exportadas:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <nome do ficheiro>¶
Guarda o gráfico no separador «Histórico» do diretório analisado num ficheiro bitmap, GIF, PNG ou JPEG. O tipo de ficheiro depende da extensão do nome de ficheiro especificado. Este exemplo cria uma imagem JPEG do gráfico do histórico para a disco C:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <nome do ficheiro>¶
Guarda os dados recolhidos num ficheiro HTML que pode ser visualizado com qualquer navegador HTML. Pode especificar quais as informações da análise que serão incluídas na exportação através de «Página inicial > Opções > Exportar > HTML > Gráficos e listas a incluir. Pode selecionar quais as listas ou gráficos adicionais que devem ser adicionadas à exportação. Estes serão automaticamente incorporados no ficheiro HTML que é gerado após a análise.
O exemplo seguinte irá gerar um relatório HTML para a disco C: e guardá-lo em «D:\HTML»:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
Se pretender que mais do que uma análise faça parte do ficheiro HTML, deve adicionar a opção da linha de comandos /GROUPSCANS. Quando exportar para HTML sem uma imagem incluída, pode, em alternativa, utilizar o interrutor /APPENDTOFILES. Sem um destes sinalizadores, o ficheiro HTML será substituído.
/IMPORT <nome do ficheiro>¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Carrega uma lista de caminhos para a interface de utilizador da pesquisa de ficheiros do TreeSize. O ficheiro pode estar em formato .txt ou .csv. Este parâmetro pode ser usado para importar resultados de uma procura anterior. Os ficheiros e pastas importados podem ser movidos/copiados/eliminados/arquivados, como qualquer resultado de pesquisa «vivo», usando o diálogo de operação de ficheiros.
Exemplo:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
Pode também combinar este parâmetro com os parâmetros /RECYCLE, /DELETE, ou /MOVE para eliminar ou mover automaticamente os ficheiros que estão contidos no ficheiro de texto. Exemplo:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <nome do ficheiro>¶
Importa uma lista de padrões de um ficheiro. O ficheiro pode ser um ficheiro de texto simples com uma lista de padrões de filtro, separados por ponto e vírgula, ou pode utilizar a interface do utilizador para criar um conjunto mais complexo de padrões e utilizar a função Exportar para gerar o ficheiro de padrões na formatação XML. As formatações suportadas são CSV, TXT e XML.
Os padrões importados serão utilizados como filtros para que a análise inclua ou exclua ficheiros e pastas específicos.
Se for utilizado em combinação com a opção da linha de comandos /SEARCH, este parâmetro criará uma nova procura avançada que utiliza os padrões do ficheiro importado como critérios para a procura.
Este exemplo importará os padrões de filtro definidos em «C:\TreeSizeFiles\patterns.txt», iniciará uma análise à disco C:\ e exportará os resultados para um ficheiro HTML:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <nome do ficheiro>¶
Guarda os resultados da análise num ficheiro SQLite que pode ser carregado para comparações numa data posterior. Exemplo:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <carácter separador>¶
Permite-lhe definir o separador utilizado ao exportar ficheiros de texto ou CSV. Os ficheiros de texto utilizam o tabulador por defeito, os ficheiros CSV o separador de listas das definições regionais do painel de controlo do Windows.
Especificar um único carácter ou a cadeia «TAB» para tabulador após esta opção. Exemplos:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <caminho>¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Move os resultados de uma pesquisa de ficheiros TreeSize para outra localização.
O seguinte comando irá procurar no disco local C: utilizando as opções de pesquisa mais recentes e move os resultados da pesquisa para a pasta «C:\Temp\ObsoleteFiles»:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
Veja também: Mover ficheiros selecionados
/NOGUI¶
Não será mostrada nenhuma janela e a aplicação não aparecerá na barra de tarefas. Útil para executar análises ou procuras em segundo plano, sem feedback visual.
Aviso
Utilize esta opção apenas se tiver testado as restantes opções da linha de comandos, porque as mensagens de erro não podem ser apresentadas neste modo.
No entanto, os erros serão registados no registo de eventos do Windows.
/NOHEADERS¶
Omite as linhas de cabeçalho normalmente escritas no topo dos ficheiros de exportação de análise ou de procura. Isto facilita a receção de dados simples para pós-processamento.
/NOUNITS¶
Omite as unidades normalmente escritas a seguir aos valores de tamanho. Esta opção em combinação com /SIZEUNIT 0 exportará valores de bytes simples. Isto facilita a receção de dados simples para pós-processamento.
Nota
Esta linha de comandos só afectará os exportados da árvore de diretórios, gerados pela utilização das opções /TEXT, /EXCEL, /HTML, /EMAIL, ou /PRINT. /EXTENSIONSLIST As opções /USERSLIST, /EXPORTDRIVESLIST, ou /TOPFILESLIST não serão afetadas.
/OPEN <nome do ficheiro>¶
Abre um relatório XML salvo no início da aplicação. Exemplo:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <nome do ficheiro>¶
Utilize este parâmetro para aplicar as definições de utilizador exportadas ao TreeSize. As definições de utilizador podem ser exportadas em «File > Options > Export». Exemplo:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
Nota
Altere o maior número possível de definições na interface do utilizador antes de salvar as opções para reduzir a quantidade de parâmetros da linha de comandos que necessita.
/PDF¶
Salva os resultados em um ficheiro PDF após a análise ou pesquisa ser concluída. A aplicação será encerrada após a gravação. O seguinte exemplo executará uma análise do seu disco local C: e salvará os resultados em um ficheiro PDF:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <nome do ficheiro>¶
Salva o gráfico de setores do diretório analisado em um bitmap, GIF, PNG ou ficheiro JPEG. O tipo de ficheiro depende da extensão do nome de ficheiro especificado. O seguinte exemplo irá analisar o disco C: e exportar um gráfico de setores em formato PNG:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
Imprime um relatório para a árvore de diretórios analisada utilizando a impressora por defeito configurada nas definições do seu sistema. A aplicação será encerrada após a impressão. Exemplo:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <valor>¶
Se o valor for definido como verdadeiro, esta opção ativa um modo de somente leitura no qual as operações de ficheiros (por exemplo, mover ou eliminar) estão desativadas, portanto, será utilizável apenas como ferramenta de relatório.
Comece com um valor de falso para desativar novamente o modo de somente leitura.
/RECYCLE¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Move todos os ficheiros para a lixeira que foram encontrados como resultado de uma pesquisa de ficheiros do TreeSize. Exemplo:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
Veja também: Mover ficheiros selecionados
/RESTRICTEDMODE <valor>¶
Se o valor for definido como verdadeiro, esta opção ativa um modo restrito no qual muitas funcionalidades estão desativadas que não são do interesse de utilizadores «normais» (não administradores). Entre as funcionalidades desativadas estão: Verificar Atualização, Abrir applet de Software do Painel de Controle do Windows, Agendar análises do TreeSize, conectar disco de rede, configurar a Restauração do Sistema do Windows, Executar como administrador, exportações e aplicar compressão NTFS. Você pode fornecer um caminho que deve ser analisado, por exemplo, o diretório pessoal do utilizador, na linha de comandos ou utilizando os Caminhos de Início em um ficheiro de configuração salvo.
Comece com um valor de falso para desativar novamente o modo restrito.
Se ativar adicionalmente a opção /READONLYMODE, o utilizador não poderá eliminar ou mover ficheiros no TreeSize, pelo que este poderá ser utilizado apenas como ferramenta de relatório.
/SCAN <caminho|nome do ficheiro>¶
Define qual disco ou caminho deve ser analisado. O caminho de análise deve ser utilizado como valor para este parâmetro.
Se, por exemplo, o disco D:\ deve ser analisado, pode utilizar:
Treesize /SCAN "D:\"
Se você não quiser analisar o disco inteiro, também pode especificar um caminho, que é utilizado como ponto de partida para a análise. Por exemplo:
TreeSize /SCAN "\\Server\Share\MyDocuments"
Múltiplos caminhos de análise também são possíveis, sendo separados por um espaço em branco. Caminhos que contêm um espaço em branco devem ser colocados entre aspas («). Exemplo:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
Os caracteres curinga «*» e «?» são permitidos. Exemplo:
Treesize /SCAN "H:\users\A*"
Também pode especificar um ficheiro de texto, que contém uma lista de caminhos que devem ser analisados. O TreeSize analisará todos os caminhos que forem encontrados no ficheiro de texto, que é especificado após esta opção. O ficheiro de texto tem de conter um caminho por linha. O exemplo seguinte analisa todos os caminhos encontrados no ficheiro «D:\PathsToScan.txt» e escreve cada resultado da análise numa folha separada de um File Excel com a data de hoje:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
Você também pode chamar o TreeSize em um loop «for» com apenas um dos caminhos, por favor, encontre um exemplo abaixo.
/SEARCH¶
Abre a janela Procurar Ficheiros do TreeSize. Se «:Start» for adicionada a esta opção da linha de comandos, a Procurar é iniciada automaticamente. Pode ser passado um ficheiro XML anteriormente guardado que contenha definições de Procurar, estas definições serão então utilizadas para realizar a procura.
Nota
Os ficheiros que são encontrados nesta pesquisa são automaticamente verificados.
O seguinte exemplo realiza a pesquisa com configurações que foram salvas anteriormente no ficheiro «SearchSettings.xml» e salva os resultados em um ficheiro de texto:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
Nota
Em geral, serão utilizadas as últimas definições de pesquisa ou um conjunto de definições de pesquisa guardado anteriormente. No entanto, também pode especificar os padrões de pesquisa para a pesquisa avançada utilizando a opção de linha de comandos /FILTER.
/SHEETNAME ¶
Permite especificar o nome da folha que será adicionada a um ficheiro Excel ao utilizar a opção de linha de comandos /EXCEL.
Nota
Um nome de folha do Excel deve ser único em um ficheiro Excel e certos caracteres especiais, como barras, barras invertidas e dois pontos, são proibidos. O TreeSize sempre criará um nome de folha único substituindo caracteres inválidos por sublinhados e adicionando a data e a hora, se necessário. Se uma folha com o nome especificado já existir no ficheiro alvo, uma nova folha com um nome único será criada. Use a opção de linha de comandos /APPENDTOFILES para adicionar os dados à folha existente.
/SHORTDATEFORMAT <formatação>¶
Altera a formatação da data curta para este processo, que pode ser configurada nas opções regionais do Painel de Controle do Windows. As exportações do TreeSize usarão este formato para valores de data. Exemplo:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
Esta opção pode ser utilizada para especificar a unidade a ser usada para mostrar os valores de tamanho: N pode ter valores de 0 a 5, como: 0 = Bytes, 1 = KB, 2 = MB, 3 = GB, 4 = TB, 5 = Unidades Automáticas. Sem esta opção, a última configuração utilizada no TreeSize será usada.
/SORTBY <ColumnName>¶
Permite-lhe especificar o valor pelo qual as exportações geradas serão ordenadas. Os valores possíveis são nomes de colunas como «Size» ou «Name». O último tipo de ordenação usado na interface de utilizador do TreeSize será usado por defeito. Exemplo:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <nome do ficheiro>¶
Guarda os resultados da análise num ficheiro SQLite que pode ser carregado para comparações numa data posterior. Exemplo:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <subjectos>¶
Esta opção permite personalizar o assunto que será utilizado para os e-mails enviados ao final da análise. Exemplo:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <nome do ficheiro>¶
Salva os resultados em um arquivo de texto ou CSV após a análise ou pesquisa ser concluída. A aplicação será encerrada após a gravação. O seguinte exemplo executará uma análise do seu disco local C: e salvará os resultados em um arquivo de texto:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
O formato de texto utiliza uma formatação tabular que tem como alvo os leitores humanos. Se o nome do ficheiro fizer referência a um ficheiro CSV, a formatação CSV será utilizada automaticamente. Se pretender utilizar explicitamente a formatação CSV, recomendamos a utilização do parâmetro /CSV.
/TITLE <title>¶
Pode ser usado para substituir o caminho raiz de uma análise por um texto personalizado. Isso permite fornecer nomes mais significativos para caminhos UNC, por exemplo, e assim aumentar a leitura de um relatório. O título escolhido será aplicado como o título do relatório ao exportar um arquivo. Exemplo:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
No contexto de uma pesquisa de ficheiros no TreeSize, este parâmetro pode ser usado para nomear uma pesquisa avançada. Exemplo:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <nome do ficheiro>¶
Esta opção permite salvar o conteúdo da lista de Top ficheiros em um arquivo Excel, HTML, Texto ou CSV. O tipo de arquivo depende da extensão do nome do arquivo especificado. Exemplo:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <nome do ficheiro>¶
Salva o gráfico do mapa de árvores da árvore de diretórios analisada como um arquivo bitmap, GIF, PNG ou JPEG. O tipo de arquivo depende da extensão do nome do arquivo especificado. Exemplo:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
Define o nível da interface do utilizador. Os valores possíveis são Simple, Normal, ou Expert. Exemplo:
Treesize /UILevel "Simple"
/USERSLIST <nome do ficheiro>¶
Esta opção permite salvar as estatísticas mostrando os resultados agrupados por nome de usuário em um arquivo Excel, HTML, Texto ou CSV. O tipo de arquivo depende da extensão do nome do arquivo especificado. As colunas exportadas serão aquelas que estavam habilitadas na interface do usuário na aba «Usuários» quando foi utilizada pela última vez, ou no momento em que o arquivo de configuração fornecido via /OPTIONS foi escrito.
O exemplo seguinte analisa o disco C: e cria um ficheiro Excel em «C:\Temp» com as estatísticas dos utilizadores deste disco:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <nome de utilizador>¶
Especifica o nome de utilizador que deve ser utilizado para autenticar as análises. Utilize /PASSWORD para especificar uma palavra-passe para este nome de utilizador. Recomenda-se a utilização da ferramenta da Microsoft RUNAS.
/USERFILTER <nome de utilizador>¶
Com esta opção, apenas os ficheiros pertencentes a um determinado utilizador serão considerados durante a análise. Forneça o nome deste utilizador após este comando.
Nota
Não é possível utilizar múltiplos nomes de utilizador aqui, mas os caracteres curinga «*» e «?» são suportados.
Exemplo:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <nome do ficheiro>¶
Salva o pequeno gráfico mostrado na parte inferior da página «Utilizadores» em um ficheiro de imagem (bitmap, GIF, PNG ou JPEG).
/USERSPIECHART <nome do ficheiro>¶
Salva um gráfico de setores que mostra as «estatísticas de utilizadores» da análise atual em um ficheiro de imagem (bitmap, GIF, PNG ou JPEG).
/VIEWTYPE n¶
Define em quais valores se baseiam a «Percentagem de Origem», as colunas de «Crescimento» e o gráfico de «Idade dos Ficheiros». Os valores possíveis são:
2: Tamanho 3: Espaço Alocado (Tamanho no disco) 7: Número de Ficheiros
/XML <nome do ficheiro>¶
Salva os resultados da análise em um ficheiro XML que pode ser carregado para comparações em uma data posterior. Exemplo:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
Esta opção pode ser combinada com a opção /EXPAND para limitar os diretórios exportados.
Nota
Ao carregar uma exportação XML limitada para o TreeSize, não é possível navegar por toda a ramificação de diretórios, mas apenas pelos diretórios exportados.
/ZIP <nome do ficheiro>¶
Esta opção só pode ser utilizada em combinação com a opção da linha de comandos /SEARCH.
Todos os ficheiros que foram encontrados como resultado de uma pesquisa de ficheiros no TreeSize serão movidos para um arquivo zip. Exemplo:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
Veja também: Mover ficheiros selecionados
<SCANPATH>¶
Para além do parâmetro /SCAN, também pode passar um ou mais caminhos no final da linha de comandos. No entanto, isto já não é recomendado para evitar erros aquando da análise da linha de comandos.
Este exemplo analisa os ficheiros «Program Files» e a pasta «Windows» e cria um relatório de texto em «C:\Reports\ScanResults.txt»:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
Caso ocorra um erro, ele será retornado como código de erro do Windows no código de saída do processo. Variáveis de ambiente (por exemplo, %APPDATA%) podem ser usadas em nomes de ficheiros para a exportação, bem como nos caminhos analisados.
Analisando Múltiplos Diretórios¶
Se você precisar analisar múltiplos diretórios, pode ser uma boa ideia mesclar várias chamadas em um arquivo Batch, por exemplo:
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"
O comando «START /WAIT» garante que as tarefas comecem sequencialmente. Não iniciar as tarefas em paralelo geralmente é melhor, pois uma única tarefa aproveita mais os caches e os recursos do sistema. Também é possível armazenar os compartilhamentos que devem ser analisados em um ficheiro de texto e usar o comando «for» do Windows assim:
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
Os caracteres de porcentagem duplos são necessários em arquivos batch; na linha de comandos, use apenas uma porcentagem.
Início Agendado¶
Você pode usar o Agendador de Tarefas do Windows para executar o TreeSize com certas opções de linha de comandos diariamente, semanalmente ou mensalmente em um horário específico. O diálogo para Agendamento de análises ajudará você a configurar uma tarefa agendada.
Você também pode usar o comando SCHTASKS para realizar análises agendadas. Se você, por exemplo, quiser analisar as unidades C: e E: na próxima noite às 03:00 a.m. e salvar os resultados em um ficheiro Excel, você poderia usar a seguinte linha 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"
Obtenha ajuda sobre o comando SCHTASKS nas páginas da Microsoft ou digitando:
SCHTAKS /Create /?
Nota
Mensagens de erro ocorrendo durante análises agendadas são listadas no registo de eventos do Windows do sistema.
PowerShell¶
Windows PowerShell pode ser útil em combinação com TreeSize. Este exemplo mostra como Procurar um par de computadores remotos que são consultados usando uma consulta LDAP no Active Diretory (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
Redirecionando Saída¶
Se nenhum outro alvo de exportação for dado, o TreeSize escreverá uma breve exportação da análise na saída padrão e os erros que ocorreram durante a análise na saída de erro padrão.
Você pode redirecionar esses fluxos de saída na linha de comandos (cmd.exe) usando o símbolo pipe, por exemplo:
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
Para redirecionar a saída usando o PowerShell, por favor, use o comando Start-Process em vez disso, por exemplo:
Início -Process -FilePath «C:\Program Files\JAM Software\TreeSize\Treesize.exe» -ArgumentList «/NOGUI /SCAN C:\» -RedirectStandardOutput «.\StdOut.txt» -RedirectStandardError «.\StdError.txt»
Windows Scripting Host¶
Se tenciona utilizar o Windows Scripting Host (WSH), o seu comando para iniciar o TreeSize terá o seguinte aspeto:
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 Saída¶
Se a operação foi concluída com sucesso, o código de saída é 0. Se ocorreu um erro, o TreeSize retornará um código de erro do Windows como código de saída, se disponível, ou 1 para indicar um erro geral.
Em qualquer caso, o Registo de Eventos do Windows conterá mais informações no registo «Aplicação», Fonte do Evento «TreeSize».