使用 MSBuild 取得建置記錄

透過使用 MSBuild 的參數，您可以指定要建置資料要檢閱，以及您是否要將組建資料至一個或多個檔案。您也可以指定自訂記錄器收集組建資料。如需 MSBuild 這個主題並未涵蓋的命令列參數的詳細資訊，請參閱 MSBuild 命令列參考。

注意事項
使用 Visual Studio IDE 中，如果您建立專案，您可以檢閱組建記錄疑難排解這些組建。如需詳細資訊，請參閱HOW TO：檢閱、儲存和設定建置記錄檔。

設定詳細程度

當您建立專案使用 MSBuild 時，如果沒有指定詳細程度，下列資訊會顯示在輸出記錄:

使用 /verbosity (/v) 參數，您可以控制多少資料出現在輸出記錄。如需疑難排解，請使用詳細等級 detailed (d) 或 diagnostic (diag)，提供大部分的資訊。

建置流程可能較慢，當您將 /verbosity 設為 detailed 和慢，當您將 /verbosity 設為 diagnostic。

msbuild MyProject.proj /t:go /v:diag

您可以使用 /fileLogger (fl) 參數儲存組建資料至檔案。下列範例會將組建資料至名為 msbuild.log的檔案。

msbuild MyProject.proj /t:go /fileLogger

在下列範例中，記錄檔會命名為，則為 MyProjectOutput.log，而且記錄檔輸出的詳細等級設定為 diagnostic。使用 /filelogparameters (flp) 參數，請指定這兩個設定。

msbuild MyProject.proj /t:go /fl /flp:logfile=MyProjectOutput.log;verbosity=diagnostic

如需詳細資訊，請參閱MSBuild 命令列參考。

下列範例將整個記錄至 msbuild1.log，錯誤和警告對 JustErrors.log為 JustWarnings.log。這個範例使用三個檔案都使用檔案編號。檔案號碼在 /fl 和 /flp 參數指定之後 (例如， /fl1 和 /flp1)。

檔案 2 和 3 的 /filelogparameters (flp) 參數在每個檔案指定如何命名每個檔案和如何包含。名稱不能為檔案指定 1，因此，使用 msbuild1.log 的預設名稱。

msbuild MyProject.proj /t:go /fl1 /fl2 /fl3 /flp2:logfile=JustErrors.log;errorsonly /flp3:logfile=JustWarnings.log;warningsonly

如需詳細資訊，請參閱MSBuild 命令列參考。

若想撰寫自己的記錄器，您可以撰寫一個實作 ILogger 介面的 Managed 型別。您可以使用自訂記錄器，例如，透過電子郵件傳送的建置錯誤，記錄到資料庫或記錄至 XML 檔案。如需詳細資訊，請參閱組建記錄器。

使用 /logger 參數，可以在 MSBuild 命令列，您可以指定自訂記錄器。您也可以使用 /noconsolelogger 參數來停用預設主控台記錄器。