重新使用 PowerShell 测量该文件夹

去年我发布了一个 PowerShell 函数来测量文件夹的大小。我最近需要再次使用它，并意识到它需要一些调整。默认情况下，原始版本会递归搜索所有子文件夹。但可能有些情况你只想测量顶层文件夹，所以我添加了一个 -NoRecurse 参数。我还添加了一个参数来显示平均值。

这是更新后的功能：

Function Measure-Folder {

<#
.SYNOPSIS
Measure the size of a folder.

.DESCRIPTION
This 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.

.PARAMETER Path
The default is the current path. The command will fail if it is not a FileSystem path.

.Parameter Average
Calculate the average file size. This will be formatted with the same unit as the total size.

.PARAMETER NoRecurse
The default behavior is to recurse through all subfolders. But you can suppress that by using -NoRecurse.

.PARAMETER Unit
The default unit of measurement is bytes, but you can use any of the standard PowerShell numeric shortcuts: "KB","MB","GB","TB","PB"

.EXAMPLE
PS C:\> measure-folder c:\scripts 

Path            Name         Count         Size
----            ----         -----         ----
C:\scripts      scripts       2858     43800390

Measure the scripts folder using the default size of bytes.

.EXAMPLE

PS C:\> dir c:\scripts -Directory | measure-folder -Unit kb | Sort Size* -Descending | Select -first 5 | format-table -AutoSize

Path                     Name          Count          SizeKB
----                     ----          -----          ------
C:\scripts\GP            GP               40  2287.080078125
C:\scripts\Workflow      Workflow         64 1253.0185546875
C:\scripts\modhelp       modhelp           1  386.4970703125
C:\scripts\stuff         stuff             4       309.09375
C:\scripts\ADTFM-Scripts ADTFM-Scripts    76  297.7880859375

Get 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.

.EXAMPLE
PS C:\> measure-folder $env:temp -Average -unit MB

Path   : C:\Users\Jeff\AppData\Local\Temp
Name   : Temp
Count  : 64626
SizeMB : 6769.94603252411
AvgMB  : 0.104755764437287

Measure all the %TEMP% folder, including a file average all formatted in MB.
.NOTES
Last Updated: July 13, 2015
Version     : 2.0

Originally published at https://jdhitsolutions.com/blog/scripting/3715/friday-fun-the-measure-of-a-folder/

Learn more about PowerShell:
Essential PowerShell Learning Resources


  ****************************************************************
  * DO NOT USE IN A PRODUCTION ENVIRONMENT UNTIL YOU HAVE TESTED *
  * THOROUGHLY IN A LAB ENVIRONMENT. USE AT YOUR OWN RISK.  IF   *
  * YOU DO NOT UNDERSTAND WHAT THIS SCRIPT DOES OR HOW IT WORKS, *
  * DO NOT USE IT OUTSIDE OF A SECURE, TEST SETTING.             *
  ****************************************************************
  

.LINK
Get-ChildItem
Measure-Object

.INPUTS
string or directory

.OUTPUTS
Custom object
#>
[cmdletbinding()]

Param(
[Parameter(Position=0,ValueFromPipeline=$True,
ValueFromPipelineByPropertyName=$True)]
[ValidateScript({
if (Test-Path $_) {
   $True
}
else {
   Throw "Cannot validate path $_"
}
})]
[Alias("fullname")]
[string]$Path = ".",
[switch]$NoRecurse,
[Alias("avg")]
[switch]$Average,
[ValidateSet("bytes","KB","MB","GB","TB","PB")]
[string]$Unit = "bytes"
)

Begin {
    Write-Verbose -Message "Starting $($MyInvocation.Mycommand)"  

    #hash table of parameters to Splat to Get-ChildItem
    $dirHash = @{
     File = $True
     Recurse = $True
    }
    if ($NoRecurse) {
        Write-Verbose "No recurse"
        $dirHash.remove("recurse")
    }

    #hash table of parameters to splat to measure-Object
    $measureHash = @{
        Property = "length"
        Sum = $True
    }
    if ($Average) {
        Write-Verbose "Including Average"
        $measureHash.Add("Average",$True)
    }
} #begin

Process {
    $Resolved = Resolve-Path -Path $path
    $Name = Split-Path -Path $Resolved -Leaf

    #verify we are in the file system
    if ($Resolved.Provider.Name -eq 'FileSystem') {

    #define a hash table to hold new object properties
    $propHash = [ordered]@{
      Path=$Resolved.Path
      Name=$Name
    }

    Write-Verbose "Measuring $resolved in $unit"

    $dirHash.Path = $Resolved

    $stats = Get-ChildItem @dirHash | Measure-Object @measureHash

    Write-Verbose "Measured $($stats.count) files"

    $propHash.Add("Count",$stats.count)
    Switch ($Unit) {

    "bytes" { 
                $propHash.Add("Size",$stats.sum)       
                if ($average) {
                    $propHash.Add("Avg",$stats.Average)
                }
                break 
            }
    "kb"    { 
                $propHash.Add("SizeKB",$stats.sum/1KB) 
                if ($average) {
                    $propHash.Add("AvgKB",$stats.Average/1KB)
                }
                break 
            }
    "mb"    { 
                $propHash.Add("SizeMB",$stats.sum/1MB)
                if ($average) {
                    $propHash.Add("AvgMB",$stats.Average/1MB)
                }
                break
            }
    "gb"    { 
                $propHash.Add("SizeGB",$stats.sum/1GB)
                if ($average) {
                    $propHash.Add("AvgGB",$stats.Average/1GB)
                }
                break
            }
    "tb"    { 
                $propHash.Add("SizeTB",$stats.sum/1TB)
                if ($average) {
                    $propHash.Add("AvgTB",$stats.Average/1TB)
                }
                break
            }
    "pb"    { 
                $propHash.Add("SizePB",$stats.sum/1PB)
                if ($average) {
                    $propHash.Add("AvgPB",$stats.Average/1PB)
                } 
                break
            }

    } #switch

    #write the new object to the pipeline
    New-Object -TypeName PSobject -Property $propHash

    }
    else {
        Write-Warning "You must specify a file system path."
    }

} #process

End {
    Write-Verbose -Message "Ending $($MyInvocation.Mycommand)"
} #end

} #end function

我希望您能让我知道您的想法或哪些附加功能会有所帮助。

更新：要获取此功能的更新版本，请访问此处。