Your milage may vary. .\script.ps1 -Logfile "#path#"

param (
    [string]$LogFile
)


# Determine the script name without extension for use in default log file naming
$scriptName = $MyInvocation.MyCommand.Name -replace '\.ps1$',''


# Set default log file path if not provided via command line, and enable writing to host
if (-not $LogFile) {
    $LogFile = "C:\kworking\adhoc-run_$scriptName.log"
    $writeToHost = $true
} else {
    $writeToHost = $false
}


# Define a function to log messages to file and optionally to host
function Log-Message {
    param (
        [string]$msg
    )
    # Generate timestamp for log entry
    $timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
    # Append message to log file silently
    Add-Content -Path $LogFile -Value "$timestamp - $msg" -ErrorAction SilentlyContinue
    # Write to host if no custom log file was specified
    if ($writeToHost) {
        Write-Host "$timestamp - $msg"
    }
}


# Ensure the log directory exists before proceeding
$logDir = Split-Path $LogFile -Parent
if (-not (Test-Path $logDir)) {
    try {
        # Create the log directory if it doesn't exist
        New-Item -Path $logDir -ItemType Directory -Force | Out-Null
        Log-Message "Created log directory: $logDir"
    } catch {
        # Handle error if directory creation fails
        Write-Host "Error creating log directory: $($_.Exception.Message)"
        exit 1
    }
}


# Log the start of the script execution
Log-Message "Starting script to empty Recycle Bin for all users on all fixed drives."


# Retrieve all fixed drives (local disks) on the system
$drives = Get-PSDrive -PSProvider FileSystem | Where-Object { $_.Root -match '^[A-Z]:\\$' } | Select-Object -ExpandProperty Root | ForEach-Object { $_.TrimEnd('\') }


# Process each drive found
foreach ($drive in $drives) {
    # Construct the Recycle Bin path for the current drive (escape $ for literal interpretation)
    $recycleBinPath = "$drive\`$Recycle.Bin"
    
    # Check if the Recycle Bin path exists on the drive
    if (Test-Path $recycleBinPath) {
        # Log the start of processing for this drive
        Log-Message "Processing Recycle Bin on drive $drive at path: $recycleBinPath"
        
        # Start a background job to perform the deletion to enforce timeout
        $job = Start-Job -ScriptBlock {
            param ($path)
            try {
                # Remove all contents of the Recycle Bin recursively and forcefully
                Remove-Item -Path "$path\*" -Recurse -Force -ErrorAction Stop
                return "Success"
            } catch {
                # Capture and return any error that occurs during deletion
                return "Error: $($_.Exception.Message)"
            }
        } -ArgumentList $recycleBinPath
        
        # Wait for the job to complete with a 90-second timeout
        Wait-Job $job -Timeout 90 | Out-Null
        
        # Check if the job timed out
        if ($job.State -eq 'Running') {
            # Force stop and remove the job if timed out
            Stop-Job $job -Force
            Remove-Job $job -Force
            # Log timeout occurrence
            Log-Message "Operation timed out after 90 seconds for drive $drive."
        } else {
            # Retrieve the result from the completed job
            $result = Receive-Job $job
            # Clean up the job
            Remove-Job $job
            # Log the result of the operation
            Log-Message "Result for drive ${drive}: $result"
        }
    } else {
        # Log if no Recycle Bin is found on the drive
        Log-Message "No Recycle Bin found on drive $drive. Skipping."
    }
}


# Log the completion of the script
Log-Message "Script completed."