Disk info tool

Been reading through Ed Wilson’s new book, Step by Step. Some really cool stuff in there and inspired me to have a play !
Created a small function to obtain the local C: drive freespace and drive size, then format the data into a custom object adding a percent used tab.

Am i on the right lines ?

Function Get-DriveInfo { #Runs only for local device

#Get drive information from WMI
$FreeSpace = (get-wmiobject win32_logicaldisk).where{($PSItem.DeviceID -eq 'C:')} | select Freespace,Size

#Create Object to Display Results
$DriveInfo = [pscustomobject]@{
    Freespace = "{0}","GB" -f [math]::truncate($freespace.freespace / 1GB)
    DiskSize = "{0}","GB" -f [math]::truncate($freespace.size / 1GB) 
    PercentUsed = "{0:P}" -f ($freespace.Freespace / $freespace.Size)

$DriveInfo | ft -AutoSize

}#End of Function

The results are displayed like so,

PS C:\Windows\system32> Get-DriveInfo

Freespace DiskSize PercentUsed

48 GB 237 GB 20.25%

Be good to get some feedback, thanks !

Nice, but the function only get the C:\drive, how about if I have a d:\drive. Use parameters and advanced functions. Nice script.

Thanks Wifredo, i’ll make it a bit more dynamic.

My only suggestion would be to filter with Get-WmiObject rather than using where-object to filter. This is always good practice, the mantra being ‘filter left and format right’.

I’d make these changes:

function Get-DriveInfo {

$freespace = Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceId = 'C:'" | 
Select-Object Freespace, Size

$props = [ordered]@{
    'Freespace(GB)' = [math]::Round($freespace.freespace / 1GB, 2)
    'DiskSize(GB)' = [math]::Round($freespace.size / 1GB, 2) 
    PercentUsed = [math]::Round(($freespace.Freespace / $freespace.Size) * 100, 2)

New-Object -TypeName PSObject -Property $props


Use the CIM cmdlet rather than WMI cmdlet. Use the -Filter parameter rather than Where (already mentioned above)

Change the properties so that you’re outputting numbers rather than strings - put the units into the property name rather than as part of the value

Output the object. You can always use Format-Table outside the function is need be. PowerShell 5 does a reasonable job of formatting table data automatically

Great stuff, thanks Richard and Peter.
Richard, any reason why you didn’t use [PSCUSTOMOBJECT] ?

I’ve added advanced function to it…

function Get-DriveInfo {

    param (
            If ($_ -match "^[A-Za-z]\:+$") {
            else {
                Throw "$_ is either not a valid drive or it is not written as 'C:'."

$freespace = Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceId = '$Drive'" |
 Select-Object Freespace, Size

$props = [ordered]@{
 'Freespace(GB)' = [math]::Round($freespace.freespace / 1GB, 2)
 'DiskSize(GB)' = [math]::Round($freespace.size / 1GB, 2)
 Percentfree = [math]::Round(($freespace.Freespace / $freespace.Size) * 100, 2)

New-Object -TypeName PSObject -Property $props

Hi Graham,

how about setting “C:” as default value for the Drive parameter?


By doing so, you still have the convenience of your first draft, but also the flexibility of your last version.


Nice idea Micheal, thanks !