Execution

Author(s)

• Manuel

Tags

Execution Self-Elevation Stub PowerShell Windows

Functions

Clear-TempDirectories ConvertTo-SplatHashtable Exit-AndWaitOnUI Format-SplatHashtable Get-QuotedPath Invoke-NativeCommand Invoke-StubScript Invoke-WhenFileChanged Remove-ItemSafe Remove-NativeProgressNoise Restart-SelfElevated Set-PSScriptID

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

Execution v5.2.0+sha.181b724

## [v5.2.0] - 2026-05-06

### Added

- `Remove-NativeProgressNoise`: new public helper that filters
 carriage-return progress lines (DISM `[==XX.X%==]`, robocopy plain
 percent, sfc, ...) out of captured native-command output. Pipeline
 in / pipeline out, retains the final tick by default so users still
 see the "100% / done" line; `-StripFinalProgress` drops every
 tick. Workaround for #13's underlying capture asymmetry between
 the wrapped backends and the bare `&` operator: native-command
 progress that the console host would render as a single
 overwriting line is captured by `Invoke-NativeCommand` as one
 entry per progress tick, and this helper lets callers post-process
 that capture without re-implementing the regexes themselves.
- `Invoke-NativeCommand`: new `-RawStream` switch for native-passthrough
 mode. Stdout / stderr inherit the parent's handles instead of being
 redirected, so the console host applies CR semantics in place: DISM /
 robocopy / sfc progress overwrite themselves on a single line exactly
 the way the bare `&` operator behaves. The wrapper still owns process
 lifetime, exit-code surfacing, working-directory wrapping, `-WhatIf`,
 and the graceful-then-hard timeout sequence; it just opts out of the
 capture machinery for the call. Triggers the Process backend; `-PassThru`
 is allowed but `Output` / `Stdout` / `Stderr` are `$null`. Mutually
 exclusive with `-Stream`, `-Encoding`, `-NoWait`, and
 `-Backend ScriptBlock` -- each combination raises a terminating error
 rather than silently degrading. Closes the live-output gap that
 `Remove-NativeProgressNoise` left open (#13 follow-up).

### Fixed

- `Invoke-NativeCommand -Stream`: defensive hardening for the
 streaming drain when wrapped subprocesses emit `\n`-only lines
 (trailing newlines, section separators, fake-progress scripts
 ending in `[Console]::WriteLine()`). Drops `[Parameter(Mandatory)]`
 on the per-line accumulator parameters of the internal
 `Read-NativeEventBatch` helper -- they remain strongly typed and
 the only caller always supplies them, so loss of binder-level
 enforcement is purely theoretical. Initialises `$snapshot` to
 `$null` ahead of the backend call and early-returns if the backend
 swallowed its own error: prevents a strict-mode follow-on
 `$snapshot cannot be retrieved because it has not been set` from
 masking the original failure. (#14)