Pentia.Invoke-MSBuild.psm1
|
<#
.SYNOPSIS Invokes MSBuild.exe. .PARAMETER MSBuildExecutablePath Absolute or relative path of MSBuild.exe. If null or empty, the script will attempt to find the latest MSBuild.exe installed with Visual Studio 2017 or later. .PARAMETER ProjectOrSolutionFilePath Path to the project or solution to build. Can be piped. .PARAMETER BuildConfiguration The build configuration to use. Leave blank to use each project's default configuration (usually "Debug"). .PARAMETER BuildArgs Additional arguments for MSBuild.exe, e.g. "/target:WebPublish", "/property:PublishUrl:<destination>" etc. See the official documentation for details: https://msdn.microsoft.com/en-us/library/ms164311.aspx. .EXAMPLE Get-WebProject -SolutionRootPath $PWD | Invoke-MSBuild -BuildConfiguration "Staging" Gets all web projects found under the current working directory, and invokes their default build target using the build configuration "Staging". Get-WebProject -SolutionRootPath $PWD | Invoke-MSBuild -BuildConfiguration "Staging" -BuildArgs "/t:WebPublish", "/p:PublishUrl:C:\Output", "/p:WebPublishMethod=FileSystem" Gets all web projects found under the current working directory, and invokes the "WebPublish" build target with the output path "C:\Output", using the build configuration "Staging". #> function Invoke-MSBuild { [CmdletBinding()] param ( [Parameter(Mandatory = $false)] [string]$MSBuildExecutablePath, [Parameter(Mandatory = $true, ValueFromPipeline = $true)] [string]$ProjectOrSolutionFilePath, [Parameter(Mandatory = $false)] [string]$BuildConfiguration, [Parameter(Mandatory = $false)] [string[]]$BuildArgs ) process { if (-not (Test-Path -Path $ProjectOrSolutionFilePath -PathType Leaf)) { throw "Project or solution file '$ProjectOrSolutionFilePath' not found." } if ([string]::IsNullOrWhiteSpace($MSBuildExecutablePath)) { $MSBuildExecutablePath = Get-MSBuild } if (-not $BuildArgs) { $BuildArgs = @() $BuildArgs += """/maxcpucount""" # Blank means all CPUs. Else use e.g. "/maxcpucount:4" } if (-not [string]::IsNullOrWhiteSpace($BuildConfiguration)) { $BuildArgs += """/property:Configuration=$BuildConfiguration""" } $BuildArgs += """$ProjectOrSolutionFilePath""" & $MSBuildExecutablePath $BuildArgs if ($LASTEXITCODE -ne 0) { throw "Failed to build '$ProjectOrSolutionFilePath'." } } } Export-ModuleMember -Function Invoke-MSBuild |