Forum Discussion
Accept pipeline input?
Charlie34000ā. Thank you for your comments. I ran (in admin mode) Update-Help -Force. This did not make any difference (I had run the command without -Force earlier).
I have written notes about PowerShell meant for colleagues and students. In the notes I explain the different parameter sets with the six sets of Get-Help as an example. At the time of writing, the off-line help files were correct. What am I supposed to do? Rewrite the notes and refer to Get-Command -Syntax or to the online help with the chance that after the next Windows update the help files (and my notes) are correct again?
In the notes I also explain the possibility of input through the pipeline vs. -InputObject (or a similar parameter). I explain in some detail how to arrive at the one-liner:
Get-Help Get-C* |
% {Write-Host `n $_.name;
Get-Help $_.name -Parameter * -ea 0 |
% {Write-Host (" Pos: {0,6:s} Pipe_inp: {1,6:s} " -f $_.position, $_.pipeLineInput),
(" Parameter name: {0,1:s}" -f $_.name)
}
} At the time I wrote this, it gave a correct table. Do I now discard this one-liner and the discussion leading to it? Again, with the chance that it will be correct again in the near future?
All-in-all, this business of help files comes across as amateurish. I find it rather unexpected, since PowerShell is after all an important software package promoted (and supported?) by one the most valuable companies in the world.
I gave second thought to my comment above and see now that a single complaint won't change the course of the MS mammoth tanker. In other words, one comment won't induce MS to change its update protocols. But, constant dropping wears away a stone: when enough people signal the unreliability of the PowerShell off-line help, who knows?