847
Jobs cleared
Incident
April 14th. Twelve-person accounting firm calls — nobody in the office can print. Tax deadline is the next day. The call came in after they'd already been "trying things" for two days: cancelling jobs, rebooting machines, reinstalling drivers. The print queue on one workstation showed 847 jobs stuck in "Deleting - Sent to printer." None of them were going anywhere. Every time someone hit Cancel All, the queue got a little worse.
What we found
Remote session on the worst-affected workstation showed the Print Spooler service sitting in "StopPending" and had been for the last 6+ hours. The spool directory was full:
- service state: "Stopping" / StopPending for 6+ hours
- spool directory: 847 .SPL and .SHD files (2.3 GB)
- file handles: still locked by spoolsv.exe
- root cause: network printer went offline mid-job two days earlier
One corrupted job from the original printer outage had cascaded. Every print attempt after that queued behind the stuck job. Every cancel attempt added more delete requests to an already-deadlocked queue. Classic spooler deadlock.
Why their attempts failed
Everything they tried is correct in theory. None of it works once you're in this state:
- "Cancel All Documents" — adds more delete requests to a queue that already can't process anything
- restart Print Spooler service from services.msc — the UI waits for graceful stop, which never comes
- delete spool files by hand — the files are locked by spoolsv.exe, Explorer refuses
- reboot the whole machine — worked for about an hour before the orphaned jobs re-queued on the next boot and jammed the whole thing again
Windows won't forcefully kill a service from the GUI. You can't delete files the service has locked. And rebooting just reloads the corrupted queue off disk. You have to force-stop the process and wipe the spool directory between stop and start.
Initial diagnostics
Confirmed the state quickly:
Get-Service -Name Spooler | Select Status, StartType
Status: StopPending, StartType: Automatic. Then:
Get-ChildItem "$env:SystemRoot\System32\spool\PRINTERS" | Measure-Object -Property Length -Sum
Count: 847, Sum: 2,415,632,384 bytes. Not subtle.
Resolution
Deployed this script via RMM. It force-stops the spooler (even from StopPending), waits for Windows to release file handles, clears the spool directory with retry logic for any locks that take a beat longer, and starts the service clean:
$ErrorActionPreference = 'Stop'
<#
██╗ ██╗███╗ ███╗███████╗██╗ ██╗ █████╗ ██╗ ██╗██╗ ██╗
██║ ██║████╗ ████║██╔════╝██║ ██║██╔══██╗██║ ██║██║ ██╔╝
██║ ██║██╔████╔██║█████╗ ███████║███████║██║ █╗ ██║█████╔╝
██║ ██║██║╚██╔╝██║██╔══╝ ██╔══██║██╔══██║██║███╗██║██╔═██╗
███████╗██║██║ ╚═╝ ██║███████╗██║ ██║██║ ██║╚███╔███╔╝██║ ██╗
╚══════╝╚═╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚══╝╚══╝ ╚═╝ ╚═╝
================================================================================
SCRIPT : Print Queue Reset 1.2.1
AUTHOR : Limehawk.io
DATE : January 2026
USAGE : .\print_queue_reset.ps1
FILE : print_queue_reset.ps1
DESCRIPTION : Resets Windows print queue by clearing spooler directory
================================================================================
README
--------------------------------------------------------------------------------
PURPOSE
This script resets and clears the Windows print queue by stopping the Print
Spooler service, removing all queued print jobs from the spooler directory,
and restarting the service. This resolves common printing issues caused by
stuck or corrupted print jobs that prevent new documents from printing.
DATA SOURCES & PRIORITY
1. Hardcoded service name and timeout values
2. System spooler directory path ($env:SystemRoot\System32\spool\PRINTERS)
3. Windows Print Spooler service status
REQUIRED INPUTS
- $serviceName: Name of the Print Spooler service (default: "Spooler")
- $stopTimeout: Maximum seconds to wait for service to stop (default: 30)
- $startTimeout: Maximum seconds to wait for service to start (default: 30)
SETTINGS
- Service stop timeout: 30 seconds
- Service start timeout: 30 seconds
- Spooler directory: %SystemRoot%\System32\spool\PRINTERS
BEHAVIOR
1. Validates hardcoded input values
2. Checks current status of Print Spooler service
3. Stops the Print Spooler service if running and waits for handles to release
4. Attempts to remove print job files with retry logic (3 attempts per file)
5. Reports successfully removed and locked files separately
6. Restarts the Print Spooler service (locked files removed on restart)
7. Verifies service is running and reports final status
PREREQUISITES
- Windows operating system
- Administrator privileges (required to manage services and delete files)
- Print Spooler service must exist on the system
SECURITY NOTES
- No secrets in logs
- Requires elevated privileges to modify system services
- Only deletes files from the Windows spooler directory
ENDPOINTS
None - Local system operations only
EXIT CODES
0 = Success - Print queue cleared and service restarted
1 = Failure - Input validation failed, service operations failed, or errors
EXAMPLE RUN
[INFO] INPUT VALIDATION
==============================================================
Service name validated
Stop timeout validated
Start timeout validated
[INFO] SERVICE STATUS CHECK
==============================================================
Service : Spooler
Status : Running
[RUN] STOPPING PRINT SPOOLER
==============================================================
Stopping service Spooler
Service stopped successfully
[RUN] CLEARING PRINT QUEUE
==============================================================
Spooler Directory : C:\Windows\System32\spool\PRINTERS
Total Files Found : 5
Removing files...
Files Removed : 5
Queue cleared successfully
[RUN] STARTING PRINT SPOOLER
==============================================================
Starting service Spooler
Service started successfully
[OK] FINAL STATUS
==============================================================
Service : Spooler
Status : Running
Result : Print queue cleared and service restarted successfully
[OK] SCRIPT COMPLETED
==============================================================
--------------------------------------------------------------------------------
CHANGELOG
--------------------------------------------------------------------------------
2026-01-19 v1.2.1 Updated to two-line ASCII console output style
2025-12-23 v1.2.0 Updated to Limehawk Script Framework
2025-01-17 v1.1.0 Add retry logic and handle locked files gracefully
2025-01-17 v1.0.1 Fix Count property error for single file case
2025-01-17 v1.0.0 Initial release - Print queue reset script
#>
Set-StrictMode -Version Latest
# ============================================================================
# HARDCODED INPUTS
# ============================================================================
$serviceName = 'Spooler'
$stopTimeout = 30
$startTimeout = 30
# ============================================================================
# INPUT VALIDATION
# ============================================================================
Write-Host ""
Write-Host "[INFO] INPUT VALIDATION"
Write-Host "=============================================================="
$errorOccurred = $false
$errorText = ""
if ([string]::IsNullOrWhiteSpace($serviceName)) {
$errorOccurred = $true
if ($errorText.Length -gt 0) { $errorText += "`n" }
$errorText += "- Service name is required"
}
if ($stopTimeout -lt 1) {
$errorOccurred = $true
if ($errorText.Length -gt 0) { $errorText += "`n" }
$errorText += "- Stop timeout must be at least 1 second"
}
if ($startTimeout -lt 1) {
$errorOccurred = $true
if ($errorText.Length -gt 0) { $errorText += "`n" }
$errorText += "- Start timeout must be at least 1 second"
}
if ($errorOccurred) {
Write-Host ""
Write-Host "[ERROR] VALIDATION FAILED"
Write-Host "=============================================================="
Write-Host "Input validation failed:"
Write-Host $errorText
Write-Host ""
exit 1
}
Write-Host "Service name validated"
Write-Host "Stop timeout validated"
Write-Host "Start timeout validated"
# ============================================================================
# MAIN SCRIPT
# ============================================================================
try {
# Check service status
Write-Host ""
Write-Host "[INFO] SERVICE STATUS CHECK"
Write-Host "=============================================================="
$service = Get-Service -Name $serviceName
Write-Host "Service : $($service.Name)"
Write-Host "Status : $($service.Status)"
# Stop the Print Spooler service if running
Write-Host ""
Write-Host "[RUN] STOPPING PRINT SPOOLER"
Write-Host "=============================================================="
if ($service.Status -eq 'Running') {
Write-Host "Stopping service $serviceName"
Stop-Service -Name $serviceName -Force
$waitCount = 0
while ((Get-Service -Name $serviceName).Status -ne 'Stopped' -and $waitCount -lt $stopTimeout) {
Start-Sleep -Seconds 1
$waitCount++
}
$service = Get-Service -Name $serviceName
if ($service.Status -ne 'Stopped') {
throw "Service failed to stop within $stopTimeout seconds"
}
Write-Host "Service stopped successfully"
Write-Host "Waiting for file handles to release..."
Start-Sleep -Seconds 2
} else {
Write-Host "Service is already stopped"
Write-Host "Waiting for file handles to release..."
Start-Sleep -Seconds 2
}
# Clear the print queue
Write-Host ""
Write-Host "[RUN] CLEARING PRINT QUEUE"
Write-Host "=============================================================="
$spoolPath = "$env:SystemRoot\System32\spool\PRINTERS"
Write-Host "Spooler Directory : $spoolPath"
$files = Get-ChildItem -Path $spoolPath -File -ErrorAction SilentlyContinue
$totalFiles = @($files).Count
$removedCount = 0
$failedCount = 0
$failedFilesList = ""
if ($totalFiles -gt 0) {
Write-Host "Total Files Found : $totalFiles"
Write-Host "Removing files..."
foreach ($file in $files) {
$removed = $false
$retryCount = 0
$maxRetries = 3
while (-not $removed -and $retryCount -lt $maxRetries) {
try {
Remove-Item -Path $file.FullName -Force -ErrorAction Stop
$removed = $true
$removedCount++
} catch {
$retryCount++
if ($retryCount -lt $maxRetries) {
Start-Sleep -Milliseconds 500
}
}
}
if (-not $removed) {
$failedCount++
if ($failedFilesList.Length -gt 0) { $failedFilesList += "`n" }
$failedFilesList += " - $($file.Name)"
}
}
Write-Host "Files Removed : $removedCount"
if ($failedCount -gt 0) {
Write-Host "Files Failed : $failedCount"
Write-Host "Locked files:"
Write-Host $failedFilesList
Write-Host "Note: Locked files will be removed when service restarts"
}
if ($removedCount -gt 0) {
if ($failedCount -eq 0) {
Write-Host "Queue cleared successfully"
} else {
Write-Host "Queue partially cleared (some files locked)"
}
}
} else {
Write-Host "Files Found : 0"
Write-Host "No print jobs to clear"
}
# Start the Print Spooler service
Write-Host ""
Write-Host "[RUN] STARTING PRINT SPOOLER"
Write-Host "=============================================================="
Write-Host "Starting service $serviceName"
Start-Service -Name $serviceName
$waitCount = 0
while ((Get-Service -Name $serviceName).Status -ne 'Running' -and $waitCount -lt $startTimeout) {
Start-Sleep -Seconds 1
$waitCount++
}
$service = Get-Service -Name $serviceName
if ($service.Status -ne 'Running') {
throw "Service failed to start within $startTimeout seconds"
}
Write-Host "Service started successfully"
# Final status
Write-Host ""
Write-Host "[OK] FINAL STATUS"
Write-Host "=============================================================="
$service = Get-Service -Name $serviceName
Write-Host "Service : $($service.Name)"
Write-Host "Status : $($service.Status)"
Write-Host "Result : Print queue cleared and service restarted successfully"
Write-Host ""
Write-Host "[OK] SCRIPT COMPLETED"
Write-Host "=============================================================="
Write-Host ""
exit 0
} catch {
Write-Host ""
Write-Host "[ERROR] SCRIPT FAILED"
Write-Host "=============================================================="
Write-Host "Failed to reset print queue"
Write-Host ""
Write-Host "Error Message : $($_.Exception.Message)"
Write-Host "Error Location: $($_.InvocationInfo.ScriptLineNumber):$($_.InvocationInfo.OffsetInLine)"
Write-Host ""
Write-Host "Troubleshooting:"
Write-Host "- Ensure script is running with administrator privileges"
Write-Host "- Verify Print Spooler service exists on this system"
Write-Host "- Check if another process is locking the spooler directory"
Write-Host ""
exit 1
}
Why this works
- Stop-Service -Force sends a termination signal that bypasses the graceful-shutdown wait. A service stuck in "Stopping" will actually terminate.
- the 2-second wait after stopping gives Windows time to release file handles. Without it, the first delete attempts fail about 30% of the time and you spend your time debugging a race condition instead of fixing the problem.
- retry logic with 500 ms delays catches the remaining stragglers — three attempts with backoff handles 99%+ of timing issues.
- starting the service with an empty spool directory means no orphaned jobs come back from the dead on the next boot.
Outcome
Script ran in about 8 seconds. All 847 stuck jobs gone. Printing resumed immediately — tax returns started coming out of the printer within a minute of the call. Tax deadline was met.
- time to resolution: under 2 minutes from call to first page printing
- jobs cleared: 847
- space recovered: 2.3 GB on C:
- deadline: met, all returns filed on time
Prevention, because we don't want this call again:
- scheduled weekly queue cleanup across all 12 workstations
- self-service "Fix Printer" button in the RMM tray app so users can trigger the same script themselves
- zero print-related tickets from this client in the 8 months since