WatchCPU.psm1

<#
DISKSPD - VM Fleet
 
Copyright(c) Microsoft Corporation
All rights reserved.
 
MIT License
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
#>


Set-StrictMode -Version 3.0

function Watch-FleetCPU
{
    [CmdletBinding()]
    param(
        [Parameter()]
        [string]
        $ComputerName = $env:COMPUTERNAME,

        [Parameter()]
        [switch]
        $Guest,

        [Parameter()]
        [int]
        $SampleInterval = 2
        )

    function div-to-width(
        [int] $div
        )
    {
        # 0 - 100 scale
        # ex: 4 -> 100/4 = 25 buckets + 1 more for == 100
        1+100/$div
    }

    function center-pad(
        [string] $s,
        [int] $width
        )
    {
        if ($width -le $s.length) {
            $s
        } else {
            (' ' * (($width - $s.length)/2) + $s)
        }
    }

    function get-legend(
        [string] $label,
        [int] $width,
        [int] $div
        )
    {
        # now produce the scale, a digit at a time in vertical orientation
        # at each multiple of 10% which aligns with a measurement bucket.
        # the width is the width of the measured values
        #
        # 0 5 1
        # 0 0
        # 0

        $lines = @()
        $lines += '-' * $width

        foreach ($dig in 0..2) {
            $o = foreach ($pos in 0..($width - 1)) {

                $val = $pos * $div
                if ($val % 10 -eq 0) {
                    switch ($dig) {
                        0 { if ($val -eq 100) { 1 } else { $val / 10 }}
                        1 { if ($val -ne 0) { 0 } else { ' ' }}
                        2 { if ($val -eq 100) { 0 } else { ' ' }}
                    }
                } else { ' ' }
            }

            $lines += $o -join ''
        }

        # trailing comments (horizontal scale name)
        $lines += center-pad $label $width

        $lines
    }

    # minimum clip, the vertical height available for the cpu core bars
    $minClip = 10

    # these are the valid divisions, in units of percentage width.
    # they must evenly divide 100% and either 10% or 20% for scale markings.
    # determine which is the best fit based on window width.

    $div = 0
    $divs = 1,2,4,5
    foreach ($i in $divs) {
        if ((div-to-width $i) -le [console]::WindowWidth) {
            $div = $i
            break
        }
    }

    # if nothing fit ... ask for minimum
    # in practice this is not possible, but we check anyway
    if ($div -eq 0) {
        Write-Error "Window width must be at least $(div-to-width $divs[-1]) columns"
        return
    }

    $width = div-to-width $div

    # which processor counterset should we use?
    # pi is only the root partition if hv is active; when hv is active:
    # hvlp is the host physical processors
    # hvvp is the guest virtual processors
    # via ctrs, hv is active iff hvlp is present and has multiple instances
    $cs = Get-Counter -ComputerName $ComputerName -ListSet 'Hyper-V Hypervisor Logical Processor' -ErrorAction SilentlyContinue
    $hvactive = $null -ne $cs -and $cs.CounterSetType -eq [Diagnostics.PerformanceCounterCategoryType]::MultiInstance

    if ($Guest -and -not $hvactive) {
        Write-Error "Hyper-V is not active on $ComputerName"
        return
    }

    if ($hvactive) {
        if ($Guest) {
            $cpuset = "\Hyper-V Hypervisor Virtual Processor(*)\% Guest Run Time"
            $legend = get-legend "Percent Guest VCPU Utilization" $width $div
        } else {
            $cpuset = '\Hyper-V Hypervisor Logical Processor(*)\% Total Run Time'
            $legend = get-legend "Percent Host LP Utilization" $width $div
        }
    } else {
        $cpuset = '\Processor Information(*)\% Processor Time'
        $legend = get-legend "Percent Processor Utilization" $width $div
    }

    # processor performance counter (turbo/speedstep)
    # this is used to normalize the total cpu utilization (can be > 100%)
    $ppset = '\Processor Information(_Total)\% Processor Performance'

    # account for the constant legend in the window height
    # use the remaining height for the vertical cpu core bars.
    $clip = [console]::WindowHeight - ($legend.Count + 1)

    # insist on a minimum amount of space
    if ($clip -lt $minClip) {
        $minWindowHeight = $minClip + $legend.Count + 1
        Write-Error "Window height must be at least $minWindowHeight lines"
        return
    }

    # set window and buffer size simultaneously so we don't have extra scrollbars
    Clear-Host
    [console]::SetWindowSize($width, [console]::WindowHeight)
    [console]::BufferWidth = [console]::WindowWidth
    [console]::BufferHeight = [console]::WindowHeight

    # common params for Get-Counter
    $gcParam = @{
        SampleInterval = $SampleInterval
        Counter = $cpuset,$ppset
        ErrorAction = 'SilentlyContinue'
    }

    while ($true) {

        # reset measurements
        # these are the vertical height of a cpu bar in each column, e.g. 2 = 2 cpus
        $m = @([int] 0) * $width

        # avoid remoting for the local case
        if ($ComputerName -eq $env:COMPUTERNAME) {
            $ctrs = Get-Counter @gcParam
        } else {
            $ctrs = Get-Counter @gcParam -ComputerName $ComputerName
        }

        # if more than one countersample was returned (ppset + something more), we have data
        if ($null -ne $ctrs -and $ctrs.Countersamples.Count -gt 1)
        {
            # get all specific instances and count them into appropriate measurement bucket
            $ctrs.Countersamples |% {

                # get scaling factor for total utility
                if ($_.Path -like "*$ppset") {
                    $pperf = $_.CookedValue/100
                }

                # a cpu: count into appropriate measurement bucket
                # (ignore total and/or and per-numa total)
                elseif ($_.InstanceName -notlike '*_Total') {
                    $m[[math]::Floor($_.CookedValue/$div)] += 1
                }

                # get total
                #
                elseif ($_.InstanceName -eq '_Total') {
                    $total = $_.CookedValue
                }
            }

            # now produce the bar area as a series of lines
            # work down the veritical altitude of each strip, starting at the clip/top
            $altitude = $clip
            $lines = do {
                $($m |% {

                    # top line - if we are potentially clipped, handle
                    if ($altitude -eq $clip) {

                        # clipped?
                        if ($_ -gt $altitude) { 'x' }
                        # unclipped but at clip?
                        elseif ($_ -eq $altitude) { '*' }
                        # nothing, bar less than altitude
                        else { ' ' }

                    } else {

                        # below top line
                        # >=, output bar
                        if ($_ -ge $altitude) { '*' }
                        # <, nothing
                        else { ' ' }
                    }
                }) -join ''
            } while (--$altitude)

            $totalStr = "{0:0.0}%" -f $total
            $normalStr = "{0:0.0}%" -f ($total*$pperf)

            # move the cursor to indicate average utilization
            # column number is zero based, width is 1-based
            $cpos = [math]::Floor(($width - 1)*$total/100)
        }
        else
        {
            # Center no data message vertically and horizontally in the frame

            $vpre = [math]::Floor($clip/2) - 1
            $vpost = [math]::Floor($clip/2)

            $lines  = @('') * $vpre
            $lines += center-pad "No Data Available" $width
            $lines += @('') * $vpost

            $totalStr = $normalStr = "---"

            # zero cursor
            $cpos = 0
        }

        Clear-Host
        Write-Host -NoNewline ($lines + $legend -join "`n")
        Write-Host -NoNewLine ("`n" + (center-pad "$ComputerName Total: $totalStr Normalized: $normalStr" $width))

        # move the cursor to indicate average utilization
        # column number is zero based, width is 1-based
        [console]::SetCursorPosition($cpos,[console]::CursorTop-$legend.Count)
    }
}
# SIG # Begin signature block
# MIIllgYJKoZIhvcNAQcCoIIlhzCCJYMCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDpHVrgmYRDPTHR
# CvnTzeQDUPUFaLxDAcDUFUhZZqFhX6CCCtkwggT6MIID4qADAgECAhMzAAAEYM9C
# qRIxX2+zAAAAAARgMA0GCSqGSIb3DQEBCwUAMIGEMQswCQYDVQQGEwJVUzETMBEG
# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj
# cm9zb2Z0IENvcnBvcmF0aW9uMS4wLAYDVQQDEyVNaWNyb3NvZnQgV2luZG93cyBQ
# cm9kdWN0aW9uIFBDQSAyMDExMB4XDTIzMTExNjE5MjAwOVoXDTI0MTExNDE5MjAw
# OVowcDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEaMBgGA1UE
# AxMRTWljcm9zb2Z0IFdpbmRvd3MwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
# AoIBAQCauQTuOKVgtP/cZ8Tr1ahkgcvw/djlgVybJLIcVkxd3PdVEHTrBg21Bpnl
# jhjuJtnVCI5HoUTgFfrnu9rzkU/ewRKVQ7y7nGt2uIJHEndqnixGNsQrVgWzoJKq
# OC2ZmAYdBcM1LXWgFRCUp3UJpkD7LNe78/AfJbxzSlRKz4C4p4cU0g66udmFRAef
# Kcyog9zVr0OEjwl9U7lCnB52eqeINXsTapdvMvaw4wb+X3qxgpg5jkjSeBHCyvvf
# rH7ckd6iE8KWW66Y8dudzys2A6ZmfZ04sWNF9nijfeYTwDYVWyPjrNUjpgP4l4pa
# tZwOw4hIjqSF1PGRGDLLdcc6Yj/zAgMBAAGjggF2MIIBcjAfBgNVHSUEGDAWBgor
# BgEEAYI3CgMGBggrBgEFBQcDAzAdBgNVHQ4EFgQUwqt2ZKpMEZwg7U1NVTVHmP/0
# MDMwRQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEWMBQGA1UEBRMNMjI5ODc5KzUwMTgyNTAfBgNVHSMEGDAWgBSpKQI5jhbEl3jN
# kPmeT5rhfFWvUzBXBgNVHR8EUDBOMEygSqBIhkZodHRwOi8vd3d3Lm1pY3Jvc29m
# dC5jb20vcGtpb3BzL2NybC9NaWNXaW5Qcm9QQ0EyMDExXzIwMTEtMTAtMTkuY3Js
# JTIwMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNy
# b3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNXaW5Qcm9QQ0EyMDExXzIwMTEtMTAt
# MTkuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggEBADVji8W8AyO3
# wLoXQ1Du4bCU8V8pnhe1LxNW+u+RdMqb5BsRPMXgwlVAyODV8n7IrcYu1UR/SS8i
# 94JbUZNG6QsB6dYY1eGaVWnYOUBxAh3dSPGJQE1TlmbHsjNYvMqQbXZbcJdzTjIC
# jpiniXWIhlgA6YJdPzqOk9uqnys6Q2Y7QOoP1xfFsGnoCK8Wrl7Y5oGB2vIXq33x
# mKw06NeW+vIScQX+Z3rz3pKh+c/fryWsJv1GDTfi0diJc+avHWxrhjeumeXxxh5l
# gNGUGPzQ9IUQgRC5p7osoY5szVAK7XE7ywzgrwX3um8eZi5wztV4240RglDisj6/
# kXkYKN5V7XcwggXXMIIDv6ADAgECAgphB3ZWAAAAAAAIMA0GCSqGSIb3DQEBCwUA
# MIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQD
# EylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0x
# MTEwMTkxODQxNDJaFw0yNjEwMTkxODUxNDJaMIGEMQswCQYDVQQGEwJVUzETMBEG
# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj
# cm9zb2Z0IENvcnBvcmF0aW9uMS4wLAYDVQQDEyVNaWNyb3NvZnQgV2luZG93cyBQ
# cm9kdWN0aW9uIFBDQSAyMDExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
# AQEA3Qy7ouQuCePnxfeWabwAIb1pMzPvrQTLVIDuBoO7xSCE2ffSi/M4sKukrS18
# YnkF/+NKPwQ1IHDjxOdr4JzANnXpijHdjXDl3De1dEaWKFuHYCMsv9xHpWf3USee
# cusHpsm5HjtTNXzl0+wnuYcc/rnJIwlvqEaRwW6WPEHTy6M/XQJqTexpHyUoXDb/
# /UMVCpTgGbTP38IS4sJbJ+4neDCLWyoJayKJU2AWLMBoHVO67EnznWGMhWgJc0Rd
# faJUK9159xXPNV1sHCtczrycI4tvbrUm2TYTw0/WJ665MjtBkizhx8136KpUTvdc
# CwSHZbRDGKiy4G0Zd+xaJPpIAwIDAQABo4IBQzCCAT8wEAYJKwYBBAGCNxUBBAMC
# AQAwHQYDVR0OBBYEFKkpAjmOFsSXeM2Q+Z5PmuF8Va9TMBkGCSsGAQQBgjcUAgQM
# HgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1Ud
# IwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0
# dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0Nl
# ckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKG
# Pmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0
# XzIwMTAtMDYtMjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQAU/HxxUaV5wm6y7zk+
# vDxSD24rPxATc/6oaNBIpjRNipYFJu4xRpBhedb/OC5Fa/TA5Si42h2PitsJ1xrH
# TAo2ZmqM7BvXBJCoGBekm7niQDI2dsTBWsa/5ATA6hbTrMNo72Ks3VRsUDBYput8
# /pSnTo707HyGc1fCUiFzNFrzo4pWyATaBwnt+IvjzvR+jq7w9guKCPs/yR1yf1O4
# 675j4OM9MWWwgeXyrM0WpJ89qLGbwkLQkIRfVB3/ieq6HUeQb7BzTkGfQJ9f5aEq
# shGRc4ohKPDO3nM5Xz6rXGDs3wMQqNMJ6fT2loW2f1GIZkcZjaKwEj2BKmgFd7uR
# TGJ7tsEHx7p6hzQDDktiepnpyvzOSjfJLaRXfBz+Pdy4D1r61sSzAoUCOuqz2W7k
# aSE33oHR9nUZBWfTk1deKRs5yO4t4c3kRXNb0NLOeqsWGYJGWNBenYGzZ69sNfK8
# 5T8k4jWiCnUG9hhWmdR4LNEFG+vQiAGdqhDxBd+6fixjtwabIyHE+Xhs4lgXBjYr
# kRIDzKTZ8i26+ZSdQO0YRfHOilxrPqsD03AYKgpq4F9H0dVjCjLyr9c2HypwWuVC
# WQhxS1e6foOB8CE89BzBxbmQkw6IRZOG6bEgmb6Yy8WVpF1i1qBjCCC9dRB3fT3z
# Rbmfl5/LV4BvM6kEz3ekYhxZfjGCGhMwghoPAgEBMIGcMIGEMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS4wLAYDVQQDEyVNaWNyb3NvZnQgV2lu
# ZG93cyBQcm9kdWN0aW9uIFBDQSAyMDExAhMzAAAEYM9CqRIxX2+zAAAAAARgMA0G
# CWCGSAFlAwQCAQUAoIGwMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG
# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCAyW6J6g6AU
# 4nKCGUNtS93Kk11a2wh6zbKvPmRappXouDBEBgorBgEEAYI3AgEMMTYwNKAUgBIA
# TQBpAGMAcgBvAHMAbwBmAHShHIAaaHR0cHM6Ly93d3cubWljcm9zb2Z0LmNvbSAw
# DQYJKoZIhvcNAQEBBQAEggEADumPQRTpbb8a2GPph9IMjQwZP7gf8WQH2X7WtzIB
# 0N1aVk8UtPKeYMkJpOtfC8CUthmcyPFkkgOifHYYBGSFTvcy9Zrt8UZ3b3VZcr+b
# 76+Yj4aqtoQ/2EXtSuRi8PDC+AKXGeuLMzuN1oVd2CR8qMtqDBFW0F5VZvveEL1R
# 8hsMymFeYMbjAFs/onC3QNZSWqvhksbF82vcaVcBIiWaum6r6AW7d4gvYwXFx8gm
# vI/GpDE08SqYI+8qrKefcWwg8CoKgsOytoC9ReyfaJKVxUX1DnszeHxN8PhytOck
# kQJTWnkqGuibe003Qh0UyQSwFRzIIZ+MY0ofoANVKsDqVqGCF5QwgheQBgorBgEE
# AYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20wghdpAgEDMQ8wDQYJYIZIAWUD
# BAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoD
# ATAxMA0GCWCGSAFlAwQCAQUABCBxO3qAnfs+GPeRHIKXzF7PtObnLaR3NqKG6hsy
# 27/wRQIGZfxoeKn2GBMyMDI0MDMyODIyNTUxMS4yMzFaMASAAgH0oIHRpIHOMIHL
# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk
# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxN
# aWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRT
# UyBFU046ODkwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0
# YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgITMwAAAe3hX8vV96VdcwABAAAB
# 7TANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAe
# Fw0yMzEyMDYxODQ1NDFaFw0yNTAzMDUxODQ1NDFaMIHLMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmlj
# YSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODkwMC0wNUUw
# LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCoMMJskrrqapycLxPC1H7zD7g8
# 8NpbEaQ6SjcTIRbzCVyYQNsz8TaL1pqFTEAPL1X7ojL4/EaEW+UjNqZs/ayMyW4Y
# IpFPZP2x4FBMVCddseF2i+aMMjDHi0LcTQZxM2s3mFMrCZAWSfLYXYDIimFBz8j0
# oLWGy3VgLmBTKM4xLqv7DZUz8B2SoAmbEtp62ngSl0hOoN73SFwE+Y24SvGQMWhy
# kpG+vXDwcpWvwDe+TgnrLR7ATRFXN5JS26dm2yy6SYFMRYnME3dMHCQ/UQIQQNC8
# nLmIvdKkAoWEMXtJsGEo3QrM2S2SBv4PpHRzRukzTtP+UAceGxM9JyrwUQP5OCEm
# W6YchEyRDSwP4hU9f7B0Ayh14Pw9vJo7jewNjeMPIkmneyLSi0ruv2ox/xRGtcJ9
# yBNC5BaRktjz7stPaojR+PDA2fuBtCo8xKlkt53mUb7AY+CZHHqhLm76pdMF6BHv
# 2TvwlVBeQRN22XjaVVRwCgjgJnNewt7PejcrpUn0qHLgLq+1BN1DzYukWkTr7wT0
# zl0iXr+NtqUkWSOnWRfe8N21tB6uv3VkW8nFdChtbbZZz24peLtJEZuNrN8Xf9PT
# PMzZXDJBI1EciR/91QcGoZFmVbFVb2rUIAs01+ZkewvbhmGVDefX9oZG4/K4gGUs
# TvTW+r1JZMxUT2MwqQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFM4b8Oz33hAqBEfK
# lAZf0NKh4CIZMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud
# HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js
# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr
# BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv
# bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw
# MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw
# DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQCd1gK2Rd+eGL0eHi+i
# E6/qDY8sbbsO4emancp6KPN+xq5ZAatiBR4jmRRhm+9Vik0Fo0DLWi/N28bFI7dX
# Yw09p3vCipbjy4Eoifm0Nud7/4U30i9+7RvW7XOQ3rx37+U7vq9lk6yYpGCNp0jl
# J188/CuRPgqJnfq5EdeafH2AoG46hKWTeB7DuXasGt6spJOenGedSre34MWZqeTI
# Q0raOItZnFuGDy4+xoD1qRz2QW+u2gCHaG8AQjhYUM4uTi9t6kttj6c7Xamr2zrW
# uceDhz7sKLttLTJ7ws5YrA2I8cTlbMAf2KW0GVjKbYGd+LZGduEK7/7fs4GUkMqc
# 51FsNdG1n+zgc7zHu2oGGeCBg4s8ZR0ZFyx7jsgm9sSFCKQ5CsbAvlr/60Ndk5Te
# MR8Js2kNUicu2CqZ03833TsvTgk7iD1KLgfS16HEvjN6m4VKJKgjJ7OJJzabtS4J
# QgUnJrIZfyosk4D18rZni9pUwN03WgTmd10WTwiZOu4g8Un6iKcPMY/iFqTu4ntk
# zFUxBBpbFG6k1CINZmoirEWmCtG3lyZ2IddmjtIefTkIvGWb4Jxzz7l2m/E2kGOi
# xDJHsahZVmwsoNvhy5ku/inU++dXHzw+hlvqTSFT89rIFVhcmsWPDJPNRSSpMhoJ
# 33V2Za/lkKcbkUM0SbQgS9qsdzCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA
# AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl
# IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX
# 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q
# UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d
# q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN
# pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k
# rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d
# Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS
# Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8
# QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm
# gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF
# ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID
# AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU
# KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1
# GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0
# bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA
# QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL
# j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p
# Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w
# Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3
# Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz
# LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU
# tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN
# 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU
# 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5
# KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy
# qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6
# 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE
# AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp
# AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd
# FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb
# atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd
# VTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzAR
# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p
# Y3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2Eg
# T3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjg5MDAtMDVFMC1E
# OTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEw
# BwYFKw4DAhoDFQDuHayKTCaYsYxJh+oWTx6uVPFw+aCBgzCBgKR+MHwxCzAJBgNV
# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w
# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m
# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6bAg9jAiGA8y
# MDI0MDMyODE3MDE0MloYDzIwMjQwMzI5MTcwMTQyWjB0MDoGCisGAQQBhFkKBAEx
# LDAqMAoCBQDpsCD2AgEAMAcCAQACAinhMAcCAQACAhNLMAoCBQDpsXJ2AgEAMDYG
# CisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEA
# AgMBhqAwDQYJKoZIhvcNAQELBQADggEBALbl92194F2K3J5nZa+9k13C0ju54g3i
# lUNtJwLjrX4SqLpGo6lZsGTUG9Fm0lYBfLcZIopJfTXvT85pzV8/kJWpD/tqUq/6
# FX32SCHK/tGFev0y5n8tHsW+7KGX0+gOXAbRzQZtEMHWzVMakA2ZpFZ4aZavRhx1
# JWjC7BmL4s2KwpaX4yUr3mLKZ78dGy1F+QOo9ucdm0sZt1JoGk0lvceHfeRrAiv2
# PYJDdGumTsM9GbHtwr8HZI/987ZIcUS5zxOAp9zly6zC2/Hw5gEGLqHeT5SN7uLl
# SYxHoNQLLqMVdFFWoBwHXRYLsE927w0cVjcBt84MJUnzzedz893BAdUxggQNMIIE
# CQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYw
# JAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAe3hX8vV
# 96VdcwABAAAB7TANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqG
# SIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCBh9XozzZ2JrOQqvgz6qWe/XXRwetpE
# B6vp3TmXtSrOEDCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EII0uDWg0CFse
# KxK3A16l1wrIwrsSDrXZ6xSf0F4xbMo5MIGYMIGApH4wfDELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt
# U3RhbXAgUENBIDIwMTACEzMAAAHt4V/L1felXXMAAQAAAe0wIgQgsGiRPVLW4WMv
# UJiCx+tNp46tuoCXArYOs872J+/uhEMwDQYJKoZIhvcNAQELBQAEggIAm3bmJuDR
# YS/AYxIHRlaxzK0fySo70XMeMmbd6s3OOK89VNucK3l08hiylL/k11ye8cC14u0s
# 9ttRfDy3vFvB6hJo+jFHe0kzhlOYpSHa7bYwYj6qlKgfDRTV/lUNKsNW1nQY8IP6
# NtICd9Clg9JZS7YLMA9tdPQVRpVs9wT17cKNSHBnFQ8Na8SE6ktx9kBCjHpyct7K
# VmFVnl3pwqxh9h2CQCILu82egRkiP7+YEX5A/p1l0us3Anya1RizIkdkvlkiYfxh
# kAw5U4/dqqkkla616UZsgpeIUp1/F0JkBMSJGeVZOvT5FexwSN2S7xL2WeWV0+WD
# f2bAIpCO6XfzkSevMfrqWBTSVEgI7nude9eKpDKSQbn2y0Dt11PKMpXCLdfE4bVS
# uicBZtsxSmHQmjZ9IgtIa3w3Aye/5DS+1X1vQgUaHlnYBsPHPiHsM1LPsoXtplDk
# NtxH5wm6X7LgBzipMsVpx2vv8AhBw11KjaGvasiz0VsLysTkVTXs/iH/yxiln1+A
# TQLV0z5qYuoaIWD8qTCqzC4t3bMnQEtvxejq8GWj7YmU20oJNscv1ov+vKS/h6K6
# kbiJMuAJCiyXJzfrpddvoCMdhbumuLfUse3kY4wxG7F3BzBvqSP/b1bDFylgYkAi
# +iV87YrB366D8ip/f9nNCGYdnzCPCFJs1qI=
# SIG # End signature block