{"id":6371,"date":"2015-04-29T00:01:00","date_gmt":"2015-04-29T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/04\/29\/powershell-tips-and-tricks-extended-history\/"},"modified":"2019-02-18T10:29:43","modified_gmt":"2019-02-18T17:29:43","slug":"powershell-tips-and-tricks-extended-history","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/powershell-tips-and-tricks-extended-history\/","title":{"rendered":"PowerShell Tips and Tricks: Extended History"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, talks about a module that provides extended command history.<\/span><\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. One of the things that came up during the Charlotte Windows PowerShell User Group meeting was the HistoryPx module that was written by Windows PowerShell MVP, Kirk Munro. This module adds additional history information to the Windows PowerShell console. For example, he adds information about the duration of a command, the output of the command, and errors generated by the command.<\/p>\n

Installing  HistoryPx<\/h2>\n

Installing the HistoryPx module is really easy because it is hosted on GitHub, and therefore I can use PSGet to download and install the module.<\/p>\n

Note <\/b> PSGet is a community-developed module that streamlines the installation of modules. It is available from PSGet.net<\/a>. It provides cmdlets such as Install-Module<\/b> and Update-Module<\/b>.<\/p>\n

To install the HistoryPx module, I also need to ensure that I have the SnippetPX module. Luckily, I can install both modules by using the following command, which will install the modules for all users:<\/p>\n

Install-Module HIstoryPx, SnippetPx<\/p>\n

Note<\/b>  Running this command requires elevated permissions.<\/p>\n

I can also install the modules for me only. If I do not want to be prompted with the EULA, then I use the –AcceptEula<\/b> switch. This command is shown here:<\/p>\n

Install-Module HistoryPx, SnippetPx  -Scope CurrentUser -AcceptEula<\/p>\n

Using the extended history module<\/h2>\n

After I have installed the HistoryPx module and the SnippetPx module, I can import the HistoryPx module by using the Import-Module<\/b> cmdlet:<\/p>\n

Import-Module HistoryPx<\/p>\n

I can now use the standard Get-History<\/b> cmdlet to retrieve my command history. This is because the HistoryPx module creates proxy functions (that is, it extends the standard Get-History<\/b> cmdlet).<\/p>\n

Note <\/b> There are several posts on the Hey, Scripting Guy! Blog about proxy functions. A good starting point is one by Windows PowerShell MVP, Shay Levy, called Proxy Functions: Spice Up Your PowerShell Core cmdlets<\/a>.<\/p>\n

Here is the output from the Get-History<\/b> cmdlet now (h<\/b> is an alias for Get-History<\/b>):<\/p>\n

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

One of the cool things about the module is that it automatically captures output in a variable, $__ <\/b>, <\/b>(it has two underscores). This means that when I am working interactively in the Windows PowerShell console, I do not need to use an intermediate variable. I can use the $__<\/b> variable and filter it directly. This technique is shown here, where I look for commands that contain the word Install<\/b>:<\/p>\n

PS C:\\> $__.where{$_.commandline -match 'install'<\/p>\n

 Id   CommandLine       Duration     Success   #Errors   Output<\/p>\n

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

   2 Install-Module HistoryPx, S… 00:00:02.515   True<\/p>\n

  10 $__.where({$psitem.commandl… 00:00:00.015   True    0       {}<\/p>\n

  12 $__.where{$_.commandline -m… 00:00:00.000   True    0       {}<\/p>\n

I see the command I was interested in is command number two. So I can now use Get-History<\/b> to look directly at the command history for that command. This is shown here:<\/p>\n

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

  Id   CommandLine       Duration     Success   #Errors   Output<\/p>\n

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

   2 Install-Module HistoryPx, S… 00:00:02.515   True<\/p>\n

There is a lot more I can do with this module, and Kirk has documented it well in his GitHub project HistoryPx<\/a>. You may want to install the modules, play around with them, and see if they help you work more effectively.<\/p>\n

Windows PowerShell Tips and Tricks Week continues tomorrow when I will talk about more cool 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> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about a module that provides extended command history. Microsoft Scripting Guy, Ed Wilson, is here. One of the things that came up during the Charlotte Windows PowerShell User Group meeting was the HistoryPx module that was written by Windows PowerShell MVP, Kirk Munro. This module adds additional history […]<\/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":[3,4,578,45],"class_list":["post-6371","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-scripting-techniques","tag-tips-and-tricks","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about a module that provides extended command history. Microsoft Scripting Guy, Ed Wilson, is here. One of the things that came up during the Charlotte Windows PowerShell User Group meeting was the HistoryPx module that was written by Windows PowerShell MVP, Kirk Munro. This module adds additional history […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6371","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=6371"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6371\/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=6371"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=6371"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=6371"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}