コマンドラインオプション¶
TreeSize の Professional Edition では、コマンドラインオプションを使用することで、スケジュールされたスキャンを実行したり、スキャン結果を翌朝モニターに表示したりすることができる。
スキャンのスケジューリング のダイアログは、以下のオプションでコマンドラインをコンパイルするのに役立ちます。
注釈
これらのオプションは、TreeSize Professional Edition でのみ利用可能です。
すべてのオプション¶
Treesize.exe [/OPTION] SCANPATH
/それとも? /HELP¶
このヘルプページを表示します。
/AGEOFFILES¶
スキャンしたディレクトリの「ファイルの年齢」タブのグラフをビットマップ、GIF、PNG、JPEG、テキスト、またはCSVファイルに保存します。ファイルの種類は指定されたファイル名の拡張子によって決まります。以下の例は、ローカルドライブCの「ファイルの年齢」グラフのJPEG画像ファイルを作成します:
Treesize /SCAN "C:\" /AGEOFFILES "C:\Documents\c_file_ages.jpg"
/APPENDTOFILES <値¶
このオプションでは、/TEXT などのエクスポート時に、TreeSize の出力を既存のファイルに追加するかどうかを選択できます。既存のファイルを上書きする場合は、"True" を選択し、"False" を選択します。
注釈
このパラメータは、エクスポートされた画像、XML、PDFファイルでは機能しません。これらのファイルは常に上書きされます。スイッチ /DATE を使用すると、生成されるすべてのレポートが一意のファイル名を持つようになります。
/EXCEL を使って Excel ファイルにエクスポートする場合、このパラメータを /SHEETNAME とともに使用することで、指定したシートにデータを追加することができます。例:
Treesize.exe /SCAN "C:\" /APPENDTOFILES True /EXCEL "C:\Export.xlsx" /SHEETNAME "test"
Treesize.exe /SCAN "C:\" /APPENDTOFILES False /TEXT "C:\Export.csv"
/ARCHIVEBITFILESONLY¶
このオプションは、スキャンでアーカイブビットが設定されているファイルのみを含めます。このオプションは、バックアップのサイズを計算したい場合に非常に便利です。この場合、デスクトップまたはスタートメニューにショートカットを作成して、バックアップのサイズを自動的に計算することができます。例:
Treesize /ARCHIVEBITFILESONLY /SCAN "\\Server\Backup\This"
/ATTACH¶
指定された場合、すべてのエクスポートされたファイルがメールに添付されます。指定されていない場合、明示的に指定されたパスのファイルは添付されません。これは、XMLまたはExcelファイルが非常に大きくなり、メールアカウントを圧迫する場合に便利です。
この例は、Excelファイルにエクスポートしますが、メールには添付しません:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL "C:\Temp\test.xlsx"
これらの例は、Excelファイルをメールに添付します:
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /EXCEL
TreeSize.exe /SCAN "F:\" /EMAIL "treesize@example.com" /ATTACH /EXCEL "C:\Temp\test.xlsx"
/BARCHART <ファイル名¶
スキャンしたディレクトリの棒グラフをビットマップ、GIF、PNG、またはJPEGファイルに保存します。ファイルの種類は指定されたファイル名の拡張子によって決まります。この例は、ローカルドライブCの棒グラフのPNG画像ファイルを作成します:
Treesize /SCAN "C:\" /BARCHART "C:\Documents\c.png"
/COMPARE <ファイル名|パス¶
スキャンしたパスを保存されたインデックスファイルと比較します。以下の例は、ドライブCをスキャンし、その結果をこのドライブの保存されたXMLレポートと比較します:
Treesize /COMPARE "C:\Reports\TreeSize\c.xml.zip" /SCAN "C:\"
インデックスファイルの代わりに、このコマンドラインパラメータでパスを指定することもできる。指定されたパスは、現在のスキャン結果と比較されます。以下の例では、ドライブ C:∕をスキャンし、さらにパス D:∕Backup_of_C を使用して 2 つの比較を実行します:
Treesize /SCAN "C:\" /COMPARE "D:\Backup_of_C"
既存のインデックスファイル「c1.xml.zip」と「c2.xml.zip」を比較するには、次のコマンドを使用します:
Treesize /OPEN "C:\Reports\TreeSize\c1.xml.zip" /COMPARE "C:\Reports\TreeSize\c2.xml.zip"
/OPEN コマンドは、最初のファイル("c1.xml.zip")をスキャンファイルに展開することで、2つのファイルの比較を準備する。2番目のファイル("c2.xml.zip")は、"c2.xml.zip "が "本物の "スキャンファイルと比較される場合と同じように、この展開されたスキャンファイルと比較される。
/COPY <パス¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索の結果をターゲット場所にコピーします。
以下のコマンドは、最新の検索オプションを使用してローカルドライブC:を検索し、検索結果を "C:∕∕ObsoleteFiles "フォルダにコピーする:
Treesize /SEARCH:Start /SCAN "C:\" /COPY "C:\temp\ObsoleteFiles"
参照: チェックされたファイルを移動
/CREATEDPASTDAYSONLY <n>¶
このオプションは、引数に入力された日数の間に作成されたファイルのみをスキャンに含めます。次の例では、このオプションはスキャンに過去8日間に作成されたファイルのみを含めます:
Treesize /CREATEDPASTDAYSONLY 8
/CREATESNAPSHOT <ドライブ¶
このコマンドライン パラメーター実行後に、指定したドライブのスナップショットを作成します。例:
Treesize /CREATESNAPSHOT "C:\" "D:\"
スナップショットの作成には管理者権限が必要な場合があります。
/CSV <ファイル名¶
スキャンまたは検索が終了した後、結果をCSVファイルに保存します。アプリケーションは保存後に自動的に終了します。この例では、ローカルドライブC:でのファイル検索の結果を最後の検索設定でCSVファイルに保存します:
Treesize /SEARCH:Start /SCAN "C:\" /CSV "C:\Results\C_search.csv"
/DATE¶
このスイッチは、コマンドライン内のすべてのエクスポートファイル名に現在の日付と時刻を追加します。これは、毎晩や毎週末など、定期的にスキャンを行いたい場合に便利です。The following example will scan the network path "\\Host\Share" and save the result to a file like "C:\Scans\name_2013-08-14_17-18-24.xls":
Treesize /SCAN "\\Host\Share" /DATE /EXCEL "C:\Scans\name.xls"
/DEDUPLICATE¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeの重複ファイル検索によって見つかった重複ファイルをNTFSハードリンクで置き換えます:
Treesize /SEARCH:Start /SCAN "C:\" /DEDUPLICATE
/DELETE¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索の結果として見つかったすべてのファイルを完全に削除します。例:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /DELETE
参照: チェックされたファイルを移動
/EMAIL <受信者¶
収集されたデータを指定されたメールアドレスに送信します。このパラメータはコマンドライン上で一度だけ使用可能で、すべての結果をまとめた 1 通のメールが送信されます。複数の宛先を指定する場合は、セミコロン(;)またはカンマ(,)で区切ってください。コマンドライン経由でメールを送信するには、TreeSize のオプション ダイアログ内の該当ページで有効な SMTP 設定を指定することが必要です。例:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com"
他のパラメータが指定されていない場合、メールはオプション設定で指定された形式(HTML またはプレーンテキスト)で送信されます。現在の設定とは別に形式を指定したい場合は、宛先アドレスのすぐ後に /TEXT または /HTML パラメータを追加してください。例:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /TEXT
パラメータを組み合わせることで、電子メールに添付ファイルを追加することもできます。以下の例では、スキャンのExcelレポートをメールに添付しています:
Treesize /SCAN "\\Server\Share" /EMAIL "treesize@example.com" /EXCEL
/EMAILIFRESULTSFOUND¶
このオプションは、コマンド ライン オプション /SEARCH および /EMAIL と組み合わせてのみ使用できます。このパラメータを指定すると、TreeSize は、指定した検索タイプで検索中に少なくとも 1 つのファイルまたはフォルダが見つかった場合にのみ、現在の検索結果を電子メールで送信します。
/EMPTYRECYCLEBIN¶
このオプションを使用すると、TreeSize は現在のスキャンを実行する前にごみ箱を空にします。例:
Treesize /EMPTYRECYCLEBIN /SCAN "C:\"
/EXECUTE ¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
このパラメータを使用すると、TreeSize ファイル検索で検出されたファイルを別のアプリケーショ ンやスクリプトに渡すことができます。このパラメータのターゲットは、バッチまたは powershell スクリプトです。次の例では、最新の検索設定でドライブ C:³³ を検索し、見つかった各ファイルに対してスクリプト "Archive.bat" を呼び出します。ファイルはコマンドラインパラメータとしてスクリプトに渡されます:
Treesize /SEARCH:Start /SCAN "C:\" /EXECUTE "C:\Scripts\Archive.bat"
参照: チェックされたファイルを移動
/EXCEL <ファイルパス¶
収集したデータを Microsoft Excel 形式でエクスポートし、入力されたファイルパスの下に保存します。ファイル名のみが指定された場合は、現在のインストール ディレクトリがエクスポートの保存に使用されます。対応しているファイル形式は、従来の .XLS ファイル形式(Excel 97-2003)と .XLSX 形式(Excel 2007で導入)です。使用されるフォーマットは、指定されたファイル名の拡張子によって異なります。保存後、アプリケーションは終了します。例:
Treesize /SCAN "C:\" /EXCEL "C:\Documents\c.xls"
ファイル名がすでに存在する場合は、そのファイルが開かれ、新しいワークシートが追加されます。
注釈
TreeSize File Search (/SEARCH) では、各検索タイプの結果は、それぞれ固有のワークシートに集められる。指定されたパスのファイルがすでに存在する場合、これらのシートは上書きされる。これを防ぐには、コマンドラインオプション /APPENDTOFILES を使用する必要があります。
/EXCLUDE <パターン1;パターン2¶
このオプションを使用すると、スキャン対象から除外するファイルやフォルダのパ ターンを指定できます。複数の除外パターンをセミコロン(;)で区切ることができます。パターンの 1 つ以上にスペースが含まれる場合は、パターン文字列全体を引用符 (") で囲む必要があります。次の例では、".tmp "で終わるファイルやフォルダ、または正確な名前が "system "であるファイルやフォルダを無視する:
Treesize /SCAN "\\Server\Users" /EXCLUDE "*.tmp;system"
/EXPAND <レベル|サイズ¶
このオプションでは、スキャン後にディレクトリツリーの何階層を展開するかを指定できる。このオプションの後に数値を指定しないと、すべてのフォルダが展開される。ディレクトリレベルの代わりに、メガバイト (MB) 単位で指定することもできる。この場合、指定した量より大きいすべてのフォルダが展開される。単位 "MB "は、番号の後に空白なしで続く必要があります。以下の例では、「H:◆User」フォルダをスキャンし、10MB以上のフォルダを全て展開し、その結果をExcelファイル「C:◆Results◆Allusers.xlsx」に保存します:
Treesize /SCAN "H:\User" /EXCEL "C:\Results\Allusers.xlsx" /EXPAND 10MB
/EXPANDABLEREPORT <値¶
このオプションを使用すると、エクセルのエクスポートでは、ディレクトリツリーのようにナビゲートできる展開可能/折りたたみ可能なグループが使用されます。
Treesize /SCAN "H:\User" /EXPANDABLEREPORT True /EXCEL "C:\Results\Allusers.xlsx"
Treesize /SCAN "H:\User" /EXPANDABLEREPORT False /EXCEL "C:\Results\Allusers.xlsx"
/EXPORTDRIVESLIST <ファイル名¶
このオプションを使用すると、「ドライブリスト」のコンテンツをエクセル、テキスト、または CSV ファイルにエクスポートできます。ファイル形式は、指定したファイル名の拡張子によって異なります。例:
Treesize /SCAN "C:\Results\AllDrives.csv" /EXPORTDRIVESLIST
/EXPORTFILES¶
指定すると場合、ファイルはすべてのエクスポートに含まれます。つまり、このオプションは、"ツール > オプション > エクスポート > * > エクスポートされた項目 > フォルダーと単一ファイル" オプションを有効にすることと同じです
/EXPORTGROUPSEXPANDED¶
指定された場合、拡張子リストのエクスポートには、グループ内に含まれる拡張子に関するすべての情報が含まれます。
/EXPORTPATHSLIST <ファイル名¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
すべての検索結果を含む単純なリストをエクスポートします。リストには検索結果のフルパスのみが含まれ、その他の情報は含まれません。出力先ファイルとしてサポートされている形式は、.txt と .csv です。
この例では、Cドライブ上のすべてのexeファイルを検索し、そのリストを作成する:
Treesize /SEARCH:Start /SCAN "C:\" /FILTER "*.exe" /EXPORTPATHSLIST "C:\Results\SearchResults.csv"
File > List of paths > Import path list"、またはパラメータ/IMPORTを使用して、以前の検索結果をユーザーインターフェイスにインポートすることができます。
ツール > オプション > エクスポート > 重複グループを含める」オプションを有効にすると、この機能を使用して、重複検索の結果をグループ構造を含めてエクスポートおよびインポートすることもできます。
/EXPORTTITLE ¶
印刷されたレポートやエクスポートされたファイル内のタイトルを変更するために使用します。これにより、自動化された環境で TreeSize を使用する際に、ユーザーに追加情報を提供できます。環境変数の使用も可能です。例:
Treesize /SCAN "\\Server3\C$" /EXPORTTITLE "This is drive C on Server3" /PRINT
/EXTENSIONSLIST <ファイル名¶
このオプションを使用すると、スキャンされたファイルシステムブランチのファイル拡張子/ファイルタイプの統計情報をExcel、HTML、Text、またはCSVファイルに保存できます。ファイル タイプは、指定したファイル名の拡張子によって異なります。エクスポートされる列は、ユーザー インターフェイスの "拡張子" タブで最後に使用されたとき、または /OPTIONS 経由で提供された設定ファイルが書き込まれたときに有効になっていた列です。
以下の例では、C:ドライブをスキャンし、このドライブ上のファイルタイプの統計情報 を含む "D: TreeSize ReportsC_filetypes.xls" という名前のExcelファイルを作成する:
Treesize /SCAN "C:\" /EXTENSIONSLIST "D:\TreeSize Reports\C_filetypes.xls"
/EXTENSIONSCHART <ファイル名¶
拡張子」ページの下部に表示される小さなグラフを画像ファイル(ビットマップ、GIF、PNG、JPEG)に保存します。
/EXTENSIONSPIECHART <ファイル名¶
画像ファイル(ビットマップ、GIF、PNG、JPEG)の「ファイル拡張子」の分布を示す円グラフを保存します。
/FILTER <パターン1;パターン2¶
特定の拡張子を持つファイルのみをカウントするファイルフィルターを設定します。例として「.mp3」や「.doc」があります。複数のパターンをセミコロン(;)で区切って渡すことができます。以下の例では、サーバーの「Users」ディレクトリ内でMP3およびAVIファイルを検索します:
Treesize /SCAN "\\Server\Users" /EXCEL "C:\Results\UsersMediaFiles.xlsx" /FILTER "*.mp3;*.avi"
TreeSize File Search (/SEARCH) を実行する場合、/FILTER コマンド ライン スイッチを使用して、高度なファイル検索のパターンを指定することもできます。より複雑なカスタム ファイル検索を実行するには、検索オプションをファイルに保存し、結果の XML ファイルを /SEARCH の後にコマンド ラインに渡す必要があります。
/FOLLOWREPARSEPOINTS¶
このスイッチをコマンドラインに追加すると、TreeSizeはファイルシステムツリーをスキャンする際にマウントポイントや外部シンボリックリンクを追跡します。
/GROUPSCANS¶
このコマンドラインスイッチを使用すると、スキャンされたすべてのディレク トリが仮想ルートフォルダの下にグループ化される。仮想ルートフォルダが使用されないようにするには、/GROUPSCANS FALSE を使用します。
/HIDESMALLFOLDERS <値¶
最小サイズより小さいオブジェクトを非表示にすることができる。/EXPAND と組み合わせて使用することはできません。この例では、最小サイズが50MBのフォルダのみがエクスポートされます:
TreeSize /HIDESMALLFOLDERS 50MB /EXCEL "C:\Results\DriveC.xlsx" /SCAN C:\
/HISTORYCHART <ファイル名¶
スキャンされたディレクトリの「履歴」タブにあるグラフをビットマップ、GIF、PNG、またはJPEGファイルに保存します。ファイルタイプは指定されたファイル名の拡張子に依存します。この例では、ドライブCの履歴グラフのJPEG画像を作成します:
Treesize /SCAN "C:\" /HISTORYCHART "C:\Documents\c_history.jpg"
/HTML <ファイル名¶
収集したデータをHTMLファイルに保存し、任意のHTMLブラウザで表示できます。エクスポートに含めるスキャン情報は、「ホーム > オプション > エクスポート > HTML > 含めるチャートとリスト」で指定できます。追加のリストやチャートをエクスポートに追加することができます。これらはスキャン後に生成されるHTMLファイルに自動的に埋め込まれます。
以下の例は、C:ドライブのHTMLレポートを生成し、"D:˶HTML "に保存する:
Treesize /SCAN "C:\" /HTML "D:\HTML\treesize.html"
複数のスキャンをHTMLファイルの一部にしたい場合は、コマンドラインスイッチ /GROUPSCANS を追加する必要があります。これらのフラグがないと、HTMLファイルは上書きされてしまいます。
/IMPORT <ファイル名¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索のユーザーインターフェースにパスのリストを読み込みます。ファイルは.txtまたは.csv形式である必要があります。このパラメータは、以前の検索結果をインポートするために使用できます。インポートされたファイルやフォルダーは、ファイル操作ダイアログを使用して、任意の「ライブ」検索結果のように移動/コピー/削除/アーカイブできます。
例:
Treesize /SEARCH /IMPORT "C:\Results\filelist.txt"
また、このパラメータをパラメータ /RECYCLE 、/DELETE 、/MOVE と組み合わせて、テキストファイルに含まれるファイルを自動的に削除または移動することもできる。例:
Treesize /SEARCH /IMPORT "C:\Results\filesToDelete.csv" /RECYCLE
/IMPORTPATTERNS <ファイル名¶
ファイルからパターンのリストをインポートします。ファイルは、セミコロンで区切られたフィルターパターンのリストを含む単純なテキストファイルであるか、ユーザーインターフェースを使用してより複雑なパターンセットを作成し、エクスポート機能を使用してXML形式のパターンファイルを生成することができます。サポートされている形式はCSV、TXT、およびXMLです。
インポートされたパターンは、特定のファイルやフォルダーを含めるか除外するためのスキャンフィルターとして使用されます。
このパラメータをコマンドラインオプション /SEARCH と組み合わせて使用すると、インポートしたファイルのパターンを検索条件として使用する新しい高度な検索が作成されます。
この例では、"C:˶TreeSizeFiles˶patterns.txt "の下に定義されているフィルタパターンをインポートし、ドライブC:˶に対してスキャンを開始し、結果をHTMLファイルにエクスポートします:
Treesize /IMPORTPATTERNS "C:\TreeSizeFiles\patterns.txt" /SCAN "C:\" /HTML "C:\Results\scanC.html"
/INDEXFILE <ファイル名¶
スキャン結果をSQLiteファイルに保存し、後で比較のためにロードできるようにします。例:
Treesize /SCAN "H:\users\" /INDEXFILE "C:\Results\Allusers.sqlite"
/LISTSEPARATOR <区切り文字¶
テキストまたはCSVファイルをエクスポートする際に使用される区切り文字を定義できます。テキストファイルはデフォルトでタブを使用し、CSVファイルはWindowsコントロールパネルの地域設定からのリスト区切り文字を使用します。
このスイッチの後に単一の文字または「TAB」という文字列を指定してください。例:
Treesize /SCAN "C:\" /LISTSEPARATOR ; /TEXT "C:\Results\c.txt"
Treesize /SCAN "C:\" /LISTSEPARATOR TAB /TEXT "C:\Results\c.csv"
/MOVE <パス¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索の結果を別の場所に移動します。
以下のコマンドは、最新の検索オプションを使用してローカルドライブC:を検索し、検索結果を "C:∕Temp∕ObsoleteFiles "フォルダに移動する:
Treesize /SCAN "C:\" /SEARCH:Start /MOVE "C:\Temp\ObsoleteFiles"
参照: チェックされたファイルを移動
/NOGUI¶
ウィンドウは表示されず、アプリケーションはタスクバーに表示されません。視覚的なフィードバックなしでバックグラウンドでスキャンや検索を実行するのに便利です。
警告
このモードではエラーメッセージを表示できないため、他のコマンドラインオプションをテストした後にのみこのスイッチを使用してください。
ただし、エラーはWindowsイベントログに記録されます。
/NOHEADERS¶
通常、スキャンまたは検索エクスポートファイルの上部に書き込まれるヘッダー行を省略します。これにより、後処理のためにプレーンデータを受け取るのが容易になります。
/NOUNITS¶
サイズ値の後に通常書かれる単位を省略する。このオプションを /SIZEUNIT 0 と組み合わせると、プレーンなバイト値がエクスポートされる。これにより、後処理用のプレーンなデータを受け取りやすくなります。
注釈
このコマンドラインは、/TEXT, /EXCEL, /HTML, /EMAIL , /PRINT オプションを使用して生成されたディレクトリツリーのエクスポートにのみ影響します。/EXTENSIONSLIST /USERSLIST, /EXPORTDRIVESLIST, /TOPFILESLIST は影響を受けません。
/OPEN <ファイル名¶
アプリケーション起動時に保存されたXMLレポートを開きます。例:
Treesize /OPEN "C:\Reports\Drive_C.xml.zip"
/OPTIONS <ファイル名¶
このパラメータを使用して、エクスポートされたユーザー設定をTreeSizeに適用します。ユーザー設定は「File > Options > Export」でエクスポートできます。例:
Treesize /OPTIONS "C:\Temp\User Settings.xml"
注釈
オプションを保存する前に、ユーザーインターフェースで可能な限り多くの設定を変更して、必要なコマンドラインパラメータの数を減らしてください。
/PDF¶
スキャンまたは検索が完了した後、結果をPDFファイルに保存します。保存後、アプリケーションは自動的に終了します。以下の例では、ローカルドライブC:をスキャンし、結果をPDFファイルに保存します:
Treesize /SCAN "C:\" /PDF "C:\Results\C_scan.pdf"
/PIECHART <ファイル名¶
スキャンされたディレクトリの円グラフをビットマップ、GIF、PNG、またはJPEGファイルに保存します。ファイルタイプは指定されたファイル名の拡張子に依存します。以下の例では、ドライブC:をスキャンし、PNG形式で円グラフをエクスポートします:
Treesize /SCAN "C:\" /PIECHART "C:\Reports\C_pie.png"
/PRINT¶
システム設定で構成されたデフォルトプリンターを使用して、スキャンされたディレクトリツリーのレポートを印刷します。印刷後、アプリケーションは終了します。例:
Treesize /SCAN "\\SERVER\USERS" /PRINT
/READONLYMODE <値¶
値がtrueに設定されている場合、このオプションはファイル操作(例:移動または削除)が無効になる読み取り専用モードを有効にします。したがって、レポートツールとしてのみ使用可能です。
再度読み取り専用モードを無効にするには、falseの値で開始してください。
/RECYCLE¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索の結果として見つかったすべてのファイルをごみ箱に移動します。例:
Treesize /SEARCH:Start /SCAN "C:\temp" /FILTER "*.tmp" /RECYCLE
参照: チェックされたファイルを移動
/RESTRICTEDMODE <値¶
値がtrueに設定されている場合、このオプションは「通常の」(非管理者)ユーザーにとって関心のない多くの機能が無効になる制限モードを有効にします。無効にされる機能には、更新の確認、Windowsコントロールパネルのソフトウェアアプレットのオープン、TreeSizeスキャンのスケジュール、ネットワークドライブの接続、Windowsシステムの復元の構成、管理者として実行、エクスポート、NTFS圧縮の適用が含まれます。コマンドラインまたは保存された構成ファイルのスタートアップパスを使用して、スキャンするパス(例:ユーザーのホームディレクトリ)を指定できます。
再度制限モードを無効にするには、falseの値で開始してください。
さらに、/READONLYMODE オプションを有効にすると、TreeSize内のファイルを削除したり移動したりすることができなくなり、レポートツールとしてのみ使用できるようになります。
/SCAN <パス|ファイル名¶
スキャンするドライブまたはパスを定義します。このパラメータの値としてスキャンパスを使用する必要があります。
例えば、ドライブD:∕∕∕∕∕をスキャンする場合:
Treesize /SCAN "D:\"
ドライブ全体をスキャンしたくない場合は、スキャンの開始点として使用されるパスを指定することもできます。例えば:
TreeSize /SCAN "\\Server\Share\MyDocuments"
複数のスキャンパスも可能で、空白で区切られます。空白を含むパスは引用符(")で囲む必要があります。例:
Treesize /SCAN "C:\Program Files\" "C:\Windows"
ワイルドカード "*" と "?" が許可されています。例:
Treesize /SCAN "H:\users\A*"
スキャンするパスのリストを含むテキスト ファイルを指定することもできます。TreeSize は、このスイッチの後に指定されたテキスト ファイルで見つかったすべてのパスをスキャンします。テキスト ファイルには、1 行に 1 つのパスを含める必要があります。次の例では、"D:˶PathsToScan.txt" ファイルで見つかったすべてのパスをスキャンし、各スキャン結果を Excel File の別のシートに今日の日付とともに書き込みます:
Treesize /SCAN "D:\PathsToScan.txt" /EXCEL "D:\Results\%DATE%.xlsx"
TreeSize を "for" ループで呼び出すこともできます。以下に例を示します。
/SEARCH¶
TreeSize の File Search ウィンドウを開きます。このコマンド ライン オプションに ":Start" を追加すると、検索が自動的に開始されます。検索設定を含む、以前に保存した XML ファイルを渡すことができます。
注釈
この検索で見つかったファイルは自動的にチェックされます。
次の例では、以前に "SearchSettings.xml" ファイルに保存された設定で検索を実行し、結果をテキストファイルに保存します:
Treesize /SEARCH:Start /OPTIONS "SearchSettings.xml" /TEXT "T:\SearchResult.txt"
注釈
一般的には、最後に保存された検索設定、または以前に保存された検索設定が使用される。しかし、/FILTER コマンドラインオプションを使用して、詳細検索の検索パターンを指定することもできます。
/SHEETNAME ¶
/EXCEL コマンドラインスイッチを使用する際に、Excel ファイルに追加されるシート名を指定できます。
注釈
Excelシート名はExcelファイル内で一意でなければならず、スラッシュ、バックスラッシュ、コロンなどの特定の特殊文字は禁じられています。TreeSize は常に無効な文字をアンダースコアに置き換え、必要に応じて日付と時刻を追加することで一意のシート名を作成します。指定された名前のシートがターゲットファイルに既に存在する場合は、一意の名前の新しいシートが作成されます。既存のシートにデータを追加するには、コマンドラインオプション /APPENDTOFILES を使用してください。
/SHORTDATEFORMAT <フォーマット¶
このプロセスの短い日付形式を変更します。これは、Windows コントロールパネルの地域オプションで設定できます。TreeSize のエクスポートは、日付値にこの形式を使用します。例:
Treesize /SCAN "E:\" /SHORTDATEFORMAT YYYY-MM-DD /TEXT "D:\export.txt"
/SIZEUNIT <n>¶
このオプションは、サイズ値を表示するために使用される単位を指定するために使用できます:Nは0から5の値を持つことができ、意味は次の通りです:0 = バイト、1 = KB、2 = MB、3 = GB、4 = TB、5 = 自動単位。このオプションがない場合、TreeSizeで最後に使用された設定が使用されます。
/SORTBY <列名¶
生成されたエクスポートをどの値でソートするかを指定できるようにする。指定可能な値は、"Size" や "Name" のような列名です。デフォルトでは、TreeSize ユーザー インターフェイスで最後に使用されたソート タイプが使用されます。例:
Treesize /SCAN "E:\" /SORTBY Size /TEXT "D:\export.txt"
Treesize /SCAN "E:\" /SORTBY Name /EXCEL "D:\export.xlsx"
/SQLITE <ファイル名¶
スキャン結果をSQLiteファイルに保存し、後で比較のためにロードできるようにします。例:
Treesize /SCAN "H:\users\" /SQLITE "C:\Results\Allusers.sqlite"
/SUBJECT <件名¶
このオプションは、スキャンの終了時に送信されるメールに使用される件名をカスタマイズすることを可能にします。例:
Treesize /SCAN "\\Server\Share" /EMAIL treesize@example.com /SUBJECT "TreeSize Professional Scan Report"
/TEXT <ファイル名¶
スキャンまたは検索が終了した後、結果をテキストまたはCSVファイルに保存します。アプリケーションは保存後に自動的に終了します。次の例では、ローカルドライブC:のスキャンを実行し、結果をテキストファイルに保存します:
Treesize /SCAN "C:\" /TEXT "C:\Results\C_scan.txt"
テキスト形式は、人間の読者を対象とした表形式を使用します。File名がCSVファイルを参照している場合、CSVフォーマットが自動的に使用されます。CSV形式を明示的に使用したい場合は、/CSV パラメータを使用することをお勧めします。
/TITLE <タイトル¶
スキャンのルートパスをカスタムテキストで置き換えるために使用できます。これにより、UNCパスに対してより意味のある名前を提供し、レポートの可読性を向上させることができます。選択したタイトルは、ファイルをエクスポートする際のレポートのタイトルとして適用されます。例:
Treesize /SCAN "\\Server3\C$" /TITLE "C: on Data server 3" /EXCEL "C:\result.xlsx"
TreeSizeファイル検索の文脈では、このパラメータを使用して高度な検索に名前を付けることができます。例:
Treesize /SEARCH:Start /SCAN "C:\" /TITLE "Image files" /FILTER "*.jpg;*.png;*.bmp" /PDF "C:\Results\C_search.pdf"
/TOPFILESLIST <ファイル名¶
このオプションは、トップファイルリストの内容をExcel、HTML、テキスト、またはCSVファイルに保存することを可能にします。ファイルタイプは指定されたファイル名の拡張子に依存します。例:
Treesize /SCAN "C:\" /TOPFILESLIST "C:\Temp\C_top_files.txt"
/TREEMAP <ファイル名¶
スキャンされたディレクトリツリーの階層マップをビットマップ、GIF、PNG、またはJPEGファイルとして保存します。ファイルタイプは指定されたファイル名の拡張子に依存します。例:
Treesize /SCAN "C:\" /TREEMAP "C:\Dokumente\treemap.jpg"
/UILevel ¶
ユーザ・インタフェースのレベルを設定します。設定可能な値は Simple 、Normal 、または Expert です:
Treesize /UILevel "Simple"
/USERSLIST <ファイル名¶
このオプションは、ユーザー名でグループ化された結果を示す統計をExcel、HTML、テキスト、またはCSVファイルに保存することを可能にします。ファイルタイプは指定されたファイル名の拡張子に依存します。エクスポートされる列は、最後に使用されたときの「ユーザー」タブのユーザーインターフェースで有効にされた列になります。または、/OPTIONSを介して提供された設定ファイルが書き込まれた時点のものになります。
以下の例では、C:ドライブをスキャンし、このドライブ上のユーザーの統計情報を含む Excel ファイルを "C:˶Temp "に作成します:
Treesize /SCAN "C:\" /USERSLIST "C:\temp\C_users.xls"
/USERNAME <ユーザー名¶
スキャンの認証に使用するユーザー名を指定します。このユーザー名のパスワードを指定するには、/PASSWORD を使用します。代わりにマイクロソフトのツール RUNAS を使用することを推奨する。
/USERFILTER <ユーザー名¶
このオプションを使用すると、特定のユーザーが所有するファイルのみがスキャンの対象となります。このスイッチの後にこのユーザーの名前を提供してください。
注釈
ここでは複数のユーザー名を使用することはできませんが、ワイルドカード「*」および「?」はサポートされています。
例:
Treesize /SCAN "\\Server\GroupDrive" /USERFILTER miller
/USERSCHART <ファイル名¶
「ユーザー」ページの下部に表示される小さなグラフを画像ファイル(ビットマップ、GIF、PNG、またはJPEG)として保存します。
/USERSPIECHART <ファイル名¶
現在のスキャンの「ユーザー統計」を示す円グラフを画像ファイル(ビットマップ、GIF、PNG、またはJPEG)として保存します。
/VIEWTYPE n¶
「親のパーセント」、「成長」列および「ファイルの年齢」グラフが基づく値を定義します。可能な値は次のとおりです:
2: サイズ 3: 割り当てられたスペース(ディスク上のサイズ) 7: ファイル数
/XML <ファイル名¶
スキャン結果をXMLファイルに保存し、後で比較のために読み込むことができます。例:
Treesize /SCAN "H:\users\" /XML "C:\Results\Allusers.xml.zip"
このオプションは、/EXPAND スイッチと組み合わせて、エクスポートされるディレクトリを制限することができる。
注釈
制限されたXMLエクスポートをTreeSizeに読み込むと、完全なディレクトリブランチをナビゲートすることはできず、エクスポートされたディレクトリのみをナビゲートできます。
/ZIP <ファイル名¶
このオプションは、コマンドラインオプション /SEARCH と組み合わせてのみ使用できる。
TreeSizeファイル検索の結果として見つかったすべてのファイルは、zipアーカイブに移動されます。例:
Treesize /SEARCH:Start /SCAN "C:\" /ZIP "C:\OldFiles\Archive.zip"
参照: チェックされたファイルを移動
<SCANPATH>¶
パラメータ /SCAN に加えて、コマンドラインの最後に1つ以上のパスを渡すこともできる。しかし、コマンドラインの解析時のエラーを避けるため、この方法は推奨されなくなった。
この例では、"Program Files "と "Windows "フォルダをスキャンし、"C:⊖Reports⊖ScanResults.txt "の下にテキストレポートを作成する:
Treesize /TEXT "C:\Reports\ScanResults.txt" "C:\Program Files" "C:\Windows"
エラーが発生した場合、プロセスの終了コードにWindowsエラーコードとして返されます。エクスポート用のファイル名やスキャンされたパスには、環境変数(例:%APPDATA%)を使用できます。
複数のディレクトリのスキャン¶
複数のディレクトリをスキャンする必要がある場合、バッチファイルにいくつかの呼び出しを統合するのが良いアイデアかもしれません。例えば:
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"
コマンド「START /WAIT」は、ジョブが順次開始されることを保証します。ジョブを並行して開始しない方が通常は良いです。なぜなら、単一のジョブがキャッシュやシステムリソースをより多く活用できるからです。また、スキャンすべき共有をテキストファイルに保存し、次のようにWindowsの「for」コマンドを使用することも可能です:
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"
注釈
バッチファイルでは二重のパーセント文字が必要ですが、コマンドラインでは単一のパーセントのみを使用します。
スケジュールされた開始¶
Windowsのスケジュールタスクを使って、毎日、毎週、毎月の決まった時間に特定のコマンドラインオプションでTreeSizeを実行することができます。スキャンのスケジューリング のダイアログがスケジュール タスクの設定に役立ちます。
また、SCHTASKS コマンドを使用してスケジュールスキャンを実行することもできる。例えば、次の夜午前3時にC:とE:のドライブをスキャンし、その結果をExcelファイルに保存したい場合、次のコマンドラインを使用することができる:
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"
SCHTASKS コマンドに関するヘルプは、マイクロソフトのページ を参照するか、次のように入力してください:
SCHTAKS /Create /?
注釈
スケジュールされたスキャン中に発生したエラーメッセージは、システムのWindowsイベントログに記録されます。
PowerShell¶
Windows PowerShell は、TreeSize と組み合わせると便利である。この例では、Active Directory (AD)内のLDAPクエリを使用してクエリされたいくつかのリモートコンピュータを検索する方法を示します:
$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
出力のリダイレクト¶
他のエクスポートターゲットが指定されていない場合、TreeSizeはスキャンの短いエクスポートを標準出力に書き込み、スキャン中に発生したエラーを標準エラーに書き込みます。
コマンドライン(cmd.exe)でパイプ記号を使用して、これらの出力ストリームをリダイレクトできます。例:
"C:\Program Files\JAM Software\TreeSize\Treesize.exe" /NOGUI /SCAN C:\ 1>StdOut.txt 2>StdError.txt
PowerShell を使用して出力をリダイレクトするには、代わりに Start-Process コマンドを使用してください。例:
Start-Process -FilePath "C:╱Program Files╱JAM SoftwareTreeSizeTreesize.exe" -ArgumentList "/NOGUI /SCAN C:╱" -RedirectStandardOutput ".↪StdOut.txt" -RedirectStandardError ".╱StdError.txt"
Windows Scripting Host¶
Windows Scripting Host (WSH) を使うつもりなら、TreeSize を起動するコマンドは次のようになる:
Set Shell = CreateObject("WScript.Shell")
Shell.Run """C:\Program Files\TreeSize\Treesize.exe"" /XML ""C:\Reports\drive_c.xml.zip"" /SCAN ""C:\"""
終了コード¶
操作が正常に完了した場合、終了コードは 0 です。エラーが発生した場合、TreeSize は利用可能な場合、Windows エラーコード を終了コードとして返します。一般的なエラーを示すために 1 を返すこともあります。
いずれにせよ、Windows イベントログには「アプリケーション」ログ、イベントソース「TreeSize」にさらなる情報が含まれます。