Note <\/b> The script today works in Windows PowerShell 4.0 and Windows PowerShell 3.0. It does not take advantage of any new features of Windows PowerShell 5.0, but it also works there. It does not work in Windows PowerShell 2.0 because Out-GridView<\/b> did not contain a –Passthru<\/b> parameter in that version.<\/p>\n
I am spending a lot of time these days playing around with Windows PowerShell 5.0. Because it is not yet released, at times, I need to get old school when it comes to working with the product and rely upon the cmdlet help. There are a few blog posts about it from the Windows PowerShell team<\/a> and some from various MVPs—but that is about it. Luckily the documentation team has been steadily documenting the product and so I can use help.<\/p>\n So that means that I need to figure out things for myself. I wrote a script that allows me to specify a particular module with the Get-Command<\/b> cmdlet. I pipe the results to Out-GridView<\/b>, and then I take the cmdlet I select from Out-GridView<\/b> and pass it to Get-Help<\/b>.<\/p>\n It is a pretty useful script, and passing selected items from Out-GridView<\/b> is a good technique to use because it essentially permits one to make a graphical tool very quickly.<\/p>\n If I wanted to, I could turn this into a function in about 30 seconds—but it is not something I feel like doing at this time. I would specify an input parameter for my module name, and maybe add a parameter to permit only full examples or standard Help output. But like I said, it is not something I feel a real need to do. Using it directly from the Windows PowerShell ISE is fine for what it is.<\/p>\n The first thing I do is specify a variable to hold the module name. This makes it pretty easy to switch modules if I need to do so. Next I use the Get-Command<\/b> cmdlet to find all the cmdlets and other commands in the specific module. This is shown here:<\/p>\n $m = "hyper-v"<\/p>\n Get-Command -Module $m | <\/p>\n The next thing I do is use the Select-Object<\/b> cmdlet to choose a few particular properties from the CmdletInfo<\/b> object that is returned via the Get-Command<\/b> cmdlet. I select the name, verb, noun, and the definition parameters:<\/p>\n Select-Object name, verb, noun, definition |<\/p>\n I pipe the object to the Out-GridView<\/b> cmdlet. I specify a title that includes the module name, and I use the –Passthru<\/b> parameter. This is important because it pauses the execution of the script, and it waits until I select a cmdlet from the grid view list. After I make a selection, it passes the resulting object down the pipeline. Here is the command:<\/p>\n Out-GridView -Title "Cmdlets from the $m module" -PassThru |<\/p>\n The last thing I do is send the output from Out-GridView<\/b> to the Get-Help<\/b> cmdlet. The complete script is shown here:<\/p>\n $m = "hyper-v"<\/p>\n Get-Command -Module $m |<\/p>\n Select-Object name, verb, noun, definition |<\/p>\n Out-GridView -Title "Cmdlets from the $m module" -PassThru |<\/p>\n Get-Help <\/p>\n As seen here, when I run the script, the output first appears in a grid:<\/p>\n When I press the OK<\/b> button, the object moves down the pipeline to the Get-Help<\/b> cmdlet. The output from the Get-Help<\/b> command appears in the output of the Windows PowerShell ISE. This is shown here where I had selected Add-VMHardDiskDrive<\/b> from the list in the Out-GridView<\/b> grid:<\/p>\n And that is all there is to using Out-GridView<\/b> to assist in exploring Windows PowerShell Help.<\/p>\n I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n Ed Wilson, Microsoft Scripting Guy<\/b> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":" Summary: Microsoft Scripting Guy, Ed Wilson, talks about using Windows PowerShell to explore Help topics. Microsoft Scripting Guy, Ed Wilson, is here. With the drops of the Windows Management Framework 5.0 (also known as Windows PowerShell 5.0), now is a good time to begin exploring modules, new cmdlets, and so on. It is way cool that Windows […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[463,3,4,61,45],"class_list":["post-207","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-help","tag-scripting-guy","tag-scripting-techniques","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":" Summary: Microsoft Scripting Guy, Ed Wilson, talks about using Windows PowerShell to explore Help topics. Microsoft Scripting Guy, Ed Wilson, is here. With the drops of the Windows Management Framework 5.0 (also known as Windows PowerShell 5.0), now is a good time to begin exploring modules, new cmdlets, and so on. It is way cool that Windows […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/207","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=207"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/207\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=207"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=207"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-12-13-14-01.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-12-13-14-02.png\" "\\"Image")
<\/a><\/p>\n