about_Parsing indicates Get- will be prepended to Process, as Get-Process #8850
Description
Prerequisites
- Write a descriptive title.
- Search the existing issues.
- I am reporting the documentation problem for version of PowerShell I am using.
Version
5.1, 7.0, 7.2, 7.3 (preview)
Link to affected document
https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_parsing
Description of the documentation error
The Note in the Long description of about_Parsing is inaccurate. It says that Get- will be prepended to Process. This isn't correct, as Process is treated as an input processing method, unless it's inside of an input processing method: Begin, Process, End. There may be other places where Get- is prepended, but inside of an input processing method was at least one place it worked as described.
[PS7.2.3][C:\] process
>>
versus
[PS7.2.3][C:\] Process {Process | Select-Object -First 2}
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
21 17.26 10.12 0.44 18784 1 AcrobatNotificationClient
20 7.42 19.58 1.64 18076 1 acrotray
Suggested fix
- Remove the
Processexample and replace it with aService/Get-Serviceexample - Add an fourth bullet used to explain that there are/may be places where this doesn't work as expected, such when used with Process
There's no way to include/outline every possible exception, as a module author could easily create and release a Get-Begin or Get-End command, so the new bullet/new information should be open-ended.
@sdwheeler You're welcome to assign this issue to me.