ScriptsCollection/dist/disk/windows_check_disk_space.ps1 at main · eVAL-Agency/ScriptsCollection · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
<#
.TITLE
	Check Disk Space [Windows]

.DESCRIPTION
	Checks if local drives are full

.SUPPORTS
	Windows (All)

.TRMM ARGUMENTS
	-threshold 20

.CATEGORY
	Disks

.SYNTAX
	-threshold <int> - The percentage of free space that is considered a warning

.LICENSE
	AGPLv3

.AUTHOR
	Charlie Powell <cdp1337@veraciousnetwork.com>

.CHANGELOG
	20250130 - Initial version
#>

param (
	[int]$threshold = 20
)

$RetStatus = 0

$Disks = (Get-CimInstance -Class Win32_LogicalDisk | Where-Object {$_.DriveType -eq 3})

Foreach ($Disk in $Disks) {
	$FreePercentage = [math]::Round($Disk.FreeSpace / $Disk.Size * 100)
	if ($FreePercentage -le $threshold) {
		$RetStatus = 1
		Write-Output "WARNING - Drive $($Disk.DeviceID) ($($Disk.VolumeName)) has $($FreePercentage)% free space remaining"
	}
	else {
		Write-Output "Drive $($Disk.DeviceID) ($($Disk.VolumeName)) has $($FreePercentage)% free space remaining"
	}
}

Exit($RetStatus)