AzStackHci.EnvironmentChecker

10.2509.0.2010

AzStackHciValidatedRecipe/AzStackHci.ValidatedRecipe.Helpers.psm1

                                Import-LocalizedData -BindingVariable lswTxt -FileName AzStackHci.ValidatedRecipe.Strings.psd1

function TestResult {

    <#

    .SYNOPSIS

        Build up a params data structure to pass the

        New-AzStackHciResultObject function.

    .DESCRIPTION

        The New-AzStackHciResultObject function get information about the

        result of a test into the correct result files (log, json, etc.)

    #>

    Param([Parameter(Mandatory=$true,Position=0)] [array]$responses,

          [Parameter(Mandatory=$true,Position=1)] [string]$Name,

          [Parameter(Mandatory=$true,Position=2)] [string]$Title,

          [Parameter(Mandatory=$true,Position=3)] [string]$DisplayName,

          [Parameter(Mandatory=$true,Position=4)] [string]$Severity,

          [Parameter(Mandatory=$true,Position=5)] [string]$Description,

          [Parameter(Mandatory=$false,Position=6)] [string]$Remediation = 'https://learn.microsoft.com/en-us/azure/azure-local/update/update-troubleshooting-23h2',

          [Parameter(Mandatory=$false,Position=7)] [string]$TargetResourceType = 'ValidatedRecipe',

          [Parameter(Mandatory=$false,Position=8)] [string]$Resource = 'Validated Assembly Recipe')

    $instanceResults = @()

    foreach ($response in $responses) {

        $detailString = $($response.details) -join ';  '

        foreach ($msg in $($response.logLines)) {

            $msgArray = $msg.split('|')

            Log-Info $msgArray[0] -Type $msgArray[1]

        }

        try {

            $Status = 'SUCCESS'

            if ($($response.rc)) {

                $Status = 'FAILURE'

            }

            $params = @{

                Name               = $Name

                Title              = $Title

                DisplayName        = $DisplayName

                Severity           = $Severity

                Description        = $Description

                Tags               = @{}

                Remediation        = $Remediation

                TargetResourceID   = $($response.computername)

                TargetResourceName = $($response.computername)

                TargetResourceType = $TargetResourceType

                Timestamp          = [datetime]::UtcNow

                Status             = $status

                HealthCheckSource  = $ENV:EnvChkrId

                AdditionalData     = @{Source    = $($response.computername)

                                       Resource  = $Resource

                                       Detail    = $detailString

                                       Status    = $status

                                       TimeStamp = [datetime]::UtcNow}}

            $instanceResults += New-AzStackHciResultObject @params

        }

        catch {

            throw $_

        }

    }

    return $instanceResults

}

function Test-PSModules

{

    <#

    .SYNOPSIS

        Test version of PS Modules installed is correct

    .DESCRIPTION

        Get installed PS module from local machine and validated its expected as per the current recipe.

        Expecting data from PsSessions to include local machine indicating ECE.

    #>

    [CmdletBinding()]

    param (

        [Parameter()]

        [System.Management.Automation.Runspaces.PSSession[]]

        $PsSession

    )

    $sb = {

        Param($lswTxt, $resultSeverity)

        $rc = 0

        $localHost = $ENV:ComputerName

        $detailList = New-Object System.Collections.Generic.List[System.Object]

        $logLines = New-Object System.Collections.Generic.List[System.Object]

        $vcNugetPath = Get-ASArtifactPath -NugetName "Microsoft.AzureStack.VersionControl.Operations"

        Import-Module "$vcNugetPath\content\Scripts\VersionControlHelpers.psm1" -Force -DisableNameChecking -Verbose:$false | Out-Null

        $InstalledModules = Get-InstalledPowerShellModules

        foreach ($mod in $InstalledModules) {

            # Get-InstalledPowerShellModules will return 0.0.0 if a required module is not installed

            # it is OK if the module is not yet installed because we are looking to update/install the modules

            # this is true especially if they are not currently installed or they have an older version installed.

            # however, if the customer has a newer version installed we do not want to downgrade the version

            # just because the recipe calls for an older version.

            try {

                $InstalledVersionObj = [Version]::Parse($mod.InstalledVersion)

            }

            catch {

                $InstalledVersionObj = $null

                $mod.InstalledVersion = "N/A"

            }

            try {

                $RequiredVersionObj = [Version]::Parse($mod.RequiredVersion)

            }

            catch {

                $RequiredVersionObj = $null

                $mod.RequiredVersion = "N/A"

            }

            if (-not $InstalledVersionObj -and -not $RequiredVersionObj) {

                $rc += 1

                $res = ${resultSeverity}

                $msg = $lswTxt.PSModulesFailedToParseBothVersions -f $mod.Name, $localHost, $mod.InstalledVersion, $mod.RequiredVersion

                $dtl = $msg

            } elseif (-not $InstalledVersionObj) {

                $rc += 1

                $res = ${resultSeverity}

                $msg = $lswTxt.PSModulesFailedToParseInstalledVersion -f $mod.Name, $localHost, $mod.InstalledVersion

                $dtl = $msg

            } elseif (-not $RequiredVersionObj) {

                $rc += 1

                $res = ${resultSeverity}

                $msg = $lswTxt.PSModulesFailedToParseRequiredVersion -f $mod.Name, $localHost, $mod.RequiredVersion

                $dtl = $msg

            } elseif ($InstalledVersionObj -le $RequiredVersionObj) {

                $res = 'SUCCESS'

                $msg = $lswTxt.PSModulesSuccess -f $mod.Name, $localHost, $mod.InstalledVersion, $mod.RequiredVersion

                $dtl = $lswTxt.PSModulesDetailSuccess -f $mod.Name, $mod.InstalledVersion

            } else {

                $rc += 1

                $res = ${resultSeverity}

                $msg = $lswTxt.PSModulesFailure -f $mod.Name, $localHost, $mod.InstalledVersion, $mod.RequiredVersion

                $dtl = $msg

            }

            $detailList.Add($dtl)

            $logLines.Add("${msg}|${res}")

        }

        $response = "" | Select-Object -Property rc, details, computername, logLines

        $response.rc = $rc

        $response.details = $detailList

        $response.computername = $localHost

        $response.logLines = $logLines

        return $response

    } #endSB

    $resultSeverity = "CRITICAL"

    $responses = if ($psSession) {

        Invoke-Command -Session $PsSession -ScriptBlock $sb -ArgumentList (,$lswTxt, $resultSeverity)

    } else {

        Invoke-Command -ScriptBlock $sb -ArgumentList (,$lswTxt, $resultSeverity)

    }

    $splat = @{responses   = $responses

        Name        = "AzStackHci_ValidatedRecipe_PowerShellModule_Version"

        Title       = "Test PowerShell Module Version"

        DisplayName = "Test PowerShell Module Version"

        Severity    = $resultSeverity

        Description = "Validating that the PS modules installed on the host are the same versions defined in the validated recipe."}

    return (TestResult @splat)

}

function Test-AzCli

{

    <#

    .SYNOPSIS

        Validate that the installed version of Azure.CLI matched the required one

    .DESCRIPTION

        Get installed version using 'az version' and compare it to the required version defined by the VersionControl module

    #>

    [CmdletBinding()]

    param (

        [Parameter()]

        [System.Management.Automation.Runspaces.PSSession[]]

        $PsSession

    )

    $sb = {

        Param($lswTxt, $resultSeverity)

        $rc = 0

        $localHost = $ENV:ComputerName

        $detailList = New-Object System.Collections.Generic.List[System.Object]

        $logLines = New-Object System.Collections.Generic.List[System.Object]

        $vcNugetPath = Get-ASArtifactPath -NugetName "Microsoft.AzureStack.VersionControl.Operations"

        Import-Module "$vcNugetPath\content\Scripts\VersionControlHelpers.psm1" -Force -DisableNameChecking -Verbose:$false | Out-Null

        $name = 'AzCli'

        try {

            $installedVersion = (az version -o json |ConvertFrom-Json).'azure-cli'

        }

        catch {

            $installedVersion = "N/A"

        }

        try {

            $requiredVersion = (Get-ValidatedRecipe -TypesToInclude 'AzCli' -TagsToInclude 'Azure').RequiredVersion

        }

        catch {

            $requiredVersion = "N/A"

        }

        try {

            $InstalledVersionObj = [Version]::Parse($installedVersion)

        }

        catch {

            $InstalledVersionObj = $null

            $installedVersion = "N/A"

        }

        try {

            $RequiredVersionObj = [Version]::Parse($requiredVersion)

        }

        catch {

            $RequiredVersionObj = $null

            $requiredVersion = "N/A"

        }

        if (-not $InstalledVersionObj -and -not $RequiredVersionObj) {

            $rc += 1

            $res = ${resultSeverity}

            $msg = $lswTxt.AzCliFailedToParseBothVersions -f $name, $localHost, $installedVersion, $requiredVersion

            $dtl = $msg

        } elseif (-not $InstalledVersionObj) {

            $rc += 1

            $res = ${resultSeverity}

            $msg = $lswTxt.AzCliFailedToParseInstalledVersion -f $name, $localHost, $requiredVersion, $installedVersion

            $dtl = $msg

        } elseif (-not $RequiredVersionObj) {

            $rc += 1

            $res = ${resultSeverity}

            $msg = $lswTxt.AzCliFailedToParseRequiredVersion -f $name, $localHost, $requiredVersion

            $dtl = $msg

        } elseif ($InstalledVersionObj -eq $RequiredVersionObj) {

            $res = 'SUCCESS'

            $msg = $lswTxt.AzCliSuccess -f $name, $localHost, $installedVersion, $requiredVersion

            $dtl = $msg

        } else {

            $rc += 1

            $res = ${resultSeverity}

            $msg = $lswTxt.AzCliFailure -f $name, $localHost, $installedVersion, $requiredVersion

            $dtl = ''

            $dtl += $msg

            $dtl += " The Az-Cli version installed conflicts with updates; "

            $dtl += "Find the [Azure-Cli] msi file path in the C:/NugetStore and run: "

            $dtl += "(Start-Process msiexec.exe -Wait -ArgumentList (/I [fullPathToAzureCliMsiFile] /quiet))"

        }

        $detailList.Add($dtl)

        $logLines.Add("${msg}|${res}")

        $response = "" | Select-Object -Property rc, details, computername, logLines

        $response.rc = $rc

        $response.details = $detailList

        $response.computername = $localHost

        $response.logLines = $logLines

        return $response

    } #endSB

    $resultSeverity = "CRITICAL"

    $responses = if ($psSession) {

        Invoke-Command -Session $PsSession -ScriptBlock $sb -ArgumentList (,$lswTxt, $resultSeverity)

    } else {

        Invoke-Command -ScriptBlock $sb -ArgumentList (,$lswTxt, $resultSeverity)

    }

    $splat = @{responses   = $responses

        Name        = "AzStackHci_ValidatedRecipe_AzureCli_Version"

        Title       = "Test Azure-Cli Module Version"

        DisplayName = "Test Azure-Cli Module Version"

        Severity    = $resultSeverity

        Description = "Validating that the installed version of Az.Cli is the required version."}

    return (TestResult @splat)

}

Export-ModuleMember -Function Test-*

# SIG # Begin signature block

# MIIoUgYJKoZIhvcNAQcCoIIoQzCCKD8CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCD7eVJJvWDpwThN

# x6E53z1Cfrd7GaVJwLC1Gf061fsDKqCCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz

# aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj

# MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5

# KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh

# ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S

# LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i

# 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL

# m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB

# UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc

# Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh

# ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+

# bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj

# 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc

# fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy

# XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1

# fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGiMwghofAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIK8n

# ZPSnS/grN75sbrv9H65yeb0OS2onNpcK4OY0fmnOMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAFvRr2+0LZznNAR2urixaiN7PcmN/PIYm4LAy

# 2R2lg48w3y5HAzBHjV+5+iC6o19+MoldVocnYNhzuFoAzBnnbk2h4C/m9Vfk2Rl8

# kXetaf6L8bKFCrE6JsNzh7UKw0H21Yld5xD+1HTm1nKoaytGB92ZdpA1XObWhyBK

# 03kEyiuJPnn0xAFiS1asD5UkTSEAd6h10Eq9zxWnA8w9BcenTSwcdAFeTZkQoEE1

# dJiO/fRogBO414byrNlE+yWi98xYXHpi55krzz6utWNXTaW9QdiTCMqWOxDu+TIY

# i7TSyrP3fNU5lZIJP2NacsF/JQ1OzvvGq2bR3Pd20dmUzdevraGCF60wghepBgor

# BgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4YwgheCAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCBCBZFfMkGmjKizCZDfo1NWy8df9n1QJwJK

# CvJy7oCIBwIGaKOvRqqRGBMyMDI1MDkwOTE5MjIwNS44MjlaMASAAgH0oIHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjo0MDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIFEKADAgECAhMzAAAB/tCo

# wns0IQsBAAEAAAH+MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMB4XDTI0MDcyNTE4MzExOFoXDTI1MTAyMjE4MzExOFowgdMxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv

# c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOjQwMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# vLwhFxWlqA43olsE4PCegZ4mSfsH2YTSKEYv8Gn3362Bmaycdf5T3tQxpP3NWm62

# YHUieIQXw+0u4qlay4AN3IonI+47Npi9fo52xdAXMX0pGrc0eqW8RWN3bfzXPKv0

# 7O18i2HjDyLuywYyKA9FmWbePjahf9Mwd8QgygkPtwDrVQGLyOkyM3VTiHKqhGu9

# BCGVRdHW9lmPMrrUlPWiYV9LVCB5VYd+AEUtdfqAdqlzVxA53EgxSqhp6JbfEKnT

# dcfP6T8Mir0HrwTTtV2h2yDBtjXbQIaqycKOb633GfRkn216LODBg37P/xwhodXT

# 81ZC2aHN7exEDmmbiWssjGvFJkli2g6dt01eShOiGmhbonr0qXXcBeqNb6QoF8jX

# /uDVtY9pvL4j8aEWS49hKUH0mzsCucIrwUS+x8MuT0uf7VXCFNFbiCUNRTofxJ3B

# 454eGJhL0fwUTRbgyCbpLgKMKDiCRub65DhaeDvUAAJT93KSCoeFCoklPavbgQya

# hGZDL/vWAVjX5b8Jzhly9gGCdK/qi6i+cxZ0S8x6B2yjPbZfdBVfH/NBp/1Ln7xb

# eOETAOn7OT9D3UGt0q+KiWgY42HnLjyhl1bAu5HfgryAO3DCaIdV2tjvkJay2qOn

# F7Dgj8a60KQT9QgfJfwXnr3ZKibYMjaUbCNIDnxz2ykCAwEAAaOCAUkwggFFMB0G

# A1UdDgQWBBRvznuJ9SU2g5l/5/b+5CBibbHF3TAfBgNVHSMEGDAWgBSfpxVdAF5i

# XYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jv

# c29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB

# JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRp

# bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1Ud

# JQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsF

# AAOCAgEAiT4NUvO2lw+0dDMtsBuxmX2o3lVQqnQkuITAGIGCgI+sl7ZqZOTDd8Lq

# xsH4GWCPTztc3tr8AgBvsYIzWjFwioCjCQODq1oBMWNzEsKzckHxAzYo5Sze7OPk

# MA3DAxVq4SSR8y+TRC2GcOd0JReZ1lPlhlPl9XI+z8OgtOPmQnLLiP9qzpTHwFze

# +sbqSn8cekduMZdLyHJk3Niw3AnglU/WTzGsQAdch9SVV4LHifUnmwTf0i07iKtT

# lNkq3bx1iyWg7N7jGZABRWT2mX+YAVHlK27t9n+WtYbn6cOJNX6LsH8xPVBRYAIR

# VkWsMyEAdoP9dqfaZzwXGmjuVQ931NhzHjjG+Efw118DXjk3Vq3qUI1re34zMMTR

# zZZEw82FupF3viXNR3DVOlS9JH4x5emfINa1uuSac6F4CeJCD1GakfS7D5ayNsaZ

# 2e+sBUh62KVTlhEsQRHZRwCTxbix1Y4iJw+PDNLc0Hf19qX2XiX0u2SM9CWTTjsz

# 9SvCjIKSxCZFCNv/zpKIlsHx7hQNQHSMbKh0/wwn86uiIALEjazUszE0+X6rcObD

# fU4h/O/0vmbF3BMR+45rAZMAETJsRDPxHJCo/5XGhWdg/LoJ5XWBrODL44YNrN7F

# RnHEAAr06sflqZ8eeV3FuDKdP5h19WUnGWwO1H/ZjUzOoVGiV3gwggdxMIIFWaAD

# AgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv

# ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIy

# MjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5

# vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64

# NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhu

# je3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl

# 3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPg

# yY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I

# 5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2

# ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/

# TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy

# 16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y

# 1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H

# XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMB

# AAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQW

# BBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30B

# ATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz

# L0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYB

# BAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNS

# b29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq

# reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27

# DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pv

# vinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9Ak

# vUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWK

# NsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2

# kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+

# c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep

# 8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+Dvk

# txW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1Zyvg

# DbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/

# 2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCCAj4CAQEwggEBoYHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjo0MDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAhGNHD/a7Q0bQ

# LWVG9JuGxgLRXseggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDANBgkqhkiG9w0BAQsFAAIFAOxqhAAwIhgPMjAyNTA5MDkxMDQ2MjRaGA8yMDI1

# MDkxMDEwNDYyNFowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA7GqEAAIBADAHAgEA

# AgIMATAHAgEAAgITSTAKAgUA7GvVgAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgor

# BgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUA

# A4IBAQBVmJ71+7A7/RWmbFjCpKULvkNsnVWVjxUZQVFeIbGeNQat2C4fPWnhDP4O

# SZskx2nTqIrZJvgCd/tp/qewf7X76CBVbC/VSKrON6S5v+Oh143Ds5S0b0/o+Xxb

# Be+Kvw6jLIrK8XyIb8cISL6v8YUeQH9o7GEzZ6Kb/7MDBj9o8mhs4+iPUGkiitc8

# m7p5maRje3gaQ/v3E8y0D9LJDZ5jvDwrVoYEOk8JiiWt2XgZ/oKSJcXGAzz4ny9/

# rla+qqJQSmWTyksRwcveIhE4RuWO5svHlcdKtY0HqGmr+vwe6l5O7fyZ/MeBsfUj

# eHAPqaDLm5M1K/lgmu6POb81MLZQMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTACEzMAAAH+0KjCezQhCwEAAQAAAf4wDQYJYIZIAWUD

# BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B

# CQQxIgQgjyDebdEZYP3yytZx+YQqRcg34o1cKBwVX2jXsbfK3cMwgfoGCyqGSIb3

# DQEJEAIvMYHqMIHnMIHkMIG9BCARhczd/FPInxjR92m2hPWqc+vGOG1+/I0WtkCs

# tyh0eTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB

# /tCowns0IQsBAAEAAAH+MCIEIPsPO+ZK0HwLDivXZBelP0KwEMDoccONRhO4bxHD

# mMYFMA0GCSqGSIb3DQEBCwUABIICAHvfbYNPIIwYDUFeZgRIozdS+iAcKke1yv4P

# 66Y3TEGumkc/VZyTrbLnH8Qwj7gWAbISENJr9hPGNNVSGbMxgKFtmkdcMZbS08x5

# CGPGrbftuVQUnq2Up5wMWtfpmmdo6J4YOzFjrXxKQsKO6YVJGJLI/stIV3n5zKiK

# HC4m2w5RpgT/Q5unECnhQiiNtubOnIXYCaeBkTr2qrvgPkiPMN3r2GgDS6iNbBlN

# RnOafCsHR0QBBc/neEscDcINA0WYyIFJPMfqioxevYw2ekvgzcjKr4KyGNIPvnv3

# g0q3uysWkddWMfiRA1j6p/Ujs3I7UUqmIdqorluSZrBT+kBoPs1naGd8ekYXwY59

# 9G2H5Bri5uurqYE2tTavcZvDVroHVBFTBdlg7bcBKLOtQjzXzGuyEfripg5anl37

# TUXUWKs6Pi8HqPm4GZz5deTFCgJwPhvbYEX1eReBbUASF5cSUKXDFufCwmKIzRlu

# 81AGwEvq7P+L5CDwpwox5m5CjgpAS9H8uib5FD2dGhQCW8cYO7cWzvdfzoSEN+1x

# mSXXhPpPwaVaChpSxp5W91YRgsa6ewkWnUZYLy8qnfkBYZVkJwpQh5BXSfwaJovu

# MwVg5CBnG5YHQ8S/hs6A9oc8Qpx8uaz2SND2zr0ErFcFwD0VJlRBBxlNuiZPp3Ud

# iHPQgAe1

# SIG # End signature block