PSQuickGraph

2.2.0

runtimes/win/lib/net9.0/Modules/PSDiagnostics/PSDiagnostics.psm1

                                # Copyright (c) Microsoft Corporation.

# Licensed under the MIT License.

<#

  PowerShell Diagnostics Module

  This module contains a set of wrapper scripts that

  enable a user to use ETW tracing in Windows

  PowerShell.

 #>

$script:Logman="$env:windir\system32\logman.exe"

$script:wsmanlogfile = "$env:windir\system32\wsmtraces.log"

$script:wsmprovfile = "$env:windir\system32\wsmtraceproviders.txt"

$script:wsmsession = "wsmlog"

$script:pssession = "PSTrace"

$script:psprovidername="Microsoft-Windows-PowerShell"

$script:wsmprovidername = "Microsoft-Windows-WinRM"

$script:oplog = "/Operational"

$script:analyticlog="/Analytic"

$script:debuglog="/Debug"

$script:wevtutil="$env:windir\system32\wevtutil.exe"

$script:slparam = "sl"

$script:glparam = "gl"

function Start-Trace

{

    Param(

    [Parameter(Mandatory=$true,

               Position=0)]

    [string]

    $SessionName,

    [Parameter(Position=1)]

    [ValidateNotNullOrEmpty()]

    [string]

    $OutputFilePath,

    [Parameter(Position=2)]

    [ValidateNotNullOrEmpty()]

    [string]

    $ProviderFilePath,

    [Parameter()]

    [Switch]

    $ETS,

    [Parameter()]

    [ValidateSet("bin", "bincirc", "csv", "tsv", "sql")]

    $Format,

    [Parameter()]

    [int]

    $MinBuffers=0,

    [Parameter()]

    [int]

    $MaxBuffers=256,

    [Parameter()]

    [int]

    $BufferSizeInKB = 0,

    [Parameter()]

    [int]

    $MaxLogFileSizeInMB=0

    )

    Process

    {

        $executestring = " start $SessionName"

        if ($ETS)

        {

            $executestring += " -ets"

        }

        if ($null -ne $OutputFilePath)

        {

            $executestring += " -o ""$OutputFilePath"""

        }

        if ($null -ne $ProviderFilePath)

        {

            $executestring += " -pf ""$ProviderFilePath"""

        }

        if ($null -ne $Format)

        {

            $executestring += " -f $Format"

        }

        if ($MinBuffers -ne 0 -or $MaxBuffers -ne 256)

        {

            $executestring += " -nb $MinBuffers $MaxBuffers"

        }

        if ($BufferSizeInKB -ne 0)

        {

            $executestring += " -bs $BufferSizeInKB"

        }

        if ($MaxLogFileSizeInMB -ne 0)

        {

            $executestring += " -max $MaxLogFileSizeInMB"

        }

        & $script:Logman $executestring.Split(" ")

    }

}

function Stop-Trace

{

    param(

    [Parameter(Mandatory=$true,

               Position=0)]

    $SessionName,

    [Parameter()]

    [switch]

    $ETS

    )

    Process

    {

        if ($ETS)

        {

            & $script:Logman update $SessionName -ets

            & $script:Logman stop $SessionName -ets

        }

        else

        {

            & $script:Logman update $SessionName

            & $script:Logman stop $SessionName

        }

    }

}

function Enable-WSManTrace

{

    # winrm

    "{04c6e16d-b99f-4a3a-9b3e-b8325bbc781e} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii

    # winrsmgr

    "{c0a36be8-a515-4cfa-b2b6-2676366efff7} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    # WinrsExe

    "{f1cab2c0-8beb-4fa2-90e1-8f17e0acdd5d} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    # WinrsCmd

    "{03992646-3dfe-4477-80e3-85936ace7abb} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    # IPMIPrv

    "{651d672b-e11f-41b7-add3-c2f6a4023672} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    #IpmiDrv

    "{D5C6A3E9-FA9C-434e-9653-165B4FC869E4} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    # WSManProvHost

    "{6e1b64d7-d3be-4651-90fb-3583af89d7f1} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    # Event Forwarding

    "{6FCDF39A-EF67-483D-A661-76D715C6B008} 0xffffffff 0xff" | Out-File $script:wsmprovfile -Encoding ascii -Append

    Start-Trace -SessionName $script:wsmsession -ETS -OutputFilePath $script:wsmanlogfile -Format bincirc -MinBuffers 16 -MaxBuffers 256 -BufferSizeInKB 64 -MaxLogFileSizeInMB 256 -ProviderFilePath $script:wsmprovfile

}

function Disable-WSManTrace

{

    Stop-Trace $script:wsmsession -ETS

}

function Enable-PSWSManCombinedTrace

{

    param (

        [switch] $DoNotOverwriteExistingTrace

    )

    $provfile = [io.path]::GetTempFilename()

    $traceFileName = [string][Guid]::NewGuid()

    if ($DoNotOverwriteExistingTrace) {

        $fileName = [string][guid]::newguid()

        $logfile = $PSHOME + "\\Traces\\PSTrace_$fileName.etl"

    } else {

        $logfile = $PSHOME + "\\Traces\\PSTrace.etl"

    }

    "Microsoft-Windows-PowerShell 0 5" | Out-File $provfile -Encoding ascii

    "Microsoft-Windows-WinRM 0 5" | Out-File $provfile -Encoding ascii -Append

    if (!(Test-Path $PSHOME\Traces))

    {

        New-Item -ItemType Directory -Force $PSHOME\Traces | Out-Null

    }

    if (Test-Path $logfile)

    {

        Remove-Item -Force $logfile | Out-Null

    }

    Start-Trace -SessionName $script:pssession -OutputFilePath $logfile -ProviderFilePath $provfile -ETS

    Remove-Item $provfile -Force -ea 0

}

function Disable-PSWSManCombinedTrace

{

    Stop-Trace -SessionName $script:pssession -ETS

}

function Set-LogProperties

{

    param(

        [Parameter(Mandatory=$true, Position=0, ValueFromPipeline=$true)]

        [Microsoft.PowerShell.Diagnostics.LogDetails]

        $LogDetails,

        [switch] $Force

     )

    Process

    {

        if ($LogDetails.AutoBackup -and !$LogDetails.Retention)

        {

            throw (New-Object System.InvalidOperationException)

        }

        $enabled = $LogDetails.Enabled.ToString()

        $retention = $LogDetails.Retention.ToString()

        $autobackup = $LogDetails.AutoBackup.ToString()

        $maxLogSize = $LogDetails.MaxLogSize.ToString()

        $osVersion = [Version] (Get-CimInstance Win32_OperatingSystem).Version

        if (($LogDetails.Type -eq "Analytic") -or ($LogDetails.Type -eq "Debug"))

        {

            if ($LogDetails.Enabled)

            {

                if($osVersion -lt 6.3.7600)

                {

                    & $script:wevtutil $script:slparam $LogDetails.Name -e:$Enabled

                }

                else

                {

                    & $script:wevtutil /q:$Force $script:slparam $LogDetails.Name -e:$Enabled

                }

            }

            else

            {

                if($osVersion -lt 6.3.7600)

                {

                    & $script:wevtutil $script:slparam $LogDetails.Name -e:$Enabled -rt:$Retention -ms:$MaxLogSize

                }

                else

                {

                    & $script:wevtutil /q:$Force $script:slparam $LogDetails.Name -e:$Enabled -rt:$Retention -ms:$MaxLogSize

                }

            }

        }

        else

        {

            if($osVersion -lt 6.3.7600)

            {

                & $script:wevtutil $script:slparam $LogDetails.Name -e:$Enabled -rt:$Retention -ab:$AutoBackup -ms:$MaxLogSize

            }

            else

            {

                & $script:wevtutil /q:$Force $script:slparam $LogDetails.Name -e:$Enabled -rt:$Retention -ab:$AutoBackup -ms:$MaxLogSize

            }

        }

    }

}

function ConvertTo-Bool([string]$value)

{

    if ($value -ieq "true")

    {

        return $true

    }

    else

    {

        return $false

    }

}

function Get-LogProperties

{

    param(

        [Parameter(Mandatory=$true, ValueFromPipeline=$true, Position=0)] $Name

    )

    Process

    {

        $details = & $script:wevtutil $script:glparam $Name

        $indexes = @(1,2,8,9,10)

        $value = @()

        foreach($index in $indexes)

        {

            $value += @(($details[$index].SubString($details[$index].IndexOf(":")+1)).Trim())

        }

        $enabled = ConvertTo-Bool $value[0]

        $retention = ConvertTo-Bool $value[2]

        $autobackup = ConvertTo-Bool $value[3]

        New-Object Microsoft.PowerShell.Diagnostics.LogDetails $Name, $enabled, $value[1], $retention, $autobackup, $value[4]

    }

}

function Enable-PSTrace

{

    param(

        [switch] $Force,

        [switch] $AnalyticOnly

     )

    $Properties = Get-LogProperties ($script:psprovidername + $script:analyticlog)

    if (!$Properties.Enabled) {

        $Properties.Enabled = $true

        if ($Force) {

            Set-LogProperties $Properties -Force

        } else {

            Set-LogProperties $Properties

        }

    }

    if (!$AnalyticOnly) {

        $Properties = Get-LogProperties ($script:psprovidername + $script:debuglog)

        if (!$Properties.Enabled) {

            $Properties.Enabled = $true

            if ($Force) {

                Set-LogProperties $Properties -Force

            } else {

                Set-LogProperties $Properties

            }

        }

    }

}

function Disable-PSTrace

{

    param(

        [switch] $AnalyticOnly

     )

    $Properties = Get-LogProperties ($script:psprovidername + $script:analyticlog)

    if ($Properties.Enabled) {

        $Properties.Enabled = $false

        Set-LogProperties $Properties

    }

    if (!$AnalyticOnly) {

        $Properties = Get-LogProperties ($script:psprovidername + $script:debuglog)

        if ($Properties.Enabled) {

            $Properties.Enabled = $false

            Set-LogProperties $Properties

        }

    }

}

Add-Type @"

using System;

namespace Microsoft.PowerShell.Diagnostics

{

    public class LogDetails

    {

        public string Name

        {

            get

            {

                return name;

            }

        }

        private string name;

        public bool Enabled

        {

            get

            {

                return enabled;

            }

            set

            {

                enabled = value;

            }

        }

        private bool enabled;

        public string Type

        {

            get

            {

                return type;

            }

        }

        private string type;

        public bool Retention

        {

            get

            {

                return retention;

            }

            set

            {

                retention = value;

            }

        }

        private bool retention;

        public bool AutoBackup

        {

            get

            {

                return autoBackup;

            }

            set

            {

                autoBackup = value;

            }

        }

        private bool autoBackup;

        public int MaxLogSize

        {

            get

            {

                return maxLogSize;

            }

            set

            {

                maxLogSize = value;

            }

        }

        private int maxLogSize;

        public LogDetails(string name, bool enabled, string type, bool retention, bool autoBackup, int maxLogSize)

        {

            this.name = name;

            this.enabled = enabled;

            this.type = type;

            this.retention = retention;

            this.autoBackup = autoBackup;

            this.maxLogSize = maxLogSize;

        }

    }

}

"@

if (Get-Command logman.exe -Type Application -ErrorAction SilentlyContinue)

{

    Export-ModuleMember Disable-PSTrace, Disable-PSWSManCombinedTrace, Disable-WSManTrace, Enable-PSTrace, Enable-PSWSManCombinedTrace, Enable-WSManTrace, Get-LogProperties, Set-LogProperties, Start-Trace, Stop-Trace

}

else

{

    # Currently we only support these cmdlets as logman.exe is not available on systems like Nano and IoT

    Export-ModuleMember Disable-PSTrace, Enable-PSTrace, Get-LogProperties, Set-LogProperties

}

# SIG # Begin signature block

# MIIoCgYJKoZIhvcNAQcCoIIn+zCCJ/cCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBzuFp8c8UN6ilP

# /hSmUPDtAUbo8uWTs6wUbaR/ZpM1B6CCDXYwggX0MIID3KADAgECAhMzAAAEBGx0

# Bv9XKydyAAAAAAQEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTE0WhcNMjUwOTExMjAxMTE0WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQC0KDfaY50MDqsEGdlIzDHBd6CqIMRQWW9Af1LHDDTuFjfDsvna0nEuDSYJmNyz

# NB10jpbg0lhvkT1AzfX2TLITSXwS8D+mBzGCWMM/wTpciWBV/pbjSazbzoKvRrNo

# DV/u9omOM2Eawyo5JJJdNkM2d8qzkQ0bRuRd4HarmGunSouyb9NY7egWN5E5lUc3

# a2AROzAdHdYpObpCOdeAY2P5XqtJkk79aROpzw16wCjdSn8qMzCBzR7rvH2WVkvF

# HLIxZQET1yhPb6lRmpgBQNnzidHV2Ocxjc8wNiIDzgbDkmlx54QPfw7RwQi8p1fy

# 4byhBrTjv568x8NGv3gwb0RbAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU8huhNbETDU+ZWllL4DNMPCijEU4w

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMjkyMzAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAIjmD9IpQVvfB1QehvpC

# Ge7QeTQkKQ7j3bmDMjwSqFL4ri6ae9IFTdpywn5smmtSIyKYDn3/nHtaEn0X1NBj

# L5oP0BjAy1sqxD+uy35B+V8wv5GrxhMDJP8l2QjLtH/UglSTIhLqyt8bUAqVfyfp

# h4COMRvwwjTvChtCnUXXACuCXYHWalOoc0OU2oGN+mPJIJJxaNQc1sjBsMbGIWv3

# cmgSHkCEmrMv7yaidpePt6V+yPMik+eXw3IfZ5eNOiNgL1rZzgSJfTnvUqiaEQ0X

# dG1HbkDv9fv6CTq6m4Ty3IzLiwGSXYxRIXTxT4TYs5VxHy2uFjFXWVSL0J2ARTYL

# E4Oyl1wXDF1PX4bxg1yDMfKPHcE1Ijic5lx1KdK1SkaEJdto4hd++05J9Bf9TAmi

# u6EK6C9Oe5vRadroJCK26uCUI4zIjL/qG7mswW+qT0CW0gnR9JHkXCWNbo8ccMk1

# sJatmRoSAifbgzaYbUz8+lv+IXy5GFuAmLnNbGjacB3IMGpa+lbFgih57/fIhamq

# 5VhxgaEmn/UjWyr+cPiAFWuTVIpfsOjbEAww75wURNM1Imp9NJKye1O24EspEHmb

# DmqCUcq7NqkOKIG4PVm3hDDED/WQpzJDkvu4FrIbvyTGVU01vKsg4UfcdiZ0fQ+/

# V0hf8yrtq9CkB8iIuk5bBxuPMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGeowghnmAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB

# BQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIE

# IEgd441WP1jGfFhxRg3sMtiUC5JDLIMXuzkPYRsZdTzgMEIGCisGAQQBgjcCAQwx

# NDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20wDQYJKoZIhvcNAQEBBQAEggEAsrRnEtAtCpUIr8i13MRxt5laRhGZJb5Y

# Dlext32mHOjXLyg34tMtnVXxYNn3pwLWVKnCihGnvECGEgtu8gsVrt6BCMQqs//c

# S9cmE8iwFJU7jaeOJwRZMqWY9aUsgGDBDagLdn1AFJvZVwqf7TDkWAMumK3Kb07y

# IOG+3fyttH8uA73vcXYZqEWNtjTFtsMyh0f4G9I4QfOaqLlVUdIlukuEF5XjfrhH

# Gzt+4ZQFPPDK6J2wpk4Jc2h3t8rXuFl3rhObgcvNYij1Xgnit+EHzP69HEXgpZfx

# psBZwG2+juDUKzKj2vAUIeorp4qR26eV4oBT5nh6fgox9h7M4svesaGCF5IwgheO

# BgorBgEEAYI3AwMBMYIXfjCCF3oGCSqGSIb3DQEHAqCCF2swghdnAgEDMQ8wDQYJ

# YIZIAWUDBAIBBQAwggFQBgsqhkiG9w0BCRABBKCCAT8EggE7MIIBNwIBAQYKKwYB

# BAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCAzJgPBQnoK1SANxZxWu2KBfo50ktoZ

# uNQWAv439AxPmAIGZ/f5bs8NGBEyMDI1MDQyMjIwMDQzOS42WjAEgAIB9KCB0aSB

# zjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UE

# CxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOkRDMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNloIIR6jCCByAwggUIoAMCAQICEzMAAAIDux5cADhsdMoA

# AQAAAgMwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTAwHhcNMjUwMTMwMTk0MjQ2WhcNMjYwNDIyMTk0MjQ2WjCByzELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFt

# ZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkRDMDAt

# MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl

# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAoZdDB+cAJzsfFIfEbYnR

# dCdMmhQxyWB06T70Udel9SsRg2H0/D63BowiwomjrtytQ5lCFOEXOaJZ3Y2qaTbj

# oM8FKI+N1W2yceTxU2P2tWfNLaalT9DqCiZVJHwz0gSxYF1o+lYGskQiDbS7FGrM

# tMOYMrA+yCz2bokI2nHuSsQEoyn9jFV9anxM2AW0xjRIo0kAisMMnNHmr6+BaN1/

# /rArrgLZE1orLFOuJPKyutI7BkQKYhEnX7h69MlgJnO40zjzXhgMeigi9pLaZxno

# Cw3dSJROgbugUsACBR6+8zsCJRaskLgntEkACwmyYbE/cvYsutUSQF7FNLtEwuWG

# Jk0mxCO4NdHWMfFI/r4fSJy6CmAuQ6Sm99dW2FXdG8rW85X00bJUUyYKLZ3wgCBj

# C6hKpPf9lURrvZJSYtY/Z1X6smB2KzDzgV3K0GFtI5ijYzi+OwmhAKzc4QwYmtcF

# 3SQDSqjLyfKUHtpvP3Im8gzPtQVWarjQKL/TeLSReAArY19I41zQ1DLUmaFRUB/h

# ZFnXz1sdbgSJHPe0fsUS7j41MqR2eQNwAC0pHuE2kQb270wWMlth3pzk+52Cykzu

# I8OUKunMN2fc0ykj0Og+ZcomKXrOUUdjHTLyUuHwnDyRXmlTr7lhUkPxBrVQUoYZ

# iwfuXsMxc3aX9VLiZrjkE08CAwEAAaOCAUkwggFFMB0GA1UdDgQWBBSyKVlAfhHn

# kNvbFntFXc8VkBiSfTAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBf

# BgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz

# L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmww

# bAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF

# BwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAkBDG3rA+kwtP

# EdKGAnUguOdgEKxn/zvPRkOeArYBLG8c8Bg1VHJo1xXJ2iUkzXnQSlV5AYGsEaJz

# 9S4MR+G881Y9nljZsxiMDtRZYZXQDzhwMywRB0aEmeKXXRbWkMaGm1Pzdb1siAoj

# etCLfOYJxeSQ+DDF8neqUvHgAyIuk7Y34Cj6LplmtARUP2hM41K3zzda+3KyvqpJ

# i87cPxDUu83pn8seJBkYMGNVgXxapv5xZSQz0AYnKnlN3TqfYY+1qg9EXPv+FWes

# EI3rCMgpL+boVDcti4TQ4tpXmLQIiBaZo3zZOBp4C7wtk4/SKzjL9tEq8puSfxYe

# 8lgIj3hrN8gN0GqY2U7X6+zX86QSCUOMU/4nOFhlqoRpUZVQSObujo8N2cUmQi4N

# 70QuCmMqZIfBXSFqCoq44nRBpV7DTqPlD/2BuSoXm4rnUwcRnnHyQrrlLKSHUYUr

# RwELI7/3QKlgS5YaK6tjgmj/sBYRN1j4J58eaX5b5bo6HD4LDduPvnXR65dztRRW

# m1vJtFJAx0igofEE8E5GDsLvfYhMQVVpW2GUc9qjiAYy/6MxIbQgdGrioX0yy3rj

# RgVGgc/qGWfl/VABAqDIZBE42+mHzWiNU+71QGoroQaFfyQjkE/kWGa4MpMj6c6Z

# sDDRQQ9b3Vv9vavZ5E1qBIXBDjtC/TcwggdxMIIFWaADAgECAhMzAAAAFcXna54C

# m0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp

# Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMy

# MjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV

# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0B

# AQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51

# yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY

# 6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9

# cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN

# 7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDua

# Rr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74

# kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2

# K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5

# TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZk

# i1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q

# BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3Pmri

# Lq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUC

# BBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJl

# pxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9y

# eS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUA

# YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw

# MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w

# Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/yp

# b+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulm

# ZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM

# 9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECW

# OKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4

# FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3Uw

# xTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPX

# fx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVX

# VAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGC

# onsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU

# 5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG

# ahC0HVUzWLOhcGbyoYIDTTCCAjUCAQEwgfmhgdGkgc4wgcsxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVy

# aWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjpEQzAwLTA1

# RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIj

# CgEBMAcGBSsOAwIaAxUAza8UV/4s+rLNZQQlxvD9SxcQ9HuggYMwgYCkfjB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAOuySO4w

# IhgPMjAyNTA0MjIxNjU3MThaGA8yMDI1MDQyMzE2NTcxOFowdDA6BgorBgEEAYRZ

# CgQBMSwwKjAKAgUA67JI7gIBADAHAgEAAgJBCjAHAgEAAgITMzAKAgUA67OabgIB

# ADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQow

# CAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQBFKKTbWpPrZ2nvMezeD5D3m0OG

# vJ9AwfYq9MhHA7pfpMf6Y7Fhykp96gdajwj2HZbHkj6y5nqgmoR/BtXOak5w2YPS

# JshJQOLe14hFdNSKeyn8hvFSk27TeiWv+iOKzgsZlZR9BYGkxfGKZEVJnk8d+xVq

# NxmXNHfpCt8nDDG9maEHgyradUwWFVehlZ9cQGYF9/dkVKtObfNBYkU5SqJOo8x0

# ENuMO7sZmEa5MZO7xOkZaPZBoLeaP5MrxT31bFP5sVBZw/5gB/5gegwfB/5P2qXZ

# AWQUvfPvbsLy5cPqorThSqwQQA0VMjTBmhgF41y85gZVamJQGTgum4RWcB5jMYIE

# DTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAID

# ux5cADhsdMoAAQAAAgMwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzEN

# BgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgcbsGLWMHvgMWKZiZv09/wwA2

# tro1MG6YaqTw+M6gv9YwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCBLA90b

# cZb2k8RTmWZ6UMNA5LD5lXbqOUsivYfcPvoTLTCBmDCBgKR+MHwxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACA7seXAA4bHTKAAEAAAIDMCIEIGAJv7WZ

# oHYZ8zuL1PDZ7XFhos4+SxhoJKeU+luDy7cfMA0GCSqGSIb3DQEBCwUABIICAGiy

# VydYqU7/GJfOySKY38RNgbC2kfRnB669+mXpCIZvHyDAuk+ch/ITIW1RoQQtD8co

# aGIICB5m1EY9ef1pkcGwwu6K5n2NLBamttxvN72MLRrY6fJcUK3LXiGwzPFeZ0VG

# sfWOGUT2lZBXo+SP9yBbT42bC1AvE4q8AwvCEpWiY0W3uiwQ8fcvO+OfV8V65cO8

# FuxapNOSkjVJGYVnxkeVKfmr1bJE1DNGZfVqQY934JlrmdsyA//DwUgGVXlY4VPy

# gohgYvB2tmimr6i/dnysyPxdplfXi7aL15Ou5z1+UFkW22HKJqpQYezj8HOCtNJ7

# pEwCSH66sFICUDP1JkSp0SoMsD4C6OTcu4GU2Vzg2uemz0OTs+92UZmHDXaJJ1zS

# sQeaTza/pr0HMsRfq3oNyb75ar4C8E674Sw5YRUIvirom4bTXQBlzdaUXiHcH6uN

# XHueFjAKjNtDsTnhrwefixNrEC+4FzypwEvCu0uvYh99B7SYVo+7tbcIin5Ml1ad

# PWlIOnKzL/d5iI5duRopDzFEBDeyTBBS1UPsZvnMxcn+IxpfUmZnxxTYUUDfsRws

# HCmMpgUVniM4+M5eUba4z3AetQYXPUT6OSdnZDzDnZKv/glNAN8fU3bNYkpA/U+p

# vHfaXpgkzVXDlavaR8GDRjmPWVlz+0kkhsmemMbm

# SIG # End signature block