PowerShellGet

2.2.1

Modules/PowerShellGet.ResourceHelper/PowerShellGet.ResourceHelper.psm1

                                #

# Copyright (c) Microsoft Corporation.

#

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

# THE SOFTWARE.

#

<#

    Helper functions for PowerShellGet DSC Resources.

#>

# Import localization helper functions.

$helperName = 'PowerShellGet.LocalizationHelper'

$resourceModuleRoot = Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent

$dscResourcesFolderFilePath = Join-Path -Path $resourceModuleRoot -ChildPath "Modules\$helperName\$helperName.psm1"

Import-Module -Name $dscResourcesFolderFilePath

# Import Localization Strings

$script:localizedData = Get-LocalizedData -ResourceName 'PowerShellGet.ResourceHelper' -ScriptRoot $PSScriptRoot

<#

    .SYNOPSIS

        This is a helper function that extract the parameters from a given table.

    .PARAMETER FunctionBoundParameters

        Specifies the hash table containing a set of parameters to be extracted.

    .PARAMETER ArgumentNames

        Specifies a list of arguments you want to extract.

#>

function New-SplatParameterHashTable {

    [CmdletBinding()]

    [OutputType([System.Collections.Hashtable])]

    param

    (

        [Parameter(Mandatory = $true)]

        [System.Collections.Hashtable]

        $FunctionBoundParameters,

        [Parameter(Mandatory = $true)]

        [System.String[]]

        $ArgumentNames

    )

    Write-Verbose -Message ($script:localizedData.CallingFunction -f $($MyInvocation.MyCommand))

    $returnValue = @{}

    foreach ($arg in $ArgumentNames) {

        if ($FunctionBoundParameters.ContainsKey($arg)) {

            # Found an argument we are looking for, so we add it to return collection.

            $returnValue.Add($arg, $FunctionBoundParameters[$arg])

        }

    }

    return $returnValue

}

<#

    .SYNOPSIS

        This is a helper function that validate that a value is correct and used correctly.

    .PARAMETER Value

        Specifies the value to be validated.

    .PARAMETER Type

        Specifies the type of argument.

    .PARAMETER Type

        Specifies the name of the provider.

    .OUTPUTS

        None. Throws an error if the test fails.

#>

function Test-ParameterValue {

    [CmdletBinding()]

    param

    (

        [Parameter(Mandatory = $true)]

        [ValidateNotNullOrEmpty()]

        [System.String]

        $Value,

        [Parameter(Mandatory = $true)]

        [ValidateNotNullOrEmpty()]

        [System.String]

        $Type,

        [Parameter(Mandatory = $true)]

        [ValidateNotNullOrEmpty()]

        [System.String]

        $ProviderName

    )

    Write-Verbose -Message ($script:localizedData.CallingFunction -f $($MyInvocation.MyCommand))

    switch ($Type) {

        'SourceUri' {

            # Checks whether given URI represents specific scheme

            # Most common schemes: file, http, https, ftp

            $scheme = @('http', 'https', 'file', 'ftp')

            $newUri = $Value -as [System.URI]

            $returnValue = ($newUri -and $newUri.AbsoluteURI -and ($scheme -icontains $newUri.Scheme))

            if ($returnValue -eq $false) {

                $errorMessage = $script:localizedData.InValidUri -f $Value

                New-InvalidArgumentException -ArgumentName $Type -Message $errorMessage

            }

        }

        'DestinationPath' {

            $returnValue = Test-Path -Path $Value

            if ($returnValue -eq $false) {

                $errorMessage = $script:localizedData.PathDoesNotExist -f $Value

                New-InvalidArgumentException -ArgumentName $Type -Message $errorMessage

            }

        }

        'PackageSource' {

            # Value can be either the package source Name or source Uri.

            # Check if the source is a Uri.

            $uri = $Value -as [System.URI]

            if ($uri -and $uri.AbsoluteURI) {

                # Check if it's a valid Uri.

                Test-ParameterValue -Value $Value -Type 'SourceUri' -ProviderName $ProviderName

            }

            else {

                # Check if it's a registered package source name.

                $source = PackageManagement\Get-PackageSource -Name $Value -ProviderName $ProviderName -ErrorVariable ev

                if ((-not $source) -or $ev) {

                    # We do not need to throw error here as Get-PackageSource does already.

                    Write-Verbose -Message ($script:localizedData.SourceNotFound -f $source)

                }

            }

        }

        default {

            $errorMessage = $script:localizedData.UnexpectedArgument -f $Type

            New-InvalidArgumentException -ArgumentName $Type -Message $errorMessage

        }

    }

}

<#

    .SYNOPSIS

        This is a helper function that does the version validation.

    .PARAMETER RequiredVersion

        Provides the required version.

    .PARAMETER MaximumVersion

        Provides the maximum version.

    .PARAMETER MinimumVersion

        Provides the minimum version.

#>

function Test-VersionParameter {

    [CmdletBinding()]

    param

    (

        [Parameter()]

        [System.String]

        $RequiredVersion,

        [Parameter()]

        [System.String]

        $MinimumVersion,

        [Parameter()]

        [System.String]

        $MaximumVersion

    )

    Write-Verbose -Message ($localizedData.CallingFunction -f $($MyInvocation.MyCommand))

    $isValid = $false

    # Case 1: No further check required if a user provides either none or one of these: minimumVersion, maximumVersion, and requiredVersion.

    if ($PSBoundParameters.Count -le 1) {

        return $true

    }

    # Case 2: #If no RequiredVersion is provided.

    if (-not $PSBoundParameters.ContainsKey('RequiredVersion')) {

        # If no RequiredVersion, both MinimumVersion and MaximumVersion are provided. Otherwise fall into the Case #1.

        $isValid = $PSBoundParameters['MinimumVersion'] -le $PSBoundParameters['MaximumVersion']

    }

    # Case 3: RequiredVersion is provided.

    #        In this case  MinimumVersion and/or MaximumVersion also are provided. Otherwise fall in to Case #1.

    #        This is an invalid case. When RequiredVersion is provided, others are not allowed. so $isValid is false, which is already set in the init.

    if ($isValid -eq $false) {

        $errorMessage = $script:localizedData.VersionError

        New-InvalidArgumentException `

            -ArgumentName 'RequiredVersion, MinimumVersion or MaximumVersion' `

            -Message $errorMessage

    }

}

<#

    .SYNOPSIS

        This is a helper function that retrieves the InstallationPolicy from the given repository.

    .PARAMETER RepositoryName

        Provides the repository Name.

#>

function Get-InstallationPolicy {

    [CmdletBinding()]

    param

    (

        [Parameter(Mandatory = $true)]

        [ValidateNotNullOrEmpty()]

        [System.String] $RepositoryName

    )

    Write-Verbose -Message ($LocalizedData.CallingFunction -f $($MyInvocation.MyCommand))

    $repositoryObject = PackageManagement\Get-PackageSource -Name $RepositoryName -ErrorAction SilentlyContinue -WarningAction SilentlyContinue

    if ($repositoryObject) {

        return $repositoryObject.IsTrusted

    }

}

<#

    .SYNOPSIS

        This method is used to compare current and desired values for any DSC resource.

    .PARAMETER CurrentValues

        This is hash table of the current values that are applied to the resource.

    .PARAMETER DesiredValues

        This is a PSBoundParametersDictionary of the desired values for the resource.

    .PARAMETER ValuesToCheck

        This is a list of which properties in the desired values list should be checked.

        If this is empty then all values in DesiredValues are checked.

#>

function Test-DscParameterState {

    [CmdletBinding()]

    param

    (

        [Parameter(Mandatory = $true)]

        [System.Collections.Hashtable]

        $CurrentValues,

        [Parameter(Mandatory = $true)]

        [System.Object]

        $DesiredValues,

        [Parameter()]

        [System.Array]

        $ValuesToCheck

    )

    $returnValue = $true

    if (($DesiredValues.GetType().Name -ne 'HashTable') `

            -and ($DesiredValues.GetType().Name -ne 'CimInstance') `

            -and ($DesiredValues.GetType().Name -ne 'PSBoundParametersDictionary')) {

        $errorMessage = $script:localizedData.PropertyTypeInvalidForDesiredValues -f $($DesiredValues.GetType().Name)

        New-InvalidArgumentException -ArgumentName 'DesiredValues' -Message $errorMessage

    }

    if (($DesiredValues.GetType().Name -eq 'CimInstance') -and ($null -eq $ValuesToCheck)) {

        $errorMessage = $script:localizedData.PropertyTypeInvalidForValuesToCheck

        New-InvalidArgumentException -ArgumentName 'ValuesToCheck' -Message $errorMessage

    }

    if (($null -eq $ValuesToCheck) -or ($ValuesToCheck.Count -lt 1)) {

        $keyList = $DesiredValues.Keys

    }

    else {

        $keyList = $ValuesToCheck

    }

    $keyList | ForEach-Object -Process {

        if (($_ -ne 'Verbose')) {

            if (($CurrentValues.ContainsKey($_) -eq $false) `

                    -or ($CurrentValues.$_ -ne $DesiredValues.$_) `

                    -or (($DesiredValues.GetType().Name -ne 'CimInstance' -and $DesiredValues.ContainsKey($_) -eq $true) -and ($null -ne $DesiredValues.$_ -and $DesiredValues.$_.GetType().IsArray))) {

                if ($DesiredValues.GetType().Name -eq 'HashTable' -or `

                        $DesiredValues.GetType().Name -eq 'PSBoundParametersDictionary') {

                    $checkDesiredValue = $DesiredValues.ContainsKey($_)

                }

                else {

                    # If DesiredValue is a CimInstance.

                    $checkDesiredValue = $false

                    if (([System.Boolean]($DesiredValues.PSObject.Properties.Name -contains $_)) -eq $true) {

                        if ($null -ne $DesiredValues.$_) {

                            $checkDesiredValue = $true

                        }

                    }

                }

                if ($checkDesiredValue) {

                    $desiredType = $DesiredValues.$_.GetType()

                    $fieldName = $_

                    if ($desiredType.IsArray -eq $true) {

                        if (($CurrentValues.ContainsKey($fieldName) -eq $false) `

                                -or ($null -eq $CurrentValues.$fieldName)) {

                            Write-Verbose -Message ($script:localizedData.PropertyValidationError -f $fieldName) -Verbose

                            $returnValue = $false

                        }

                        else {

                            $arrayCompare = Compare-Object -ReferenceObject $CurrentValues.$fieldName `

                                -DifferenceObject $DesiredValues.$fieldName

                            if ($null -ne $arrayCompare) {

                                Write-Verbose -Message ($script:localizedData.PropertiesDoesNotMatch -f $fieldName) -Verbose

                                $arrayCompare | ForEach-Object -Process {

                                    Write-Verbose -Message ($script:localizedData.PropertyThatDoesNotMatch -f $_.InputObject, $_.SideIndicator) -Verbose

                                }

                                $returnValue = $false

                            }

                        }

                    }

                    else {

                        switch ($desiredType.Name) {

                            'String' {

                                if (-not [System.String]::IsNullOrEmpty($CurrentValues.$fieldName) -or `

                                        -not [System.String]::IsNullOrEmpty($DesiredValues.$fieldName)) {

                                    Write-Verbose -Message ($script:localizedData.ValueOfTypeDoesNotMatch `

                                            -f $desiredType.Name, $fieldName, $($CurrentValues.$fieldName), $($DesiredValues.$fieldName)) -Verbose

                                    $returnValue = $false

                                }

                            }

                            'Int32' {

                                if (-not ($DesiredValues.$fieldName -eq 0) -or `

                                        -not ($null -eq $CurrentValues.$fieldName)) {

                                    Write-Verbose -Message ($script:localizedData.ValueOfTypeDoesNotMatch `

                                            -f $desiredType.Name, $fieldName, $($CurrentValues.$fieldName), $($DesiredValues.$fieldName)) -Verbose

                                    $returnValue = $false

                                }

                            }

                            { $_ -eq 'Int16' -or $_ -eq 'UInt16'} {

                                if (-not ($DesiredValues.$fieldName -eq 0) -or `

                                        -not ($null -eq $CurrentValues.$fieldName)) {

                                    Write-Verbose -Message ($script:localizedData.ValueOfTypeDoesNotMatch `

                                            -f $desiredType.Name, $fieldName, $($CurrentValues.$fieldName), $($DesiredValues.$fieldName)) -Verbose

                                    $returnValue = $false

                                }

                            }

                            default {

                                Write-Warning -Message ($script:localizedData.UnableToCompareProperty `

                                        -f $fieldName, $desiredType.Name)

                                $returnValue = $false

                            }

                        }

                    }

                }

            }

        }

    }

    return $returnValue

}

# SIG # Begin signature block

# MIIjhQYJKoZIhvcNAQcCoIIjdjCCI3ICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBH3QB1YDOZOOwJ

# V+KQVBF6PeRCZ7EOOlwmL67tD15ypKCCDYEwggX/MIID56ADAgECAhMzAAABUZ6N

# j0Bxow5BAAAAAAFRMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMTkwNTAyMjEzNzQ2WhcNMjAwNTAyMjEzNzQ2WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCVWsaGaUcdNB7xVcNmdfZiVBhYFGcn8KMqxgNIvOZWNH9JYQLuhHhmJ5RWISy1

# oey3zTuxqLbkHAdmbeU8NFMo49Pv71MgIS9IG/EtqwOH7upan+lIq6NOcw5fO6Os

# +12R0Q28MzGn+3y7F2mKDnopVu0sEufy453gxz16M8bAw4+QXuv7+fR9WzRJ2CpU

# 62wQKYiFQMfew6Vh5fuPoXloN3k6+Qlz7zgcT4YRmxzx7jMVpP/uvK6sZcBxQ3Wg

# B/WkyXHgxaY19IAzLq2QiPiX2YryiR5EsYBq35BP7U15DlZtpSs2wIYTkkDBxhPJ

# IDJgowZu5GyhHdqrst3OjkSRAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUV4Iarkq57esagu6FUBb270Zijc8w

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU0MTM1MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAWg+A

# rS4Anq7KrogslIQnoMHSXUPr/RqOIhJX+32ObuY3MFvdlRElbSsSJxrRy/OCCZdS

# se+f2AqQ+F/2aYwBDmUQbeMB8n0pYLZnOPifqe78RBH2fVZsvXxyfizbHubWWoUf

# NW/FJlZlLXwJmF3BoL8E2p09K3hagwz/otcKtQ1+Q4+DaOYXWleqJrJUsnHs9UiL

# crVF0leL/Q1V5bshob2OTlZq0qzSdrMDLWdhyrUOxnZ+ojZ7UdTY4VnCuogbZ9Zs

# 9syJbg7ZUS9SVgYkowRsWv5jV4lbqTD+tG4FzhOwcRQwdb6A8zp2Nnd+s7VdCuYF

# sGgI41ucD8oxVfcAMjF9YX5N2s4mltkqnUe3/htVrnxKKDAwSYliaux2L7gKw+bD

# 1kEZ/5ozLRnJ3jjDkomTrPctokY/KaZ1qub0NUnmOKH+3xUK/plWJK8BOQYuU7gK

# YH7Yy9WSKNlP7pKj6i417+3Na/frInjnBkKRCJ/eYTvBH+s5guezpfQWtU4bNo/j

# 8Qw2vpTQ9w7flhH78Rmwd319+YTmhv7TcxDbWlyteaj4RK2wk3pY1oSz2JPE5PNu

# Nmd9Gmf6oePZgy7Ii9JLLq8SnULV7b+IP0UXRY9q+GdRjM2AEX6msZvvPCIoG0aY

# HQu9wZsKEK2jqvWi8/xdeeeSI9FN6K1w4oVQM4Mwggd6MIIFYqADAgECAgphDpDS

# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla

# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT

# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG

# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S

# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz

# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7

# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u

# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33

# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl

# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP

# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB

# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF

# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM

# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ

# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud

# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO

# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0

# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw

# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA

# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY

# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj

# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd

# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ

# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf

# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ

# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j

# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B

# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96

# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7

# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I

# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVWjCCFVYCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAVGejY9AcaMOQQAAAAABUTAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgAchP/Cco

# Y2JAjut9Hy3IC65/Rf67ea66bxFJosTcn0EwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQAIgveDB911fnhUMCwzY+/rM4o1tT6rKpAY3xo9x2sK

# NyOXMfXd4rXVpEqUiluP0Xx56OpmyFWXYfUlKdcaOtOERB+ZatHvRy3BfIg6X81F

# gUusnOUF9Xe237YUOdbaKFicSJphsjKNX/IOhFTkxXEhoZJYlnQhm1Fwbr/WkiRX

# w2T/03tjIcgcYtapwMGtPWzhgyGW0aVYfL8g1Pi9WPbsYhf2rwjwp1hB6Xjo7asx

# NQBXKJXchNZSPRjD2N4y7Cw5itTlNKXRIvDKhjpTNpjc6cQ1mCW5isO26FFZqipM

# V/dGH9FkcoFWRiYShO61tEUTTGq+T98ByoWEJi/zgUowoYIS5DCCEuAGCisGAQQB

# gjcDAwExghLQMIISzAYJKoZIhvcNAQcCoIISvTCCErkCAQMxDzANBglghkgBZQME

# AgEFADCCAVAGCyqGSIb3DQEJEAEEoIIBPwSCATswggE3AgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIC/kxGVUD9dHj97p1ebOvAvua7/KO9KXvMwYjoQX

# Yqt4AgZdQhNBSAMYEjIwMTkwODE2MjM0NDA1Ljk4WjAEgAIB9KCB0KSBzTCByjEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWlj

# cm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBF

# U046OEE4Mi1FMzRGLTlEREExJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFNlcnZpY2Wggg48MIIE8TCCA9mgAwIBAgITMwAAAPC8X5uus0z/JQAAAAAA8DAN

# BgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0x

# ODEwMjQyMTE0MjJaFw0yMDAxMTAyMTE0MjJaMIHKMQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBP

# cGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4QTgyLUUzNEYtOURE

# QTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCASIwDQYJ

# KoZIhvcNAQEBBQADggEPADCCAQoCggEBAOA0NU1qxnJpypqn3MG2wgRaYZZ2QnGc

# wAj3sxQZhdUB+lCsJVsz1hRfTIiiQP4pwyRnQCsHQHRFuE4jurcQZ9MeRF/Yuff0

# D1FmdVOFHJzN/Q+oNiX+6lotA9ePVpHvQbCN8xRhfqcQAiSsK843a79AUqGsjCd3

# VWJWr+1znoDWsqPSYXPRNxKTpP8DMN87Is0ct5rEOEIhf1Y/Cmvqxk+/YPVltkCR

# Ju2GXm9Q1gV23E3H+FpMKmjYWgf1+/jMnJJ8Kdxcn+zL6RoFdVe0tPmPaA9BgZhx

# 6x/QESPlfkghNO+UxWPWl5VazwIjn5hE+o11ksaggZjbtYgz6LQ2MZMCAwEAAaOC

# ARswggEXMB0GA1UdDgQWBBTbonpzo/dOODGJO5JviAP5lgJM0TAfBgNVHSMEGDAW

# gBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8v

# Y3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNUaW1TdGFQQ0Ff

# MjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0YVBDQV8yMDEw

# LTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0G

# CSqGSIb3DQEBCwUAA4IBAQBtMugaDn3fBCBZuRHoCQBfvJu/w38RvEldFdf32nb/

# gjeewZwVpMpkqENn4PLNZYU2g4gmGtbEeta8tJeyXTGKWGme1vmjKG/CRdRiav3q

# EPtDzBRPh30u7j09X+y0LPQGvXiKJw6fpMJ4u7yR6I9Bnw9l4DeD794iBPx6CvKG

# /abyL6p+jABu4S0ckiEf8xjcm+jqxfYY2fkJSAumYqdjVx4egxyEkBRv2rM/Z9eS

# eKWa8GM2o866RWtPPWG7dHJc1nV50gvXEZp4IAr9WCuT3BLlJdkgO+4kdtj2+oCK

# DBzwOTRewcHXKINOZxBSdrAwMmNm20sGFdNq8uJinTSsMIIGcTCCBFmgAwIBAgIK

# YQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcNMjUwNzAxMjE0

# NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIwDQYJKoZIhvcN

# AQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0VBDVpQoAgoX7

# 7XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEwRA/xYIiEVEMM

# 1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQedGFnkV+BVLHP

# k0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKxXf13Hz3wV3Ws

# vYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4GkbaICDXoeByw

# 6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEAAaOCAeYwggHi

# MBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7fEYbxTNoWoVt

# VTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0T

# AQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNV

# HR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9w

# cm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEE

# TjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2Nl

# cnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0gAQH/BIGVMIGS

# MIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYBBQUHAgIwNB4y

# IB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUAbQBlAG4AdAAu

# IB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOhIW+z66bM9TG+

# zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS+7lTjMz0YBKK

# dsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlKkVIArzgPF/Uv

# eYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon/VWvL/625Y4z

# u2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOiPPp/fZZqkHim

# bdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/fmNZJQ96LjlX

# dqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCIIYdqwUB5vvfHh

# AN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0cs0d9LiFAR6A

# +xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7aKLixqduWsqdC

# osnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQcdeh0sVV42ne

# V8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+NR4Iuto229Nf

# j950iEkSoYICzjCCAjcCAQEwgfihgdCkgc0wgcoxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9w

# ZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjhBODItRTM0Ri05RERB

# MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYF

# Kw4DAhoDFQANNgeEcQurwQBjEGIfgqElBgszv6CBgzCBgKR+MHwxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBBQUAAgUA4QGpiTAiGA8yMDE5

# MDgxNzA2MTUzN1oYDzIwMTkwODE4MDYxNTM3WjB3MD0GCisGAQQBhFkKBAExLzAt

# MAoCBQDhAamJAgEAMAoCAQACAhanAgH/MAcCAQACAhIEMAoCBQDhAvsJAgEAMDYG

# CisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEA

# AgMBhqAwDQYJKoZIhvcNAQEFBQADgYEAjSoH3BEQxk1fe0gNA2AbOJi2GlxxuSme

# Fo2ZYG90SxLnSsLyrS6hEkUJ8ACfNB7EwHBzN5D10aEuFNklSJ/PMPuWaSGuEOSY

# hNHAxK2Q+6jvwoypjJSRodPk3G5fXo2xhho0TgmtL5GMvTqHVb9pLrhrOK/IFdDC

# Yub/CnAZIm8xggMNMIIDCQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMAITMwAAAPC8X5uus0z/JQAAAAAA8DANBglghkgBZQMEAgEFAKCCAUowGgYJ

# KoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCAmkxY+yiyV

# 3VtQGjHv8P73pBt9y6sB0p6jsiDAOG7PMjCB+gYLKoZIhvcNAQkQAi8xgeowgecw

# geQwgb0EIAzeQWn9L0RuSHnOeDxwpXTczaNhlyt9V/TLVBiWxgCQMIGYMIGApH4w

# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAADwvF+brrNM/yUAAAAA

# APAwIgQgETbv5U5AVs3k5eCY1nsK3QZ7J0P+Ffj4t0Nbbmq+EoswDQYJKoZIhvcN

# AQELBQAEggEANsry7x3JVhFK7wbiSMt2CwWRurqfWJxUFDbxK0MMs/kOVeBTSEh6

# HPRB0gf+JIjkkkpwPInThJWASgBEweit5ZfycyuNg8LOxRYDiAd5JD/bylj9I8Ek

# S6xzNvQ5FY3dDZlEqb8tpUrHhl6q2CUbXV/ekdA//jl0Z6PadZ4iOei9ZSER6J+K

# wnF89jODHHmj5+WENvA71ASwb7uFOJm1pWq1R2MeAtPfgnmke9HTvn7ZzJ87Vs98

# fZSY4caNeOARXGbdnqFou0JRcNH+LOp4KP5ACivTqyMpslFt8bi6Ln01y+b3gBSk

# B8pCKhvyTE2FPAGFGLQMtcr6Ikwzk9B+OA==

# SIG # End signature block