DosInstallUtilities

1.1.2

functions/Install-RequiredModule.ps1

                                <#

    .SYNOPSIS

    Imports/Installs a module required to run this module/function

    .DESCRIPTION

    Attempts to load a local module first - if the module isn't available it will attempt to download/install from PSGallery.

    .PARAMETER ModuleName

    Name of the module to install

    .PARAMETER Scope

    Scope used to install the module - default is CurrentUser

    .EXAMPLE

    Install-RequiredModule -ModuleName dbatools

#>

function Install-RequiredModule{

    [CmdletBinding()]

    param(

        [Parameter(Mandatory=$true)]

        [ValidateNotNullorEmpty()]

        [string] $ModuleName,

        [string] $Scope = "CurrentUser",

        [version] $RequiredVersion

    )

    Write-DosTelemetry -Message "Install-RequiredModule start"

    # Adding PSModule path becuse in some cases the path to user directory was not in the module system path 

    $currentUserPSModulePath = "$home\Documents\WindowsPowerShell\Modules"

    $replaceCurrentUserModulePath = Add-ToPSModulePath -Path $currentUserPSModulePath

    #First scenario - required version of the module is already loaded

    $importedModule = Get-ModuleWorkAround -Name $ModuleName

    if($null -ne $importedModule){

        Write-DosMessage -Level "Information" -Message "Module '$ModuleName' already imported."

        if ($RequiredVersion) {

            Write-DosMessage -Level "Verbose" -Message "Checking if imported module '$ModuleName' matches required version '$RequiredVersion'."

            if ((Compare-ModuleVersion -ModuleToCompare $importedModule -RequiredVersion $RequiredVersion)) {

                Write-DosMessage -Level "Information" -Message "Confirming '$ModuleName' with version '$RequiredVersion' is loaded into session."

                if ($importedModule.Count -gt 1) {

                    Write-DosMessage -Level "Information" -Message "Multiple '$ModuleName' modules loaded in session. This should never happen?"

                    Remove-Module -Name $ModuleName

                    try {

                        Import-Module -Name $ModuleName -RequiredVersion $RequiredVersion -Global -ErrorAction Stop

                    }

                    catch [System.Management.Automation.RuntimeException]{

                        Write-DosMessage -Level "Warning" -Message "'$ModuleName' was previously loaded during this session. If you encounter weird issues with DosInstallUtilities, please restart PowerShell and resolve conflicts with '$ModuleName' imports." 

                    }

                    Write-DosMessage -Level "Information" -Message "Successfully imported '$ModuleName' with version '$RequiredVersion' into session."

                    Write-DosTelemetry -Message "Multiple modules found in session. Removed all and successfully imported '$ModuleName' with version '$RequiredVersion' into session."

                }

                else {

                    Write-DosMessage -Level "Information" -Message "Using '$ModuleName' that is currently loaded in the session."

                    Write-DosTelemetry -Message "Using '$ModuleName' that is currently loaded in the session."

                }

                # Removing user path from ps module to cover cases in it is not included in system path

                if ($replaceCurrentUserModulePath) {

                    Remove-FromPSModulePath -Path $currentUserPSModulePath

                }

                return

            }

            else {

                Write-DosMessage -Level "Information" -Message "Removing '$ModuleName' that does not match required version '$RequiredVersion'."

                Remove-Module -Name $ModuleName

            }

        }

        else {

            # Removing user path from ps module to cover cases in it is not included in system path

            if ($replaceCurrentUserModulePath) {

                Remove-FromPSModulePath -Path $currentUserPSModulePath

            }

            return

        }

    }

    Write-DosMessage -Level "Information" -Message "Did not find module '$ModuleName' loaded in session."

    # Second scenario is required version of the module is installed on the system

    Write-DosMessage -Level "Information" -Message "Checking if module '$ModuleName' is already installed."

    $installedModule = Get-ModuleWorkAround -Name $ModuleName -ListAvailable

    if($null -ne $installedModule){

        Write-DosMessage -Level "Information" -Message "Module '$ModuleName' already installed."

        if ($RequiredVersion) {

            Write-DosMessage -Level "Verbose" -Message "Checking if installed module '$ModuleName' matches required version '$RequiredVersion'."

            if ((Compare-ModuleVersion -ModuleToCompare $installedModule -RequiredVersion $RequiredVersion)) {

                Write-DosMessage -Level "Information" -Message "Importing '$ModuleName' with version '$RequiredVersion'."

                try {

                    Import-Module -Name $ModuleName -RequiredVersion $RequiredVersion -Global -ErrorAction Stop

                }

                catch [System.Management.Automation.RuntimeException]{

                    Write-DosMessage -Level "Warning" -Message "'$ModuleName' was previously loaded during this session. If you encounter weird issues with DosInstallUtilities, please restart PowerShell and resolve conflicts with '$ModuleName' imports." 

                }

                Write-DosTelemetry -Message "'$ModuleName' found on the system and successfully imported with version '$RequiredVersion'"

                if ($replaceCurrentUserModulePath) {

                    Remove-FromPSModulePath -Path $currentUserPSModulePath

                }

                return

            }                        

        }

        else {

            Write-DosMessage -Level "Information" -Message "Module '$ModuleName' is installed on system, attempting to import."

            try {

                Import-Module -Name $ModuleName -Global -ErrorAction Stop

            }

            catch [System.Management.Automation.RuntimeException]{

                Write-DosMessage -Level "Warning" -Message "'$ModuleName' was previously loaded during this session. If you encounter weird issues with DosInstallUtilities, please restart PowerShell and resolve conflicts with '$ModuleName' imports." 

            }

            Write-DosTelemetry -Message "'$ModuleName' found on the system and successfully imported with version"

            if ($replaceCurrentUserModulePath) {

                Remove-FromPSModulePath -Path $currentUserPSModulePath

            }

            return

        }

    }

    Write-DosMessage -Level "Information" -Message "Did not find module '$ModuleName' installed on system."

    #Third scenario is module is installed from PSGallery

    $psVersion = Get-PSVersion

    if ($psVersion.PSVersion.Major -ge 5) {

        Write-DosMessage -Level "Information" -Message "Attempting to fetch '$ModuleName'."

        $desiredRepo = "PSGallery"

        $isTrusted = Get-RepositoryTrust -RepositoryName $desiredRepo

        if (!($isTrusted)) {

            Write-DosMessage -Level "Information" -Message "'$desiredRepo' is not trusted. Toggling trust to download '$ModuleName'"

            Set-RepositoryTrust -RepositoryName $desiredRepo -Trust

        }

        #Error check here - also assume that PowerShellGet is loaded/available.

        try {

            if ($RequiredVersion) {

                Write-DosMessage -Level "Information" -Message "Module '$ModuleName' version '$RequiredVersion' being downloaded from PSGallery."

                Install-Module $ModuleName -RequiredVersion $RequiredVersion -Scope $scope

                Write-DosMessage -Level "Information" -Message "Successfully downloaded module '$ModuleName' with version '$RequiredVersion' from PSGallery."

                try {

                        Import-Module -Name $ModuleName -RequiredVersion $RequiredVersion -Global -ErrorAction Stop

                    }

                    catch [System.Management.Automation.RuntimeException]{

                        Write-DosMessage -Level "Warning" -Message "'$ModuleName' was previously loaded during this session. If you encounter weird issues with DosInstallUtilities, please restart PowerShell and resolve conflicts with '$ModuleName' imports." 

                    }

                Write-DosMessage -Level "Information" -Message "Successfully imported module '$ModuleName' with version '$RequiredVersion' from PSGallery."

                Write-DosTelemetry -Message "Successfully imported module '$ModuleName' with version '$RequiredVersion' from PSGallery."

            }

            else {

                Write-DosMessage -Level "Information" -Message "Module '$ModuleName' being downloaded from PSGallery."

                Install-Module $ModuleName -Scope $scope

                Write-DosMessage -Level "Information" -Message "Successfully downloaded module '$ModuleName' from PSGallery."

                try {

                    Import-Module -Name $ModuleName -Global -ErrorAction Stop

                }

                catch [System.Management.Automation.RuntimeException]{

                    Write-DosMessage -Level "Warning" -Message "'$ModuleName' was previously loaded during this session. If you encounter weird issues with DosInstallUtilities, please restart PowerShell and resolve conflicts with '$ModuleName' imports." 

                }

                Write-DosMessage -Level "Information" -Message "Successfully imported module '$ModuleName' from PSGallery."

                Write-DosTelemetry -Message "Successfully imported module '$ModuleName' from PSGallery."

            }

        }

        catch {

            Write-DosMessage -Level "Error" -Message "Error installing or importing '$ModuleName'. Exception: $($_.Exception)"

            if (!($isTrusted)) {

                Write-DosMessage -Level "Information" -Message "Returning '$desiredRepo' to an untrusted state."

                Set-RepositoryTrust -RepositoryName $desiredRepo

            }

        }

        if (!($isTrusted)) {

            Write-DosMessage -Level "Information" -Message "Returning '$desiredRepo' to an untrusted state."

            Set-RepositoryTrust -RepositoryName $desiredRepo

        }

    }

    else {

        Write-DosMessage -Level "Fatal" -Message "Unable to install required module: '$ModuleName'. Insufficient PowerShell Version: $psVersion, PowerShell Version 5.0 or greater is required to download from PSGallery"

    }

    if ($replaceCurrentUserModulePath) {

        Remove-FromPSModulePath -Path $currentUserPSModulePath

    }

    Write-DosTelemetry -Message "Install-RequiredModule completed - successfully"

}

#Work around for pester issue: https://github.com/pester/Pester/issues/1007

function Get-ModuleWorkAround{

    param(

        [string] $Name,

        [switch] $ListAvailable

    )

    if($ListAvailable.IsPresent){

        return Get-Module -Name $Name -ListAvailable

    }

    else {

        return Get-Module -Name $Name

    }

}

function Get-RepositoryTrust {

    param (

        [string] $RepositoryName

    )

    $repo = Get-PSRepository -Name $RepositoryName

    return $repo.Trusted

}

function Set-RepositoryTrust {

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "", Justification="WhatIf support not implemented.")]

    param (

        [string] $RepositoryName,

        [switch] $Trust

    )

    if ($Trust.IsPresent) {

        Set-PSRepository -Name $RepositoryName -InstallationPolicy Trusted

    }

    else {

        Set-PSRepository -Name $RepositoryName -InstallationPolicy Untrusted

    }

}

function Add-ToPSModulePath {

    [CmdletBinding()]

    param(

        [Parameter(Mandatory=$true)]

        [string] $Path

    )

    if (!($env:PSModulePath.split(";") -contains $Path)){

        Write-DosMessage -Level "Information" -Message "Adding '$Path' to PSModulePath"

        $current = $env:PSModulePath

        [Environment]::SetEnvironmentVariable("PSModulePath",$current + ";" + $Path, "Machine")

        $env:PSModulePath = [System.Environment]::GetEnvironmentVariable("PSModulePath","Machine")

        return $true

    }else{

        Write-DosMessage -Level "Information" -Message "'$Path' is already present in PSModulePath"

        return $false

    }

}

function Remove-FromPSModulePath{

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "", Justification="WhatIf support not implemented.")]

    [CmdletBinding()]

    param(

        [Parameter(Mandatory=$true)]

        [string] $Path

    )

    if ($env:PSModulePath.split(";") -contains $Path){

        $newValue = (($env:PSModulePath).Split(";") | Where-Object { $_ -ne $Path }) -join ";"

        [Environment]::SetEnvironmentVariable("PSModulePath", $newValue, "Machine")

        $env:PSModulePath = [System.Environment]::GetEnvironmentVariable("PSModulePath","Machine")

        Write-DosMessage -Level "Information" -Message "$Path removed from PSModulePath." 

    }else{

        Write-DosMessage -Level "Information" -Message "$Path is not present in $env:PSModulePath"

    }

}

function Compare-ModuleVersion {

    [CmdletBinding()]

    param(

        [object] $ModuleToCompare,

        [version] $RequiredVersion

    )

    $isMatch = $false

    foreach($module in $ModuleToCompare) {

        if ($module.Version.CompareTo($RequiredVersion) -eq 0) {

            Write-DosMessage -Level "Information" -Message "Found Module '$ModuleName' that meets the version requirements."

            $isMatch = $true

            break;

        }

    }

    if (!$isMatch) {

        Write-DosMessage -Level "Information" -Message "No module with version '$RequiredVersion' was found for module '$ModuleName'."

    }

    return $isMatch

}

# SIG # Begin signature block

# MIIcRwYJKoZIhvcNAQcCoIIcODCCHDQCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAIgi5RM/ruS200

# PtTvzIkFPrV/WOoZPRHb37jrHZnpAaCCCqAwggUwMIIEGKADAgECAhAECRgbX9W7

# ZnVTQ7VvlVAIMA0GCSqGSIb3DQEBCwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV

# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0xMzEwMjIxMjAwMDBa

# Fw0yODEwMjIxMjAwMDBaMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy

# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lD

# ZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3

# DQEBAQUAA4IBDwAwggEKAoIBAQD407Mcfw4Rr2d3B9MLMUkZz9D7RZmxOttE9X/l

# qJ3bMtdx6nadBS63j/qSQ8Cl+YnUNxnXtqrwnIal2CWsDnkoOn7p0WfTxvspJ8fT

# eyOU5JEjlpB3gvmhhCNmElQzUHSxKCa7JGnCwlLyFGeKiUXULaGj6YgsIJWuHEqH

# CN8M9eJNYBi+qsSyrnAxZjNxPqxwoqvOf+l8y5Kh5TsxHM/q8grkV7tKtel05iv+

# bMt+dDk2DZDv5LVOpKnqagqrhPOsZ061xPeM0SAlI+sIZD5SlsHyDxL0xY4PwaLo

# LFH3c7y9hbFig3NBggfkOItqcyDQD2RzPJ6fpjOp/RnfJZPRAgMBAAGjggHNMIIB

# yTASBgNVHRMBAf8ECDAGAQH/AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAK

# BggrBgEFBQcDAzB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9v

# Y3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHow

# eDA6oDigNoY0aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJl

# ZElEUm9vdENBLmNybDA6oDigNoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0Rp

# Z2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDBPBgNVHSAESDBGMDgGCmCGSAGG/WwA

# AgQwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAK

# BghghkgBhv1sAzAdBgNVHQ4EFgQUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHwYDVR0j

# BBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8wDQYJKoZIhvcNAQELBQADggEBAD7s

# DVoks/Mi0RXILHwlKXaoHV0cLToaxO8wYdd+C2D9wz0PxK+L/e8q3yBVN7Dh9tGS

# dQ9RtG6ljlriXiSBThCk7j9xjmMOE0ut119EefM2FAaK95xGTlz/kLEbBw6RFfu6

# r7VRwo0kriTGxycqoSkoGjpxKAI8LpGjwCUR4pwUR6F6aGivm6dcIFzZcbEMj7uo

# +MUSaJ/PQMtARKUT8OZkDCUIQjKyNookAv4vcn4c10lFluhZHen6dGRrsutmQ9qz

# sIzV6Q3d9gEgzpkxYz0IGhizgZtPxpMQBvwHgfqL2vmCSfdibqFT+hKUGIUukpHq

# aGxEMrJmoecYpJpkUe8wggVoMIIEUKADAgECAhAKRecO+XBAYPQ5XoaaebXrMA0G

# CSqGSIb3DQEBCwUAMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJ

# bmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0

# IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwHhcNMTcwNDEzMDAwMDAw

# WhcNMjAwNDE1MTIwMDAwWjCBpDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcw

# FQYDVQQHEw5TYWx0IExha2UgQ2l0eTEeMBwGA1UEChMVSGVhbHRoIENhdGFseXN0

# LCBJbmMuMR4wHAYDVQQDExVIZWFsdGggQ2F0YWx5c3QsIEluYy4xLzAtBgkqhkiG

# 9w0BCQEWIGFkbWluaXN0cmF0b3JAaGVhbHRoY2F0YWx5c3QuY29tMIIBIjANBgkq

# hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv8AEfB5imOv8J17fvW8w+WKuE0keRub9

# 1+QzkiI+nSa9y2yADr/ZCEXqxGqDKdg47CjlvpOmKg8K88NPaTPvGN5fm7p7avmn

# Cfp7IGXLGtutZ1RnFW2fYC8+kl86WinKVQ7eHLe7Rsvn9CyurIzttJpJcTikxqrr

# U45yE8Iw/H9ziiwP+grfm8AiGN3C2vuxbhs8YwG2pbbn2aa5hN5q4bbFzoQ4xHGO

# kFiqhRYVyGbVZNeoGTpkf/DNXJh07RuSDdcFXoh7whwwvfXhrk9Z5YzE6GEk2CUF

# adTjqWHuGyfpBpY7bYZ8/mbDTmUqLNeGsTQrVmowv4r+usyK6lz6LwIDAQABo4IB

# xTCCAcEwHwYDVR0jBBgwFoAUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHQYDVR0OBBYE

# FDCXth9LjWUWNRWEPkEw5VZAVdBSMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUEDDAK

# BggrBgEFBQcDAzB3BgNVHR8EcDBuMDWgM6Axhi9odHRwOi8vY3JsMy5kaWdpY2Vy

# dC5jb20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDA1oDOgMYYvaHR0cDovL2NybDQu

# ZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwTAYDVR0gBEUwQzA3

# BglghkgBhv1sAwEwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQu

# Y29tL0NQUzAIBgZngQwBBAEwgYQGCCsGAQUFBwEBBHgwdjAkBggrBgEFBQcwAYYY

# aHR0cDovL29jc3AuZGlnaWNlcnQuY29tME4GCCsGAQUFBzAChkJodHRwOi8vY2Fj

# ZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRTSEEyQXNzdXJlZElEQ29kZVNpZ25p

# bmdDQS5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAQEAkIewxl/k

# WdhH2w7hIW0jT2WXhasjLk/UVeJtON2V7uj6J5/geg9huBlF9UDASBN9Po3sULeE

# /WQ+Lxbd3BDLq+jcENPKdEE7v9NFOCzs142tBJ+tng5uSD4KCG7wStTggI8XElpu

# 0uraecK21bq4T4A2uGXpruEVNdS8DkANh34AwLJWanhaavbqunHZMkjQU0oluktS

# ikJ1BVeyROM0Xh11VBnM5nSftS4c8eC66ZXhsuc268wwzwb3eD81jKwXdli3SrvT

# zFKtAFqzh2/1bVIceq+iT7zketpGuFTg3BOkhbiJhIEjAS9pA3v+tVKrWcdTp/HC

# mT2XH0Xyeg2GhzGCEP0wghD5AgEBMIGGMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNV

# BAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0ECEApF

# 5w75cEBg9Dlehpp5teswDQYJYIZIAWUDBAIBBQCgfDAQBgorBgEEAYI3AgEMMQIw

# ADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYK

# KwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgcvdT2UsxLuF/+MOm612++qlsZ6d5

# pQ/s35VSGhkeerkwDQYJKoZIhvcNAQEBBQAEggEAEG1uU7BAUEIPfxZw4R7tPOuJ

# FatJX/xwSIEtdBhwAPANnM9W5tGVhgrvon0UdSE1545VS4agtFnwOC/USjclQg0I

# MkA5RIqb8IW7Ga8iQt5Yj1yUTzgWJ6+5NQVrE+4ugzlhJ2/6a/8u+GF9CxbD/6SX

# wsAoV9M/RH9WPJLbd2UCjwbNbdTzhoWP+ZJUkOiuqa96zMqf1ozcUeZwJlUZ7zly

# Gl8Z5H3shy0XvMfTYNlsTJ1PedGgQnmFoYC/ZSw6EWdZ+dfSloun7OWE1m6FrKIF

# Bd3UsXTI2RmzcxZ+MU6QlYcR7hIm1nX+sWJDRjQt9UzF1lzF4FY4j62ENNPJ3KGC

# Dskwgg7FBgorBgEEAYI3AwMBMYIOtTCCDrEGCSqGSIb3DQEHAqCCDqIwgg6eAgED

# MQ8wDQYJYIZIAWUDBAIBBQAweAYLKoZIhvcNAQkQAQSgaQRnMGUCAQEGCWCGSAGG

# /WwHATAxMA0GCWCGSAFlAwQCAQUABCDUsvnt1ioin8ew6ZRYQ+nybKBJKGCzkuil

# 9ryIe5AgRgIRAM6Zjr016hl6+Tz4n/Oas/0YDzIwMjAwMzE2MTc1NDQxWqCCC7sw

# ggaCMIIFaqADAgECAhAEzT+FaK52xhuw/nFgzKdtMA0GCSqGSIb3DQEBCwUAMHIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJ

# RCBUaW1lc3RhbXBpbmcgQ0EwHhcNMTkxMDAxMDAwMDAwWhcNMzAxMDE3MDAwMDAw

# WjBMMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJDAiBgNV

# BAMTG1RJTUVTVEFNUC1TSEEyNTYtMjAxOS0xMC0xNTCCASIwDQYJKoZIhvcNAQEB

# BQADggEPADCCAQoCggEBAOlkNZz6qZhlZBvkF9y4KTbMZwlYhU0w4Mn/5Ts8EShQ

# rwcx4l0JGML2iYxpCAQj4HctnRXluOihao7/1K7Sehbv+EG1HTl1wc8vp6xFfpRt

# rAMBmTxiPn56/UWXMbT6t9lCPqdVm99aT1gCqDJpIhO+i4Itxpira5u0yfJlEQx0

# DbLwCJZ0xOiySKKhFKX4+uGJcEQ7je/7pPTDub0ULOsMKCclgKsQSxYSYAtpIoxO

# zcbVsmVZIeB8LBKNcA6Pisrg09ezOXdQ0EIsLnrOnGd6OHdUQP9PlQQg1OvIzocU

# CP4dgN3Q5yt46r8fcMbuQhZTNkWbUxlJYp16ApuVFKMCAwEAAaOCAzgwggM0MA4G

# A1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF

# BwMIMIIBvwYDVR0gBIIBtjCCAbIwggGhBglghkgBhv1sBwEwggGSMCgGCCsGAQUF

# BwIBFhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BTMIIBZAYIKwYBBQUHAgIw

# ggFWHoIBUgBBAG4AeQAgAHUAcwBlACAAbwBmACAAdABoAGkAcwAgAEMAZQByAHQA

# aQBmAGkAYwBhAHQAZQAgAGMAbwBuAHMAdABpAHQAdQB0AGUAcwAgAGEAYwBjAGUA

# cAB0AGEAbgBjAGUAIABvAGYAIAB0AGgAZQAgAEQAaQBnAGkAQwBlAHIAdAAgAEMA

# UAAvAEMAUABTACAAYQBuAGQAIAB0AGgAZQAgAFIAZQBsAHkAaQBuAGcAIABQAGEA

# cgB0AHkAIABBAGcAcgBlAGUAbQBlAG4AdAAgAHcAaABpAGMAaAAgAGwAaQBtAGkA

# dAAgAGwAaQBhAGIAaQBsAGkAdAB5ACAAYQBuAGQAIABhAHIAZQAgAGkAbgBjAG8A

# cgBwAG8AcgBhAHQAZQBkACAAaABlAHIAZQBpAG4AIABiAHkAIAByAGUAZgBlAHIA

# ZQBuAGMAZQAuMAsGCWCGSAGG/WwDFTAfBgNVHSMEGDAWgBT0tuEgHf4prtLkYaWy

# oiWyyBc1bjAdBgNVHQ4EFgQUVlMPwcYHp03X2G5XcoBQTOTsnsEwcQYDVR0fBGow

# aDAyoDCgLoYsaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC10

# cy5jcmwwMqAwoC6GLGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3Vy

# ZWQtdHMuY3JsMIGFBggrBgEFBQcBAQR5MHcwJAYIKwYBBQUHMAGGGGh0dHA6Ly9v

# Y3NwLmRpZ2ljZXJ0LmNvbTBPBggrBgEFBQcwAoZDaHR0cDovL2NhY2VydHMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3VyZWRJRFRpbWVzdGFtcGluZ0NBLmNy

# dDANBgkqhkiG9w0BAQsFAAOCAQEALoOhRAVKBOO5MlL62YHwGrv4CY0juT3YkqHm

# RhxKL256PGNuNxejGr9YI7JDnJSDTjkJsCzox+HizO3LeWvO3iMBR+2VVIHggHsS

# sa8Chqk6c2r++J/BjdEhjOQpgsOKC2AAAp0fR8SftApoU39aEKb4Iub4U5IxX9iC

# gy1tE0Kug8EQTqQk9Eec3g8icndcf0/pOZgrV5JE1+9uk9lDxwQzY1E3Vp5HBBHD

# o1hUIdjijlbXST9X/AqfI1579JSN3Z0au996KqbSRaZVDI/2TIryls+JRtwxspGQ

# o18zMGBV9fxrMKyh7eRHTjOeZ2ootU3C7VuXgvjLqQhsUwm09zCCBTEwggQZoAMC

# AQICEAqhJdbWMht+QeQF2jaXwhUwDQYJKoZIhvcNAQELBQAwZTELMAkGA1UEBhMC

# VVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0

# LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTE2

# MDEwNzEyMDAwMFoXDTMxMDEwNzEyMDAwMFowcjELMAkGA1UEBhMCVVMxFTATBgNV

# BAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8G

# A1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQTCC

# ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL3QMu5LzY9/3am6gpnFOVQo

# V7YjSsQOB0UzURB90Pl9TWh+57ag9I2ziOSXv2MhkJi/E7xX08PhfgjWahQAOPcu

# HjvuzKb2Mln+X2U/4Jvr40ZHBhpVfgsnfsCi9aDg3iI/Dv9+lfvzo7oiPhisEeTw

# mQNtO4V8CdPuXciaC1TjqAlxa+DPIhAPdc9xck4Krd9AOly3UeGheRTGTSQjMF28

# 7DxgaqwvB8z98OpH2YhQXv1mblZhJymJhFHmgudGUP2UKiyn5HU+upgPhH+fMRTW

# rdXyZMt7HgXQhBlyF/EXBu89zdZN7wZC/aJTKk+FHcQdPK/P2qwQ9d2srOlW/5MC

# AwEAAaOCAc4wggHKMB0GA1UdDgQWBBT0tuEgHf4prtLkYaWyoiWyyBc1bjAfBgNV

# HSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzASBgNVHRMBAf8ECDAGAQH/AgEA

# MA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB5BggrBgEFBQcB

# AQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggr

# BgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNz

# dXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHoweDA6oDigNoY0aHR0cDovL2NybDQu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDA6oDigNoY0

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB

# LmNybDBQBgNVHSAESTBHMDgGCmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYcaHR0

# cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzALBglghkgBhv1sBwEwDQYJKoZIhvcN

# AQELBQADggEBAHGVEulRh1Zpze/d2nyqY3qzeM8GN0CE70uEv8rPAwL9xafDDiBC

# LK938ysfDCFaKrcFNB1qrpn4J6JmvwmqYN92pDqTD/iy0dh8GWLoXoIlHsS6HHss

# IeLWWywUNUMEaLLbdQLgcseY1jxk5R9IEBhfiThhTWJGJIdjjJFSLK8pieV4H9YL

# FKWA1xJHcLN11ZOFk362kmf7U2GJqPVrlsD0WGkNfMgBsbkodbeZY4UijGHKeZR+

# WfyMD+NvtQEmtmyl7odRIeRYYJu6DC0rbaLEfrvEJStHAgh8Sa4TtuF8QkIoxhhW

# z0E0tmZdtnR79VYzIi8iNrJLokqV2PWmjlIxggJNMIICSQIBATCBhjByMQswCQYD

# VQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGln

# aWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgVGlt

# ZXN0YW1waW5nIENBAhAEzT+FaK52xhuw/nFgzKdtMA0GCWCGSAFlAwQCAQUAoIGY

# MBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAcBgkqhkiG9w0BCQUxDxcNMjAw

# MzE2MTc1NDQxWjArBgsqhkiG9w0BCRACDDEcMBowGDAWBBQDJb1QXtqWMC3CL0+g

# Hkwovig0xTAvBgkqhkiG9w0BCQQxIgQg9Rj4g2Z78BE5e3fLVFbN3k9KithnN8x/

# 374lYN9WJV8wDQYJKoZIhvcNAQEBBQAEggEAe967ebRSCs/ERlvNSAvsZkNd+UFt

# HyzoNmD/8pyra38TxNjOjrt4PKKjDniUu4yJ1W93j1kxNkH5hPLdu/ImL1T5RkNQ

# 65fnvapEecAMK1gQw9WHtVqUxblhJKRUaV4bVe+QGMYeYkexXFbneLLLIC6Cz7rU

# zs71LAgT+5TQ1ABV1xiHo1jonC3pdBicg+ZtxwP4zK/Aqph4QjrXnenZnll3p30T

# KI9m6fYswDXHX6cPQQ5wuu7O9EStxcGk+BCcnfoazGmAAzKjhlVLUM+VOQmGYuHI

# AO8zPMn4e8w4pMUVE+KcSCuEgxi/auN2/qWCXDhGlerevJ52NfaNCJ+hWg==

# SIG # End signature block