{"id":4842,"date":"2012-10-11T00:01:00","date_gmt":"2012-10-11T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2012\/10\/11\/using-categories-to-help-search-powershell-help\/"},"modified":"2012-10-11T00:01:00","modified_gmt":"2012-10-11T00:01:00","slug":"using-categories-to-help-search-powershell-help","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/using-categories-to-help-search-powershell-help\/","title":{"rendered":"Using Categories to Help Search PowerShell Help"},"content":{"rendered":"

Summary<\/b>: Learn how to use advanced features in the Windows PowerShell Get-Help<\/b> cmdlet to quickly find PowerShell Help information.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. It seems that my schedule keeps getting fuller. Tonight is the Windows PowerShell User Group in Charlotte<\/a>. We will be having a script club, so it should be a really cool learning opportunity. If you have never been to a script club meeting, they are a bit different. For example, tonight we will have a scenario, and everyone will have a certain amount of time to solve the scenario. Then each participant will have a chance to explain their script to the group. It is great learning opportunity. Beginners can ask questions, and solicit help from the more experienced club members. You do not have to make a presentation if you do not want to do so. I always learn something due to the many different ways of approaching a specific problem. If you are in the area tonight, stop on by, it will be great fun.<\/p>\n

On Monday October 15, 2012, I speak at the Raleigh SQL users group Raleigh SQL Server User Group<\/a> about using Windows PowerShell to manage SQL Server 2012. It will be a lot of fun. Then Windows PowerShell Saturday #003<\/a> happens in Atlanta, Georgia on October 27. I will be making two presentations there. Of course, the Scripting Wife will be accompanying me to all of these October events. It seems the list of where I will be changes on a daily basis, so you can always check the Scripting Community page<\/a> to see upcoming Windows PowerShell events in your area.<\/p>\n

Playing around with Get-Help<\/h2>\n

The more I play around with the Get-Help<\/b> cmdlet, the more I like it. I also seem to continue to find new things to explore with this cmdlet.<\/p>\n

Note   <\/b>In Windows PowerShell 3.0 you must first use the Update-Help<\/b> cmdlet to update the help files. See this collection of blogs<\/a> that talk about updatable Help in Windows PowerShell 3.0.<\/p>\n

When first learning Windows PowerShell, it is important to get good at using the Get-Command<\/b> cmdlet, the Get-Member<\/b> cmdlet and the Get-Help<\/b> cmdlet. Each of these cmdlets are important because they help with the discoverability of Windows PowerShell. In addition, each cmdlet is powerful and has multiple levels of use. Today, I want to talk a bit about using the Get-Help<\/b> cmdlet.<\/p>\n

There is no alias created for the Get-Help<\/b> cmdlet, but there is a function called Help. You can use the Help function in the same way that you would use the Get-Help<\/b> cmdlet. The difference is that the Help function contains a built-in More<\/b> <\/i>function. It will automatically display information, one page at a time, when the information takes more than a single page to display in the Windows PowerShell console. In the Windows PowerShell ISE, there is no pager; therefore, the More<\/b> <\/i>function does not work.<\/p>\n

By default, when using the Get-Help<\/b> cmdlet, most people type Get-Help<\/b> and a name of a cmdlet, for example, Get-Process<\/b>. The command to display Help information about the Get-Process<\/b> cmdlet is shown here.<\/p>\n

Get-Help Get-Process<\/p>\n

The command and associated output are shown in the image that follows.<\/p>\n

\"Image<\/a><\/p>\n

There are four levels of detail that are displayed by the Get-Help<\/b> cmdlet. The levels are Default, Detailed, Full, and Example. The Detailed, Full, and Example levels are accessible via switched parameters. The first, Default, is the default view.<\/p>\n

In addition to the four defined levels of Help, additional parameters accept values to aid in searching the Help files for specific information. Some do not work with the core cmdlets, but they could be implemented by Help writers in the future. The three parameters that do not really work right now are Role<\/b>, <\/i>Component<\/b>, <\/i>and Functionality<\/b>. <\/i><\/p>\n

One of the parameters that is pretty cool is Category<\/b>. Available categories for this parameter are as follows:<\/p>\n

Alias<\/p>\n

Cmdlet<\/p>\n

Provider<\/p>\n

General<\/p>\n

FAQ<\/p>\n

Glossary<\/p>\n

HelpFile<\/p>\n

ScriptCommand<\/p>\n

Function<\/p>\n

Filter<\/p>\n

ExternalScript<\/p>\n

AllDefaultHelp<\/p>\n

Workflow<\/p>\n

Because of the way that Windows PowerShell 3.0 automatically finds information in modules that are not yet loaded, use of the Get-Help<\/b> command provides information about items from the various categories even if they are not loaded. For example, the following command returns Help information on my system, because I have a haswmivalue <\/i>filter in my HSGWMImoduleV6.<\/p>\n

help -Category filter<\/p>\n

The command and associated information are shown in the image that follows.<\/p>\n

\"Image<\/a><\/p>\n

Keep in mind, that when using the Category<\/b> <\/i>parameter to find Help information that are related to specific categories of commands, you still have access to the Full<\/b>, <\/i>Detailed<\/b>, <\/i>and <\/i>Examples<\/b> <\/i>switches. Therefore, the following commands also work.<\/p>\n

help -Category filter –Examples<\/p>\n

help -Category filter –Detailed<\/p>\n

help -Category filter –Full<\/p>\n

To find where the filter resides, use the Get-Command<\/b> cmdlet as shown here.<\/p>\n

PS C:\\> gcm haswmivalue<\/p>\n

 <\/p>\n

CommandType     Name                                               ModuleName<\/p>\n

———–     —-                                               ———-<\/p>\n

Filter          HasWmiValue                                        HSGWMImoduleV6<\/p>\n

To search the About <\/i>Help files, as opposed to the Cmdlet<\/i> Help files, use the category HelpFile<\/b>. <\/i>The following script illustrates a command to search the About <\/i>Help files for articles related to operators as well as the output associated with the command.<\/p>\n

PS C:\\> Get-Help -Category helpfile -name *operator*<\/p>\n

 <\/p>\n

Name                              Category  Module                    Synopsis<\/p>\n

—-                              ——–  ——                    ——–<\/p>\n

about_Arithmetic_Operators        HelpFile                            Describes t…<\/p>\n

about_Assignment_Operators        HelpFile                            Describes h…<\/p>\n

about_Comparison_Operators        HelpFile                            Describes t…<\/p>\n

about_Logical_Operators           HelpFile                            Describes t…<\/p>\n

about_Operators                   HelpFile                            Describes t…<\/p>\n

about_Operator_Precedence         HelpFile                            Lists the W…<\/p>\n

about_Type_Operators              HelpFile                            Describes t…<\/p>\n

Join me tomorrow when I will talk about more cool Windows PowerShell stuff.<\/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><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Learn how to use advanced features in the Windows PowerShell Get-Help cmdlet to quickly find PowerShell Help information. Microsoft Scripting Guy, Ed Wilson, is here. It seems that my schedule keeps getting fuller. Tonight is the Windows PowerShell User Group in Charlotte. We will be having a script club, so it should be a […]<\/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":[51,362,3,45],"class_list":["post-4842","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-powershell-3","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Learn how to use advanced features in the Windows PowerShell Get-Help cmdlet to quickly find PowerShell Help information. Microsoft Scripting Guy, Ed Wilson, is here. It seems that my schedule keeps getting fuller. Tonight is the Windows PowerShell User Group in Charlotte. We will be having a script club, so it should be a […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4842","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=4842"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4842\/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=4842"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=4842"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=4842"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}