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 # MIIcSgYJKoZIhvcNAQcCoIIcOzCCHDcCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAIgi5RM/ruS200 # PtTvzIkFPrV/WOoZPRHb37jrHZnpAaCCCqMwggUwMIIEGKADAgECAhAECRgbX9W7 # 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 # aGxEMrJmoecYpJpkUe8wggVrMIIEU6ADAgECAhAMMCpTLsjxo9FR9hag8ePUMA0G # CSqGSIb3DQEBCwUAMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJ # bmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0 # IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwHhcNMjAwMzMxMDAwMDAw # WhcNMjMwNTEwMTIwMDAwWjCBpzELMAkGA1UEBhMCVVMxDTALBgNVBAgTBFV0YWgx # FzAVBgNVBAcTDlNhbHQgTGFrZSBDaXR5MR4wHAYDVQQKExVIZWFsdGggQ2F0YWx5 # c3QsIEluYy4xHjAcBgNVBAMTFUhlYWx0aCBDYXRhbHlzdCwgSW5jLjEwMC4GCSqG # SIb3DQEJARYhYWRtaW5uaXN0cmF0b3JAaGVhbHRoY2F0YWx5c3QuY29tMIIBIjAN # BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2fY0HWdxDJezDOsbHp7f9u/lrrD5 # nuZ1mENMgvixlrtC/KXgBRXlcWH7ajIOKljKnWCSAZwlZy4nFGbMagKmMzohXUXg # xo94u5nCdiBa/kgPazNGpL0AyGgX2VARMbcpm8Gdy+/uH3Kc7L91lcoGZVVBnVIt # 1oj5iXURqmhL83TrMyYqyj3XOH0So8Y10FVLPSukocMzMqBIRgvn/7EP0iWtOjXx # +o1wB5Ql+z9G3NCqF6CKE/Pn355XYbbmjF7BPzKoOjocHO6VU2uEflJWq1ZFb0QY # /tAosyyLYi9kFfO1damtJfRbbsVqavwg2UeQkzhg9CpB6eSsmBXPlFHudQIDAQAB # o4IBxTCCAcEwHwYDVR0jBBgwFoAUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHQYDVR0O # BBYEFFjfHOOIre2C4m9NCk8TFJlDwMxUMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUE # DDAKBggrBgEFBQcDAzB3BgNVHR8EcDBuMDWgM6Axhi9odHRwOi8vY3JsMy5kaWdp # Y2VydC5jb20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDA1oDOgMYYvaHR0cDovL2Ny # bDQuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwTAYDVR0gBEUw # QzA3BglghkgBhv1sAwEwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNl # cnQuY29tL0NQUzAIBgZngQwBBAEwgYQGCCsGAQUFBwEBBHgwdjAkBggrBgEFBQcw # AYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tME4GCCsGAQUFBzAChkJodHRwOi8v # Y2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRTSEEyQXNzdXJlZElEQ29kZVNp # Z25pbmdDQS5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAQEAsBxn # 9yJAQi+9cJPZpJvOEV6iHaOBGv8898wNJCc4eB5g8WPziEY70GZVeqEdx3z0wS8U # QQIr19Hkju2NFZjDtzB9z1jAc/9EgqFGoCZbPijv1EYAa2oOVAp1BPbLjqBSdXqu # 2mzqo14CJ30oNom9ep9F6LGZ5zEoPsMrJejSbJGr4EacrksX8C8qeFklc7FzwiGk # GX7IQxidrrhOm2fOvGGAAxnvNYAR0FqJK0LiWWPSt5R/j63H/6HQtqD2sLevI3+O # bRP74TPchDobFmWlSogX9oB63E7fsbDAqecY0cRPQ6tVWK53Ke2sB514nahFjZDa # mxsa3/acZWL659ly3jGCEP0wghD5AgEBMIGGMHIxCzAJBgNVBAYTAlVTMRUwEwYD # VQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAv # BgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EC # EAwwKlMuyPGj0VH2FqDx49QwDQYJYIZIAWUDBAIBBQCgfDAQBgorBgEEAYI3AgEM # MQIwADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4w # DAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgcvdT2UsxLuF/+MOm612++qls # Z6d5pQ/s35VSGhkeerkwDQYJKoZIhvcNAQEBBQAEggEAYTPzwlbXwbk0EuXfpY4F # k166l19Fje9q869TsWAjJGX4VTdsC7s33DoTMY0kayt4JQMUz2uDfRKn825SNI9v # oTy6xtIuKHF9kcT3acvq+1MmP5DClzqaYdbkjCdlziPy6GMEd6pmgQVBre86IODi # p4kiF4PQ5jnAuSrZYpiO9EsG7hpUalew4dG7TRP+vRNweFlzKjoYd3TtzDM4fxvF # Y/qg9OX2fzAXH5t+X78xSzu8mVhOkPssTYnkL5AeYMkRgqaLPHCCvkMgGTmUIpzp # JiSHBXqYO7K4PyUT3JAzzMKrISJsIDhjyWtngcMy3O3L4Gi1zHee/2RjwJYchimT # waGCDskwgg7FBgorBgEEAYI3AwMBMYIOtTCCDrEGCSqGSIb3DQEHAqCCDqIwgg6e # AgEDMQ8wDQYJYIZIAWUDBAIBBQAweAYLKoZIhvcNAQkQAQSgaQRnMGUCAQEGCWCG # SAGG/WwHATAxMA0GCWCGSAFlAwQCAQUABCBu71Lx9zB71EM6pW5GaafDCb2wXd6z # 0Sxc8Bc3PHenSQIRAMYEmh8I4kqaFXTQU/K7VkcYDzIwMjAwNTEyMTkzNTM1WqCC # C7swggaCMIIFaqADAgECAhAEzT+FaK52xhuw/nFgzKdtMA0GCSqGSIb3DQEBCwUA # MHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsT # EHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJl # ZCBJRCBUaW1lc3RhbXBpbmcgQ0EwHhcNMTkxMDAxMDAwMDAwWhcNMzAxMDE3MDAw # MDAwWjBMMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJDAi # BgNVBAMTG1RJTUVTVEFNUC1TSEEyNTYtMjAxOS0xMC0xNTCCASIwDQYJKoZIhvcN # AQEBBQADggEPADCCAQoCggEBAOlkNZz6qZhlZBvkF9y4KTbMZwlYhU0w4Mn/5Ts8 # EShQrwcx4l0JGML2iYxpCAQj4HctnRXluOihao7/1K7Sehbv+EG1HTl1wc8vp6xF # fpRtrAMBmTxiPn56/UWXMbT6t9lCPqdVm99aT1gCqDJpIhO+i4Itxpira5u0yfJl # EQx0DbLwCJZ0xOiySKKhFKX4+uGJcEQ7je/7pPTDub0ULOsMKCclgKsQSxYSYAtp # IoxOzcbVsmVZIeB8LBKNcA6Pisrg09ezOXdQ0EIsLnrOnGd6OHdUQP9PlQQg1OvI # zocUCP4dgN3Q5yt46r8fcMbuQhZTNkWbUxlJYp16ApuVFKMCAwEAAaOCAzgwggM0 # MA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsG # AQUFBwMIMIIBvwYDVR0gBIIBtjCCAbIwggGhBglghkgBhv1sBwEwggGSMCgGCCsG # AQUFBwIBFhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BTMIIBZAYIKwYBBQUH # AgIwggFWHoIBUgBBAG4AeQAgAHUAcwBlACAAbwBmACAAdABoAGkAcwAgAEMAZQBy # AHQAaQBmAGkAYwBhAHQAZQAgAGMAbwBuAHMAdABpAHQAdQB0AGUAcwAgAGEAYwBj # AGUAcAB0AGEAbgBjAGUAIABvAGYAIAB0AGgAZQAgAEQAaQBnAGkAQwBlAHIAdAAg # AEMAUAAvAEMAUABTACAAYQBuAGQAIAB0AGgAZQAgAFIAZQBsAHkAaQBuAGcAIABQ # AGEAcgB0AHkAIABBAGcAcgBlAGUAbQBlAG4AdAAgAHcAaABpAGMAaAAgAGwAaQBt # AGkAdAAgAGwAaQBhAGIAaQBsAGkAdAB5ACAAYQBuAGQAIABhAHIAZQAgAGkAbgBj # AG8AcgBwAG8AcgBhAHQAZQBkACAAaABlAHIAZQBpAG4AIABiAHkAIAByAGUAZgBl # AHIAZQBuAGMAZQAuMAsGCWCGSAGG/WwDFTAfBgNVHSMEGDAWgBT0tuEgHf4prtLk # YaWyoiWyyBc1bjAdBgNVHQ4EFgQUVlMPwcYHp03X2G5XcoBQTOTsnsEwcQYDVR0f # BGowaDAyoDCgLoYsaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJl # ZC10cy5jcmwwMqAwoC6GLGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFz # c3VyZWQtdHMuY3JsMIGFBggrBgEFBQcBAQR5MHcwJAYIKwYBBQUHMAGGGGh0dHA6 # Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBPBggrBgEFBQcwAoZDaHR0cDovL2NhY2VydHMu # ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3VyZWRJRFRpbWVzdGFtcGluZ0NB # LmNydDANBgkqhkiG9w0BAQsFAAOCAQEALoOhRAVKBOO5MlL62YHwGrv4CY0juT3Y # kqHmRhxKL256PGNuNxejGr9YI7JDnJSDTjkJsCzox+HizO3LeWvO3iMBR+2VVIHg # gHsSsa8Chqk6c2r++J/BjdEhjOQpgsOKC2AAAp0fR8SftApoU39aEKb4Iub4U5Ix # X9iCgy1tE0Kug8EQTqQk9Eec3g8icndcf0/pOZgrV5JE1+9uk9lDxwQzY1E3Vp5H # BBHDo1hUIdjijlbXST9X/AqfI1579JSN3Z0au996KqbSRaZVDI/2TIryls+JRtwx # spGQo18zMGBV9fxrMKyh7eRHTjOeZ2ootU3C7VuXgvjLqQhsUwm09zCCBTEwggQZ # oAMCAQICEAqhJdbWMht+QeQF2jaXwhUwDQYJKoZIhvcNAQELBQAwZTELMAkGA1UE # BhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2lj # ZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4X # DTE2MDEwNzEyMDAwMFoXDTMxMDEwNzEyMDAwMFowcjELMAkGA1UEBhMCVVMxFTAT # BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEx # MC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBD # QTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL3QMu5LzY9/3am6gpnF # OVQoV7YjSsQOB0UzURB90Pl9TWh+57ag9I2ziOSXv2MhkJi/E7xX08PhfgjWahQA # OPcuHjvuzKb2Mln+X2U/4Jvr40ZHBhpVfgsnfsCi9aDg3iI/Dv9+lfvzo7oiPhis # EeTwmQNtO4V8CdPuXciaC1TjqAlxa+DPIhAPdc9xck4Krd9AOly3UeGheRTGTSQj # MF287DxgaqwvB8z98OpH2YhQXv1mblZhJymJhFHmgudGUP2UKiyn5HU+upgPhH+f # MRTWrdXyZMt7HgXQhBlyF/EXBu89zdZN7wZC/aJTKk+FHcQdPK/P2qwQ9d2srOlW # /5MCAwEAAaOCAc4wggHKMB0GA1UdDgQWBBT0tuEgHf4prtLkYaWyoiWyyBc1bjAf # BgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzASBgNVHRMBAf8ECDAGAQH/ # AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB5BggrBgEF # BQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBD # BggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0 # QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHoweDA6oDigNoY0aHR0cDovL2Ny # bDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDA6oDig # NoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9v # dENBLmNybDBQBgNVHSAESTBHMDgGCmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYc # aHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzALBglghkgBhv1sBwEwDQYJKoZI # hvcNAQELBQADggEBAHGVEulRh1Zpze/d2nyqY3qzeM8GN0CE70uEv8rPAwL9xafD # DiBCLK938ysfDCFaKrcFNB1qrpn4J6JmvwmqYN92pDqTD/iy0dh8GWLoXoIlHsS6 # HHssIeLWWywUNUMEaLLbdQLgcseY1jxk5R9IEBhfiThhTWJGJIdjjJFSLK8pieV4 # H9YLFKWA1xJHcLN11ZOFk362kmf7U2GJqPVrlsD0WGkNfMgBsbkodbeZY4UijGHK # eZR+WfyMD+NvtQEmtmyl7odRIeRYYJu6DC0rbaLEfrvEJStHAgh8Sa4TtuF8QkIo # xhhWz0E0tmZdtnR79VYzIi8iNrJLokqV2PWmjlIxggJNMIICSQIBATCBhjByMQsw # CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu # ZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQg # VGltZXN0YW1waW5nIENBAhAEzT+FaK52xhuw/nFgzKdtMA0GCWCGSAFlAwQCAQUA # oIGYMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAcBgkqhkiG9w0BCQUxDxcN # MjAwNTEyMTkzNTM1WjArBgsqhkiG9w0BCRACDDEcMBowGDAWBBQDJb1QXtqWMC3C # L0+gHkwovig0xTAvBgkqhkiG9w0BCQQxIgQgTRCY2GAAwqo78W5p2PhR5pi35ROw # yY21FgMWTPA2TSowDQYJKoZIhvcNAQEBBQAEggEAJFSoswMHToDe9laiD62PdXX3 # F9CH143WaUCmh7dt70Ky96IcYN9Ht9LVEdsatUWvaq7BtrVfscFeIh936kWLG1Yj # vAuCSUgCcJcasEMzUvf98Zp77l7Q4a+7n4m7Dt4CcqyyxcoI6yHzavVrzS+VCHGU # 2DhBP22+mAi4sKynmgamudiBVUkK6/ayCPOteo5Bim4TUhcty9HPGGxHd+Hh/dKb # sWZbIaI1yWA1eta/vcw5aWiK0InGuAJn0GD3JOGR1uhuJiaS31amY6LIe+MClsxf # jSrgOLp+UBT+sgjgrsJ7Mx5DC1LeoqjR2Tqtwx4AssIsQS3V29W2rNV9ogzzCw== # SIG # End signature block |