Opções de linha de comando

A edição Professional do TreeSize aceita opções de linha de comando que permitem executar varreduras programadas ou ter os resultados de uma varredura no monitor na manhã seguinte.

A caixa de diálogo para Agendamento de varreduras o ajudará a compilar uma linha de comando com as opções abaixo.

Note

Essas opções estão disponíveis apenas no TreeSize Professional Edition.

Todas as opções

Treesize.exe [/OPTION] SCANPATH

/? ou /HELP

Mostra esta página de ajuda.

/AGEOFFILES

Salva o gráfico na guia “Age of Files” do diretório digitalizado em um arquivo bitmap, GIF, PNG, JPEG, texto ou CSV. O tipo de arquivo depende da extensão do nome de arquivo especificado. O exemplo a seguir cria um arquivo de imagem JPEG do gráfico “Age of Files” para a unidade local C:

Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"

/APPENDTOFILES <valor>

Com essa opção, você pode selecionar se o TreeSize deve ou não anexar sua saída aos arquivos existentes ao fazer uma exportação, por exemplo, ao usar /TEXT. Selecione “True” para anexar e “False”, se quiser substituir os arquivos existentes.

Note

Esse parâmetro não funcionará com imagens exportadas, arquivos XML e PDF. Esses arquivos sempre serão sobrescritos. Você pode usar a opção /DATE para garantir que todos os relatórios gerados tenham um nome de arquivo exclusivo.

Ao Exportar para um arquivo Excel via /EXCEL, esse parâmetro pode ser usado junto com /SHEETNAME para anexar os dados à planilha 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

Essa opção incluirá somente arquivos para os quais o bit de arquivamento esteja definido nas verificações. Essa opção pode ser muito útil se você quiser calcular o tamanho de um backup. Nesse caso, é possível criar um atalho na área de trabalho ou no menu Iniciar que iniciará automaticamente o cálculo do tamanho do backup. Exemplo:

Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"

/ATTACH

Se especificado, todos os arquivos exportados serão anexados ao e-mail. Se não for especificado, os arquivos com um caminho fornecido explicitamente não serão anexados. Isso é útil caso seus arquivos XML ou Excel estejam ficando muito grandes e encham sua conta de e-mail.

Este exemplo exportará para um arquivo do Excel, mas não o anexará ao e-mail:

TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"

Esses 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 arquivo>

Salva o gráfico de barras do diretório digitalizado 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 a unidade local C:

Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"

/COMPARE <nome do arquivo|caminho>

Compara o caminho escaneado com um arquivo de índice salvo. O exemplo a seguir escaneia a unidade C: e compara o resultado com um relatório XML salvo para essa unidade:

Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"

Em vez de um arquivo de índice, você também pode usar um caminho com esse parâmetro de linha de comando. O caminho fornecido será comparado com o resultado da varredura atual. O exemplo a seguir verifica a unidade C:\e usa adicionalmente o caminho D:Backup_of_C para realizar uma comparação entre os dois:

Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"

Como alternativa, você pode comparar dois arquivos de índice já existentes, por exemplo, “c1.xml.zip” e “c2.xml.zip”, usando 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 arquivos expandindo o primeiro arquivo (“c1.xml.zip”) em um arquivo de verificação. O segundo arquivo (“c2.xml.zip”) será comparado a esse arquivo de varredura expandido, exatamente como aconteceria se “c2.xml.zip” fosse comparado a uma varredura “real”.

/COPY <caminho>

Essa opção só pode ser usada em conjunto com a opção de linha de comando /SEARCH.

Copia os resultados de uma pesquisa de arquivo do TreeSize para o local de destino.

O comando a seguir pesquisará em sua unidade local C: usando as opções de pesquisa mais recentes e copiará os resultados da pesquisa para a pasta “C:\temp\ObsoleteFiles”:

Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"

Consulte também: Mover arquivos verificados

/CREATEDPASTDAYSONLY <n>

Essa opção incluirá nas varreduras apenas os arquivos que foram criados durante o número de dias inserido no argumento. No exemplo a seguir, essa opção incluirá na varredura apenas os arquivos criados durante os últimos oito dias:

Treesize /CREATEDPASTDAYSONLY 8

/CREATESNAPSHOT <drive>

Cria uma imagem capturada para as unidades que são fornecidas após esse parâmetro de linha de comando. Exemplo:

Treesize /CREATESNAPSHOT "C:\" "D:\"

A criação de instantâneos pode exigir privilégios administrativos.

/CSV <nome do arquivo>

Salva os resultados em um arquivo CSV após a conclusão da varredura ou da pesquisa. O aplicativo será encerrado após o salvamento. Este exemplo salvará os resultados de uma pesquisa de arquivos na unidade local C: com as últimas configurações de pesquisa em um arquivo CSV:

Treesize /SEARCH:Start /SCAN  "C:\" /CSV "C:\Results\C_search.csv"

/DATE

Essa opção adicionará a data e a hora atuais a todos os nomes de arquivos de exportação na linha de comando. Isso é útil se você quiser fazer varreduras regularmente, por exemplo, todas as noites ou todos os finais de semana. O exemplo a seguir fará a varredura do caminho de rede “\\Host\Share” e salvará o resultado em um arquivo como “C:\Scans\name_2013-08-14_17-18-24.xls”:

Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"

/DEDUPLICATE

Essa opção só pode ser usada em conjunto com a opção de linha de comando /SEARCH.

Ele substituirá os arquivos duplicados que foram encontrados pela pesquisa de arquivos duplicados do TreeSize por hardlinks NTFS:

Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE

/DELETE

Essa opção só pode ser usada em conjunto com a opção de linha de comando /SEARCH.

Exclui permanentemente todos os arquivos que foram encontrados como resultado de uma pesquisa de arquivos do TreeSize. Exemplo:

Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE

Consulte também: Mover arquivos verificados

/EMAIL <recipiente>

Envia os dados coletados para o endereço de e-mail fornecido. Esse parâmetro pode ser usado apenas uma vez na linha de comando, 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 por meio da linha de comando, é necessário especificar configurações SMTP válidas na página correspondente da caixa de 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 quiser definir o formato independentemente das opções atuais, você poderá 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 exemplo a seguir adicionará um relatório do Excel sobre a varredura como anexo do e-mail:

Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL

/EMAILIFRESULTSFOUND

Essa opção só pode ser usada em combinação com as opções de linha de comando /SEARCH e /EMAIL. Se esse parâmetro for especificado, o TreeSize só enviará um e-mail com os resultados da pesquisa atual se pelo menos um arquivo ou pasta tiver sido encontrado durante a pesquisa, por qualquer um dos tipos de pesquisa especificados.

/EMPTYRECYCLEBIN

Se você usar essa opção, o TreeSize esvaziará a lixeira antes de executar a varredura atual. Exemplo:

Treesize /EMPTYRECYCLEBIN /SCAN "C:\"

/EXECUTE

Essa opção só pode ser usada em conjunto com a opção de linha de comando /SEARCH.

Esse parâmetro permite passar arquivos que foram encontrados pela pesquisa de arquivos do TreeSize para outro aplicativo ou script. Um possível destino para esse parâmetro pode ser um lote ou um script powershell. O exemplo a seguir pesquisará a unidade C:\ com as configurações de pesquisa mais recentes e chamará o script “Archive.bat” para cada arquivo encontrado. O arquivo será passado para o script como parâmetro de linha de comando:

Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"

Consulte também: Mover arquivos verificados

/EXCEL <caminho do arquivo>

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 .XLS convencional (Excel 97-2003) e o formato .XLSX (introduzido com o Excel 2007). O formato usado depende da extensão do nome do arquivo especificado. O aplicativo 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.

Note

No site TreeSize File Search (/SEARCH), os resultados de cada tipo de pesquisa são coletados em sua própria planilha específica. Se o arquivo no caminho fornecido já existir, essas planilhas serão substituídas. Para evitar isso, você precisa usar a opção de linha de comando /APPENDTOFILES.

/EXCLUDE <padrão1;padrão2>

Essa opção permite especificar padrões para arquivos e pastas que devem ser excluídos de uma varredura. Vários padrões de exclusão podem ser separados por ponto e vírgula (;). Se um ou mais padrões contiverem espaços, a cadeia de caracteres completa do padrão deverá ser colocada entre aspas (“). O exemplo a seguir ignorará arquivos e pastas que terminem com “.tmp” ou cujo nome exato seja “system”:

Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"

/EXPAND <nível|tamanho>

Esta opção permite que você especifique quantos níveis na árvore de diretórios serão expandidos após a verificação. Se você não especificar um número após essa opção, todas as pastas serão expandidas. Em vez de um nível de diretório, você também pode indicar uma quantidade em Mega Bytes (MB). Nesse caso, todas as pastas maiores que a quantidade fornecida serão expandidas. A unidade “MB” deve seguir o número, sem espaço em branco. O exemplo a seguir fará a verificação da pasta. “H:\Usuário”, expandirá todas as pastas maiores que 10 MB e salvará o resultado no arquivo Excel “C:\Results\Allusers.xlsx”:

Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB

/EXPANDABLEREPORT <valor>

Se essa opção for usada, as exportações do Excel usarão grupos expansíveis/colapsá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 arquivo>

Essa opção permite exportar o conteúdo da “Drive List” para um arquivo Excel, de texto ou CSV. O tipo de arquivo depende da extensão do nome de arquivo especificado. Exemplo:

Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST

/EXPORTFILES

Se especificado, os arquivos serão incluídos em todas as exportações. Portanto, essa opção é equivalente a ativar a opção “Ferramentas > Opções > Exportar > * > Elementos exportados > Pastas e arquivos 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 arquivo>

Essa opção só pode ser usada em conjunto com a opção de linha de comando /SEARCH.

Exporta uma lista simples que contém todos os resultados da pesquisa. A lista conterá apenas os caminhos completos dos resultados da pesquisa e nenhuma outra informação. Os formatos suportados para o arquivo de destino são .txt e .csv.

Este exemplo pesquisará e criará uma lista de todos os arquivos exe na unidade C:

Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"

Ele pode ser usado para importar os resultados de uma pesquisa anterior de volta para a interface do usuário, usando “File > List of paths > Import path list” ou o parâmetro /IMPORT.

Se a opção “Tools > Options > Export > Include duplicate groups” (Ferramentas > Opções > Exportar > Incluir grupos duplicados) estiver ativada, você também poderá usar essa função para exportar e importar resultados da pesquisa de duplicatas, incluindo a estrutura de grupos.

/EXPORTTITLE