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 を無効にし、イベントのログをコンソールに記録しません。

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

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