MSBuild コマンド ライン リファレンス

スイッチ

省略形

説明

/consoleloggerparameters:

parameters

/clp:parameters

指定したパラメーターをコンソール logger に渡し、コンソール ウィンドウにビルド情報を表示します。 次のパラメーターを指定できます。

  • PerformanceSummary タスク、ターゲット、およびプロジェクトで経過した時間を表示します。

  • Summary エラーや警告の概要を終了時に表示します。

  • NoSummary エラーや警告の概要を終了時に表示しません。

  • ErrorsOnly エラーのみを表示します。

  • WarningsOnly 警告のみを表示します。

  • NoItemAndPropertyList 詳細レベルが diagnostic に設定されている場合、各プロジェクト ビルドの開始時に項目とプロパティの一覧を表示しません。

  • ShowCommandLine TaskCommandLineEvent メッセージを表示します。

  • ShowTimestamp タイムスタンプをメッセージの先頭に表示します。

  • ShowEventId 開始したイベント、終了したイベント、およびメッセージのイベント ID を表示します。

  • ForceNoAlign テキストをコンソール バッファーのサイズに合わせません。

  • DisableConsoleColor すべてのログ メッセージに、コンソールの既定の色を使用します。

  • DisableMPLogging マルチプロセッサ以外のモードで実行されている場合にマルチプロセッサ ログ出力方法を無効にします。

  • EnableMPLogging マルチプロセッサ以外のモードで実行されている場合でもマルチプロセッサ ログ出力方法を有効にします。 このログ出力方法はデフォルトで有効です。

  • Verbosity この logger の /verbosity 設定をオーバーライドします。

次の例に示すように、セミコロンまたはコンマを使用して複数のパラメーターを区切ります。

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/dfl

各 MSBuild ノードのビルド出力を、そのノード独自のファイルに記録します。 これらのファイルの初期位置は、現在のディレクトリです。 既定では、ファイルの名前は "MSBuildNodeId.log" になります。 /fileLoggerParameters スイッチを使用して、ファイルの場所と fileLogger の他のパラメーターを指定できます。

/fileLoggerParameters スイッチを使用してログ ファイル名を指定すると、分散 logger はその名前をテンプレートとして使用し、各ノードのログ ファイルを作成するときに、その名前にノード ID を追加します。

/distributedlogger:

central logger*

forwarding logger

/dl:central logger*forwarding logger

MSBuild のイベントを記録して、各ノードに異なる logger インスタンスをアタッチします。 複数の logger を指定するには、各 logger を個別に指定します。

logger を指定するには、logger の構文を使用します。 logger の構文については、この後に示されている /logger スイッチを参照してください。

このスイッチを使用する方法を次の例に示します。

/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll

/fileLogger

[number]

/fl[number]

ビルド出力を、現在のディレクトリにある単一のファイルに記録します。 number を指定しない場合、出力ファイルの名前は msbuild.log になります。 number を指定した場合、出力ファイルの名前は msbuildn.log になります。この n には、number が設定されます。 Number は、1 から 9 までの数値を指定できます。

/fileLoggerParameters スイッチを使用して、ファイルの場所と fileLogger の他のパラメーターを指定できます。

/fileloggerparameters:[number]

parameters

/flp:[ number] parameters

ファイル logger と分散ファイル logger の追加のパラメーターを指定します。 このスイッチが指定されているということは、対応する /filelogger[number] スイッチが存在することを意味します。 Number は、1 から 9 までの数値を指定できます。

/consoleloggerparameters に示されているすべてのパラメーターを使用できます。 また、次のパラメーターを 1 つ以上使用することもできます。

  • LogFile ビルド ログが書き込まれるログ ファイルへのパス。 分散ファイル logger では、このパスをログ ファイル名の先頭に追加します。

  • Append ビルド ログを、ログ ファイルに追加して記録するか、ログ ファイルを上書きして記録するかについて指定します。 このスイッチを設定すると、ビルド ログはログ ファイルに追加して記録されます。 このスイッチを指定しないと、既存のログ ファイルの内容が上書きして記録されます。

    append スイッチを含めた場合、そのスイッチが true または false のどちらに設定されている場合でも、ログが追加して記録されます。 append スイッチを含めない場合、ログは上書きして記録されます。

    次の場合、ファイルを上書きして記録します。msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log

    次の場合、ファイルを追加して記録します。msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=true

    次の場合、ファイルを追加して記録します。msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=false  

  • Encoding ファイルのエンコード (UTF-8、Unicode、ASCII など) を指定します。

次の例では、警告とエラー用に個別のログ ファイルを生成します。

/flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly

次の例は、他の使用法を示しています:

/fileLoggerParameters:LogFile=MyLog.log;Append; Verbosity=diagnostic;Encoding=UTF-8

/flp:Summary;Verbosity=minimal;LogFile=msbuild.sum

/flp1:warningsonly;logfile=msbuild.wrn

/flp2:errorsonly;logfile=msbuild.err

/logger:

logger

/l:logger

MSBuild からのイベントをログに記録する logger を指定します。 複数の logger を指定するには、各 logger を個別に指定します。

logger に対して次の構文を使用します。[LoggerClass,]LoggerAssembly[;LoggerParameters]

LoggerClass に対して次の構文を使用します。[PartialOrFullNamespace.]LoggerClassName

アセンブリに logger が 1 つしか含まれていない場合は、logger クラスを指定する必要はありません。

LoggerAssembly に対して次の構文を使用します。{AssemblyName[,StrongName] | AssemblyFile}

logger のパラメーターは省略可能であり、入力されたとおりに logger に渡されます。

/logger スイッチを使用する例を次に示します。

/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML

/noconsolelogger

/noconlog

既定のコンソール logger を無効にし、イベントのログをコンソールに記録しません。