{"id":9271,"date":"2012-05-30T00:01:00","date_gmt":"2012-05-30T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2012\/05\/30\/learn-the-easy-way-to-use-powershell-to-get-file-hashes\/"},"modified":"2012-05-30T00:01:00","modified_gmt":"2012-05-30T00:01:00","slug":"learn-the-easy-way-to-use-powershell-to-get-file-hashes","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/learn-the-easy-way-to-use-powershell-to-get-file-hashes\/","title":{"rendered":"Learn the Easy Way to Use PowerShell to Get File Hashes"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, talks about using the Windows PowerShell PSCX Get-Hash cmdlet to get hash files in a directory.<\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I have a question that I hope will not require a lot of work on your part. I need to find the MD5 hash of files and folders. I use this information to determine if something has changed on a system. The problem is that everything I have seen appears to make this really complicated. Is there anything you can do that will make this easier?<\/p>\n

—MO<\/p>\n

\"Hey,<\/p>\n

 Hello MO,<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. It is official. I am going to be doing a book signing at Microsoft TechEd 2012. I will be autographing copies of my Windows PowerShell 2.0 Best Practices book that was published by Microsoft Press. Incidentally, the autograph session will take place at the O’Reilly booth on Tuesday at 10:30 (refer to the following blog for a complete schedule: The Scripting Guys Reveal Their TechEd 2012 Schedule<\/a>. You will want to get to the booth early because we will be giving away autographed copies to the first 25 people in line. If you have a copy that you want to ensure gets signed, bring it to the book signing. Or just bring it along to the Scripting Guys booth, where I will also be glad to sign books, T-shirts, hats…whatever you happen to have (not blank checks, however).<\/p>\n

Note<\/b>   This is the third in a series of four Hey, Scripting Guy! blogs about using Windows PowerShell to facilitate security forensic analysis of a compromised computer system. The intent of the series is not to teach security forensics, but rather to illustrate how Windows PowerShell could be utilized to assist in such an inquiry. The first blog discussed using Windows PowerShell to capture and to analyze process and service information<\/a>.  The second blog talked about using Windows PowerShell to save event logs in XML format and perform offline analysis<\/a>.<\/p>\n

MD5 hashing of files<\/h2>\n

MO, actually I do not think that doing a MD5 hash is all that complicated—a bit tedious, but not overly complicated. The MD5Class<\/a> is documented on MSDN, and it is not too bad. However, there is no real reason for IT Pros to have to mess with the .NET Framework classes if they do not want to do so. The reason? Well, the reason is that the Windows PowerShell Community Extensions includes a function that will get the MD5 hash for you. It works just like any other Windows PowerShell function or cmdlet, and it is extremely easy to use.<\/p>\n

Note   <\/b>I have written several blogs about the PowerShell Community Extensions (PSCX).<\/a> One especially well received blog, Tell Me About PowerShell Community Extensions<\/a>, <\/i>was written by one of the developers of the project, Windows PowerShell MVP, Keith Hill. To obtain the PSCX, download them from CodePlex<\/a>, and follow the installation instructions in Keith’s blog.<\/p>\n

After you install the PSCX, import the module by using the following command:<\/p>\n

Import-Module pscx<\/p>\n

The cmdlet you want to use is the Get-Hash<\/b> cmdlet. It accepts piped input for the path to the file to hash, and it returns an object with the path to the file and the hash value. You can specify the type of hash to use (MD5, SHA1, SHA256, SHA384, SHA512, or RIPEMD160), but this is not a requirement because it selects an MD5 hash by default. The Get-Hash<\/b> cmdlet does not hash directories, only files. Therefore, an error returns (Access is denied) when the Get-Hash<\/b> cmdlet runs across directories. There are several approaches to dealing with this issue:<\/p>\n

    \n
  1. Ignore the error.<\/li>\n
  2. Tell the cmdlet to ignore the error by specifying an error action.<\/li>\n
  3. Develop a filter (by using the Where-Object<\/b>) that returns only files.<\/li>\n<\/ol>\n

    Ignore the error<\/h2>\n

    The following command generates an MD5 hash for every file in the c:\\fso directory:<\/p>\n

    <\/span>dir c:\\fso -Recurse | Get-Hash<\/p>\n

    The command and its associated output are shown here (errors appear in the output due to the presence of child directories).<\/p>\n

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

    Tell the cmdlet to ignore the error<\/h2>\n

    One way to deal with expected errors is to tell the cmdlet to ignore the error for you. Windows PowerShell cmdlets implement a common parameter named ErrorAction. <\/i>Use of the ErrorAction <\/i>ubiquitous parameter permits you to control the error action preference on a command-by-command basis. You can achieve the behavior of the VBScript script On Error Resume Next <\/i>functionality if you so desire, but the real power is that it is doable on a cmdlet-by-cmdlet basis. There is also a global variable named $ErrorActionPreference<\/b> that enables you to set the behavior on a global basis. There are four allowable values for the ActionPreference<\/b>. These values are shown here (retrieved by using the GetValues<\/b> <\/i>static method from the System.Enum .NET Framework class).<\/p>\n

    PS C:\\> [enum]::GetValues(“System.Management.Automation.ActionPreference”)<\/p>\n

    SilentlyContinue<\/p>\n

    Stop<\/p>\n

    Continue<\/p>\n

    Inquire<\/p>\n

    The SilentlyContinue<\/i> value tells Windows PowerShell to not report any errors, but to continue to attempt to process the next command. This is the On Error Resume Next <\/i>type of setting. Stop<\/i> means that Windows PowerShell will halt execution when reaching an error. Continue<\/i> means that Windows PowerShell will inform you of the error, and will then continue processing if possible (this is the default behavior). Inquire<\/i> means that Windows PowerShell will let you know an error occurred, and ask you if you want to continue execution or halt the command. There are numerical equivalents to the values, and therefore, SilentlyContinue<\/i> is equal to 0. The ErrorAction<\/i> common parameter also has a parameter alias of EA<\/i>. Therefore, by using the previous information, the following command appears.<\/p>\n

    dir c:\\fso -Recurse | Get-Hash -ea 0<\/p>\n

    The command to retrieve an MD5 hash value for each file in the c:\\fso directory and to suppress any errors that may arise is shown here, along with the output associated with the command.<\/p>\n

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

    Develop a filter<\/h2>\n

    To create a filter that only returns files, use the psiscontainer<\/b> <\/i>property with Where-Object<\/b>. Because I do not want to retrieve any ps<\/b> container type of objects, I use the not operator (!<\/b>) to tell Windows PowerShell that I want no containers. This approach is shown here.<\/p>\n

    dir c:\\fso -Recurse | Where-Object {!$_.psiscontainer } | get-hash<\/p>\n

    The command and the output from the command are shown here.<\/p>\n

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

    From a performance standpoint, filtering out only files was a bit faster—not much, but a little: 3.06 total seconds as opposed to 3.28 total seconds. Due to file system caching, I rebooted my computer, ran the Measure-Command<\/b> cmdlet, rebooted the computer, and ran the Measure-Command<\/b> cmdlet. This eliminated caching from the equation. The commands and the associated output from the commands are shown here.<\/p>\n

    PS C:\\> Measure-Command { dir c:\\fso -Recurse | Where-Object {!$_.psiscontainer } | g<\/p>\n

    et-hash }<\/p>\n

     <\/p>\n

    Days              : 0<\/p>\n

    Hours             : 0<\/p>\n

    Minutes           : 0<\/p>\n

    Seconds           : 3<\/p>\n

    Milliseconds      : 61<\/p>\n

    Ticks             : 30610419<\/p>\n

    TotalDays         : 3.54287256944444E-05<\/p>\n

    TotalHours        : 0.000850289416666667<\/p>\n

    TotalMinutes      : 0.051017365<\/p>\n

    TotalSeconds      : 3.0610419<\/p>\n

    TotalMilliseconds : 3061.0419<\/p>\n

     <\/p>\n

    PS C:\\> Measure-Command { dir c:\\fso -Recurse | Get-Hash -ea 0 }<\/p>\n

     <\/p>\n

    Days              : 0<\/p>\n

    Hours             : 0<\/p>\n

    Minutes           : 0<\/p>\n

    Seconds           : 3<\/p>\n

    Milliseconds      : 280<\/p>\n

    Ticks             : 32803013<\/p>\n

    TotalDays         : 3.79664502314815E-05<\/p>\n

    TotalHours        : 0.000911194805555555<\/p>\n

    TotalMinutes      : 0.0546716883333333<\/p>\n

    TotalSeconds      : 3.2803013<\/p>\n

    TotalMilliseconds : 3280.3013<\/p>\n<\/p>\n

    MO, that is all there is to using the Get-Hash<\/b> cmdlet from the PSCX to obtain hash values from files in a folder. Security Week will continue tomorrow when I will talk about storing and comparing hash values to detect changes to files.<\/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: Microsoft Scripting Guy, Ed Wilson, talks about using the Windows PowerShell PSCX Get-Hash cmdlet to get hash files in a directory. Hey, Scripting Guy! I have a question that I hope will not require a lot of work on your part. I need to find the MD5 hash of files and folders. I use […]<\/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,63,45],"class_list":["post-9271","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-security","tag-windows-powershell"],"acf":[],"blog_post_summary":"

    Summary: Microsoft Scripting Guy, Ed Wilson, talks about using the Windows PowerShell PSCX Get-Hash cmdlet to get hash files in a directory. Hey, Scripting Guy! I have a question that I hope will not require a lot of work on your part. I need to find the MD5 hash of files and folders. I use […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/9271","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=9271"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/9271\/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=9271"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=9271"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=9271"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}