Remove-UnusedDockerImages

Containers: Purges unused Docker images, dangling volumes, and stopped containers

Script

#Requires -Version 5.1

[CmdletBinding(SupportsShouldProcess = $true)]
Param(
    [switch]$PruneVolumes,

    [switch]$Force
)

Process {
    try {
        if (-not (Get-Command docker -ErrorAction SilentlyContinue)) {
            Write-Warning "Docker CLI is not installed or not found in the system's PATH. Please install Docker and try again."
            return
        }

        $pruneArgs = @('system', 'prune')
        if ($PruneVolumes) {
            $pruneArgs += '--volumes'
        }
        if ($Force -or $PSCmdlet.MyInvocation.BoundParameters.ContainsKey('WhatIf')) {
            $pruneArgs += '--force'
        }

        $desc = "Cleans up dangling Docker resources (Prune Volumes = $PruneVolumes)"
        if ($PSCmdlet.ShouldProcess("Docker Host Environment", "Prune system data. This cannot be undone. " + $desc)) {
            Write-Host "Initiating Docker system prune..." -ForegroundColor Cyan
            
            $output = docker @pruneArgs 2>&1
            
            Write-Host "Prune operation successfully finalized!" -ForegroundColor Green
            Write-Output $output
        }
    }
    catch {
        Write-Error $_
        throw
    }
}

Customize

PruneVolumes switch

Off

Prune unused named data volumes as well (caution: could delete persistent data if no active container binds it).

Force switch

Off

Bypasses the confirmation prompt.