{"id":4465,"date":"2015-07-22T14:45:30","date_gmt":"2015-07-22T18:45:30","guid":{"rendered":"http:\/\/jdhitsolutions.com\/blog\/?p=4465"},"modified":"2015-07-22T14:50:02","modified_gmt":"2015-07-22T18:50:02","slug":"measuring-folders-with-powershell-one-more-time","status":"publish","type":"post","link":"https:\/\/jdhitsolutions.com\/blog\/powershell\/4465\/measuring-folders-with-powershell-one-more-time\/","title":{"rendered":"Measuring Folders with PowerShell One More Time"},"content":{"rendered":"

I know I just posted an update<\/a> to my Measure-Folder function but I couldn't help myself and now I have an update to the update. Part of the update came as the result of a comment asking about formatting results to a certain number of decimal places. I typically the Round() method from the Math .NET class.<\/p>\n

PS C:\\> [math]::Round(1234.56789,2)\r\n1234.57\r\nPS C:\\> [math]::Round(1234.5678900123,4)\r\n1234.5679<\/pre>\n
So I added a parameter, Round, to automatically round to a certain number of decimal points. The default is 2 but you can enter any value between 0 and 10. If you use 0 the effect is to treat the value as an integer.<\/p>\n
The other change I made was to simplify the code. My intention when creating a PowerShell tool is not have duplicate commands, or commands that are very, very similar. In last week's version I used a Switch statement to dynamically create properties and values. But each item was practically the same except for the unit of measurement. So instead I came up with a hash table of units.<\/p>\n
$unitHash = @{\r\n  Bytes = 1\r\n  KB = 1KB\r\n  MB = 1MB\r\n  GB = 1GB\r\n  TB = 1TB\r\n  PB = 1PB\r\n}<\/pre>\n
With this I can use the hashtable key as the part of property name, and the value for formatting the result.<\/p>\n
$value = [Math]::Round($stats.sum\/$UnitHash.item($unit),$Round)<\/code><\/pre>\n
The property name is created on the fly for anything other than the default \"bytes\".<\/p>\n
$Label = \"Size\"\r\nif ($unit -ne 'bytes') {\r\n  $label+= $($unit.ToUpper())\r\n}\r\n$propHash.Add($label,$value)<\/pre>\n
I use the same process if the user wants the average. Here's the complete revised function.<\/p>\n
#requires -version 4.0\r\n\r\nFunction Measure-Folder {\r\n\r\n<#\r\n.SYNOPSIS\r\nMeasure the size of a folder.\r\n\r\n.DESCRIPTION\r\nThis command will take a file path and create a custom measurement object that shows the number of files and the total size. The default size will be in bytes but you can specify a different unit of measurement. The command will format the result accordingly and dynamically change the property name as well.\r\n\r\n.PARAMETER Path\r\nThe default is the current path. The command will fail if it is not a FileSystem path.\r\n\r\n.PARAMETER Average\r\nGet the average file size. This will be formatted with the same unit as the total size.\r\n\r\n.PARAMETER NoRecurse\r\nThe default behavior is to recurse through all subfolders. But you can suppress that by using -NoRecurse.\r\n\r\n.PARAMETER Unit\r\nThe default unit of measurement is bytes, but you can use any of the standard PowerShell numeric shortcuts: \"KB\",\"MB\",\"GB\",\"TB\",\"PB\"\r\n\r\n.PARAMETER Round\r\nThe number of decimal points to round the sum and average values. The default is 2. Use a value of 10 to not round. The maximum value is 10.\r\n\r\n.EXAMPLE\r\nPS C:\\> measure-folder c:\\scripts \r\n\r\nPath            Name         Count         Size\r\n----            ----         -----         ----\r\nC:\\scripts      scripts       2858     43800390\r\n\r\nMeasure the scripts folder using the default size of bytes.\r\n\r\n.EXAMPLE\r\n\r\nPS C:\\> dir c:\\scripts -Directory | measure-folder -Unit kb | Sort Size* -Descending | Select -first 5 | format-table -AutoSize\r\n\r\nPath                     Name          Count          SizeKB\r\n----                     ----          -----          ------\r\nC:\\scripts\\GP            GP               40         2287.08\r\nC:\\scripts\\Workflow      Workflow         64         1253.02\r\nC:\\scripts\\modhelp       modhelp           1          386.49\r\nC:\\scripts\\stuff         stuff             4          309.09\r\nC:\\scripts\\ADTFM-Scripts ADTFM-Scripts    76          297.78\r\n\r\nGet all the child folders under C:\\scripts, measuring the size in KB. Sort the results on the size property in descending order. Then select the first 5 objects and format the results as a table.\r\n\r\n.EXAMPLE\r\nPS C:\\> measure-folder $env:temp -Average -unit MB -round 10\r\n\r\nPath   : C:\\Users\\Jeff\\AppData\\Local\\Temp\r\nName   : Temp\r\nCount  : 64626\r\nSizeMB : 6769.94603252411\r\nAvgMB  : 0.104755764437287\r\n\r\nMeasure all the %TEMP% folder, including a file average all formatted in MB with no rounding\r\n.NOTES\r\nLast Updated: July 22, 2015\r\nVersion     : 2.2\r\n\r\nOriginally published at http:\/\/jdhitsolutions.com\/blog\/scripting\/3715\/friday-fun-the-measure-of-a-folder\/\r\n\r\nLearn more about PowerShell:\r\n
Essential PowerShell Learning Resources<\/a><\/blockquote>