Get-DiskSpace.ps1

<#
.SYNOPSIS
	Return disk partition space details for a single or multiple computers
.DESCRIPTION
	Return disk partition space details for a single or multiple computers

	You can supply a single computer name, multiple computer names separated by a comma, or read in a list of computers from a .txt file
.PARAMETER ComputerName
	Name of computer/s you wish to query. FQDNs preferred.
.INPUTS
	System.String
.OUTPUTS
	System.Management.Automation.PSCustomObject
.EXAMPLE
	.\Get-DiskSpace.ps1 -ComputerName SERVER01.corp.com, SERVER02.corp.com -Verbose | Format-Table -AutoSize
.EXAMPLE
	.\Get-DiskSpace.ps1 -ComputerName (Get-Content C:\ServerList.txt) -Verbose | Where-Object {$_.PercentFree -lt 10} | Export-Csv C:\LowDiskSpaceReport.csv -NoTypeInformation
.NOTES
	20150204	K. Kirkpatrick
	[x] Default value for -ComputerName param is now $ENV:COMPUTERNAME
	[x] type casted output as [int] for space detail
	[x] Removed redundant array variable; objects now passed straight to the pipeline
	[x] General syntax cleanup

	#TAG:PUBLIC

	GitHub:	 https://github.com/vScripter
	Twitter:  @vScripter
	Email:	 kevin@vMotioned.com

[-------------------------------------DISCLAIMER-------------------------------------]
	All script are provided as-is with no implicit
	warranty or support. It's always considered a best practice
	to test scripts in a DEV/TEST environment, before running them
	in production. In other words, I will not be held accountable
	if one of my scripts is responsible for an RGE (Resume Generating Event).
	If you have questions or issues, please reach out/report them on
	my GitHub page. Thanks for your support!
[-------------------------------------DISCLAIMER-------------------------------------]
#>

[cmdletbinding(PositionalBinding = $true,
			   DefaultParameterSetName = "Default")]
param (
	[parameter(mandatory = $false,
			   ValueFromPipeline = $true,
			   ValueFromPipelineByPropertyName = $true,
			   Position = 0)]
	[alias('Comp', 'Name', 'DNSHostName')]
	[string[]]$ComputerName = "$ENV:COMPUTERNAME"
)

BEGIN {
	#Requires -Version 3

	$SizeInGB = @{ Name = "SizeGB"; Expression = { [int]("{0:N2}" -f ($_.Size/1GB)) } }
	$FreespaceInGB = @{ Name = "FreespaceGB"; Expression = { [int]("{0:N2}" -f ($_.Freespace/1GB)) } }
	$PercentFree = @{ name = "PercentFree"; Expression = { [int](($_.FreeSpace/$_.Size) * 100) } }

} # BEGIN

PROCESS {

	foreach ($c in $ComputerName) {
		if (Test-Connection -ComputerName $c -Count 2 -Quiet) {
			try {
				Write-Verbose -Message "Working on $c"

				$diskQuery = $null
				$diskQuery = Get-WmiObject -ComputerName $c -Query "SELECT SystemName,Caption,VolumeName,Size,Freespace,DriveType FROM win32_logicaldisk WHERE drivetype = 3" -ErrorAction 'Stop' |
				Select-Object SystemName, Caption, VolumeName, $SizeInGB, $FreespaceInGB, $PercentFree

				foreach ($item in $diskQuery) {
					$objDiskInfo = @()
					$objDiskInfo = [PSCustomObject] @{
						SystemName = $item.SystemName
						DriveLetter = $item.Caption
						VolumeName = $item.VolumeName
						SizeGB = $item.SizeGB
						FreeSpaceGB = $item.FreeSpaceGB
						PercentFree = $item.PercentFree
					} # $objDiskInfo

					# define custom type name
					$objDiskinfo.PSTypeNames.Insert(0, 'PSCustomObject.DiskSpace')

					# assigned custom type name to output
					$defaultProperties = @('SystemName', 'DriveLetter', 'PercentFree')
					$defaultDisplayPropertySet = New-Object System.Management.Automation.PSPropertySet(‘DefaultDisplayPropertySet’, [string[]]$defaultProperties)
					$PSStandardMembers = [System.Management.Automation.PSMemberInfo[]]@($defaultDisplayPropertySet)
					$objDiskinfo | Add-Member MemberSet PSStandardMembers $PSStandardMembers
					$objDiskinfo
				} # foreach

			} catch {
				Write-Warning -Message "$c - $_"
			} # try/catch

		} else {
			Write-Warning -Message "$c - Unreachable via Ping"
		} # if/else
	} # foreach

} # PROCESS

END {

	Write-Verbose -Message 'Done'

} # END