Public/ps1/Job/Reset-ApprxrSpooler.ps1

<#
.SYNOPSIS
    Recovers a wedged Windows print spooler / Print Management cmdlet stack
    with graduated escalation.

.DESCRIPTION
    Print failures on Windows fall into four progressively worse buckets,
    and Reset-ApprxrSpooler offers one Mode for each. Each Mode runs the
    prior steps plus its own additional work:

      Refresh - graceful Restart-Service Spooler. Clears stale in-memory
                state. Lightest, non-destructive.
      Restart - force-stop the Spooler service; if it doesn't reach Stopped
                in StopTimeoutSeconds, escalate to Stop-Process spoolsv;
                then Start-Service. Non-destructive.
      Clean - same as Restart, plus delete every file in
                C:\Windows\System32\spool\PRINTERS. Stuck files there get
                re-processed on every Spooler start and perpetually wedge
                it; the only fix is to remove them. Discards every queued
                print job on the host.
      Full - same as Clean, plus restart the PrintNotify service and
                Winmgmt (WMI) with -Force. Use this when the Spooler
                itself is fine but Print Management cmdlets (Get-Printer
                etc.) hang - the WMI/CIM layer or PrintNotify is wedged,
                not spooling. Restarting Winmgmt cascades to dependent
                services so it's heavy; that's why it's only in Full.

    Every Mode also runs a Win32_Printer CIM probe at the start, which
    succeeds even when Get-Printer hangs (different code path) and is
    returned in the result. This typically pinpoints the troublemaker:
    a network/WSD printer with WorkOffline=true or PrinterStatus other
    than 3 (Idle) / 4 (Printing).

.PARAMETER Mode
    'Refresh' (default), 'Restart', 'Clean', or 'Full'. See description.

.PARAMETER StopTimeoutSeconds
    How long to wait for the Spooler service to reach Stopped before
    continuing. Only used by Restart, Clean, and Full modes. Default 15.

.OUTPUTS
    [PSCustomObject] with:
      Success - $true if Spooler is Running at the end
      Mode - the requested mode
      FinalStatus - the Spooler service's status after recovery
      StuckFilesRemoved - files deleted from the spool folder
                          (0 unless Mode is Clean or Full)
      CimPrinters - array of { Name, PortName, PrinterStatus,
                          WorkOffline } from Win32_Printer
      SuspectPrinters - subset of CimPrinters that are offline or in
                          a non-idle/non-printing state - these are
                          the most likely cause of cmdlet hangs
      Steps - array of human-readable step descriptions
                          for diagnosing what happened

.EXAMPLE
    Reset-ApprxrSpooler
    # Graceful refresh - clears stale in-memory spooler state.

.EXAMPLE
    Reset-ApprxrSpooler -Mode Restart
    # Force-restart for an unresponsive Spooler service.

.EXAMPLE
    Reset-ApprxrSpooler -Mode Clean
    # Recovery for a Spooler stuck on a bad job. Discards queued jobs.

.EXAMPLE
    Reset-ApprxrSpooler -Mode Full
    # Last resort - cmdlets are hanging even though Spooler looks OK.
    # Restarts WMI and PrintNotify in addition to the Clean steps.

.NOTES
    Requires permission to manage the Spooler / WMI services
    (typically admin). Used by the REFRESH_SPOOLER / RESTART_SPOOLER /
    CLEAN_SPOOLER / FULL_SPOOLER and legacy RESET_SPOOLER remote
    actions in Get-ApprxrRemoteJob.
#>

function Reset-ApprxrSpooler {
    [CmdletBinding()]
    param(
        [ValidateSet('Refresh', 'Restart', 'Clean', 'Full')]
        [string]$Mode = 'Refresh',

        [int]$StopTimeoutSeconds = 15
    )

    $steps           = @()
    $stuckCount      = 0
    $cimPrinters     = @()
    $suspectPrinters = @()

    # Diagnostic snapshot via Win32_Printer CIM. This works even when
    # Get-Printer hangs - they go through different code paths - and lets
    # us pinpoint a misbehaving network/WSD printer that's blocking
    # PrintManagement enumeration. Always run, even on Refresh, since it
    # is read-only and fast.
    try {
        $cimPrinters = @(Get-CimInstance -ClassName Win32_Printer -ErrorAction Stop |
            Select-Object Name, PortName,
                @{N='PrinterStatus';E={ "$($_.PrinterStatus)" }},
                @{N='WorkOffline'; E={ [bool]$_.WorkOffline }})
        $steps += "Win32_Printer CIM probe returned $($cimPrinters.Count) printer(s)"
        # Win32_Printer.PrinterStatus enum: 1=Other, 2=Unknown, 3=Idle,
        # 4=Printing, 5=WarmingUp, 6=StoppedPrinting, 7=Offline.
        # 3 / 4 are healthy; everything else (or WorkOffline=true) is
        # suspect and the most likely cause of cmdlet hangs.
        $suspectPrinters = @($cimPrinters | Where-Object {
            $_.WorkOffline -or ($_.PrinterStatus -notin '3','4')
        })
        if ($suspectPrinters.Count -gt 0) {
            $names = ($suspectPrinters | ForEach-Object { $_.Name }) -join ', '
            $steps += "Suspect printer(s) (offline / not idle): $names"
        }
    } catch {
        $steps += "Win32_Printer CIM probe failed: $($_.Exception.Message)"
    }

    try {
        if ($Mode -eq 'Refresh') {
            # Lightest path: a single graceful restart. Doesn't help if the
            # service is hung at the OS level, but is fast and non-destructive.
            try {
                Restart-Service -Name Spooler -Force -ErrorAction Stop
                $steps += 'Restart-Service Spooler succeeded'
            } catch {
                $steps += "Restart-Service Spooler failed: $($_.Exception.Message)"
            }
        }
        else {
            # Restart, Clean, and Full all need a hard stop first.
            try {
                Stop-Service -Name Spooler -Force -ErrorAction Stop
                $steps += 'Stop-Service Spooler succeeded'
            } catch {
                $steps += "Stop-Service failed ($($_.Exception.Message)); escalating to Stop-Process"
                $proc = Get-Process spoolsv -ErrorAction SilentlyContinue
                if ($proc) {
                    try {
                        Stop-Process -Id $proc.Id -Force -ErrorAction Stop
                        $steps += "Killed spoolsv.exe (PID $($proc.Id))"
                    } catch {
                        $steps += "Stop-Process for spoolsv (PID $($proc.Id)) failed: $($_.Exception.Message)"
                    }
                } else {
                    $steps += 'spoolsv.exe was not running'
                }
            }

            # Wait for Stopped state before continuing.
            $deadline = (Get-Date).AddSeconds($StopTimeoutSeconds)
            while ((Get-Service Spooler -ErrorAction SilentlyContinue).Status -ne 'Stopped' -and (Get-Date) -lt $deadline) {
                Start-Sleep -Milliseconds 500
            }
            $stoppedStatus = (Get-Service Spooler -ErrorAction SilentlyContinue).Status
            $steps += "Spooler status after stop: $stoppedStatus"

            # Clean and Full: wipe the spool folder. Stuck files there are
            # what cause repeated wedges across service restarts.
            if ($Mode -in 'Clean','Full') {
                $spoolPath = Join-Path $env:windir 'System32\spool\PRINTERS'
                if (Test-Path $spoolPath) {
                    $stuckFiles = @(Get-ChildItem -Path $spoolPath -File -ErrorAction SilentlyContinue)
                    $stuckCount = $stuckFiles.Count
                    foreach ($sf in $stuckFiles) {
                        Remove-Item -Path $sf.FullName -Force -ErrorAction SilentlyContinue
                    }
                    $steps += "Removed $stuckCount file(s) from $spoolPath"
                } else {
                    $steps += "Spool path '$spoolPath' does not exist - skipped"
                }
            }

            # Bring the Spooler service back up.
            try {
                Start-Service -Name Spooler -ErrorAction Stop
                $steps += 'Start-Service Spooler succeeded'
            } catch {
                $steps += "Start-Service Spooler failed: $($_.Exception.Message)"
            }

            # Full only: also restart PrintNotify (the modern Print
            # Management subsystem) and Winmgmt (WMI). PrintManagement
            # cmdlets like Get-Printer can hang via the CIM/WMI layer
            # even when the Spooler itself is healthy, and these
            # restarts are the canonical fix. Winmgmt -Force will
            # cascade-restart its dependent services - heavy but
            # necessary when WMI is wedged.
            if ($Mode -eq 'Full') {
                try {
                    Restart-Service -Name PrintNotify -Force -ErrorAction Stop
                    $steps += 'Restart-Service PrintNotify -Force succeeded'
                } catch {
                    $steps += "Restart-Service PrintNotify -Force failed: $($_.Exception.Message)"
                }
                try {
                    Restart-Service -Name Winmgmt -Force -ErrorAction Stop
                    $steps += 'Restart-Service Winmgmt -Force succeeded (dependent services were also restarted)'
                } catch {
                    $steps += "Restart-Service Winmgmt -Force failed: $($_.Exception.Message)"
                }
            }
        }

        $finalStatus = (Get-Service Spooler -ErrorAction SilentlyContinue).Status
        $steps += "Spooler final status: $finalStatus"

        [PSCustomObject]@{
            Success           = ($finalStatus -eq 'Running')
            Mode              = $Mode
            FinalStatus       = "$finalStatus"
            StuckFilesRemoved = $stuckCount
            CimPrinters       = $cimPrinters
            SuspectPrinters   = $suspectPrinters
            Steps             = $steps
        }
    } catch {
        [PSCustomObject]@{
            Success           = $false
            Mode              = $Mode
            FinalStatus       = 'Unknown'
            StuckFilesRemoved = $stuckCount
            CimPrinters       = $cimPrinters
            SuspectPrinters   = $suspectPrinters
            Steps             = $steps + "Unhandled error: $($_.Exception.Message)"
        }
    }
}
# SIG # Begin signature block
# MIInKgYJKoZIhvcNAQcCoIInGzCCJxcCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDjB9QzGz7sZ0im
# eP+EaFRqRNt2ATsm+2D1+EJ2upEaoqCCIKYwggWNMIIEdaADAgECAhAOmxiO+dAt
# 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK
# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV
# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa
# Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy
# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD
# ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
# ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E
# MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy
# unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF
# xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1
# 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB
# MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR
# WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6
# nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB
# YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S
# UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x
# q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB
# NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP
# TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC
# AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp
# Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv
# bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0
# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB
# LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc
# Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov
# Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy
# oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW
# juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF
# mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z
# twGpn1eqXijiuZQwggaXMIIEf6ADAgECAhAfsijAKebq6quDMIHCRvIfMA0GCSqG
# SIb3DQEBCwUAMGoxCzAJBgNVBAYTAlBMMSEwHwYDVQQKExhBc3NlY28gRGF0YSBT
# eXN0ZW1zIFMuQS4xODA2BgNVBAMTL0NlcnR1bSBFeHRlbmRlZCBWYWxpZGF0aW9u
# IENvZGUgU2lnbmluZyAyMDIxIENBMB4XDTI2MDIwMzEzNTE0NFoXDTI4MDIwMzEz
# NTE0M1owgaExHTAbBgNVBA8TFFByaXZhdGUgT3JnYW5pemF0aW9uMRMwEQYLKwYB
# BAGCNzwCAQMTAk5MMREwDwYDVQQFEwg5NjMyNDU2MjELMAkGA1UEBhMCTkwxEDAO
# BgNVBAgMB1V0cmVjaHQxEzARBgNVBAcMCkFtZXJzZm9vcnQxETAPBgNVBAoMCEFQ
# UFJYIEJWMREwDwYDVQQDDAhBUFBSWCBCVjCCAaIwDQYJKoZIhvcNAQEBBQADggGP
# ADCCAYoCggGBAOF+mHloTjmkknba8mOejw0Gq3Aczy1dtatfdLM70ken0n07zIlY
# 2jNmyTv5I5RixXAt3LJUwWnUQH8okGFJYvnLZRPyjpCxnEqq8GL6puhKjIIcTs8W
# VhoADX+mFtLXygLrfk1j6A+dnNXjoCQMsVSEYppSGrpMpKsPQONb1mmFRx66vqro
# HcP93qWYTm/f3TpRzlscIxcQ/3Ab+KLeW0sHgC/a8MVHLicbdUe/pka4jMM98Djj
# BtkBc18dI6ECtrDfB2FXXFomvgm5UyPaf2sYxMPL+X/iCNhaQevoT3vttxMvKzAD
# JxJK7VsV2nrCvxfTaP4cVd9FfoxUqjCE0eA/IH3qrKqAv3eONjMrRzoO9jJumusi
# t91wYT1dwTe/o2FAwfmZ7qxofCXTlO008weUDY5UBw8d+BavVvnDNR08eEcCJN37
# wBJn1hhjFZZD6OxVcMEoyhIG5tJqvmBPyR5A1oYeGSL+/xBbLpAQR0oAhAivxvn4
# POX2r4M/wXGJewIDAQABo4IBfzCCAXswDAYDVR0TAQH/BAIwADBBBgNVHR8EOjA4
# MDagNKAyhjBodHRwOi8vY2V2Y3NjYTIwMjEuY3JsLmNlcnR1bS5wbC9jZXZjc2Nh
# MjAyMS5jcmwwdwYIKwYBBQUHAQEEazBpMC4GCCsGAQUFBzABhiJodHRwOi8vY2V2
# Y3NjYTIwMjEub2NzcC1jZXJ0dW0uY29tMDcGCCsGAQUFBzAChitodHRwOi8vcmVw
# b3NpdG9yeS5jZXJ0dW0ucGwvY2V2Y3NjYTIwMjEuY2VyMB8GA1UdIwQYMBaAFKxX
# yggW3D/FMRwKTdv78d6ZJy00MB0GA1UdDgQWBBSEZ5pbrzKazBz6ZCRYAbuQVlDy
# pDBKBgNVHSAEQzBBMAcGBWeBDAEDMDYGCyqEaAGG9ncCBQEHMCcwJQYIKwYBBQUH
# AgEWGWh0dHBzOi8vd3d3LmNlcnR1bS5wbC9DUFMwEwYDVR0lBAwwCgYIKwYBBQUH
# AwMwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQARtX2dHRUVP9uH
# 5FuVIvj22UsNMW2gsexnRxeL/xKxY4BXv6UkQmcgABKbYlWGH0wodaKRhrT9NyK1
# tt0P1C53zAkaiwNU7gSge7s/OPk2yA7g++iVBUDXRelZVCWi31V8yRVV+zXAFEkK
# timx00QcEhLFu1DAyjABmKouChHJyqF4dHWytvQZQHw1dfG1OSh6F82thRipW/q1
# ggWzm91QdieGlaSBZy9N881+h4V23R7oJVyWcCUtar19rBJH+/TaZHMo3VDVazhr
# CYUKMf/f6RA+iuSsPcpwMi7BZzTxawQtEe/1vG3RLVP94bWl69gY8LiTe0OU23tp
# 1PuTiHFLEXjTIb9WnBljH2PvUpJVaxQAMZrunKZvuafYSAvcEfSiRvgFg3r1UH9I
# nLjJVxsjfxjnbg5y/5SChh+OBbld7+NdvWVoFUGwqK2IuALD0O2/gtQBS/+UZuiB
# GsWpTv9PWI9/C2kPjEcBjC3sZedZOjkEJNSb8siUDItoswA+ddZRBBLdkNJCIKX4
# +lrKAAXdOqGu1QSu57G/OOLyjeUHEWx73XzoPMdgGfkcbdSBQoWBevDbC2xLzqr6
# EQZhplxGR39HZ4M4GyNFcpL4Xhuw1Gma8ldGTeuNw5ktP5Jmf9zvrjP5epHgMl6r
# jO0VG4wGU+R4e/FPQClKsyxI/cTJMjCCBrQwggScoAMCAQICEA3HrFcF/yGZLkBD
# Igw6SYYwDQYJKoZIhvcNAQELBQAwYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERp
# Z2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMY
# RGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MB4XDTI1MDUwNzAwMDAwMFoXDTM4MDEx
# NDIzNTk1OVowaTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMu
# MUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0
# MDk2IFNIQTI1NiAyMDI1IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
# ggIBALR4MdMKmEFyvjxGwBysddujRmh0tFEXnU2tjQ2UtZmWgyxU7UNqEY81FzJs
# Qqr5G7A6c+Gh/qm8Xi4aPCOo2N8S9SLrC6Kbltqn7SWCWgzbNfiR+2fkHUiljNOq
# nIVD/gG3SYDEAd4dg2dDGpeZGKe+42DFUF0mR/vtLa4+gKPsYfwEu7EEbkC9+0F2
# w4QJLVSTEG8yAR2CQWIM1iI5PHg62IVwxKSpO0XaF9DPfNBKS7Zazch8NF5vp7ea
# Z2CVNxpqumzTCNSOxm+SAWSuIr21Qomb+zzQWKhxKTVVgtmUPAW35xUUFREmDrMx
# SNlr/NsJyUXzdtFUUt4aS4CEeIY8y9IaaGBpPNXKFifinT7zL2gdFpBP9qh8SdLn
# Eut/GcalNeJQ55IuwnKCgs+nrpuQNfVmUB5KlCX3ZA4x5HHKS+rqBvKWxdCyQEEG
# cbLe1b8Aw4wJkhU1JrPsFfxW1gaou30yZ46t4Y9F20HHfIY4/6vHespYMQmUiote
# 8ladjS/nJ0+k6MvqzfpzPDOy5y6gqztiT96Fv/9bH7mQyogxG9QEPHrPV6/7umw0
# 52AkyiLA6tQbZl1KhBtTasySkuJDpsZGKdlsjg4u70EwgWbVRSX1Wd4+zoFpp4Ra
# +MlKM2baoD6x0VR4RjSpWM8o5a6D8bpfm4CLKczsG7ZrIGNTAgMBAAGjggFdMIIB
# WTASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQWBBTvb1NK6eQGfHrK4pBW9i/U
# SezLTjAfBgNVHSMEGDAWgBTs1+OC0nFdZEzfLmc/57qYrhwPTzAOBgNVHQ8BAf8E
# BAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwgwdwYIKwYBBQUHAQEEazBpMCQGCCsG
# AQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQQYIKwYBBQUHMAKGNWh0
# dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRSb290RzQu
# Y3J0MEMGA1UdHwQ8MDowOKA2oDSGMmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9E
# aWdpQ2VydFRydXN0ZWRSb290RzQuY3JsMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsG
# CWCGSAGG/WwHATANBgkqhkiG9w0BAQsFAAOCAgEAF877FoAc/gc9EXZxML2+C8i1
# NKZ/zdCHxYgaMH9Pw5tcBnPw6O6FTGNpoV2V4wzSUGvI9NAzaoQk97frPBtIj+ZL
# zdp+yXdhOP4hCFATuNT+ReOPK0mCefSG+tXqGpYZ3essBS3q8nL2UwM+NMvEuBd/
# 2vmdYxDCvwzJv2sRUoKEfJ+nN57mQfQXwcAEGCvRR2qKtntujB71WPYAgwPyWLKu
# 6RnaID/B0ba2H3LUiwDRAXx1Neq9ydOal95CHfmTnM4I+ZI2rVQfjXQA1WSjjf4J
# 2a7jLzWGNqNX+DF0SQzHU0pTi4dBwp9nEC8EAqoxW6q17r0z0noDjs6+BFo+z7bK
# SBwZXTRNivYuve3L2oiKNqetRHdqfMTCW/NmKLJ9M+MtucVGyOxiDf06VXxyKkOi
# rv6o02OoXN4bFzK0vlNMsvhlqgF2puE6FndlENSmE+9JGYxOGLS/D284NHNboDGc
# mWXfwXRy4kbu4QFhOm0xJuF2EZAOk5eCkhSxZON3rGlHqhpB/8MluDezooIs8CVn
# rpHMiD2wL40mm53+/j7tFaxYKIqL0Q4ssd8xHZnIn/7GELH3IdvG2XlM9q7WP/Uw
# gOkw/HQtyRN62JK4S1C8uw3PdBunvAZapsiI5YKdvlarEvf8EA+8hcpSM9LHJmyr
# xaFtoza2zNaQ9k+5t1wwggbNMIIEtaADAgECAhEAu/DMtbe4Mf0hrjJ3iuQMiTAN
# BgkqhkiG9w0BAQwFADCBgDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8g
# VGVjaG5vbG9naWVzIFMuQS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9u
# IEF1dGhvcml0eTEkMCIGA1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAy
# MB4XDTIxMDUxOTA1MzIxM1oXDTM2MDUxODA1MzIxM1owajELMAkGA1UEBhMCUEwx
# ITAfBgNVBAoTGEFzc2VjbyBEYXRhIFN5c3RlbXMgUy5BLjE4MDYGA1UEAxMvQ2Vy
# dHVtIEV4dGVuZGVkIFZhbGlkYXRpb24gQ29kZSBTaWduaW5nIDIwMjEgQ0EwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCUvvjwlqjf9eedRTK+NoavZlVx
# mQTPIN1nK5XQRUQWyPWwHD54wa2aD2kRDrAjBf71/T0XN9Oqms5ML/Jolgryv3JW
# 7/yahp7lg/wn3PDnNwzC1BlFMyCdEktQmUXMmE4mmxSutRY1OGGagENWPjbQ1R/x
# 4HuTByWbG+TUV7dIPxE7TMy9Npco4f09DN6QFRXdk7bZTu58kxu6MFH6mzQkC3IX
# vExfo0c/CT4/hTZD2XknHjXLzi9jzInSHS9GQqeXd6nWbkwEu7znKpNEcSElorDS
# EcRhc1OSOLjUK0x0cOw8whzQ0fWGkPoqgCslbjZoko7U7kj/Fn4TWQ8s75LHjhVa
# o+w2SWMP0ELWYIkq1ComGq3wqBD7VU6rtCDoUf237HkgRBxLXFjwp444oKWnchYM
# Z7epWX8jqntSr4QHeidL72c6XswQIIZsFglV4BO28jO02yS7w4iyY0c6PQs34GZ7
# SWphsN1DaiX9ysc6hovVYoVA94t+3p4TI1RtK9Ayh0atmfYPJqtBfk5kJ1h4nNax
# 0lZmJL9chJjZQb+7XW8MQgstiQdsegaz2QL6Edm+94N8IW6TYaalyO9LeR35A9Mo
# TLo79rdB04naTqWdPTBKh7DpS53ZAQn5dYs2per+m7ZeIxnEWaNcG+PbRh+ZslFb
# 6M75JgN43szB+/VYVQIDAQABo4IBVTCCAVEwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
# HQ4EFgQUrFfKCBbcP8UxHApN2/vx3pknLTQwHwYDVR0jBBgwFoAUtqFUOQLDoD+O
# irz61PgcptE6Dv0wDgYDVR0PAQH/BAQDAgEGMBMGA1UdJQQMMAoGCCsGAQUFBwMD
# MDAGA1UdHwQpMCcwJaAjoCGGH2h0dHA6Ly9jcmwuY2VydHVtLnBsL2N0bmNhMi5j
# cmwwbAYIKwYBBQUHAQEEYDBeMCgGCCsGAQUFBzABhhxodHRwOi8vc3ViY2Eub2Nz
# cC1jZXJ0dW0uY29tMDIGCCsGAQUFBzAChiZodHRwOi8vcmVwb3NpdG9yeS5jZXJ0
# dW0ucGwvY3RuY2EyLmNlcjA5BgNVHSAEMjAwMC4GBFUdIAAwJjAkBggrBgEFBQcC
# ARYYaHR0cDovL3d3dy5jZXJ0dW0ucGwvQ1BTMA0GCSqGSIb3DQEBDAUAA4ICAQC7
# khlZjFbU+gsRdcraFFJKj1PL63MVudnm/AILuNaxm7LIZOYtrZaRWEpR0qd3uhSp
# UEI29fMBZvuu3CHXJsM58hbJFo4YoHnyDJgTkeVmc10fd1NI//cI3nRD1/Alx09y
# WhPZlze0A/Bvwc3LcZtTywfsL5tD3QAL8ZqelrHt1Eb8AnDEnAzKNbm1mwYmD/5d
# y1XkIKfsM1pmRM2ZDcJ4qpwVewE7g+4e+Y+iq42LuaHPvNAkwq0daA9Hp3qemk0c
# RFfM5257MvEsu+6w8+44mpQUOgpASVIjY3l2vdf6BUfBJfsd3pcp/2hfDnXaql9A
# oB7ps7eCZb9VXKm/u2lTRMf5esOcZFy4udsnGBaOwSSUe0chYusfJ9IjsmpoMl4C
# W5E0R/U55Bz6TpDo+gaXQJL4i/zv0UR5papGsDguBASp9g/OfnvGTeWrS9l5orEk
# tu9ExrFfPvAKxZK+4AO9bapPhMATraKo6kx6K51pS1ZO2pf1r3B+lXN5bTLgp8g/
# dygUZm2cmauBAzJA5v/iHOb0b4b4Muqc8dxgcX1jZRLtLvxnAWxkKIMfj7A4M0Jr
# N4rLBUpPFM0+Bp2sR7rtFqNZW56huaDkxO75eNRN2z4A959R5GBRnFWtgE65+B1R
# HAQQ/TOF4mU0Y3oIhVQr3rUh4tdSvIxr8QpsDKIvsDCCBu0wggTVoAMCAQICEAqA
# 7xhLjfEFgtHEdqeVdGgwDQYJKoZIhvcNAQELBQAwaTELMAkGA1UEBhMCVVMxFzAV
# BgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVk
# IEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1NiAyMDI1IENBMTAeFw0yNTA2
# MDQwMDAwMDBaFw0zNjA5MDMyMzU5NTlaMGMxCzAJBgNVBAYTAlVTMRcwFQYDVQQK
# Ew5EaWdpQ2VydCwgSW5jLjE7MDkGA1UEAxMyRGlnaUNlcnQgU0hBMjU2IFJTQTQw
# OTYgVGltZXN0YW1wIFJlc3BvbmRlciAyMDI1IDEwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQDQRqwtEsae0OquYFazK1e6b1H/hnAKAd/KN8wZQjBjMqiZ
# 3xTWcfsLwOvRxUwXcGx8AUjni6bz52fGTfr6PHRNv6T7zsf1Y/E3IU8kgNkeECqV
# Q+3bzWYesFtkepErvUSbf+EIYLkrLKd6qJnuzK8Vcn0DvbDMemQFoxQ2Dsw4vEjo
# T1FpS54dNApZfKY61HAldytxNM89PZXUP/5wWWURK+IfxiOg8W9lKMqzdIo7VA1R
# 0V3Zp3DjjANwqAf4lEkTlCDQ0/fKJLKLkzGBTpx6EYevvOi7XOc4zyh1uSqgr6Un
# bksIcFJqLbkIXIPbcNmA98Oskkkrvt6lPAw/p4oDSRZreiwB7x9ykrjS6GS3NR39
# iTTFS+ENTqW8m6THuOmHHjQNC3zbJ6nJ6SXiLSvw4Smz8U07hqF+8CTXaETkVWz0
# dVVZw7knh1WZXOLHgDvundrAtuvz0D3T+dYaNcwafsVCGZKUhQPL1naFKBy1p6ll
# N3QgshRta6Eq4B40h5avMcpi54wm0i2ePZD5pPIssoszQyF4//3DoK2O65Uck5Wg
# gn8O2klETsJ7u8xEehGifgJYi+6I03UuT1j7FnrqVrOzaQoVJOeeStPeldYRNMmS
# F3voIgMFtNGh86w3ISHNm0IaadCKCkUe2LnwJKa8TIlwCUNVwppwn4D3/Pt5pwID
# AQABo4IBlTCCAZEwDAYDVR0TAQH/BAIwADAdBgNVHQ4EFgQU5Dv88jHt/f3X85Fx
# YxlQQ89hjOgwHwYDVR0jBBgwFoAU729TSunkBnx6yuKQVvYv1Ensy04wDgYDVR0P
# AQH/BAQDAgeAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMIGVBggrBgEFBQcBAQSB
# iDCBhTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMF0GCCsG
# AQUFBzAChlFodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz
# dGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAyNUNBMS5jcnQwXwYDVR0f
# BFgwVjBUoFKgUIZOaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1
# c3RlZEc0VGltZVN0YW1waW5nUlNBNDA5NlNIQTI1NjIwMjVDQTEuY3JsMCAGA1Ud
# IAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG/WwHATANBgkqhkiG9w0BAQsFAAOCAgEA
# ZSqt8RwnBLmuYEHs0QhEnmNAciH45PYiT9s1i6UKtW+FERp8FgXRGQ/YAavXzWjZ
# hY+hIfP2JkQ38U+wtJPBVBajYfrbIYG+Dui4I4PCvHpQuPqFgqp1PzC/ZRX4pvP/
# ciZmUnthfAEP1HShTrY+2DE5qjzvZs7JIIgt0GCFD9ktx0LxxtRQ7vllKluHWiKk
# 6FxRPyUPxAAYH2Vy1lNM4kzekd8oEARzFAWgeW3az2xejEWLNN4eKGxDJ8WDl/FQ
# USntbjZ80FU3i54tpx5F/0Kr15zW/mJAxZMVBrTE2oi0fcI8VMbtoRAmaaslNXdC
# G1+lqvP4FbrQ6IwSBXkZagHLhFU9HCrG/syTRLLhAezu/3Lr00GrJzPQFnCEH1Y5
# 8678IgmfORBPC1JKkYaEt2OdDh4GmO0/5cHelAK2/gTlQJINqDr6JfwyYHXSd+V0
# 8X1JUPvB4ILfJdmL+66Gp3CSBXG6IwXMZUXBhtCyIaehr0XkBoDIGMUG1dUtwq1q
# mcwbdUfcSYCn+OwncVUXf53VJUNOaMWMts0VlRYxe5nK+At+DI96HAlXHAL5SlfY
# xJ7La54i71McVWRP66bW+yERNpbJCjyCYG2j+bdpxo/1Cy4uPcU3AWVPGrbn5PhD
# Bf3Froguzzhk++ami+r3Qrx5bIbY3TVzgiFI7Gq3zWcxggXaMIIF1gIBATB+MGox
# CzAJBgNVBAYTAlBMMSEwHwYDVQQKExhBc3NlY28gRGF0YSBTeXN0ZW1zIFMuQS4x
# ODA2BgNVBAMTL0NlcnR1bSBFeHRlbmRlZCBWYWxpZGF0aW9uIENvZGUgU2lnbmlu
# ZyAyMDIxIENBAhAfsijAKebq6quDMIHCRvIfMA0GCWCGSAFlAwQCAQUAoIGEMBgG
# CisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcC
# AQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIE
# IAM/WQfiDikrC3RchM9l0G2hX6NeWD3N/MXABcXuB2GvMA0GCSqGSIb3DQEBAQUA
# BIIBgMKoMCuGrcUWrehR8esAzrafQHB2DEXVQ3COuJ7aaTSPXqxDM5kOcftzfuBd
# K7729BWAtIGomokjUriwZNlOVR51X+DKl2m5S4VwCR30v8zzpnvTAxz3hDvVjhwr
# kHC1YUxvLRUBoaD0enViPnu5Zr7xSJDrJE+kOOSPU6+2cdXp5OaDzcTRkQ6Hp8aY
# l2grzSPurWwUcITGwo9LXB18PKxC55Y/cOKcBrWBEVbEm/T/yzGGHQNKSite33aQ
# FbwfpCVs2jNjQ+sa2R7RxNdQSx+rNaFQ2ZE9/d3I/GUjAijXWo3DqCU/qc9EebJp
# kZht+L8E9hTIGIMbWlMDfLl23D1oSFzwjOMLndGujS7X1nxPENMJgQ++5q4aOIHK
# UMyvOJiMNTF0pgBkj9NzNKuTkB+YDMxHcW9DbfRowz4b5ryAeLmIVR2xuxTm1ljj
# mtuxKPkS/1bXu7tujGiNCdT4qBnZNBAKV8Bt4uSjB/oKz4MRv4QBdDsoGsRBMJ6K
# rLmfXqGCAyYwggMiBgkqhkiG9w0BCQYxggMTMIIDDwIBATB9MGkxCzAJBgNVBAYT
# AlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQg
# VHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEC
# EAqA7xhLjfEFgtHEdqeVdGgwDQYJYIZIAWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMx
# CwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yNjA0MzAxMjA2MTdaMC8GCSqG
# SIb3DQEJBDEiBCD9IY6e50Sc7uv4zxFc075gBA0erB0090u9ZiFP9NoOxzANBgkq
# hkiG9w0BAQEFAASCAgAf5Y28m9n8uCgz3lP1FDOm3S4sTJcp2PW6UjKduUu6kgQB
# xZdCCLY3iiP3VIe8oS3VolY+5NmGCW/5how8cG0hAkry0USZ8iHs0t+t5GmOYqbr
# xvXnzXj3E7/+m1uu5O2lRRxmo4XgJr0olraHJYQnkMxKdKQGsO6Q4Oa5PnG/a9ss
# l5FeKK7SdiYYYs7lPExibwop7NnCfMTvRbFbQ2ptBK44Scuo9gXOR7Zo3EJmu2jA
# q5hDj6rBUdIkKKbW1YW/TWylo2jFbIhxzZLdTy8NvCKXgcmI9nNNRdxcI9lgjmFR
# CK3Uk7tyBp8PQET6d56ZKFXLqWD00+oVosQMyMiHzw4r5K+FKmvFtbsgzncqN5tt
# bK6sI6k3y3ItXU/7/qb7QhXb8xpAw6FqrwIqe5L0nImEtsUFhQEupgykBXBuMZMx
# jDirGZY5rpSnJk2AhU4HagS5LuguDt1N4JVikVrcKB0RjXjxp4cYk7WdbmZ2GClL
# YmtEHGILOj4rKb/eULRF97eoR89m9FG6YGxmveL/55Ou/nIVW0YZUvafhEeZK2F6
# dIDeS1uQhZ+ZMnM6kqPzfVJa2Dc8C3+9G0DswWFvywq01QY/Ep53C4N/chjII7XE
# dnUTUtKZg5w4cjgWm6Lx8Ba/UHrN4QjQFaCexEF3etx8WM5FfBRi/DCBI/1pBw==
# SIG # End signature block