PR Summary

FixSet-PSDebug -Trace to display all lines of multiline commands.

PR Context

Fixes#8113

When usingSet-PSDebug -Trace 1 or-Trace 2, multiline commands (e.g., using backtick line continuation) only showed the first line in debug output. This made it difficult to trace and debug scripts with multiline commands.

Before this fix:

Set-PSDebug-Trace1Write-Output"foo`bar"

Output:

DEBUG:    3+  >>>> Write-Output "foo `foobar

After this fix:

Output:

DEBUG:    3+  >>>> Write-Output "foo `DEBUG:    4+  >>>> bar"foobar

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Make sure all.h,.cpp,.cs,.ps1 and.psm1 files have the correct copyright header
• This PR is ready to merge. If this PR is a work in progress, please open this as aDraft Pull Request and mark it as Ready to Review when it is ready to merge.
• Breaking changes
  • None
  • OR
  • Experimental feature(s) needed
    • Experimental feature name(s):
• User-facing changes
  • Not Applicable
  • OR
  • Documentation needed
    • Issue filed:
• Testing - New and feature
  • N/A or can only be tested interactively
  • OR
  • Make sure you've added a new test if existing tests do not effectively test the code changed

Description

Root Cause

TheTraceLine method in the debugger was callingPositionUtilities.BriefMessage(extent.StartScriptPosition), which only considers the start position of an extent. For multiline commands, this meant only the first line was displayed.

Solution

1. Added a new overloadPositionUtilities.BriefMessage(IScriptExtent extent) that handles multiline extents by:

   • Detecting if an extent spans multiple lines
   • For single-line extents, delegating to the existing method
   • For multiline extents, formatting each line with appropriate line numbers and markers

2. ChangedTraceLine to call the new extent-based overload and write each line separately so each gets theDEBUG: prefix.

Files Changed

• src/System.Management.Automation/engine/debugger/debugger.cs - ChangedTraceLine to use extent-basedBriefMessage and write each line separately
• src/System.Management.Automation/engine/parser/Position.cs - Added newBriefMessage(IScriptExtent) overload
• test/powershell/Modules/Microsoft.PowerShell.Core/Set-PSDebug.Tests.ps1 - Added tests for multiline command tracing with-Trace 1 and-Trace 2

Testing

Test Coverage

Added test cases that:

1. Create a script with a multiline command using backtick line continuation
2. Run it in a separate process to capture trace output
3. Verify both the first line (Write-Output) and continuation line (bar") appear in debug output withDEBUG: prefix

Tests cover both-Trace 1 and-Trace 2 options.

Automated Tests

All tests pass:

Context Tracing can be used  [+] Should be able to go through the tracing options  [+] Should be able to set strict  [+] Should skip magic extents created by pwsh  [+] Should trace all lines of a multiline command  [+] Should trace all lines of a multiline command with -Trace 2Tests Passed: 5, Failed: 0