external help file | Module Name | online version | schema |
---|---|---|---|
PSScriptTools-help.xml |
PSScriptTools |
2.0.0 |
Get folder size information.
Get-FolderSizeInfo [-Path] <String[]> [-Hidden] [-EnableLongFileName] [<CommonParameters>]
This command is an alternative to discovering the size of a folder, or at least an easier method. Use the -Hidden parameter to include hidden files in the output. The measurement will include all files in all sub-folders.
Note that this command has been optimized for performance, but if you have a lot of files to count that will take time, especially when using Windows PowerShell. When querying system folders like C:\Windows on a Windows PowerShell platform, you might get better results including hidden files. Due to the nature of the .NET Framework changes, you might see different results for the same folder when run in PowerShell 7 compared to Windows PowerShell 5.1.
This command will ignore reparse points, such as symbolic links and junctions.
If using on a profile folder, you will most likely get access denied warnings in Windows PowerShell and you can assume those locations will not be counted.
PS C:\> Get-FolderSizeInfo -Path d:\temp
Computername Path TotalFiles TotalSize
------------ ---- ---------- ---------
BOVINE320 D:\temp 48 121824451
PS C:\> Get-FolderSizeInfo -Path d:\temp -hidden
Computername Path TotalFiles TotalSize
------------ ---- ---------- ---------
BOVINE320 D:\temp 146 125655552
Include hidden files.
PS C:\> Get-ChildItem d:\ -Directory | Get-FolderSizeInfo |
Where-Object TotalSize -gt 1MB | Sort-Object TotalSize -Descending |
Format-Table -View mb
Computername Path TotalFiles TotalSizeMB
------------ ---- ---------- -----------
BOVINE320 D:\VMDisks 18 114873.7246
BOVINE320 D:\ISO 17 42526.8204
BOVINE320 D:\SQLServer2017Media 1 710.8545
BOVINE320 D:\officeViewers 4 158.9155
BOVINE320 D:\Temp 48 116.1809
BOVINE320 D:\Sysinternals 153 59.6169
BOVINE320 D:\blog 41 21.9948
BOVINE320 D:\BackTemp 2 21.6734
BOVINE320 D:\rip 3 11.1546
BOVINE320 D:\logs 134 3.9517
BOVINE320 D:\2016 5 1.5608
Get the top-level directories from D and pipe them to Get-FolderSizeInfo. Items with a total size of greater than 1MB are sorted on the total size and then formatted as a table using a built-in view called MB which formats the total size in MB. There are also views named KB,GB and TB to display formatted results accordingly.
PS C:\> Get-ChildItem c:\work -Directory | Get-FolderSizeInfo -Hidden |
Where-Object {$_.TotalSize -ge 2mb} | Format-Table -view name
Path: C:\work
Name TotalFiles TotalKB
---- ---------- -------
A 20 5843.9951
keepass 15 5839.084
PowerShellBooks 26 4240.3779
sunday 47 24540.6523
Get all sub-folders under C:\work greater than 2MB in size and display using the Name table view.
-Hidden
Include hidden directories.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Enter a file system path like C:\Scripts.
Type: String[]
Parameter Sets: (All)
Aliases: PSPath
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
Enable support for long file and folder names. Read https://learn.microsoft.com/windows/win32/fileio/maximum-file-Path-limitation?tabs=registry to learn more.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: lfn,EnableLN
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/