{"id":77271,"date":"2016-02-23T00:01:04","date_gmt":"2016-02-23T08:01:04","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/?p=77271"},"modified":"2022-04-21T13:23:45","modified_gmt":"2022-04-21T20:23:45","slug":"overview-of-the-powershell-get-module-to-find-scripts","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/overview-of-the-powershell-get-module-to-find-scripts\/","title":{"rendered":"Overview of the PowerShellGet module to find scripts"},"content":{"rendered":"

Summary<\/strong>: In this blog post, I provide a quick overview of the PowerShellGet<\/strong> module and its various commands.<\/p>\n

Believe it or not, the Windows PowerShell Saturday event in Tampa, Florida<\/a> is coming up pretty quickly. There are still some tickets available, but they have been going pretty quickly lately. There are some awesome speakers coming to Tampa for this event and I am looking forward to seeing all of them. Something really cool is that Ashley McGlone is coming from Columbus, Ohio for the event. I was his mentor for a couple of years, and it is really great to see how successful he has become. In fact, we are getting together after the PowerShell Summit in Seattle to record a couple sessions for a Microsoft Virtual Academy<\/a> (MVA) course. Several speakers from Tampa will also be involved in this project. I can say that we have a blue ribbon roster of speakers for our event in Tampa\u2014all of whom are well known in the Windows PowerShell community. Ashley asked me to talk a bit about the PowerShellGet<\/strong> module and package management in Windows PowerShell for the MVA course we will be doing. With this in mind, I have been playing with Windows PowerShellGet<\/strong> more.<\/p>\n

Explore the PowerShell Get module<\/h2>\n

The first thing that I do when I am looking at something new, or when I want to refresh my memory about something is to look at the module. Because most stuff in Windows PowerShell ships in a module now, it is always a safe bet that there is a module. I can use<\/p>\n

Get-Module<\/strong> to list all modules, and then I can search through the list. But in this case, I happen to know that the module is PowerShellGet<\/strong>, so I don\u2019t need to do that. I type the following command, but the results are a bit muddled because the ExportedCommands<\/strong> is a collection, and it needs to be expanded to make more sense.<\/p>\n

  PS C:\\> Get-Module PowerShellGet | select ExportedCommands\n\n  ExportedCommands\n  ----------------\n  {[Find-DscResource, Find-DscResource], [Find-Module, Find-Module], [Find-Script, ...\n<\/code><\/pre>\n
The easy way to do this is to use the Expand<\/strong> parameter from Select-Object<\/strong>. Here is the command I use:<\/p>\n
  Get-Module PowerShellGet | select -EXPAND ExportedCommands\n<\/code><\/pre>\n
The command and its output are shown here:<\/p>\n
\"Image<\/a><\/p>\n
From the list of commands, I can see that the first thing I might need to do is to see if I have a registered Windows PowerShell repository. The cmdlet I use is Get-PSRepository<\/strong>:<\/p>\n
  PS C:\\> Get-PSRepository\n\n  Name \u00a0 \u00a0      PackageManagementProvider InstallationPolicy\u00a0\u00a0 SourceLocation\n  ---- \u00a0 \u00a0      ------------------------- ------------------\u00a0\u00a0 -----------\n  PSGallery\u00a0\u00a0\u00a0\u00a0\u00a0NuGet\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Untrusted\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 https:\/\/...\n<\/code><\/pre>\n
Again, the output is a bit truncated, so I decide to pipe the output to Format-List<\/strong>:<\/p>\n
\"Image<\/a><\/p>\n
Cool. I can see that I have registered the PSGallery and that it uses NuGet as the package management provider. I also see the publish location and other locations. It is not a trusted location and the installation policy is listed as untrusted. Sweet.<\/p>\n
Finding scripts<\/h2>\n
I saw that there is a Find-Script<\/strong> command. I also see that there is a script publish and source location in the PSGallery, so I can probably use Find-Script<\/strong> to find a script. I happen to know that one reason for this is so I can easily use script resources with OMS automation<\/a>. Right now, it is not unreasonable to simply use Find-Script<\/strong> with no parameters and look at the output. There are not that many scripts published to PSGallery at this point. Here is the output from the command:<\/p>\n
\"Image<\/a><\/p>\n
But if I have an idea as to what I am interested in finding, I can use wildcard characters after Find-Script<\/strong>. Here, I look for a script that may have the letters automat<\/strong> in the name:<\/p>\n
PS C:\\> Find-Script *automat*\n\nVersion\u00a0\u00a0\u00a0 Name \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0         Type\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Repository\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Description\n-------\u00a0\u00a0\u00a0 ----\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ----\u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0----------\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 -----\n1.0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Start-AutomationChildRunbook\u00a0\u00a0\u00a0\u00a0\u00a0Script\u00a0\u00a0\u00a0\u00a0 PSGallery\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Th...\n1.0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Create-AutomationReport\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0Script\u00a0\u00a0\u00a0\u00a0 PSGallery\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Th...\n<\/code><\/pre>\n
Once again, I have the truncated output. I am most interested in the name and description. I use \nFormat-Table<\/strong> and -Wrap<\/strong> to help me get better output:<\/p>\n
Find-Script *automat* | Format-Table name, description -Wrap\n<\/code><\/pre>\n
This command and its output are shown here:<\/p>\n
\"Image<\/a><\/p>\n
Join me tomorrow when I will talk about finding DSC resources. 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>. Also check out my Microsoft Operations Management Suite Blog<\/a>. See you tomorrow. Until then, peace. Ed Wilson, Microsoft Scripting Guy<\/strong> \u00a0 \u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"
Summary: In this blog post, I provide a quick overview of the PowerShellGet module and its various commands. Believe it or not, the Windows PowerShell Saturday event in Tampa, Florida is coming up pretty quickly. There are still some tickets available, but they have been going pretty quickly lately. There are some awesome speakers coming […]<\/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":[568],"tags":[51,666,3,45],"class_list":["post-77271","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-hey-scripting-guy","tag-getting-started","tag-powershell-get","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"
Summary: In this blog post, I provide a quick overview of the PowerShellGet module and its various commands. Believe it or not, the Windows PowerShell Saturday event in Tampa, Florida is coming up pretty quickly. There are still some tickets available, but they have been going pretty quickly lately. There are some awesome speakers coming […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/77271","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=77271"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/77271\/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=77271"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=77271"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=77271"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}