Public/Set/Set-OneTimeReboot.ps1

function Set-OneTimeReboot {
    <#
        .SYNOPSIS
        Schedules or removes a one-time reboot task locally or on remote
        computers.
 
        .DESCRIPTION
        Creates, updates, or removes a Windows Scheduled Task that runs
        shutdown.exe /r one time at a target local date/time.
 
        The function supports:
        - Local scheduling when -ComputerName is not provided.
        - Remote scheduling over PowerShell remoting when -ComputerName is
          provided.
        - WSMan (default) or SSH remoting via Start-NewPSRemoteSession.
        - Optional wake-to-run, force-close apps, and task self-deletion
          settings.
 
        TIME RESOLUTION
        - If -DateTime is supplied, that exact local timestamp is used.
        - If -DateTime is omitted, -At (HH:mm) is used for the next occurrence.
            If today's time has passed, scheduling rolls to tomorrow.
 
        IDEMPOTENT TASK UPDATE If a task with the same -TaskName already exists,
        it is removed and recreated with the new settings.
 
        REMOVE MODE Pass -Remove to unregister the task instead of creating it.
 
        CONFIG DEFAULTS Unbound parameters can be populated from
        settings.oneTimeReboot in config, including At, SelfDelete,
        defaultComment, taskNamePrefix, and optional
        deleteExpiredTaskAfterMinutes.
 
        SUPPORTS -WhatIf / -Confirm Local and remote operations honor
        ShouldProcess for safe preview.
 
        .PARAMETER ComputerName
        Target computer name(s) for remote scheduling/removal. Accepts values
        from pipeline and property name input. Aliases: CN, Host, Name.
 
        .PARAMETER Credential
        Credential used to establish remote sessions. Not required for local
        mode.
 
        .PARAMETER At
        Time of day in 24-hour HH:mm format for computed scheduling when
        -DateTime is not provided.
 
        .PARAMETER DateTime
        Exact local date/time to use for scheduling. Overrides -At when
        supplied.
 
        .PARAMETER TaskName
        Scheduled task name to create, update, or remove.
 
        .PARAMETER SelfDelete
        Enables or disables post-expiration task cleanup.
 
        .PARAMETER Force
        When true, adds /f to shutdown.exe to force-close running applications.
 
        .PARAMETER Wake
        When true, sets WakeToRun in scheduled task settings.
 
        .PARAMETER Remove
        Removes the scheduled task identified by -TaskName on each target and
        exits without creating a new reboot task.
 
        .PARAMETER UseSsh
        Uses SSH-based PowerShell remoting for remote targets.
 
        .PARAMETER UseCredSSP
        Uses CredSSP authentication for WSMan remoting when applicable.
 
        .PARAMETER Port
        Remote SSH port used when -UseSsh is specified. Default is 22.
 
        .INPUTS
        System.String[]. You can pipe computer names to this function.
 
        .OUTPUTS
        System.Management.Automation.PSCustomObject. Returns one object per
        processed target with properties: ComputerName, Transport, TaskName,
        ScheduledFor, Status, Detail.
 
        .EXAMPLE
        Set-OneTimeReboot
 
        Schedules a one-time local reboot using effective defaults from config.
 
        .EXAMPLE
        Set-OneTimeReboot -At '03:15' -Force:$true
 
        Schedules a local reboot at the next 03:15 and forces app closure.
 
        .EXAMPLE
        'PC01','PC02' | Set-OneTimeReboot -At '01:00' -TaskName 'TT_OneTimeReboot'
 
        Schedules the reboot task on two remote computers via default WSMan
        remoting.
 
        .EXAMPLE
        Set-OneTimeReboot -ComputerName 'srv-01' -UseSsh -Port 2222 -Credential (Get-Credential) -DateTime (Get-Date).AddHours(2)
 
        Schedules a reboot on srv-01 over SSH remoting using a custom port.
 
        .EXAMPLE
        Set-OneTimeReboot -ComputerName 'PC01' -TaskName 'TT_OneTimeReboot' -Remove
 
        Removes the reboot task from a remote target.
 
        .EXAMPLE
        Set-OneTimeReboot -ComputerName 'PC01' -At '01:00' -WhatIf
 
        Previews the remote operation without making changes.
 
        .NOTES
        - Administrative permissions are required on target systems.
        - Requires remoting connectivity and endpoint configuration for remote
          use.
        - Uses ScheduledTasks cmdlets when available; otherwise falls back to
            schtasks.exe on the target.
 
        .LINK
        Start-NewPSRemoteSession
 
        .LINK
        Register-ScheduledTask
 
        .LINK
        Unregister-ScheduledTask
        #>

    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
    param(
        # If specified, schedules on remote machine(s). If omitted, schedules locally.
        [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName)]
        [Alias('CN', 'Host', 'Name')]
        [string[]]$ComputerName,

        # Exact local date/time to use for scheduling.
        # Declared before Credential so positional calls like:
        # Set-OneTimeReboot -ComputerName PC01 '4/21/2026 1:00:00 AM'
        # bind the second argument to DateTime instead of Credential.
        [Nullable[datetime]]$DateTime,

        # Credential for remote session creation (WSMan/SSH).
        # Also supports username-only for SSH key auth via PSRemoting helper.
        [pscredential]$Credential,

        # --- scheduling params ---
        [ValidatePattern('^(?:[01]\d|2[0-3]):[0-5]\d$')]
        [string]$At,

        [string]$TaskName,
        [string]$Description,

        [Nullable[bool]]$SelfDelete,
        [Nullable[bool]]$Force,
        [Nullable[bool]]$Wake,

        [switch]$Remove,

        # --- transport passthrough (minimal, but useful) ---
        [switch]$UseSsh,
        [switch]$UseCredSSP,
        [int]$Port = 22
    )

    begin {
        Set-StrictMode -Version Latest
        $ErrorActionPreference = 'Stop'

        # Init runtime (loads config, helper functions, etc.)
        Initialize-TechToolboxRuntime

        # Map config defaults
        $cfg = $script:cfg.settings.oneTimeReboot

        # Logging shim (uses Write-Log if available, else Write-Host)
        function _Log {
            param([ValidateSet('Ok', 'E-Info', 'Info', 'Warn', 'Error')][string]$Level, [string]$Message)
            if (Get-Command Write-Log -ErrorAction SilentlyContinue) {
                Write-Log -Level $Level -Message $Message
            }
            else {
                $color = switch ($Level) {
                    'Ok' { 'Green' }
                    'E-Info' { 'Cyan' }
                    'Info' { 'Gray' }
                    'Warn' { 'Yellow' }
                    'Error' { 'Red' }
                    default { 'Gray' }
                }
                Write-Host "[Set-OneTimeReboot][$Level] $Message" -ForegroundColor $color
            }
        }

        # Apply config defaults only when param is not explicitly bound
        if (-not $PSBoundParameters.ContainsKey('At')) { $At = $cfg.at }
        if (-not $PSBoundParameters.ContainsKey('SelfDelete')) { $SelfDelete = [bool]$cfg.selfDelete }

        # Can be defaulted later
        if (-not $PSBoundParameters.ContainsKey('Force')) { $Force = $false }
        if (-not $PSBoundParameters.ContainsKey('Wake')) { $Wake = $false }

        if (-not $PSBoundParameters.ContainsKey('TaskName')) {
            # Default to prefix if no explicit TaskName
            $TaskName = $cfg.taskNamePrefix
        }
        if (-not $PSBoundParameters.ContainsKey('Description')) {
            $Description = $cfg.defaultDescription
        }

        $deleteAfterMin = 10
        if ($cfg.deleteExpiredTaskAfterMinutes -as [int]) {
            $deleteAfterMin = [int]$cfg.deleteExpiredTaskAfterMinutes
        }

        function _ComputeTargetDateTime {
            param([string]$At, [Nullable[datetime]]$DateTime)

            if ($null -ne $DateTime) { return [datetime]$DateTime }

            $parts = $At.Split(':')
            $candidate = (Get-Date).Date.AddHours([int]$parts[0]).AddMinutes([int]$parts[1])
            if ($candidate -le (Get-Date)) { $candidate = $candidate.AddDays(1) }
            return $candidate
        }

        function _SetOneTimeRebootLocal {
            [CmdletBinding(DefaultParameterSetName = 'Schedule')]
            param(
                [Parameter(ParameterSetName = 'Schedule', Mandatory = $true)]
                [datetime]$Target,

                [Parameter(ParameterSetName = 'Schedule', Mandatory = $true)]
                [string]$TaskName,

                [Parameter(ParameterSetName = 'Remove', Mandatory = $true)]
                [switch]$Remove,

                [string]$Description,
                [switch]$Force,
                [switch]$Wake,
                [switch]$SelfDelete
            )

            # --- Removal mode ---
            if ($Remove) {
                if (Get-Command Get-ScheduledTask -ErrorAction SilentlyContinue) {
                    Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false -ErrorAction SilentlyContinue
                    return [pscustomobject]@{
                        Status       = 'Removed'
                        ScheduledFor = $null
                        TaskName     = $TaskName
                        Engine       = 'ScheduledTasks'
                    }
                }

                & schtasks.exe /Delete /TN $TaskName /F 2>$null | Out-Null
                return [pscustomobject]@{
                    Status       = 'Removed'
                    ScheduledFor = $null
                    TaskName     = $TaskName
                    Engine       = 'schtasks.exe'
                }
            }

            # --- Scheduling mode ---
            $hasST = [bool](Get-Command New-ScheduledTaskAction -ErrorAction SilentlyContinue)
            $useSchTasks = (-not $hasST) -or $SelfDelete

            # schtasks.exe does not support automatic task deletion, so we use a
            # short-term trigger as a workaround when SelfDelete is enabled.
            # Otherwise, we prefer ScheduledTasks cmdlets for better settings
            # control and reliability.
            if (-not $useSchTasks) {
                $RBargs = '/r', '/t', '0'
                if ($Force) { $RBargs += '/f' }

                $action = New-ScheduledTaskAction -Execute 'shutdown.exe' -Argument ($RBargs -join ' ')
                $trigger = New-ScheduledTaskTrigger -Once -At $Target
                $settings = New-ScheduledTaskSettingsSet -StartWhenAvailable

                if ($Wake) { $settings.WakeToRun = $true }

                Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false -ErrorAction SilentlyContinue

                Register-ScheduledTask -TaskName $TaskName `
                    -Action $action `
                    -Trigger $trigger `
                    -Settings $settings `
                    -User 'SYSTEM' `
                    -Description $Description `
                    -Force | Out-Null

                return @{
                    Status       = 'Scheduled'
                    ScheduledFor = $Target
                    TaskName     = $TaskName
                    Engine       = 'ScheduledTasks'
                    Fallback     = $null
                }
            }

            # --- schtasks.exe path ---
            $trArgs = 'shutdown.exe /r /t 0'
            if ($Force) { $trArgs += ' /f' }

            $st = $Target.ToString('HH:mm')
            $sd = $Target.ToString('MM/dd/yyyy', [cultureinfo]::InvariantCulture)

            & schtasks.exe /Delete /TN $TaskName /F 2>$null | Out-Null

            $createArgs = @(
                '/Create',
                '/SC', 'ONCE',
                '/TN', $TaskName,
                '/TR', $trArgs,
                '/ST', $st,
                '/SD', $sd,
                '/RU', 'SYSTEM',
                '/F'
            )

            & schtasks.exe @createArgs | Out-Null

            return [pscustomobject]@{
                Status       = 'Scheduled'
                ScheduledFor = $Target
                TaskName     = $TaskName
                Engine       = 'schtasks.exe'
                Fallback     = 'Used schtasks.exe (ScheduledTasks cmdlets unavailable or SelfDelete enabled)'
            }
        }

        $targetDT = _ComputeTargetDateTime -At $At -DateTime $DateTime
        $targetText = $targetDT.ToString('yyyy-MM-dd HH:mm:ss')
        _Log E-Info "`nEffective: At=$At | DateTime=$targetText | TaskName=$TaskName | SelfDelete=$SelfDelete | Force=$Force | Wake=$Wake | Remove=$Remove"
    }

    process {
        # Local mode when ComputerName is null/empty
        if (-not $ComputerName -or $ComputerName.Count -eq 0) {

            if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME, ($Remove ? "Remove task $TaskName" : "Schedule reboot at $($targetDT)"))) {

                $r = _SetOneTimeRebootLocal `
                    -Target $targetDT `
                    -TaskName $TaskName `
                    -Description $Description `
                    -Remove:$Remove `
                    -Force:$Force `
                    -Wake:$Wake `
                    -SelfDelete:$SelfDelete

                [pscustomobject]@{
                    ComputerName = $env:COMPUTERNAME
                    Transport    = 'Local'
                    TaskName     = $r.TaskName
                    Description  = $Description
                    ScheduledFor = $r.ScheduledFor
                    Status       = $r.Status
                    Detail       = $r.Fallback
                }
            }
            return
        }

        foreach ($cn in $ComputerName) {

            if (-not $PSCmdlet.ShouldProcess($cn, ($Remove ? "Remove task $TaskName" : "Schedule reboot at $($targetDT)"))) {
                continue
            }

            try {
                $sess = Start-NewPSRemoteSession -ComputerName $cn -Credential $Credential -UseSsh:$UseSsh -UseCredSSP:$UseCredSSP -Port $Port

                try {
                    # ArgumentList order MUST match the helper param order.
                    # [1](https://stackoverflow.com/questions/13092352/how-important-is-parameter-order-when-calling-powershell-cmdlets)
                    # [2](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/09-functions?view=powershell-7.6)
                    # Capture the local helper scriptblock once (outside Invoke-Command)
                    $helperText = ${function:_SetOneTimeRebootLocal}.ToString()

                    $remoteResult = Invoke-Command -Session $sess -ScriptBlock {
                        param(
                            [string]$HelperText,
                            [datetime]$Target,
                            [string]$TaskName,
                            [string]$Description,
                            [bool]$Remove,
                            [bool]$Force,
                            [bool]$Wake,
                            [bool]$SelfDelete
                        )

                        # Rehydrate the scriptblock on the remote side
                        $Helper = [scriptblock]::Create($HelperText)

                        if ($Remove) {
                            & $Helper `
                                -TaskName     $TaskName `
                                -Description  $Description `
                                -Remove `
                                -Force:       $Force `
                                -Wake:        $Wake `
                                -SelfDelete:  $SelfDelete
                        }
                        else {
                            & $Helper `
                                -Target       $Target `
                                -TaskName     $TaskName `
                                -Description  $Description `
                                -Force:       $Force `
                                -Wake:        $Wake `
                                -SelfDelete:  $SelfDelete
                        }

                    } -ArgumentList @(
                        $helperText,
                        $targetDT,
                        $TaskName,
                        $Description,
                        [bool]$Remove,
                        [bool]$Force,
                        [bool]$Wake,
                        [bool]$SelfDelete
                    )

                    [pscustomobject]@{
                        ComputerName = $cn
                        Transport    = ($UseSsh ? "SSH:$Port" : "WSMan")
                        TaskName     = $remoteResult.TaskName
                        Description  = $Description
                        ScheduledFor = $remoteResult.ScheduledFor
                        Status       = $remoteResult.Status
                        Detail       = $remoteResult.Fallback
                    }
                }
                finally {
                    if ($sess) { Remove-PSSession -Session $sess -ErrorAction SilentlyContinue }
                }
            }
            catch {
                _Log Error "[$cn] $($_.Exception.Message)"
                [pscustomobject]@{
                    ComputerName = $cn
                    Transport    = ($UseSsh ? "SSH:$Port" : "WSMan")
                    TaskName     = $TaskName
                    Description  = $Description
                    ScheduledFor = $targetDT
                    Status       = 'Error'
                    Detail       = $_.Exception.Message
                }
            }
        }
    }
}

# SIG # Begin signature block
# MIIfAgYJKoZIhvcNAQcCoIIe8zCCHu8CAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAkCkFTkZ9JcbvV
# 7SAuKiMegSS6bZrwQ4Gsw4aSXD5msKCCGEowggUMMIIC9KADAgECAhAR+U4xG7FH
# qkyqS9NIt7l5MA0GCSqGSIb3DQEBCwUAMB4xHDAaBgNVBAMME1ZBRFRFSyBDb2Rl
# IFNpZ25pbmcwHhcNMjUxMjE5MTk1NDIxWhcNMjYxMjE5MjAwNDIxWjAeMRwwGgYD
# VQQDDBNWQURURUsgQ29kZSBTaWduaW5nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A
# MIICCgKCAgEA3pzzZIUEY92GDldMWuzvbLeivHOuMupgpwbezoG5v90KeuN03S5d
# nM/eom/PcIz08+fGZF04ueuCS6b48q1qFnylwg/C/TkcVRo0WFcKoFGT8yGxdfXi
# caHtapZfbSRh73r7qR7w0CioVveNBVgfMsTgE0WKcuwxemvIe/ptmkfzwAiw/IAC
# Ib0E0BjiX4PySbwWy/QKy/qMXYY19xpRItVTKNBtXzADUtzPzUcFqJU83vM2gZFs
# Or0MhPvM7xEVkOWZFBAWAubbMCJ3rmwyVv9keVDJChhCeLSz2XR11VGDOEA2OO90
# Y30WfY9aOI2sCfQcKMeJ9ypkHl0xORdhUwZ3Wz48d3yJDXGkduPm2vl05RvnA4T6
# 29HVZTmMdvP2475/8nLxCte9IB7TobAOGl6P1NuwplAMKM8qyZh62Br23vcx1fXZ
# TJlKCxBFx1nTa6VlIJk+UbM4ZPm954peB/fIqEacm8LkZ0cPwmLE5ckW7hfK4Trs
# o+RaudU1sKeA+FvpOWgsPccVRWcEYyGkwbyTB3xrIBXA+YckbANZ0XL7fv7x29hn
# gXbZipGu3DnTISiFB43V4MhNDKZYfbWdxze0SwLe8KzIaKnwlwRgvXDMwXgk99Mi
# EbYa3DvA/5ZWikLW9PxBFD7Vdr8ZiG/tRC9I2Y6fnb+PVoZKc/2xsW0CAwEAAaNG
# MEQwDgYDVR0PAQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQW
# BBRfYLVE8caSc990rnrIHUjoB7X/KjANBgkqhkiG9w0BAQsFAAOCAgEAiGB2Wmk3
# QBtd1LcynmxHzmu+X4Y5DIpMMNC2ahsqZtPUVcGqmb5IFbVuAdQphL6PSrDjaAR8
# 1S8uTfUnMa119LmIb7di7TlH2F5K3530h5x8JMj5EErl0xmZyJtSg7BTiBA/UrMz
# 6WCf8wWIG2/4NbV6aAyFwIojfAcKoO8ng44Dal/oLGzLO3FDE5AWhcda/FbqVjSJ
# 1zMfiW8odd4LgbmoyEI024KkwOkkPyJQ2Ugn6HMqlFLazAmBBpyS7wxdaAGrl18n
# 6bS7QuAwCd9hitdMMitG8YyWL6tKeRSbuTP5E+ASbu0Ga8/fxRO5ZSQhO6/5ro1j
# PGe1/Kr49Uyuf9VSCZdNIZAyjjeVAoxmV0IfxQLKz6VOG0kGDYkFGskvllIpQbQg
# WLuPLJxoskJsoJllk7MjZJwrpr08+3FQnLkRuisjDOc3l4VxFUsUe4fnJhMUONXT
# Sk7vdspgxirNbLmXU4yYWdsizz3nMUR0zebUW29A+HYme16hzrMPOeyoQjy4I5XX
# 3wXAFdworfPEr/ozDFrdXKgbLwZopymKbBwv6wtT7+1zVhJXr+jGVQ1TWr6R+8ea
# tIOFnY7HqGaxe5XB7HzOwJKdj+bpHAfXft1vUoiKr16VajLigcYCG8MdwC3sngO3
# JDyv2V+YMfsYBmItMGBwvizlQ6557NbK95EwggWNMIIEdaADAgECAhAOmxiO+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
# twGpn1eqXijiuZQwgga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqG
# SIb3DQEBCwUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx
# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRy
# dXN0ZWQgUm9vdCBHNDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkx
# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4
# RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYg
# MjAyNSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphB
# cr48RsAcrHXbo0ZodLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6p
# vF4uGjwjqNjfEvUi6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHe
# HYNnQxqXmRinvuNgxVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEd
# gkFiDNYiOTx4OtiFcMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjU
# jsZvkgFkriK9tUKJm/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bR
# VFLeGkuAhHiGPMvSGmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeS
# LsJygoLPp66bkDX1ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIV
# NSaz7BX8VtYGqLt9MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL
# 6s36czwzsucuoKs7Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2Zd
# SoQbU2rMkpLiQ6bGRinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFU
# eEY0qVjPKOWug/G6X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/
# BAgwBgEB/wIBADAdBgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0j
# BBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0
# cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0
# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8E
# PDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz
# dGVkUm9vdEc0LmNybDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEw
# DQYJKoZIhvcNAQELBQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/
# T8ObXAZz8OjuhUxjaaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQ
# E7jU/kXjjytJgnn0hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9r
# EVKChHyfpzee5kH0F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y
# 1IsA0QF8dTXqvcnTmpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gx
# dEkMx1NKU4uHQcKfZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3t
# y9qIijanrUR3anzEwlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcy
# tL5TTLL4ZaoBdqbhOhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEB
# YTptMSbhdhGQDpOXgpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud
# /v4+7RWsWCiKi9EOLLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiS
# uEtQvLsNz3Qbp7wGWqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZP
# ubdcMIIG7TCCBNWgAwIBAgIQCoDvGEuN8QWC0cR2p5V0aDANBgkqhkiG9w0BAQsF
# ADBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNV
# BAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hB
# MjU2IDIwMjUgQ0ExMB4XDTI1MDYwNDAwMDAwMFoXDTM2MDkwMzIzNTk1OVowYzEL
# MAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJE
# aWdpQ2VydCBTSEEyNTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIwMjUg
# MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANBGrC0Sxp7Q6q5gVrMr
# V7pvUf+GcAoB38o3zBlCMGMyqJnfFNZx+wvA69HFTBdwbHwBSOeLpvPnZ8ZN+vo8
# dE2/pPvOx/Vj8TchTySA2R4QKpVD7dvNZh6wW2R6kSu9RJt/4QhguSssp3qome7M
# rxVyfQO9sMx6ZAWjFDYOzDi8SOhPUWlLnh00Cll8pjrUcCV3K3E0zz09ldQ//nBZ
# ZREr4h/GI6Dxb2UoyrN0ijtUDVHRXdmncOOMA3CoB/iUSROUINDT98oksouTMYFO
# nHoRh6+86Ltc5zjPKHW5KqCvpSduSwhwUmotuQhcg9tw2YD3w6ySSSu+3qU8DD+n
# igNJFmt6LAHvH3KSuNLoZLc1Hf2JNMVL4Q1OpbybpMe46YceNA0LfNsnqcnpJeIt
# K/DhKbPxTTuGoX7wJNdoRORVbPR1VVnDuSeHVZlc4seAO+6d2sC26/PQPdP51ho1
# zBp+xUIZkpSFA8vWdoUoHLWnqWU3dCCyFG1roSrgHjSHlq8xymLnjCbSLZ49kPmk
# 8iyyizNDIXj//cOgrY7rlRyTlaCCfw7aSUROwnu7zER6EaJ+AliL7ojTdS5PWPsW
# eupWs7NpChUk555K096V1hE0yZIXe+giAwW00aHzrDchIc2bQhpp0IoKRR7YufAk
# prxMiXAJQ1XCmnCfgPf8+3mnAgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAAMB0G
# A1UdDgQWBBTkO/zyMe39/dfzkXFjGVBDz2GM6DAfBgNVHSMEGDAWgBTvb1NK6eQG
# fHrK4pBW9i/USezLTjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYIKwYB
# BQUHAwgwgZUGCCsGAQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8vb2Nz
# cC5kaWdpY2VydC5jb20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRpZ2lj
# ZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEy
# NTYyMDI1Q0ExLmNydDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5kaWdp
# Y2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hB
# MjU2MjAyNUNBMS5jcmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcB
# MA0GCSqGSIb3DQEBCwUAA4ICAQBlKq3xHCcEua5gQezRCESeY0ByIfjk9iJP2zWL
# pQq1b4URGnwWBdEZD9gBq9fNaNmFj6Eh8/YmRDfxT7C0k8FUFqNh+tshgb4O6Lgj
# g8K8elC4+oWCqnU/ML9lFfim8/9yJmZSe2F8AQ/UdKFOtj7YMTmqPO9mzskgiC3Q
# YIUP2S3HQvHG1FDu+WUqW4daIqToXFE/JQ/EABgfZXLWU0ziTN6R3ygQBHMUBaB5
# bdrPbF6MRYs03h4obEMnxYOX8VBRKe1uNnzQVTeLni2nHkX/QqvXnNb+YkDFkxUG
# tMTaiLR9wjxUxu2hECZpqyU1d0IbX6Wq8/gVutDojBIFeRlqAcuEVT0cKsb+zJNE
# suEB7O7/cuvTQasnM9AWcIQfVjnzrvwiCZ85EE8LUkqRhoS3Y50OHgaY7T/lwd6U
# Arb+BOVAkg2oOvol/DJgddJ35XTxfUlQ+8Hggt8l2Yv7roancJIFcbojBcxlRcGG
# 0LIhp6GvReQGgMgYxQbV1S3CrWqZzBt1R9xJgKf47CdxVRd/ndUlQ05oxYy2zRWV
# FjF7mcr4C34Mj3ocCVccAvlKV9jEnstrniLvUxxVZE/rptb7IRE2lskKPIJgbaP5
# t2nGj/ULLi49xTcBZU8atufk+EMF/cWuiC7POGT75qaL6vdCvHlshtjdNXOCIUjs
# arfNZzGCBg4wggYKAgEBMDIwHjEcMBoGA1UEAwwTVkFEVEVLIENvZGUgU2lnbmlu
# ZwIQEflOMRuxR6pMqkvTSLe5eTANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3
# AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG
# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCBEDQ0KFCEw
# 4rXWWa5scWA7gExRc7WMQszLjY4gopSZWDANBgkqhkiG9w0BAQEFAASCAgAmeSN9
# SzNhQh2yRrz+nr6SmvTJiMd6uHiHBHKITspAXvmdPXQZTiD44WV0x6kiOVxggvBI
# 2GLhUQe23gB6aZtsP+P65x0ABMXCjghVmjCDT7kzOE76VYmmxhCklKJa5Acm93BQ
# SguPWsI7QHd/Mdmr2xpbKazGtG0iiJgL5OnNW40HddAUF7eFYYKahxCZW3tTuBDu
# RSOuRc9Rr9ASQzPa3Qm1POBIaB5HfAjoCHwnqXeDpx0g6CKcuGqL7if5z1HYFtx3
# i/65O/fDFepcsw7LhuFCTy2dYCikB/peBzgEL2o0hKBWLPIj3YCY8rSfTlxAYW9K
# QHjtkRTOT/KOXAQdFJS1cHOa2kW9S/AiHNf49KZ31/lVg+hAYsqvcCdnSuc7TQCS
# 0YOYUXnBN3AvS2Qhz/XdI3XEuGZhIrOqcU9kh3HiqJjn4XELem9SN4v/rF76LLC+
# UgQ/J5idJWhBoEB7HTPSCWy0mhCTbGk2O87PFgi43DxP6XWBr5IERDOBTi5FNic4
# ZitYqbMS5GbO1Qxde+vGyIk7mLwQdc1AXfw51JhfJNWmMyvZDuUxVDljgAITFPjG
# B9FTtWyt6fv83UZfuOINc8MIqPWQ3XeaHDxPA2ab9y5jYLw/ZOgNFidhRDYxk1j1
# f8mueA0qlaZ8UDYeb6CcZCp29OnMhR+6sPf1iqGCAyYwggMiBgkqhkiG9w0BCQYx
# ggMTMIIDDwIBATB9MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwg
# SW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcg
# UlNBNDA5NiBTSEEyNTYgMjAyNSBDQTECEAqA7xhLjfEFgtHEdqeVdGgwDQYJYIZI
# AWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJ
# BTEPFw0yNjA0MjAyMTI3MTdaMC8GCSqGSIb3DQEJBDEiBCDR7Iy1euj/J74wGOs8
# 1IqHAIjN0t9LuGvk739zSXxN6zANBgkqhkiG9w0BAQEFAASCAgC5YuKV7hcNV0fT
# vmWeyU1qrY7rTii1IluJc7tAgxMZf20uSxKHQSe2gMiSq+ZdPRBDpNmSPpzvPKjn
# 9FkKfc+B/fV5aGiQQFEVLzgHtiibuXB1Cv3NfsyC/7s9PJaQ3zNw97dsfY13GewK
# rmpx+JEgkxukCuGVgfN7Y7k72SWNqDMvHSluNEIpft50lglOuIzQPnNgAqv6AXm/
# nWa3RkTuDFjENMEoBwUSoYQH0Zj19IU0YDU1wRKumTTYyHt5O0MHi4Q7pQit2sSk
# NK/cofUPpURlDf5n30Z5wmGVehTiIy7DkwMXdvgCnKbvRKbtfx5Y7PV07+60znBk
# 5pimeEz9ysIditDZyI0iNknQquyeISkWpFZltUc75iIuxTnz8CvnHBlFf+6UOrJu
# DNAEUsu1n5RIpXJJR7HZapV+tkaTToyTiHK3ejlku6IH6jcq8nulTh6XOP0aPwed
# czizQamTPDpZ+e2fN2cL++thXbqYrLzXerSEKmdeK7/i3G5pmEgCvU3n1wBrvpfU
# zySBLPQZnrvsejVHltwg4VKh9PHafSewE6k8WZYq+FMcOs29qRM/pPqXvhQJM+D6
# I9rWGRSZ+pPIhC0JL4ULjWgSJK+YPbuZq7ISkHT5n8XIbpz7GM/4mUDDW9z+Ry88
# IhkMZKGISjKu87ILRDZzpwZB/L6DiA==
# SIG # End signature block