<Project DefaultTargets="Build">
  <!-- ビルド(Build)の動作を定義する -->
  <Target Name="Build">
    <!-- 重要度'high'でメッセージを出力する -->
    <Message Text="Hello, world!" Importance="high"/>
  </Target>
</Project>

`msbuild`コマンドでMSBuildプロジェクトファイルを*ビルド*する
>msbuild -nologo -v:minimal HelloWorld.msbuild.xml
  Hello, world!

`dotnet build`コマンドでMSBuildプロジェクトファイルを*ビルド*する
>dotnet build -nologo HelloWorld.msbuild.xml
  Hello, world!

ビルドに成功しました。
    0 個の警告
    0 エラー

経過時間 00:00:00.10

`dotnet msbuild`コマンドでも同様に*ビルド*することができる
`dotnet`コマンドで`msbuild`コマンドのコマンドライン引数を使用したい場合に用いる
>dotnet msbuild -nologo HelloWorld.msbuild.xml
  Hello, world!

    ︙
  <PropertyGroup>
    <!--
      環境変数LOG_DIRでログディレクトリが指定されていない場合、
      プロパティを再定義してデフォルトのディレクトリを指定する
    -->
    <Log_Dir Condition=" '$(LOG_DIR)' == '' ">/var/log/</Log_Dir>
  </PropertyGroup>

  <!-- ビルド(Buildターゲット)の実行前にこのターゲットを実行させる -->
  <Target Name="PrintEnvironmentProperties" BeforeTargets="Build">
    <!-- 環境変数LANGの値を表示する -->
    <Message Text="Lang: $(Lang)" Importance="high"/>

    <!-- ログディレクトリ(LOG_DIR)の指定値を表示する -->
    <Message Text="Log_Dir: $(Log_Dir)" Importance="high"/>

    <!-- データディレクトリ(DATA_DIR)の指定値を表示する -->
    <Message Text="Data_Dir: $(Data_Dir)" Importance="high"/>
  </Target>
    ︙

環境変数DATA_DIRのみを指定してビルドする
(環境変数LOG_DIRに対応するプロパティはデフォルト値が使用される)
$DATA_DIR=./data/ dotnet msbuild -nologo -v:minimal
  Lang: ja_JP.UTF-8
  Log_Dir: /var/log/
  Data_Dir: ./data/

環境変数DATA_DIRとLOG_DIRを指定してビルドする
$DATA_DIR=./data/ LOG_DIR=./log/ dotnet msbuild -nologo -v:minimal
  Lang: ja_JP.UTF-8
  Log_Dir: ./log/
  Data_Dir: ./data/

環境変数とコマンドライン引数の両方で同一のプロパティの値を指定してビルドする
(最も優先度の高いコマンドライン引数の指定値が使用される)
$LOG_DIR=./log/ dotnet msbuild -nologo -v:minimal -p:Log_Dir=~/.tmp/log/
  Lang: ja_JP.UTF-8
  Log_Dir: ~/.tmp/log/
  Data_Dir: 

    ︙
  <PropertyGroup>
    <!--
      ビルド構成(Configurationプロパティ)がDebugと等しい場合のみ、
      コンパイラ定数(DefineConstantsプロパティ)にDEBUG_LOGを追加する
    -->
    <DefineConstants Condition=" '$(Configuration)' == 'Debug' ">$(DefineConstants);DEBUG_LOG</DefineConstants>

    <!--
      Copyrightプロパティが空の文字列(=未定義)の場合のみ、
      CopyrightYearプロパティとAuthorsプロパティの値を展開して著作権表示の文字列を構成する
    -->
    <Copyright Condition=" '$(Copyright)' == '' ">Copyright © $(CopyrightYear) $(Authors)</Copyright>
  </PropertyGroup>

  <ItemGroup>
    <!--
      ターゲットフレームワーク(TargetFrameworkプロパティ)が.NET Framework 4.x('net4'で始まる)場合を除き、
      参照パッケージ(PackageReferenceアイテム)にSystem.Text.Encoding.CodePagesを含める
    -->
    <PackageReference Include="System.Text.Encoding.CodePages" Condition="! $(TargetFramework.StartsWith('net4'))" />
  </ItemGroup>
    ︙

    ︙
  <!-- ビルド構成(Configuration)によらず共通で定義するプロパティを記述する -->
  <PropertyGroup>
      ︙
  </PropertyGroup>

  <!-- ビルド構成がDebugの場合のみ定義するプロパティを記述する -->
  <PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
      ︙
  </PropertyGroup>

  <!-- ビルド構成がReleaseの場合のみ定義するプロパティを記述する -->
  <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
      ︙
  </PropertyGroup>
    ︙

    ︙
  <ItemGroup>
    <!--
      ターゲットフレームワーク(TargetFrameworkプロパティ)が.NET Framework 1.x.y〜4.x.y('net1(x(y))'〜'net4(x(y))')の場合を除き、
      参照パッケージ(PackageReferenceアイテム)にSystem.Text.Encoding.CodePagesを含める
    -->
    <PackageReference
      Include="System.Text.Encoding.CodePages"
      Condition="! $([System.Text.RegularExpressions.Regex]::IsMatch(
        $(TargetFramework),
        '^net[1-4][0-9]*'
      ))"
    />
  </ItemGroup>
    ︙

    ︙
  <ItemGroup>
    <!--
      ターゲットフレームワークの識別子(TargetFrameworkIdentifier)が'.NETFramework'の場合を除き、
      参照パッケージ(PackageReferenceアイテム)にSystem.Text.Encoding.CodePagesを含める
    -->
    <PackageReference
      Include="System.Text.Encoding.CodePages"
      Condition=" '$([MSBuild]::GetTargetFrameworkIdentifier( $(TargetFramework) ))' != '.NETFramework' "
    />
  </ItemGroup>
    ︙

    ︙
  <Choose>
    <!-- 構成(Configuration)が'Debug'の場合 -->
    <When Condition=" '$(Configuration)' == 'Debug' ">
      <PropertyGroup>
        <!-- コンパイラ定数にDEBUG_FOOとDEBUG_BARを追加する -->
        <DefineConstants>$(DefineConstants);DEBUG_FOO;DEBUG_BAR</DefineConstants>
        <!-- 整数演算でのオーバーフロー・アンダーフロー発生時に例外OverflowExceptionをスローさせる -->
        <CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>
      </PropertyGroup>
    </When>
    <!-- 構成(Configuration)が'Release'の場合 -->
    <When Condition=" '$(Configuration)' == 'Release' ">
      <PropertyGroup>
        <!-- 整数演算でのオーバーフロー・アンダーフローを許容する -->
        <CheckForOverflowUnderflow>false</CheckForOverflowUnderflow>
        <!-- デバッグシンボルの生成を行わない -->
        <DebugSymbols>false</DebugSymbols>
        <DebugType>none</DebugType>
      </PropertyGroup>
    </When>
    <!-- 上記のいずれにも一致しない場合 -->
    <Otherwise>
      <PropertyGroup>
        <!-- 独自のプロパティConfigurationErrorを定義して、エラーメッセージを表示させる -->
        <ConfigurationError>configuration '$(Configuration)' is not defined</ConfigurationError>
      </PropertyGroup>
    </Otherwise>
  </Choose>

  <!-- Buildが実行される前、かつプロパティConfigurationErrorの値が空の文字列以外の場合に実行されるターゲットを定義 -->
  <Target Name="ReportConfigurationError" BeforeTargets="Build" Condition=" '$(ConfigurationError)' != '' ">
    <!-- ConfigurationErrorプロパティに設定された値をエラーメッセージとして表示する -->
    <Error Text="$(ConfigurationError)"/>
  </Target>
    ︙

<!-- InitialTargets属性でプロジェクトが読み込まれた際にDebugPrintターゲットを実行するように指定する -->
<Project Sdk="Microsoft.NET.Sdk" InitialTargets="DebugPrint">
  <Target Name="DebugPrint">
    <!-- メッセージをデフォルトの重要度で表示する -->
    <Message Text="Hello, world!"/>

    <!-- 現在の構成(Configurationプロパティ)を、重要度'high'で表示する -->
    <Message Text="configuration: '$(Configuration)'" Importance="high"/>

    <!-- コンパイラに渡されるコンパイル対象ファイル(Compileアイテム)を表示する -->
    <Message Text="source files: @(Compile)"/>

    <!-- 警告メッセージを表示する -->
    <Warning Text="Hello, warning!"/>

    <!-- エラーメッセージを表示する -->
    <Error Text="Hello, error!"/>
  </Target>
    ︙

    ︙
  <Target Name="RunCommand">
    <!-- `echo`コマンドを実行する -->
    <Exec Command="echo &quot;Hello, world!&quot;"/>
  </Target>
    ︙

    ︙
  <!-- 以下はLinuxのechoコマンドを使用する場合の例。　DOSのechoコマンドを実行する場合は修正が必要になる。 -->
  <Target Name="RunEcho" Condition=" '$(OS)' == 'Unix' ">
    <!--
      以下のパラメータを指定してコマンドを実行する
      Command="...": `echo`コマンドを実行する(コマンド中でダブルクオーテーションを記述する場合は&quot;にエスケープする)
      ConsoleToMSBuild="true": 標準出力と標準エラーをキャプチャする
      EnvironmentVariables="...": コマンドに渡す環境変数を指定する(複数指定する場合はセミコロン;で区切る)
      EchoOff="true": タスク実行のメッセージとコマンドの出力をオフにする(標準出力・標準エラーのキャプチャには影響しない)
    -->
    <Exec
      Command="echo &quot;${HELLO}, ${WORLD}!&quot;"
      ConsoleToMSBuild="true"
      EnvironmentVariables="HELLO=Hello;WORLD=MSBuild"
      EchoOff="true"
    >
      <!-- コマンドの標準出力・標準エラーをプロパティEchoOutputに格納する -->
      <Output TaskParameter="ConsoleOutput" PropertyName="EchoOutput" />
      <!-- コマンドの終了コードをプロパティEchoExitCodeに格納する -->
      <Output TaskParameter="ExitCode" PropertyName="EchoExitCode" />
    </Exec>

    <!-- Execタスクの出力パラメータの内容を表示する -->
    <Message Text="output: $(EchoOutput)" Importance="high"/>
    <Message Text="exit code: $(CommandExitCode)" Importance="high"/>
  </Target>
    ︙

    ︙
  <Target Name="GitRetrieveHeadHash">
    <!--
      以下のパラメータを指定してコマンドを実行する
      Command="...": 実行するコマンド(git rev-parse)を指定
      ConsoleToMSBuild="true": 標準出力と標準エラーをキャプチャする
      WorkingDirectory="...": コマンドを実行する際の作業ディレクトリとして、
                              プロジェクトファイルのあるディレクトリ$(MSBuildProjectDirectory)からの相対パスを指定する
      EchoOff="true": タスク実行のメッセージとコマンドの出力をオフにする(標準出力・標準エラーのキャプチャには影響しない)
    -->
    <Exec
      Command="git rev-parse HEAD"
      ConsoleToMSBuild="true"
      WorkingDirectory="$(MSBuildProjectDirectory)\..\src\"
      EchoOff="true"
    >
      <!-- コマンドの実行結果をプロパティGitHeadHashに格納する -->
      <Output TaskParameter="ConsoleOutput" PropertyName="GitHeadHash" />
    </Exec>

    <!-- コマンドの実行結果(GitHeadHashプロパティの値)を表示する -->
    <Message Text="hash: $(GitHeadHash)" Importance="high"/>
  </Target>
    ︙

# csprojの場合 (FOO;BAR;BAZの3つの定数を定義してビルド・実行する)
dotnet build -p:DefineConstants=FOO%3BBAR%3BBAZ sample.csproj && dotnet run -p sample.csproj --no-build

# vbprojの場合
dotnet build -p:DefineConstants=FOO%2CBAR%2CBAZ sample.vbproj && dotnet run -p sample.vbproj --no-build