Refresh-EnvironmentVariables

1.0.2

Refresh-EnvironmentVariables.ps1

                                <#PSScriptInfo

.VERSION 1.0.2

.GUID 9ff8b18d-cc46-449e-81f1-bbdacc3f41b4

.AUTHOR asherto

.COMPANYNAME asheroto

.TAGS PowerShell Windows refresh reload path env environment variable variables update current

.PROJECTURI https://github.com/asheroto/Refresh-EnvironmentVariables

.RELEASENOTES

[Version 0.0.1] - Initial Release.

[Version 1.0.0] - Total rework of script, implementing Chocolatey's Update-SessionEnvironment function into one single script.

[Version 1.0.1] - Rename to Refresh-EnvironmentVariables to avoid naming conflicts with Chocolatey's RefreshEnv.cmd.

[Version 1.0.2] - Fix bug with CheckForUpdate.

#>

<#

.SYNOPSIS

    Refreshes the environment variables in the current PowerShell session.

.DESCRIPTION

    Refreshes the environment variables in the current PowerShell session.

.EXAMPLE

    Refresh-EnvironmentVariables

.PARAMETER CheckForUpdate

    Checks if there is an update available for the script.

.PARAMETER Version

    Displays the version of the script.

.PARAMETER Help

    Displays the full help information for the script.

.NOTES

    Version      : 1.0.2

    Created by   : asheroto

.LINK

    Project Site: https://github.com/asheroto/Refresh-EnvironmentVariables

#>

[CmdletBinding()]

param (

    [switch]$Version,

    [switch]$Help,

    [switch]$CheckForUpdate

)

# Derived from the original work by Chocolatey Software, used in accordance with license

# Copyright © 2017 - 2021 Chocolatey Software, Inc.

# Changes made:

# - Extracted the functions from the original script for use in Refresh-EnvironmentVariables.ps1

# - Removed Write-FunctionCallLogMessage from Update-SessionEnvironment as it only applies to Chocolatey

# - Added custom functions

# Original license, included per the terms of the Apache 2.0 license:

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

#     http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

# Version

$CurrentVersion = '1.0.2'

$RepoOwner = 'asheroto'

$RepoName = 'Refresh-EnvironmentVariables'

$PowerShellGalleryName = 'Refresh-EnvironmentVariables'

# Versions

$ProgressPreference = 'SilentlyContinue' # Suppress progress bar (makes downloading super fast)

$ConfirmPreference = 'None' # Suppress confirmation prompts

# Display version if -Version is specified

if ($Version.IsPresent) {

    $CurrentVersion

    exit 0

}

# Display full help if -Help is specified

if ($Help) {

    Get-Help -Name $MyInvocation.MyCommand.Source -Full

    exit 0

}

function Get-GitHubRelease {

    <#

        .SYNOPSIS

        Fetches the latest release information of a GitHub repository.

        .DESCRIPTION

        This function uses the GitHub API to get information about the latest release of a specified repository, including its version and the date it was published.

        .PARAMETER Owner

        The GitHub username of the repository owner.

        .PARAMETER Repo

        The name of the repository.

        .EXAMPLE

        Get-GitHubRelease -Owner "asheroto" -Repo "winget-install"

        This command retrieves the latest release version and published datetime of the winget-install repository owned by asheroto.

    #>

    [CmdletBinding()]

    param (

        [string]$Owner,

        [string]$Repo

    )

    try {

        $url = "https://api.github.com/repos/$Owner/$Repo/releases/latest"

        $response = Invoke-RestMethod -Uri $url -ErrorAction Stop

        $latestVersion = $response.tag_name

        $publishedAt = $response.published_at

        # Convert UTC time string to local time

        $UtcDateTime = [DateTime]::Parse($publishedAt, [System.Globalization.CultureInfo]::InvariantCulture, [System.Globalization.DateTimeStyles]::RoundtripKind)

        $PublishedLocalDateTime = $UtcDateTime.ToLocalTime()

        [PSCustomObject]@{

            LatestVersion     = $latestVersion

            PublishedDateTime = $PublishedLocalDateTime

        }

    } catch {

        Write-Error "Unable to check for updates.`nError: $_"

        exit 1

    }

}

function CheckForUpdate {

    param (

        [string]$RepoOwner,

        [string]$RepoName,

        [version]$CurrentVersion,

        [string]$PowerShellGalleryName

    )

    $Data = Get-GitHubRelease -Owner $RepoOwner -Repo $RepoName

    if ($Data.LatestVersion -gt $CurrentVersion) {

        Write-Output "`nA new version of $RepoName is available.`n"

        Write-Output "Current version: $CurrentVersion."

        Write-Output "Latest version: $($Data.LatestVersion)."

        Write-Output "Published at: $($Data.PublishedDateTime).`n"

        Write-Output "You can download the latest version from https://github.com/$RepoOwner/$RepoName/releases`n"

        if ($PowerShellGalleryName) {

            Write-Output "Or you can run the following command to update:"

            Write-Output "Install-Script $PowerShellGalleryName -Force`n"

        }

    } else {

        Write-Output "`n$RepoName is up to date.`n"

        Write-Output "Current version: $CurrentVersion."

        Write-Output "Latest version: $($Data.LatestVersion)."

        Write-Output "Published at: $($Data.PublishedDateTime)."

        Write-Output "`nRepository: https://github.com/$RepoOwner/$RepoName/releases`n"

    }

    exit 0

}

# Check for updates if -CheckForUpdate is specified

if ($CheckForUpdate) {

    CheckForUpdate -RepoOwner $RepoOwner -RepoName $RepoName -CurrentVersion $CurrentVersion -PowerShellGalleryName $PowerShellGalleryName

}

function Get-EnvironmentVariable {

    <#

.SYNOPSIS

Gets an Environment Variable.

.DESCRIPTION

This will will get an environment variable based on the variable name

and scope while accounting whether to expand the variable or not

(e.g.: `%TEMP%`-> `C:\User\Username\AppData\Local\Temp`).

.NOTES

This helper reduces the number of lines one would have to write to get

environment variables, mainly when not expanding the variables is a

must.

.PARAMETER Name

The environment variable you want to get the value from.

.PARAMETER Scope

The environment variable target scope. This is `Process`, `User`, or

`Machine`.

.PARAMETER PreserveVariables

A switch parameter stating whether you want to expand the variables or

not. Defaults to false.

.PARAMETER IgnoredArguments

Allows splatting with arguments that do not apply. Do not use directly.

.EXAMPLE

Get-EnvironmentVariable -Name 'TEMP' -Scope User -PreserveVariables

.EXAMPLE

Get-EnvironmentVariable -Name 'PATH' -Scope Machine

.LINK

Get-EnvironmentVariableNames

.LINK

Set-EnvironmentVariable

#>

    [CmdletBinding()]

    [OutputType([string])]

    param(

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

        [Parameter(Mandatory = $true)][System.EnvironmentVariableTarget] $Scope,

        [Parameter(Mandatory = $false)][switch] $PreserveVariables = $false,

        [parameter(ValueFromRemainingArguments = $true)][Object[]] $ignoredArguments

    )

    # Do not log function call, it may expose variable names

    ## Called from chocolateysetup.psm1 - wrap any Write-Host in try/catch

    [string] $MACHINE_ENVIRONMENT_REGISTRY_KEY_NAME = "SYSTEM\CurrentControlSet\Control\Session Manager\Environment\";

    [Microsoft.Win32.RegistryKey] $win32RegistryKey = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey($MACHINE_ENVIRONMENT_REGISTRY_KEY_NAME)

    if ($Scope -eq [System.EnvironmentVariableTarget]::User) {

        [string] $USER_ENVIRONMENT_REGISTRY_KEY_NAME = "Environment";

        [Microsoft.Win32.RegistryKey] $win32RegistryKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey($USER_ENVIRONMENT_REGISTRY_KEY_NAME)

    } elseif ($Scope -eq [System.EnvironmentVariableTarget]::Process) {

        return [Environment]::GetEnvironmentVariable($Name, $Scope)

    }

    [Microsoft.Win32.RegistryValueOptions] $registryValueOptions = [Microsoft.Win32.RegistryValueOptions]::None

    if ($PreserveVariables) {

        Write-Verbose "Choosing not to expand environment names"

        $registryValueOptions = [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames

    }

    [string] $environmentVariableValue = [string]::Empty

    try {

        #Write-Verbose "Getting environment variable $Name"

        if ($win32RegistryKey -ne $null) {

            # Some versions of Windows do not have HKCU:\Environment

            $environmentVariableValue = $win32RegistryKey.GetValue($Name, [string]::Empty, $registryValueOptions)

        }

    } catch {

        Write-Debug "Unable to retrieve the $Name environment variable. Details: $_"

    } finally {

        if ($win32RegistryKey -ne $null) {

            $win32RegistryKey.Close()

        }

    }

    if ($environmentVariableValue -eq $null -or $environmentVariableValue -eq '') {

        $environmentVariableValue = [Environment]::GetEnvironmentVariable($Name, $Scope)

    }

    return $environmentVariableValue

}

function Get-EnvironmentVariableNames([System.EnvironmentVariableTarget] $Scope) {

    <#

.SYNOPSIS

Gets all environment variable names.

.DESCRIPTION

Provides a list of environment variable names based on the scope. This

can be used to loop through the list and generate names.

.NOTES

Process dumps the current environment variable names in memory /

session. The other scopes refer to the registry values.

.INPUTS

None

.OUTPUTS

A list of environment variables names.

.PARAMETER Scope

The environment variable target scope. This is `Process`, `User`, or

`Machine`.

.EXAMPLE

Get-EnvironmentVariableNames -Scope Machine

.LINK

Get-EnvironmentVariable

.LINK

Set-EnvironmentVariable

#>

    # Do not log function call

    # HKCU:\Environment may not exist in all Windows OSes (such as Server Core).

    switch ($Scope) {

        'User' {

            Get-Item 'HKCU:\Environment' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Property

        }

        'Machine' {

            Get-Item 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' | Select-Object -ExpandProperty Property

        }

        'Process' {

            Get-ChildItem Env:\ | Select-Object -ExpandProperty Key

        }

        default {

            throw "Unsupported environment scope: $Scope"

        }

    }

}

function Update-SessionEnvironment {

    <#

.SYNOPSIS

Updates the environment variables of the current powershell session with

any environment variable changes that may have occurred during a

Chocolatey package install.

.DESCRIPTION

When Chocolatey installs a package, the package author may add or change

certain environment variables that will affect how the application runs

or how it is accessed. Often, these changes are not visible to the

current PowerShell session. This means the user needs to open a new

PowerShell session before these settings take effect which can render

the installed application nonfunctional until that time.

Use the Update-SessionEnvironment command to refresh the current

PowerShell session with all environment settings possibly performed by

Chocolatey package installs.

.NOTES

This method is also added to the user's PowerShell profile as

`refreshenv`. When called as `refreshenv`, the method will provide

additional output.

Preserves `PSModulePath` as set by the process.

.INPUTS

None

.OUTPUTS

None

#>

    $userName = $env:USERNAME

    $architecture = $env:PROCESSOR_ARCHITECTURE

    $psModulePath = $env:PSModulePath

    #ordering is important here, $user should override $machine...

    $ScopeList = 'Process', 'Machine'

    if ('SYSTEM', "${env:COMPUTERNAME}`$" -notcontains $userName) {

        # but only if not running as the SYSTEM/machine in which case user can be ignored.

        $ScopeList += 'User'

    }

    foreach ($Scope in $ScopeList) {

        Get-EnvironmentVariableNames -Scope $Scope |

        ForEach-Object {

            Set-Item "Env:$_" -Value (Get-EnvironmentVariable -Scope $Scope -Name $_)

        }

    }

    #Path gets special treatment b/c it munges the two together

    $paths = 'Machine', 'User' |

    ForEach-Object {

      (Get-EnvironmentVariable -Name 'PATH' -Scope $_) -split ';'

    } |

    Select-Object -Unique

    $Env:PATH = $paths -join ';'

    # PSModulePath is almost always updated by process, so we want to preserve it.

    $env:PSModulePath = $psModulePath

    # reset user and architecture

    if ($userName) {

        $env:USERNAME = $userName;

    }

    if ($architecture) {

        $env:PROCESSOR_ARCHITECTURE = $architecture;

    }

}

# Output

Write-Output "Refreshing environment variables..."

# Call the function to update the session environment

Update-SessionEnvironment

# Output

Write-Output "Finished"

# SIG # Begin signature block

# MIIpMwYJKoZIhvcNAQcCoIIpJDCCKSACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAVgiRUj84KObeo

# yKzyVX/OyAMQYQX6nhUnDIFsaPprAqCCDh8wggawMIIEmKADAgECAhAIrUCyYNKc

# TJ9ezam9k67ZMA0GCSqGSIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNV

# BAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBaFw0z

# NjA0MjgyMzU5NTlaMGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwg

# SW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcg

# UlNBNDA5NiBTSEEzODQgMjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw

# ggIKAoICAQDVtC9C0CiteLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc9es0

# JAfhS0/TeEP0F9ce2vnS1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyAVxJr

# Q5qZ8sU7H/Lvy0daE6ZMswEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQIXhF

# LqGfLOEYwhrMxe6TSXBCMo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/sk+F

# LEikVoQ11vkunKoAFdE3/hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na59zHh

# 3K3kGKDYwSNHR7OhD26jq22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pgVItJ

# wZPt4bRc4G/rJvmM1bL5OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7BzzosmJQay

# g9Rc9hUZTO1i4F4z8ujo7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQokbI

# YViY9XwCFjyDKK05huzUtw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jLchAp

# QfDVxW0mdmgRQRNYmtwmKwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHMIRro

# OBl8ZhzNeDhFMJlP/2NPTLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQABo4IB

# WTCCAVUwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8Rhvv+

# YXsIiGX0TkIwHwYDVR0jBBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0P

# AQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGswaTAk

# BggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAC

# hjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9v

# dEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeBDAED

# MAgGBmeBDAEEATANBgkqhkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bgAhql

# +Eg08yy25nRm95RysQDKr2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7FoFF

# UP2cvbaF4HZ+N3HLIvdaqpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZGM1h

# mYFW9snjdufE5BtfQ/g+lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG3Ryw

# YFzzDaju4ImhvTnhOE7abrs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5Ubdld

# AhQfQDN8A+KVssIhdXNSy0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WIIIJw

# 8MzK7/0pNVwfiThV9zeKiwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956rEnP

# LqR0kq3bPKSchh/jwVYbKyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuWTatE

# QOON8BUozu3xGFYHKi8QxAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3E+bn

# KD+sEq6lLyJsQfmCXBVmzGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60bhQji

# WQ1tygVQK+pKHJ6l/aCnHwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOImYIbq

# yK+p/pQd52MbOoZWeE4wggdnMIIFT6ADAgECAhAN0Uk2zX4f3m8X7HdlwxBNMA0G

# CSqGSIb3DQEBCwUAMGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwg

# SW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcg

# UlNBNDA5NiBTSEEzODQgMjAyMSBDQTEwHhcNMjMwMzE3MDAwMDAwWhcNMjQwMzE2

# MjM1OTU5WjBvMQswCQYDVQQGEwJVUzERMA8GA1UECBMIT2tsYWhvbWExETAPBgNV

# BAcTCE11c2tvZ2VlMRwwGgYDVQQKExNBc2hlciBTb2x1dGlvbnMgSW5jMRwwGgYD

# VQQDExNBc2hlciBTb2x1dGlvbnMgSW5jMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A

# MIICCgKCAgEA081RwO7808Fuab0RP0L2gthlZB8fiiGUBpnqJhsD1Bzpk+45B2LA

# qmrUp+nZIXNwr5me/55enGI9CkhaxmZoFhBxoM1u5lODNp8GaAYzIEi0IJldzZ9y

# PAQMfhTkHRiOwKBqTGO3h/gSZtaZ+8F+ltCmlXvv2vpqFpt5JL+uJm9SRIN5WLiP

# QM/isjYR+eIcaZxQeHLfbnemNcaT4cXOMChUsmG6WsoHZO1o76dCN+owz23koLy2

# Y1R3N2PMQj3kj8Bnlph6ffNnitKhXuwj3NkWwPSSQvYhcBuTcCOxpXpUjWlQNuTt

# llTHp9leKMq11raPkSaLe2qVX4eBc6HPtBT+7XagpaA409d7fmYTOLKmE0BCEdgb

# YZzYmKSyjrAgWlU9SYxurhFgHuQFD0CsBW1aXl6IEjn26cVx+hmj2KCOFELAdh1r

# 9UTNt37a/o/TYCp/mQ22/oa/224is1dpNj7RAHnNaix5n8RKKHufEh85lVjS/cBn

# 7z3cCKejyfBaUGK10SUwZKJiJ51DKkRkdh4A5cL85wKkQcFnRpfT/T+KTOEYRFT/

# vz3uK9bMLwuBj+gkP3WnlVXf67IY3FfZaQUDNdtwur4UTGrDQOn8Xl2rEy7L9VlJ

# UOCjX93WfW0B1Q4IxSdF6vIJw1m44HpIU4jxnqTBEo6BVVRCtdmp/x0CAwEAAaOC

# AgMwggH/MB8GA1UdIwQYMBaAFGg34Ou2O/hfEYb7/mF7CIhl9E5CMB0GA1UdDgQW

# BBTH3/U7rGshoJKjtOAVqNAEWJ/PBDAOBgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAww

# CgYIKwYBBQUHAwMwgbUGA1UdHwSBrTCBqjBToFGgT4ZNaHR0cDovL2NybDMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25pbmdSU0E0MDk2U0hB

# Mzg0MjAyMUNBMS5jcmwwU6BRoE+GTWh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9E

# aWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNBNDA5NlNIQTM4NDIwMjFDQTEu

# Y3JsMD4GA1UdIAQ3MDUwMwYGZ4EMAQQBMCkwJwYIKwYBBQUHAgEWG2h0dHA6Ly93

# d3cuZGlnaWNlcnQuY29tL0NQUzCBlAYIKwYBBQUHAQEEgYcwgYQwJAYIKwYBBQUH

# MAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBcBggrBgEFBQcwAoZQaHR0cDov

# L2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25p

# bmdSU0E0MDk2U0hBMzg0MjAyMUNBMS5jcnQwCQYDVR0TBAIwADANBgkqhkiG9w0B

# AQsFAAOCAgEAQtDUmTp7UG2w4A4WaT6BoMLBLqzm09S64nFfuIUFjWk3KTCStpwR

# 3KzwG78CpYb7I0G6T7O2Emv+u0WgKVaWPbLFlnrjXXB+68DxR+CFWh6UDioz/9wo

# +eD/V2eKilAc2WSEIC8NzXT3C4yEtxUmnebK7Ysxy4qLlb4Sxk9NspS+Lg3jKBxb

# ExduQWHi1ytqw9NCghzK1Y2h5/AHwSYfwz7AyRerN3gTwzmmgTaWYEHVCL0NQddO

# 1lkSz6LPq2/JWHns7I0tNPCT5nZYva1v34EZvP9+P+SUDBH8bfrm6HlTd+Z6qNW5

# ACsALaCCAsZRQ6i7UZfjolD/lADn65f46XfnNMIo8PPpagFBIvxg03DGDJQu4QnY

# AyZhtrLDxc8VLtGZP8QVBf9JVcjVD8FxMMobDnuDq0YZ1h3ydRo1dqOzWVDipp0i

# oPd0UbL7EcZr6QcM72LWFvAACyVcIiXlh5jY+JehqaZMlS9aw4WQT0gpvBOaOJqb

# vGoAbtyHRFIkFbJG/Wxkpr+VkU1JvilXCh8g0OsXwvJk4dK4GeBVa7VLlq95fLiK

# zL54EZDTY1W+YfKYUseiptRlu5XBUn15C9rTpqDZhHFz6exyLfYcJzdxJJdArjio

# UKKR9ZhLfxm1bmFMb8NPWOKH/ZI6vR0jNgwalk3nTx63ZnVAOJLH+BkxghpqMIIa

# ZgIBATB9MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFB

# MD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5

# NiBTSEEzODQgMjAyMSBDQTECEA3RSTbNfh/ebxfsd2XDEE0wDQYJYIZIAWUDBAIB

# BQCgfDAQBgorBgEEAYI3AgEMMQIwADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg

# /oHEYGPvLK1fXFxEknMFPnnYkBBWBDW41GSxM7CmzOAwDQYJKoZIhvcNAQEBBQAE

# ggIADcndL9noG0sGoP9yjyjfm4n+OOZ7sfUAWCjvmIzmzShl+3dpwa0F3o2NUjm+

# OjComHBf6zTSKCgJ2jfaLRgcmQ83MeIaf2C4AZTxsVB+MInBWCWk+reX1ah72+4Y

# c0ao6gIAdfJnKzGz9J2G6ZjNZ0EBU4dDmLpyoX1eAZ3KRbmMqDcbdFMLhD7dmNo+

# sCLrJ1zAlqokFenwhDSJfHuh/yxP140v9Qhi+iUszz+ERqZLG46KRWtAay6C5Rkg

# EBJ+71U2JtS8vQHeCqi7Emw35AMWKo6IVE0kZiqW5+QKOJidIDx/PjmKWjVSMLZx

# n2BwAXfU0ml9Y99pD8KGzaL36G15I20ejbfNWzr1k3CmukCuWxQvJv7V+R1phgW9

# +UQnjvmaPpLIjbS6XxYapC6/fFWxBsTwXSsbnNz/efAfF5u6UCBgPGmrAYnKaSgz

# bAih9XpiUCTQby6KW4qnR303vQUMPm2lDp4PGPbtdWv1An3InjcikAn/0WQcWOuZ

# X7ObUy+QMHiquFgtIYOv+Tmm94dCgGe+F/DiQO+giQjvTPX+BEDQaL5eBLVTyg7X

# vjZZbcZpfndpCFTWCsz8x1Zh3y/LRJhbs1Hp5/12H3g7+DOAlWLP0SqcKq8iY1HR

# 3FTi+mUpzMlGQMmNNoTxC+zb4+atXv0A7qmRX0D+BVWvT3GhghdAMIIXPAYKKwYB

# BAGCNwMDATGCFywwghcoBgkqhkiG9w0BBwKgghcZMIIXFQIBAzEPMA0GCWCGSAFl

# AwQCAQUAMHgGCyqGSIb3DQEJEAEEoGkEZzBlAgEBBglghkgBhv1sBwEwMTANBglg

# hkgBZQMEAgEFAAQgk0BQ2ITYMyRlMGVq6P8jGeBlkfQ+B7Ssch87A8Ej3yACEQDQ

# amXmaVKUOCSey2nhMmM3GA8yMDIzMDgzMDA4MzcwNFqgghMJMIIGwjCCBKqgAwIB

# AgIQBUSv85SdCDmmv9s/X+VhFjANBgkqhkiG9w0BAQsFADBjMQswCQYDVQQGEwJV

# UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRy

# dXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMB4XDTIzMDcx

# NDAwMDAwMFoXDTM0MTAxMzIzNTk1OVowSDELMAkGA1UEBhMCVVMxFzAVBgNVBAoT

# DkRpZ2lDZXJ0LCBJbmMuMSAwHgYDVQQDExdEaWdpQ2VydCBUaW1lc3RhbXAgMjAy

# MzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKNTRYcdg45brD5UsyPg

# z5/X5dLnXaEOCdwvSKOXejsqnGfcYhVYwamTEafNqrJq3RApih5iY2nTWJw1cb86

# l+uUUI8cIOrHmjsvlmbjaedp/lvD1isgHMGXlLSlUIHyz8sHpjBoyoNC2vx/CSSU

# pIIa2mq62DvKXd4ZGIX7ReoNYWyd/nFexAaaPPDFLnkPG2ZS48jWPl/aQ9OE9dDH

# 9kgtXkV1lnX+3RChG4PBuOZSlbVH13gpOWvgeFmX40QrStWVzu8IF+qCZE3/I+PK

# hu60pCFkcOvV5aDaY7Mu6QXuqvYk9R28mxyyt1/f8O52fTGZZUdVnUokL6wrl76f

# 5P17cz4y7lI0+9S769SgLDSb495uZBkHNwGRDxy1Uc2qTGaDiGhiu7xBG3gZbeTZ

# D+BYQfvYsSzhUa+0rRUGFOpiCBPTaR58ZE2dD9/O0V6MqqtQFcmzyrzXxDtoRKOl

# O0L9c33u3Qr/eTQQfqZcClhMAD6FaXXHg2TWdc2PEnZWpST618RrIbroHzSYLzrq

# awGw9/sqhux7UjipmAmhcbJsca8+uG+W1eEQE/5hRwqM/vC2x9XH3mwk8L9Cgsqg

# cT2ckpMEtGlwJw1Pt7U20clfCKRwo+wK8REuZODLIivK8SgTIUlRfgZm0zu++uuR

# ONhRB8qUt+JQofM604qDy0B7AgMBAAGjggGLMIIBhzAOBgNVHQ8BAf8EBAMCB4Aw

# DAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAgBgNVHSAEGTAX

# MAgGBmeBDAEEAjALBglghkgBhv1sBwEwHwYDVR0jBBgwFoAUuhbZbU2FL3Mpdpov

# dYxqII+eyG8wHQYDVR0OBBYEFKW27xPn783QZKHVVqllMaPe1eNJMFoGA1UdHwRT

# MFEwT6BNoEuGSWh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0

# ZWRHNFJTQTQwOTZTSEEyNTZUaW1lU3RhbXBpbmdDQS5jcmwwgZAGCCsGAQUFBwEB

# BIGDMIGAMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wWAYI

# KwYBBQUHMAKGTGh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRy

# dXN0ZWRHNFJTQTQwOTZTSEEyNTZUaW1lU3RhbXBpbmdDQS5jcnQwDQYJKoZIhvcN

# AQELBQADggIBAIEa1t6gqbWYF7xwjU+KPGic2CX/yyzkzepdIpLsjCICqbjPgKjZ

# 5+PF7SaCinEvGN1Ott5s1+FgnCvt7T1IjrhrunxdvcJhN2hJd6PrkKoS1yeF844e

# ktrCQDifXcigLiV4JZ0qBXqEKZi2V3mP2yZWK7Dzp703DNiYdk9WuVLCtp04qYHn

# bUFcjGnRuSvExnvPnPp44pMadqJpddNQ5EQSviANnqlE0PjlSXcIWiHFtM+YlRpU

# urm8wWkZus8W8oM3NG6wQSbd3lqXTzON1I13fXVFoaVYJmoDRd7ZULVQjK9WvUzF

# 4UbFKNOt50MAcN7MmJ4ZiQPq1JE3701S88lgIcRWR+3aEUuMMsOI5ljitts++V+w

# QtaP4xeR0arAVeOGv6wnLEHQmjNKqDbUuXKWfpd5OEhfysLcPTLfddY2Z1qJ+Pan

# x+VPNTwAvb6cKmx5AdzaROY63jg7B145WPR8czFVoIARyxQMfq68/qTreWWqaNYi

# yjvrmoI1VygWy2nyMpqy0tg6uLFGhmu6F/3Ed2wVbK6rr3M66ElGt9V/zLY4wNjs

# HPW2obhDLN9OTH0eaHDAdwrUAuBcYLso/zjlUlrWrBciI0707NMX+1Br/wd3H3GX

# REHJuEbTbDJ8WC9nR2XlG3O2mflrLAZG70Ee8PBf4NvZrZCARK+AEEGKMIIGrjCC

# BJagAwIBAgIQBzY3tyRUfNhHrP0oZipeWzANBgkqhkiG9w0BAQsFADBiMQswCQYD

# VQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGln

# aWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcN

# MjIwMzIzMDAwMDAwWhcNMzcwMzIyMjM1OTU5WjBjMQswCQYDVQQGEwJVUzEXMBUG

# A1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQg

# RzQgUlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMIICIjANBgkqhkiG9w0B

# AQEFAAOCAg8AMIICCgKCAgEAxoY1BkmzwT1ySVFVxyUDxPKRN6mXUaHW0oPRnkyi

# baCwzIP5WvYRoUQVQl+kiPNo+n3znIkLf50fng8zH1ATCyZzlm34V6gCff1DtITa

# EfFzsbPuK4CEiiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW1OcoLevTsbV15x8GZY2U

# KdPZ7Gnf2ZCHRgB720RBidx8ald68Dd5n12sy+iEZLRS8nZH92GDGd1ftFQLIWhu

# NyG7QKxfst5Kfc71ORJn7w6lY2zkpsUdzTYNXNXmG6jBZHRAp8ByxbpOH7G1WE15

# /tePc5OsLDnipUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCYJn+gGkcgQ+NDY4B7dW4n

# JZCYOjgRs/b2nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucfWmyU8lKVEStYdEAoq3ND

# zt9KoRxrOMUp88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLcGEh/FDTP0kyr75s9/g64

# ZCr6dSgkQe1CvwWcZklSUPRR8zZJTYsg0ixXNXkrqPNFYLwjjVj33GHek/45wPmy

# MKVM1+mYSlg+0wOI/rOP015LdhJRk8mMDDtbiiKowSYI+RQQEgN9XyO7ZONj4Kbh

# PvbCdLI/Hgl27KtdRnXiYKNYCQEoAA6EVO7O6V3IXjASvUaetdN2udIOa5kM0jO0

# zbECAwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFLoW

# 2W1NhS9zKXaaL3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX44LScV1kTN8uZz/nupiu

# HA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB3BggrBgEF

# BQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBB

# BggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0

# VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybDMu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcmwwIAYDVR0gBBkw

# FzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQB9WY7A

# k7ZvmKlEIgF+ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJLKftwig2qKWn8acHPHQfp

# PmDI2AvlXFvXbYf6hCAlNDFnzbYSlm/EUExiHQwIgqgWvalWzxVzjQEiJc6VaT9H

# d/tydBTX/6tPiix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2MvGQmh2ySvZ180HAKfO+o

# vHVPulr3qRCyXen/KFSJ8NWKcXZl2szwcqMj+sAngkSumScbqyQeJsG33irr9p6x

# eZmBo1aGqwpFyd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJxLafzYeHJLtPo0m5d2aR

# 8XKc6UsCUqc3fpNTrDsdCEkPlM05et3/JWOZJyw9P2un8WbDQc1PtkCbISFA0LcT

# JM3cHXg65J6t5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SVe+0KXzM5h0F4ejjpnOHd

# I/0dKNPH+ejxmF/7K9h+8kaddSweJywm228Vex4Ziza4k9Tm8heZWcpw8De/mADf

# IBZPJ/tgZxahZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJDwq9gdkT/r+k0fNX2bwE

# +oLeMt8EifAAzV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr5n8apIUP/JiW9lVUKx+A

# +sDyDivl1vupL0QVSucTDh3bNzgaoSv27dZ8/DCCBY0wggR1oAMCAQICEA6bGI75

# 0C3n79tQ4ghAGFowDQYJKoZIhvcNAQEMBQAwZTELMAkGA1UEBhMCVVMxFTATBgNV

# BAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEkMCIG

# A1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTIyMDgwMTAwMDAw

# MFoXDTMxMTEwOTIzNTk1OVowYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lD

# ZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGln

# aUNlcnQgVHJ1c3RlZCBSb290IEc0MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAv+aQc2jeu+RdSjwwIjBpM+zCpyUuySE98orYWcLhKac9WKt2ms2uexuE

# DcQwH/MbpDgW61bGl20dq7J58soR0uRf1gU8Ug9SH8aeFaV+vp+pVxZZVXKvaJNw

# wrK6dZlqczKU0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckgHWMpLc7sXk7Ik/ghYZs0

# 6wXGXuxbGrzryc/NrDRAX7F6Zu53yEioZldXn1RYjgwrt0+nMNlW7sp7XeOtyU9e

# 5TXnMcvak17cjo+A2raRmECQecN4x7axxLVqGDgDEI3Y1DekLgV9iPWCPhCRcKtV

# gkEy19sEcypukQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjXWkmkwuapoGfdpCe8oU85

# tRFYF/ckXEaPZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIbZpp0yt5LHucOY67m1O+S

# kjqePdwA5EUlibaaRBkrfsCUtNJhbesz2cXfSwQAzH0clcOP9yGyshG3u3/y1Yxw

# LEFgqrFjGESVGnZifvaAsPvoZKYz0YkH4b235kOkGLimdwHhD5QMIR2yVCkliWzl

# DlJRR3S+Jqy2QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIWIgnffEx1P2PsIV/EIFFr

# b7GrhotPwtZFX50g/KEexcCPorF+CiaZ9eRpL5gdLfXZqbId5RsCAwEAAaOCATow

# ggE2MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX44LScV1kTN8uZz/nupiu

# HA9PMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgPMA4GA1UdDwEB/wQE

# AwIBhjB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp

# Z2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDBFBgNVHR8EPjA8MDqgOKA2

# hjRodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURSb290

# Q0EuY3JsMBEGA1UdIAQKMAgwBgYEVR0gADANBgkqhkiG9w0BAQwFAAOCAQEAcKC/

# Q1xV5zhfoKN0Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviHGmlUIu2kiHdtvRoU9BNK

# ei8ttzjv9P+Aufih9/Jy3iS8UgPITtAq3votVs/59PesMHqai7Je1M/RQ0SbQyHr

# lnKhSLSZy51PpwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3A8eHqNJMQBk1RmppVLC4

# oVaO7KTVPeix3P0c2PR3WlxUjG/voVA9/HYJaISfb8rbII01YBwCA8sgsKxYoA5A

# Y8WYIsGyWfVVa88nq2x2zm8jLfR+cWojayL/ErhULSd+2DrZ8LaHlv1b0VysGMNN

# n3O3AamfV6peKOK5lDGCA3YwggNyAgEBMHcwYzELMAkGA1UEBhMCVVMxFzAVBgNV

# BAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0

# IFJTQTQwOTYgU0hBMjU2IFRpbWVTdGFtcGluZyBDQQIQBUSv85SdCDmmv9s/X+Vh

# FjANBglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQw

# HAYJKoZIhvcNAQkFMQ8XDTIzMDgzMDA4MzcwNFowKwYLKoZIhvcNAQkQAgwxHDAa

# MBgwFgQUZvArMsLCyQ+CXc6qisnGTxmcz0AwLwYJKoZIhvcNAQkEMSIEIPTRzN+p

# bGrHSgQd1gOYp0RINajT/twIDNIFufZUL1jDMDcGCyqGSIb3DQEJEAIvMSgwJjAk

# MCIEINL25G3tdCLM0dRAV2hBNm+CitpVmq4zFq9NGprUDHgoMA0GCSqGSIb3DQEB

# AQUABIICAEgGUL0u1DHnIU8nWqotiY7u6e5VdqaNF8cr17B931QqyquV0Ez8QBry

# GZx5ReauN3pgWA2Mgqau4geQWR+q5F2Nw/AAY6oN/ysgwkMq2erbvPBSuHmDy4Oq

# 2Bth8ut24Clybr5qcObQ2dQKW97HvDxgCfSn+WHNRMj6qfn+V1oZtOSThxdKfLGL

# lU+tnnr8uXdFQy7Vt2M8b342FbPA96v2790dRl8Prg282hMP0vq0ehkIbVuesbqW

# Dg8NxNwnT6m+Su7sT+nkxNNR/HuyyOC35HUUk7XlZ+dFwlgP+pcFZhYGkkPTc8es

# Ai4NFsZRJ7R/QcqJzLhLzI2LKYnuXjk2WIOserud4FdHBqxlEXsOPJHDCSYTomTv

# BI13OpDL9hOoLXRQ7TJRRWO9WS21xSkMntAIwSQUzuNlrSvsASCRgC90alwMn3bi

# fKuNCfMD7gNs88umt1Fq2ZExW1rH8zVBViIohAyE/RcGbrC4O1Fw/82gmC6xWkSx

# TVAs11z2m0YU2HWzH0Llo3yOCo9gOoBmo3e+h+oU0U2ER6Qvtk5bQj6SvwVrIPks

# EQduRAi+Bee6snWF1Ch99TKRdMUV8A+sMLj9MOMfrt/l6d4cxXM2uiWDb+wKJra7

# Ps+XduM1aeK67OEK9q2JkyzOTWvdoFj32WZO+i5j+IzqsB6VJHzI

# SIG # End signature block