{"id":13141,"date":"2011-08-01T00:01:00","date_gmt":"2011-08-01T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/08\/01\/use-the-powershell-grep-command-to-parse-the-command-line\/"},"modified":"2011-08-01T00:01:00","modified_gmt":"2011-08-01T00:01:00","slug":"use-the-powershell-grep-command-to-parse-the-command-line","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-the-powershell-grep-command-to-parse-the-command-line\/","title":{"rendered":"Use the PowerShell Grep Command to Parse the Command Line"},"content":{"rendered":"

Summary<\/strong>: In this article, Microsoft Scripting Guy Ed Wilson teaches how to use the Windows PowerShell version of grep to parse the command line.<\/p>\n

 <\/p>\n

\"Hey,Hey, Scripting Guy! I have enjoyed reading Sean’s legacy scripting<\/a> articles, but I am a bit confused. It seems that all these commands return data, and I would love to be able to easily parse the information that the commands return. Can you give me an example of that?<\/p>\n

—KG<\/p>\n

 <\/p>\n

\"Hey,Hello KG,<\/p>\n

Microsoft Scripting Guy Ed Wilson here. The TechReady conference in Seattle last week was great. We even had a few sun sightings during the week. The day I flew into Seattle was absolutely beautiful, and I was able to see all the mountains stretching up into the sky. The Space Needle<\/a> was clearly visible. All in all, it was a Seattle Chamber of Commerce type of day.<\/p>\n

KG, if you are going to work with legacy commands very often, you will need to become competent at using the Select-String <\/b>cmdlet<\/a>. Often, I will look around for an object that will return the same types of information that I might obtain via a legacy command—to avoid the issue of extensive text parsing.<\/p>\n

For example, the ipconfig<\/b> <\/i>command will return an IP address and a log of other information. But I can use WMI to obtain the IP address as well. The following command returns the IP address on my local computer. Note that gwmi<\/b> is an alias for the Get-WMIObject<\/b> cmdlet. I only have one network interface card that is ipenabled, so I can return the ipaddress<\/b> property directly. Unfortunately, the ipaddress<\/b> <\/i>property returns an array with both the IPv4 and IPv6 address in it. I index into the array to return only the IPv4 address:<\/p>\n

(gwmi win32_NetworkAdapterConfiguration -Filter ‘ipenabled = “true”‘).ipaddress[0]<\/p>\n

As you can tell, typing the preceding command is a bit cumbersome when compared to typing ipconfig. <\/i>However, if I put the above command in a function and I place it in my profile or some module, I can call it as easily as typing Get-IPAddress<\/b>. Or if I create an alias, I can type gia<\/b>. The Get-IPAddress<\/b> function and code to create an alias are shown here:<\/p>\n

Get-IPAddressFunction.ps1<\/strong><\/p>\n

Function Get-IPAddress<\/p>\n

{<\/p>\n

 (Get-WmiObject -class win32_NetworkAdapterConfiguration `<\/p>\n

   -Filter ‘ipenabled = “true”‘).ipaddress[0]<\/p>\n

} #end function Get-Ipaddress<\/p>\n

 <\/p>\n

New-Alias -Name GIA -Value Get-IPAddress -Description “HSG alias”<\/p>\n

 <\/p>\n

When I run the function to load it into memory, I can then access it by alias if I wish. This is shown in the following figure.<\/p>\n

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

Figuring out how to use the Select-String<\/b> cmdlet can be a bit confusing. The online help for the cmdlet is rather extensive, and the examples do not seem to cover simple cases. For example, if I want to parse the results of the ipconfig<\/b> command, I might be tempted to do something like this:<\/p>\n

PS C:\\> Select-String -Pattern “IPV4” -InputObject ipconfig<\/p>\n

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

Unfortunately, nothing is returned. I try putting parentheses around the command to force evaluation first, and I at least see something returned to the screen. The command is shown here:<\/p>\n

Select-String -Pattern “IPV4” -InputObject (ipconfig)<\/p>\n

The command and output are shown in the following figure.<\/p>\n

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

As can be seen in the preceding figure, the results are completely jumbled and unreadable. It seems that it might be a lost cause, but if you stick with it and use the pipeline, the output is much more readable. The command that uses the pipeline and the associated output are shown here (in addition, it does not matter if I use the simplematch<\/i> switched parameter or not):<\/p>\n

PS C:\\> ipconfig | Select-String -Pattern “IPv4” -SimpleMatch<\/p>\n

   IPv4 Address. . . . . . . . . . . : 10.0.0.188<\/p>\n

 <\/p>\n

PS C:\\> ipconfig | Select-String -Pattern “IPv4”<\/p>\n

   IPv4 Address. . . . . . . . . . . : 10.0.0.188<\/p>\n

 <\/p>\n

When I try to shorten the command, however, problems arise. I try to use select<\/b> as an alias for the Select-String cmdlet, and no errors appear, but I am left with a blank screen, as shown in the following figure.<\/p>\n

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

The problem is that select<\/b> is an alias for the Select-Object<\/b> cmdlet, and not for the Select-String cmdlet, as shown here:<\/p>\n

PS C:\\> Get-Alias select<\/p>\n

 <\/p>\n

CommandType<\/span>  Name<\/span>               Definition<\/span><\/p>\n

Alias                  select                Select-Object<\/p>\n

 <\/p>\n

Well, what are the aliases for the Select-String<\/b> cmdlet? According to the output, there isn’t even one:<\/p>\n

PS C:\\> Get-Alias -Definition select-string<\/p>\n

Get-Alias : This command cannot find a matching alias because an alias with definition ‘select-string’<\/p>\n

 does not exist.<\/p>\n

At line:1 char:10<\/p>\n

+ Get-Alias <<<<  -Definition select-string<\/p>\n

    + CategoryInfo          : ObjectNotFound: (select-string:String) [Get-Alias], ItemNotFoundException<\/p>\n

    + FullyQualifiedErrorId : ItemNotFoundException,Microsoft.PowerShell.Commands.GetAliasCommand<\/p>\n

Now, I may decide that I would like to create an alias for Select-String<\/b>. Grep<\/b> would be a good one to use. The command to accomplish this appears here (you would want to place it in your startup profile; see this collection of Hey, Scripting Guy! posts<\/a> for information about profiles):<\/p>\n

New-Alias -Name grep -Value Select-String -Description “HSG alias”<\/p>\n

When I have an alias for Select-String<\/b>, I can shorten my command quite a bit. The shortened command and associated output are shown here:<\/p>\n

PS C:\\> ipconfig | grep “IPv4”<\/p>\n

   IPv4 Address. . . . . . . . . . . : 10.0.0.188<\/p>\n

 <\/p>\n

KG, this should be enough to get you started playing around with the Select-String cmdlet. Join me again tomorrow, when we will explore some more ways to use this powerful cmdlet.<\/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

 <\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: In this article, Microsoft Scripting Guy Ed Wilson teaches how to use the Windows PowerShell version of grep to parse the command line.   Hey, Scripting Guy! I have enjoyed reading Sean’s legacy scripting articles, but I am a bit confused. It seems that all these commands return data, and I would love to […]<\/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,3,4,281,45],"class_list":["post-13141","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-select-string","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: In this article, Microsoft Scripting Guy Ed Wilson teaches how to use the Windows PowerShell version of grep to parse the command line.   Hey, Scripting Guy! I have enjoyed reading Sean’s legacy scripting articles, but I am a bit confused. It seems that all these commands return data, and I would love to […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13141","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=13141"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/13141\/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=13141"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=13141"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=13141"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}