{"id":47,"date":"2026-10-14T05:41:12","date_gmt":"2026-10-14T05:41:12","guid":{"rendered":"http:\/\/www.scmgalaxy.com\/tutorials\/2015\/06\/17\/msbuild-training\/"},"modified":"2026-10-14T05:41:12","modified_gmt":"2026-10-14T05:41:12","slug":"msbuild-training","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/msbuild-training\/","title":{"rendered":"MSBuild Training Guide: Basics, Custom Targets, Logging, and Troubleshooting"},"content":{"rendered":"\n

Originally published on 2015-06-17; fully revised and updated.<\/em><\/p>\n\n\n

\n
\"MSBuild<\/figure>\n<\/div>\n\n\n

Training registration form (original link)<\/a><\/p>\n\n\n\n

This guide turns a short training announcement into a practical MSBuild reference for DevOps engineers, .NET developers, and release teams. You will learn the core MSBuild model, how to extend builds with custom targets and tasks, and how to troubleshoot build failures and performance issues using repeatable techniques.<\/p>\n\n\n\n

Updated MSBuild training curriculum<\/h2>\n\n\n\n

The original post outlined three core modules. The structure below keeps that intent and adds implementation guidance.<\/p>\n\n\n\n

Module 1: MSBuild 4.0 basics<\/strong><\/p>\n\n\n\n

  • What MSBuild is and where it fits in the build lifecycle<\/li>
  • Sample project file structure<\/li>
  • Solutions vs. projects<\/li>
  • Targets and tasks<\/li>
  • Properties and items<\/li>
  • Editing project files in Visual Studio<\/li><\/ul>\n\n\n\n

    Module 2: Customization and extension<\/strong><\/p>\n\n\n\n

    • Build events<\/li>
    • Custom build steps<\/li>
    • Custom build tools<\/li>
    • Custom build targets<\/li>
    • Custom build tasks<\/li>
    • MSBuild extension pack usage patterns<\/li><\/ul>\n\n\n\n

      Module 3: Troubleshooting and diagnostics<\/strong><\/p>\n\n\n\n

      • Logging and verbosity tuning<\/li>
      • Console logger and file logger usage<\/li>
      • Custom loggers<\/li>
      • Error handling patterns<\/li>
      • Debugging build scripts, tasks, and loggers<\/li>
      • Import conflicts, performance bottlenecks, and incremental build issues<\/li><\/ul>\n\n\n\n

        How an MSBuild workflow runs<\/h2>\n\n\n\n
        \nflowchart TD\n    A[Developer changes code] --> B[MSBuild loads solution and project files]\n    B --> C[Evaluate properties and items]\n    C --> D[Resolve target dependency graph]\n    D --> E[Execute tasks in target order]\n    E --> F{Build errors?}\n    F -- Yes --> G[Inspect logs and fix configuration or code]\n    G --> A\n    F -- No --> H[Publish build outputs]\n<\/pre>\n\n\n\n
        Core MSBuild concepts compared<\/h2>\n\n\n\n
        Concept<\/th>What it represents<\/th>Why it matters<\/th><\/tr><\/thead>
        Solution (.sln)<\/td>Container of multiple projects<\/td>Useful for orchestrating multi-project builds from one entry point<\/td><\/tr>
        Project (.csproj, .vbproj, etc.)<\/td>Build definition for a single application or library<\/td>Holds references, properties, items, and targets for one unit of build<\/td><\/tr>
        Target<\/td>Named phase of work (for example Build, Clean, Publish)<\/td>Controls ordering and dependencies across build steps<\/td><\/tr>
        Task<\/td>Atomic operation executed inside a target<\/td>Performs concrete actions such as compile, copy, create directory, or run tools<\/td><\/tr>
        Property and Item<\/td>Configuration values and file collections<\/td>Drive conditional logic and input\/output behavior<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Practical command-line examples<\/h2>\n\n\n\n
        Use these commands in a terminal or CI job to build, clean, and collect diagnostics.<\/p>\n\n\n
        msbuild MySolution.sln \/t:Clean,Build \/p:Configuration=Release \/m<\/code><\/span><\/pre>\n\n
        msbuild MyProject.csproj \/t:Build \/v:detailed \/fl \/flp:logfile=msbuild.log;verbosity=diagnostic<\/code><\/span><\/pre>\n\n
        msbuild MyProject.csproj \/t:Rebuild \/p:Configuration=Debug \/p:Platform=\"Any CPU\"<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        Customization example: adding a post-build target<\/h2>\n\n\n\n
        This sample shows a simple target that creates an artifacts directory and copies the built output into it.<\/p>\n\n\n
        <Project<\/span>><\/span>\n  <PropertyGroup<\/span>><\/span>\n    <ArtifactsDir<\/span>><\/span>$(MSBuildProjectDirectory)\\artifacts<\/ArtifactsDir<\/span>><\/span>\n  <\/PropertyGroup<\/span>><\/span>\n\n  <Target<\/span> Name<\/span>=\"AfterBuild\"<\/span>><\/span>\n    <MakeDir<\/span> Directories<\/span>=\"$(ArtifactsDir)\"<\/span> \/><\/span>\n    <Copy<\/span> SourceFiles<\/span>=\"$(TargetPath)\"<\/span> DestinationFolder<\/span>=\"$(ArtifactsDir)\"<\/span> \/><\/span>\n  <\/Target<\/span>><\/span>\n<\/Project<\/span>><\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
        Troubleshooting options at a glance<\/h2>\n\n\n\n
        Option<\/th>Best for<\/th>Typical usage<\/th><\/tr><\/thead>
        Console logger<\/td>Immediate feedback in local runs and CI logs<\/td>Use \/v:minimal, \/v:normal, or \/v:detailed depending on noise tolerance<\/td><\/tr>
        File logger<\/td>Persisting diagnostics for later analysis<\/td>Use \/fl with \/flp:logfile=…;verbosity=diagnostic<\/td><\/tr>
        Custom logger<\/td>Special reporting or integration needs<\/td>Use \/logger:TypeName,AssemblyName when built-in output is insufficient<\/td><\/tr>
        Error handling in targets<\/td>Graceful failure behavior<\/td>Use explicit target dependencies and clear failure points to avoid silent errors<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Best practices and common pitfalls<\/h2>\n\n\n\n
        • Keep project files readable: group properties, items, and targets logically.<\/li>
        • Prefer explicit target dependencies over hidden side effects in build events.<\/li>
        • Use detailed logging only when troubleshooting; reduce verbosity in normal CI runs.<\/li>
        • Validate incremental build behavior whenever you add custom copy, transform, or generated-file steps.<\/li>
        • Test custom targets in a clean workspace to catch missing assumptions.<\/li>
        • Document non-default properties passed from CI so local and pipeline builds stay consistent.<\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"
          A practical, updated MSBuild training reference based on the original course outline. Learn how MSBuild works, how to customize builds, and how to troubleshoot slow or failing pipelines.<\/p>\n","protected":false},"author":1,"featured_media":3461,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[8],"tags":[99,1681,884,1684,883,100,97,366,1686,1680,135,1685,1682,94,1683,1673,96],"class_list":["post-47","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-training","tag-bangalore","tag-chennai","tag-classroom","tag-classroom-msbuild-training","tag-course","tag-hyderabad","tag-india","tag-msbuild","tag-msbuild-classroom-training","tag-msbuild-course","tag-msbuild-training","tag-msbuild-training-online","tag-mumbai","tag-online","tag-online-msbuild-training","tag-pune","tag-training"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=47"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47\/revisions"}],"predecessor-version":[{"id":79286,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/47\/revisions\/79286"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media\/3461"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=47"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=47"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=47"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}