Clarifications for Issue #17

All 54 tests pass

Author: darianmiller

source/delphi-msbuild.ps1

@@ -89,7 +89,19 @@ param(
 
   [string[]]$Define = @(),
 
-  [switch]$ShowOutput
+  [switch]$ShowOutput,
+
+  # When set, the result object is written as compressed JSON to this file path.
+  # Used by Invoke-BuildPipeline to capture structured results from the subprocess
+  # while still streaming build output to the console via | Out-Host.
+  [string]$OutputFile,
+
+  # Output format for the result object.
+  # object (default) -- emits a PSCustomObject to the pipeline.
+  # json             -- emits a single compressed JSON line; used by Invoke-BuildPipeline
+  #                     to capture structured results from the subprocess.
+  [ValidateSet('object', 'json')]
+  [string]$Format = 'object'
 )
 
 Set-StrictMode -Version Latest
@@ -345,7 +357,15 @@ try {
     output         = $buildResult.Output
   }
 
-  Write-Output $resultObj
+  if (-not [string]::IsNullOrWhiteSpace($OutputFile)) {
+    Set-Content -LiteralPath $OutputFile -Value ($resultObj | ConvertTo-Json -Depth 5 -Compress) -Encoding UTF8
+  }
+
+  if ($Format -eq 'json') {
+    Write-Output ($resultObj | ConvertTo-Json -Depth 5 -Compress)
+  } else {
+    Write-Output $resultObj
+  }
 
   if ($buildResult.ExitCode -ne 0) {
     if ($ShowOutput) {