Document -WindowStyle Hidden behavior change on Windows 11 24H2+

Open Beginner friendly
#12,897 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
powershell
Domain
documentation

Research direction

Start with the -WindowStyle parameter section in about_pwsh and review the behavior described for pwsh -WindowStyle Hidden. Update it to distinguish Windows 11 24H2+ (build 26100+) from earlier versions, then verify that the documented behavior matches the issue's table and related fix.

Written by the indexing model from the issue text.

Description

hold-for-pr hold-for-release

Summary

PowerShell/PowerShell#27111 fixes PowerShell/PowerShell#3028 by eliminating the console window flash when launching pwsh -WindowStyle Hidden on Windows 11 24H2+ (build 26100+).

The fix uses consoleAllocationPolicy=detached in the pwsh.exe manifest and AllocConsoleWithOptions to allocate the console programmatically — invisibly when -WindowStyle Hidden is specified.

Pages to update

  • about_pwsh — The -WindowStyle parameter section should note that on Windows 11 24H2+, -WindowStyle Hidden prevents console window creation entirely (rather than creating then hiding).

Behavior change

Windows version Old behavior New behavior
Before build 26100 Console window flashes briefly, then hides Unchanged
Build 26100+ Console window flashes briefly, then hides No console window created

Related

  • Fix PR: PowerShell/PowerShell#27111
  • Issue: PowerShell/PowerShell#3028 (open since January 2017, 160+ upvotes)
Dominant language
PowerShell
Stars
2.5k
Forks
1.7k
Avg merge
8h 45m
Merged PRs (30d)
33

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MicrosoftDocs/PowerShell-Docs

All issues in MicrosoftDocs/PowerShell-Docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.