DSCResources/VE_XD7StoreFrontStore/VE_XD7StoreFrontStore.psm1

<#
    ===========================================================================
     Created with: SAPIEN Technologies, Inc., PowerShell Studio 2019 v5.6.157
     Created on: 2/8/2019 12:12 PM
     Created by: CERBDM
     Organization:
     Filename: VE_XD7StoreFrontStore.psm1
    -------------------------------------------------------------------------
     Module Name: VE_XD7StoreFrontStore
    ===========================================================================
#>



#TODO: Test switching auth - See TODOs below

Import-LocalizedData -BindingVariable localizedData -FileName VE_XD7StoreFrontStore.Resources.psd1;

function Get-TargetResource {
    [CmdletBinding()]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSDSCUseVerboseMessageInDSCResource', '')]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingEmptyCatchBlock', '')]
    [OutputType([System.Collections.Hashtable])]
    param (
        [Parameter(Mandatory = $true)]
        [System.String]
        $StoreName,

        [Parameter(Mandatory = $true)]
        [System.String]
        $FarmName,

        [Parameter(Mandatory = $true)]
        [ValidateSet('Explicit','Anonymous')]
        [System.String]
        $AuthType,

        [Parameter(Mandatory = $true)]
        [System.String[]]
        $Servers
    )
    process {

        Import-Module Citrix.StoreFront -ErrorAction Stop -Verbose:$false;

        $StoreService = Get-STFStoreService -Verbose | Where-Object { $_.friendlyname -eq $StoreName };
        if ($StoreService) {
            ## This is a hack, as Get-STFStoreFarm throws an error if run twice in quick succession?!
            $null = Get-STFStoreFarm -StoreService $StoreService -FarmName $FarmName -Verbose -OutVariable StoreFarm
        }

        switch ($StoreService.service.Anonymous) {
            $True { $CurrentAuthType = 'Anonymous' }
            $False { $CurrentAuthType = 'Explicit' }
        }

        $targetResource = @{
            StoreName = $StoreService.FriendlyName
            FarmName = $StoreFarm.FarmName
            Port = $StoreFarm.Port
            TransportType = $StoreFarm.TransportType
            Servers = [System.String[]]$StoreFarm.Servers
            LoadBalance = $StoreFarm.LoadBalance
            FarmType = $StoreFarm.FarmType
            AuthType = $CurrentAuthType
            AuthVirtualPath = $StoreService.AuthenticationServiceVirtualPath
            StoreVirtualPath = $StoreService.VirtualPath
            SiteId = $StoreService.SiteId
            ServiceUrls = [System.String[]]$StoreFarm.ServiceUrls
            SSLRelayPort = $StoreFarm.SSLRelayPort
            AllFailedBypassDuration = $StoreFarm.AllFailedBypassDuration
            BypassDuration = $StoreFarm.BypassDuration
            FriendlyName = $StoreService.FriendlyName
            Zones = $StoreFarm.Zones
            LockedDown = $storeservice.service.LockedDown
        };

        return $targetResource;

    } #end process
} #end function Get-TargetResource


function Test-TargetResource {
    [CmdletBinding()]
    [OutputType([System.Boolean])]
    param (
        [Parameter(Mandatory = $true)]
        [System.String]
        $StoreName,

        [Parameter(Mandatory = $true)]
        [ValidateSet("Explicit","Anonymous")]
        [System.String]
        $AuthType,

        [Parameter(Mandatory = $true)]
        [System.String[]]
        $Servers,

        [Parameter(Mandatory = $true)]
        [System.String]
        $FarmName,

        [Parameter()]
        [System.UInt32]
        $Port,

        [Parameter()]
        [ValidateSet('HTTP','HTTPS','SSL')]
        [System.String]
        $TransportType,

        [Parameter()]
        [System.Boolean]
        $LoadBalance,

        [Parameter()]
        [ValidateSet('XenApp','XenDesktop','AppController')]
        [System.String]
        $FarmType,

        [Parameter()]
        [System.String]
        $AuthVirtualPath = "/Citrix/$($StoreName)auth",

        [Parameter()]
        [System.String]
        $StoreVirtualPath = "/Citrix/$($StoreName)",

        [Parameter()]
        [System.UInt64]
        $SiteId = 1,

        [Parameter()]
        [System.String[]]
        $ServiceUrls,

        [Parameter()]
        [System.UInt32]
        $SSLRelayPort,

        [Parameter()]
        [System.UInt32]
        $AllFailedBypassDuration,

        [Parameter()]
        [System.UInt32]
        $BypassDuration,

        [Parameter()]
        [System.String[]]
        $Zones,

        [Parameter()]
        [System.Boolean]
        $LockedDown,

        [Parameter()]
        [ValidateSet('Present','Absent')]
        [System.String]
        $Ensure = 'Present'
    )
    process {

        $targetResource = Get-TargetResource -StoreName $StoreName -AuthType $AuthType -FarmName $FarmName -Servers $Servers
        if ($Ensure -eq 'Present') {
            $inCompliance = $true;
            foreach ($property in $PSBoundParameters.Keys) {

                if ($targetResource.ContainsKey($property)) {

                    $expected = $PSBoundParameters[$property];
                    $actual = $targetResource[$property];
                    if ($PSBoundParameters[$property] -is [System.String[]]) {
                        if ($actual) {
                            if (Compare-Object -ReferenceObject $expected -DifferenceObject $actual -ErrorAction silentlycontinue) {
                                Write-Verbose ($localizedData.ResourcePropertyMismatch -f $property, ($expected -join ','), ($actual -join ','));
                                $inCompliance = $false;
                            }
                        }
                        else {
                            Write-Verbose ($localizedData.ResourcePropertyMismatch -f $property, ($expected -join ','), ($actual -join ','));
                            $inCompliance = $false;
                        }
                    }
                    elseif ($expected -ne $actual) {

                        Write-Verbose ($localizedData.ResourcePropertyMismatch -f $property, $expected, $actual);
                        $inCompliance = $false;
                    }
                }

            }
        }
        else {
            if ($targetResource.StoreName) {
                $inCompliance = $false
            }
            else {
                $inCompliance = $true
            }
        }

        if ($inCompliance) {
            Write-Verbose ($localizedData.ResourceInDesiredState);
        }
        else {
            Write-Verbose ($localizedData.ResourceNotInDesiredState);
        }

        return $inCompliance;

    } #end process
} #end function Test-TargetResource


function Set-TargetResource {
    [CmdletBinding()]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingEmptyCatchBlock', '')]
    param (
        [Parameter(Mandatory = $true)]
        [System.String]
        $StoreName,

        [Parameter(Mandatory = $true)]
        [ValidateSet('Explicit','Anonymous')]
        [System.String]
        $AuthType,

        [Parameter(Mandatory = $true)]
        [System.String[]]
        $Servers,

        [Parameter(Mandatory = $true)]
        [System.String]
        $FarmName,

        [Parameter()]
        [System.UInt32]
        $Port,

        [Parameter()]
        [ValidateSet('HTTP','HTTPS','SSL')]
        [System.String]
        $TransportType,

        [parameter()]
        [System.Boolean]
        $LoadBalance,

        [Parameter()]
        [ValidateSet('XenApp','XenDesktop','AppController')]
        [System.String]
        $FarmType,

        [Parameter()]
        [System.String]
        $AuthVirtualPath = "/Citrix/$($StoreName)auth",

        [Parameter()]
        [System.String]
        $StoreVirtualPath = "/Citrix/$($StoreName)",

        [Parameter()]
        [System.UInt64]
        $SiteId = 1,

        [Parameter()]
        [System.String[]]
        $ServiceUrls,

        [Parameter()]
        [System.UInt32]
        $SSLRelayPort,

        [Parameter()]
        [System.UInt32]
        $AllFailedBypassDuration,

        [Parameter()]
        [System.UInt32]
        $BypassDuration,

        [Parameter()]
        [System.String[]]
        $Zones,

        [Parameter()]
        [System.Boolean]
        $LockedDown,

        [Parameter()]
        [ValidateSet('Present','Absent')]
        [System.String]
        $Ensure = 'Present'
    )
    process {

        Import-Module Citrix.StoreFront -ErrorAction Stop -Verbose:$false
        $StoreService = Get-STFStoreService | Where-Object { $_.friendlyname -eq $StoreName }
        if ($StoreService) {
            ## This is a hack, as Get-STFStoreFarm throws an error if run twice in quick succession?!
            $null = Get-STFStoreFarm -StoreService $StoreService -FarmName $FarmName -Verbose -OutVariable StoreFarm
        }

        if ($Ensure -eq 'Present') {

            #Region Create Params hashtable
            $AllParams = @{}
            $ChangedParams = @{}
            $targetResource = Get-TargetResource -StoreName $StoreName -AuthType $AuthType -Servers $Servers -FarmName $FarmName
            foreach ($property in $PSBoundParameters.Keys) {
                if ($targetResource.ContainsKey($property)) {
                    if (!($AllParams.ContainsKey($property))) {
                        $AllParams.Add($property, $PSBoundParameters[$property])
                    }
                    $expected = $PSBoundParameters[$property];
                    $actual = $targetResource[$property];
                    if ($PSBoundParameters[$property] -is [System.String[]]) {
                        if ($actual) {
                            if (Compare-Object -ReferenceObject $expected -DifferenceObject $actual) {
                                if (!($ChangedParams.ContainsKey($property))) {
                                    Write-Verbose -Message ($localizedData.SettingResourceProperty -f $property)
                                    $ChangedParams.Add($property, $PSBoundParameters[$property])
                                }
                            }
                        }
                        Else {
                            Write-Verbose -Message ($localizedData.SettingResourceProperty -f $property)
                            $ChangedParams.Add($property, $PSBoundParameters[$property])
                        }
                    }
                    elseif ($expected -ne $actual) {
                        if (!($ChangedParams.ContainsKey($property))) {
                            Write-Verbose -Message ($localizedData.SettingResourceProperty -f $property)
                            $ChangedParams.Add($property, $PSBoundParameters[$property])
                        }
                    }
                }
            }
            $AllParams.Remove('StoreName')
            $ChangedParams.Remove('StoreName')
            $AllParams.Remove('LockedDown')
            if ($FarmName.Length -gt 0) {

                $FarmNameParam = $FarmName
            }
            elseif ($StoreFarm.FarmName.length -gt 0) {

                $FarmNameParam = $StoreFarm.FarmName
            }
            else {

                $FarmNameParam = "$($StoreName)farm"
            }

            if (!($AllParams.ContainsKey('FarmName'))) {
                $AllParams.Add('FarmName', $FarmNameParam)
            }
            if (!($ChangedParams.ContainsKey('FarmName'))) {
                $ChangedParams.Add('FarmName', $FarmNameParam)
            }
            #endregion

            #Region Check for Authentication service - create if needed
            $AllParams.Remove('AuthType')
            $AllParams.Remove("AuthVirtualPath")
            if ($AuthType -eq 'Anonymous') {
                $AllParams.Add('Anonymous', $true)
                $ChangedAuth = 'Anonymous'
            }
            else {
                $Auth = Get-STFAuthenticationService -VirtualPath $AuthVirtualPath -SiteID $SiteId
                if ($Auth.VirtualPath -ne $AuthVirtualPath) {

                    Write-Verbose -Message $localizedData.RunningAddSTFAuthenticationService
                    $Auth = Add-STFAuthenticationService -VirtualPath $AuthVirtualPath -SiteID $SiteId -confirm:$false
                }
                $AllParams.Add('AuthenticationService', $Auth)
                $ChangedAuth = $Auth
            }
            #endregion

            #Region Add Servers value if not exist
            if (!($ChangedParams.ContainsKey('Servers'))) {
                $ChangedParams.Add('Servers', $Servers)
            }
            #endregion

            if ($StoreService.friendlyName -eq $StoreName) {
                if ($ChangedParams.ContainsKey('AuthType')) {
                    $ChangedParams.Remove('AuthType')
                    if ($ChangedAuth -eq 'Anonymous') {
                        $Auth = Get-STFAuthenticationService -VirtualPath $StoreService.AuthenticationServiceVirtualPath -SiteID $StoreService.SiteId
                        if ($Auth) {
                            #TODO: What do you do here? The following doesn't work since it's in use
                            #Write-Verbose "Running Remove-STFAuthenticationService"
                            #$Auth | Remove-STFAuthenticationService -confirm:$false
                        }
                    }
                    else {
                        #TODO: Fix this. It gets following error
                            #set-stfstoreservice : An error occurred while updating the Store service:
                            # System.NullReferenceException: Object reference not set to an instance of an object.
                            # at
                            #Citrix.StoreFront.Model.Store.StoreService.Citrix.StoreFront.Model.IAuthenticatedService.RemoveAuthenticationService(AuthenticationServiceauthenticationService)
                            # at Citrix.StoreFront.Stores.Cmdlets.SetStoreService.ProcessRecord().
                            #At line:1 char:1
                        #Write-Verbose "Running Set-STFStoreService"
                        #Set-STFStoreService -StoreService $StoreService -AuthenticationService $Auth -Confirm:$false
                    }
                }
                if ($ChangedParams.ContainsKey('LockedDown')) {
                    Write-Verbose -Message $localizedData.RunningSetSTFStoreService
                    Set-STFStoreService -StoreService $StoreService -LockedDown $LockedDown -confirm:$false
                    $ChangedParams.Remove('LockedDown')
                }

                If ($ChangedParams.ContainsKey('AuthVirtualPath')) {
                    $ChangedParams.Remove('AuthVirtualPath')
                }
                if ($StoreFarm) {
                    #update params
                    $ChangedParams.Add('StoreService', $StoreService)

                    #Update settings
                    Write-Verbose -Message $localizedData.RunningSetSTFStoreFarm
                    Set-STFStoreFarm @ChangedParams -confirm:$false
                }
                else {
                    #update params
                    $KeysToRemove = 'AuthenticationService','Anonymous'
                    $KeysToRemove | ForEach-Object { $AllParams.Remove($_) }

                    #Create farm
                    Write-Verbose -Message $localizedData.RunningNewSTFStoreFarm
                    New-STFStoreFarm @AllParams -confirm:$false
                    #Add farm to storeservice
                    Write-Verbose -Message $localizedData.RunningAddSTFStoreFarm
                    $StoreService = Get-STFStoreService | Where-Object { $_.friendlyname -eq $StoreName }
                    Add-STFStoreFarm -Farm $AllParams.FarmName -StoreService $StoreService
                }
            }
            else {
                #update params
                $AllParams.Add('FriendlyName', $StoreName)
                $AllParams.Add('VirtualPath', $StoreVirtualPath)
                $AllParams.Add('SiteId', $SiteId)

                #Create
                Write-Verbose -Message $localizedData.RunningAddSTFStoreService
                Add-STFStoreService @AllParams -confirm:$false

                if ($ChangedParams.ContainsKey('LockedDown')) {
                    #This setting isn't available to be set via the Add-STFStoreService
                    Write-Verbose -Message $localizedData.RunningSetSTFStoreFarmLockedDown
                    $StoreService = Get-STFStoreService | Where-Object { $_.friendlyname -eq $StoreName }
                    Set-STFStoreService -StoreService $StoreService -LockedDown $LockedDown -confirm:$false
                }

            }
        }
        else {
            #Uninstall
            Write-Verbose -Message $localizedData.RunningRemoveSTFStoreService
            $AuthVirtPath = $StoreService.AuthenticationServiceVirtualPath
            $SiteId = $StoreService.SiteId
            $StoreService | Remove-STFStoreService -confirm:$false
            Write-Verbose -Message ($localizedData.RunningGetSTFAuthenticationService -f $AuthVirtPath)
            $Auth = Get-STFAuthenticationService -VirtualPath $AuthVirtPath -SiteID $SiteId
            if ($Auth) {
                Write-Verbose -Message $localizedData.RunningRemoveSTFAuthenticationService
                $Auth | Remove-STFAuthenticationService -confirm:$false
            }
        }

    } #end process
} #end function Set-TargetResource


Export-ModuleMember -Function *-TargetResource;

# SIG # Begin signature block
# MIIcawYJKoZIhvcNAQcCoIIcXDCCHFgCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUGxEBxdxK7qc8layjrx+UYktF
# UX6ggheaMIIFIzCCBAugAwIBAgIQAsbTxa4q6RSRmx0hkVyicTANBgkqhkiG9w0B
# AQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD
# VQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFz
# c3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMB4XDTE5MDcwMzAwMDAwMFoXDTIxMTEw
# MzEyMDAwMFowYDELMAkGA1UEBhMCR0IxDzANBgNVBAcTBkxvbmRvbjEfMB0GA1UE
# ChMWVmlydHVhbCBFbmdpbmUgTGltaXRlZDEfMB0GA1UEAxMWVmlydHVhbCBFbmdp
# bmUgTGltaXRlZDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ/s4NME
# JLA1Aji4EHJ85uwyEEAepndYn1X8pRnGkOlTzVHITAeH7BQnehjbNwCj7MHUPTSM
# zSucXhyfaMZthCNYtugyZ2uU4uVjB1f3xdmXXFX+aukMYgCk1ZQFbQMBqbzRY4Cl
# DwlLNGVEjDJeLBUL6ciIETqDc27YLg772WLpuvIXne13EYXN422Y83XRqEMf4v9S
# 398S8MRk5qdasRtxYZY6GciZZQnAL/XObpXDM3tDFgcQuyGcZttRuXVZXEj+mlY8
# gUIzkSJ0aJn1pVVTsa+tCvAZuJMJwdPhyM7NUa7Ysm7n9qdF7BvcrWBmaYRfDyya
# lLwRoOcI2HVodX8CAwEAAaOCAcUwggHBMB8GA1UdIwQYMBaAFFrEuXsqCqOl6nED
# wGD5LfZldQ5YMB0GA1UdDgQWBBSDFWXl70FjVfl8IBwATpE46qvGeDAOBgNVHQ8B
# Af8EBAMCB4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYDVR0fBHAwbjA1oDOgMYYv
# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmww
# NaAzoDGGL2h0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3Mt
# ZzEuY3JsMEwGA1UdIARFMEMwNwYJYIZIAYb9bAMBMCowKAYIKwYBBQUHAgEWHGh0
# dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCAYGZ4EMAQQBMIGEBggrBgEFBQcB
# AQR4MHYwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBOBggr
# BgEFBQcwAoZCaHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hB
# MkFzc3VyZWRJRENvZGVTaWduaW5nQ0EuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZI
# hvcNAQELBQADggEBAJ1VZZNMAy8KyQLBqwRWAWDqcOxjVly6FTIeqO2/ul9rEYm8
# B9mNx60/AL+TbTbUwBzia2pwBuIin70eClZHFstvQcASBbB0k14R/rs+jestfFRm
# rsEz272POc6vsKce3TOlqBc2rtvVyuUPRvI2yQm1WYTpOgQnnp3ix2LBd+fgRANs
# P9yurvnGdEFFzToFDXFVkFHBQ9Pr5tAb4i7ZkSFC52BtB7NVuoiH83lx07SyjIxU
# 11ELEDZBpO3HiTsTzbhPAEw4CP++ONK8fieWZevDK9DFEiNIC0gWL/DH1+c7eihO
# oJdJqRAT9wkAMIjcskZ5LObGvMst/hqwBewpLzYwggUwMIIEGKADAgECAhAECRgb
# X9W7ZnVTQ7VvlVAIMA0GCSqGSIb3DQEBCwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYD
# VQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAi
# BgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0xMzEwMjIxMjAw
# MDBaFw0yODEwMjIxMjAwMDBaMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdp
# Q2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERp
# Z2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqG
# SIb3DQEBAQUAA4IBDwAwggEKAoIBAQD407Mcfw4Rr2d3B9MLMUkZz9D7RZmxOttE
# 9X/lqJ3bMtdx6nadBS63j/qSQ8Cl+YnUNxnXtqrwnIal2CWsDnkoOn7p0WfTxvsp
# J8fTeyOU5JEjlpB3gvmhhCNmElQzUHSxKCa7JGnCwlLyFGeKiUXULaGj6YgsIJWu
# HEqHCN8M9eJNYBi+qsSyrnAxZjNxPqxwoqvOf+l8y5Kh5TsxHM/q8grkV7tKtel0
# 5iv+bMt+dDk2DZDv5LVOpKnqagqrhPOsZ061xPeM0SAlI+sIZD5SlsHyDxL0xY4P
# waLoLFH3c7y9hbFig3NBggfkOItqcyDQD2RzPJ6fpjOp/RnfJZPRAgMBAAGjggHN
# MIIByTASBgNVHRMBAf8ECDAGAQH/AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUE
# DDAKBggrBgEFBQcDAzB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6
# Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMu
# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0f
# BHoweDA6oDigNoY0aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNz
# dXJlZElEUm9vdENBLmNybDA6oDigNoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29t
# L0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDBPBgNVHSAESDBGMDgGCmCGSAGG
# /WwAAgQwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQ
# UzAKBghghkgBhv1sAzAdBgNVHQ4EFgQUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHwYD
# VR0jBBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8wDQYJKoZIhvcNAQELBQADggEB
# AD7sDVoks/Mi0RXILHwlKXaoHV0cLToaxO8wYdd+C2D9wz0PxK+L/e8q3yBVN7Dh
# 9tGSdQ9RtG6ljlriXiSBThCk7j9xjmMOE0ut119EefM2FAaK95xGTlz/kLEbBw6R
# Ffu6r7VRwo0kriTGxycqoSkoGjpxKAI8LpGjwCUR4pwUR6F6aGivm6dcIFzZcbEM
# j7uo+MUSaJ/PQMtARKUT8OZkDCUIQjKyNookAv4vcn4c10lFluhZHen6dGRrsutm
# Q9qzsIzV6Q3d9gEgzpkxYz0IGhizgZtPxpMQBvwHgfqL2vmCSfdibqFT+hKUGIUu
# kpHqaGxEMrJmoecYpJpkUe8wggZqMIIFUqADAgECAhADAZoCOv9YsWvW1ermF/Bm
# MA0GCSqGSIb3DQEBBQUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy
# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD
# ZXJ0IEFzc3VyZWQgSUQgQ0EtMTAeFw0xNDEwMjIwMDAwMDBaFw0yNDEwMjIwMDAw
# MDBaMEcxCzAJBgNVBAYTAlVTMREwDwYDVQQKEwhEaWdpQ2VydDElMCMGA1UEAxMc
# RGlnaUNlcnQgVGltZXN0YW1wIFJlc3BvbmRlcjCCASIwDQYJKoZIhvcNAQEBBQAD
# ggEPADCCAQoCggEBAKNkXfx8s+CCNeDg9sYq5kl1O8xu4FOpnx9kWeZ8a39rjJ1V
# +JLjntVaY1sCSVDZg85vZu7dy4XpX6X51Id0iEQ7Gcnl9ZGfxhQ5rCTqqEsskYnM
# Xij0ZLZQt/USs3OWCmejvmGfrvP9Enh1DqZbFP1FI46GRFV9GIYFjFWHeUhG98oO
# jafeTl/iqLYtWQJhiGFyGGi5uHzu5uc0LzF3gTAfuzYBje8n4/ea8EwxZI3j6/oZ
# h6h+z+yMDDZbesF6uHjHyQYuRhDIjegEYNu8c3T6Ttj+qkDxss5wRoPp2kChWTrZ
# FQlXmVYwk/PJYczQCMxr7GJCkawCwO+k8IkRj3cCAwEAAaOCAzUwggMxMA4GA1Ud
# DwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI
# MIIBvwYDVR0gBIIBtjCCAbIwggGhBglghkgBhv1sBwEwggGSMCgGCCsGAQUFBwIB
# FhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BTMIIBZAYIKwYBBQUHAgIwggFW
# HoIBUgBBAG4AeQAgAHUAcwBlACAAbwBmACAAdABoAGkAcwAgAEMAZQByAHQAaQBm
# AGkAYwBhAHQAZQAgAGMAbwBuAHMAdABpAHQAdQB0AGUAcwAgAGEAYwBjAGUAcAB0
# AGEAbgBjAGUAIABvAGYAIAB0AGgAZQAgAEQAaQBnAGkAQwBlAHIAdAAgAEMAUAAv
# AEMAUABTACAAYQBuAGQAIAB0AGgAZQAgAFIAZQBsAHkAaQBuAGcAIABQAGEAcgB0
# AHkAIABBAGcAcgBlAGUAbQBlAG4AdAAgAHcAaABpAGMAaAAgAGwAaQBtAGkAdAAg
# AGwAaQBhAGIAaQBsAGkAdAB5ACAAYQBuAGQAIABhAHIAZQAgAGkAbgBjAG8AcgBw
# AG8AcgBhAHQAZQBkACAAaABlAHIAZQBpAG4AIABiAHkAIAByAGUAZgBlAHIAZQBu
# AGMAZQAuMAsGCWCGSAGG/WwDFTAfBgNVHSMEGDAWgBQVABIrE5iymQftHt+ivlcN
# K2cCzTAdBgNVHQ4EFgQUYVpNJLZJMp1KKnkag0v0HonByn0wfQYDVR0fBHYwdDA4
# oDagNIYyaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElE
# Q0EtMS5jcmwwOKA2oDSGMmh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2Vy
# dEFzc3VyZWRJRENBLTEuY3JsMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYY
# aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2Fj
# ZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURDQS0xLmNydDANBgkq
# hkiG9w0BAQUFAAOCAQEAnSV+GzNNsiaBXJuGziMgD4CH5Yj//7HUaiwx7ToXGXEX
# zakbvFoWOQCd42yE5FpA+94GAYw3+puxnSR+/iCkV61bt5qwYCbqaVchXTQvH3Gw
# g5QZBWs1kBCge5fH9j/n4hFBpr1i2fAnPTgdKG86Ugnw7HBi02JLsOBzppLA044x
# 2C/jbRcTBu7kA7YUq/OPQ6dxnSHdFMoVXZJB2vkPgdGZdA0mxA5/G7X1oPHGdwYo
# FenYk+VVFvC7Cqsc21xIJ2bIo4sKHOWV2q7ELlmgYd3a822iYemKC23sEhi991VU
# QAOSK2vCUcIKSK+w1G7g9BQKOhvjjz3Kr2qNe9zYRDCCBs0wggW1oAMCAQICEAb9
# +QOWA63qAArrPye7uhswDQYJKoZIhvcNAQEFBQAwZTELMAkGA1UEBhMCVVMxFTAT
# BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEk
# MCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTA2MTExMDAw
# MDAwMFoXDTIxMTExMDAwMDAwMFowYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERp
# Z2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMY
# RGlnaUNlcnQgQXNzdXJlZCBJRCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
# MIIBCgKCAQEA6IItmfnKwkKVpYBzQHDSnlZUXKnE0kEGj8kz/E1FkVyBn+0snPgW
# Wd+etSQVwpi5tHdJ3InECtqvy15r7a2wcTHrzzpADEZNk+yLejYIA6sMNP4YSYL+
# x8cxSIB8HqIPkg5QycaH6zY/2DDD/6b3+6LNb3Mj/qxWBZDwMiEWicZwiPkFl32j
# x0PdAug7Pe2xQaPtP77blUjE7h6z8rwMK5nQxl0SQoHhg26Ccz8mSxSQrllmCsSN
# vtLOBq6thG9IhJtPQLnxTPKvmPv2zkBdXPao8S+v7Iki8msYZbHBc63X8djPHgp0
# XEK4aH631XcKJ1Z8D2KkPzIUYJX9BwSiCQIDAQABo4IDejCCA3YwDgYDVR0PAQH/
# BAQDAgGGMDsGA1UdJQQ0MDIGCCsGAQUFBwMBBggrBgEFBQcDAgYIKwYBBQUHAwMG
# CCsGAQUFBwMEBggrBgEFBQcDCDCCAdIGA1UdIASCAckwggHFMIIBtAYKYIZIAYb9
# bAABBDCCAaQwOgYIKwYBBQUHAgEWLmh0dHA6Ly93d3cuZGlnaWNlcnQuY29tL3Nz
# bC1jcHMtcmVwb3NpdG9yeS5odG0wggFkBggrBgEFBQcCAjCCAVYeggFSAEEAbgB5
# ACAAdQBzAGUAIABvAGYAIAB0AGgAaQBzACAAQwBlAHIAdABpAGYAaQBjAGEAdABl
# ACAAYwBvAG4AcwB0AGkAdAB1AHQAZQBzACAAYQBjAGMAZQBwAHQAYQBuAGMAZQAg
# AG8AZgAgAHQAaABlACAARABpAGcAaQBDAGUAcgB0ACAAQwBQAC8AQwBQAFMAIABh
# AG4AZAAgAHQAaABlACAAUgBlAGwAeQBpAG4AZwAgAFAAYQByAHQAeQAgAEEAZwBy
# AGUAZQBtAGUAbgB0ACAAdwBoAGkAYwBoACAAbABpAG0AaQB0ACAAbABpAGEAYgBp
# AGwAaQB0AHkAIABhAG4AZAAgAGEAcgBlACAAaQBuAGMAbwByAHAAbwByAGEAdABl
# AGQAIABoAGUAcgBlAGkAbgAgAGIAeQAgAHIAZQBmAGUAcgBlAG4AYwBlAC4wCwYJ
# YIZIAYb9bAMVMBIGA1UdEwEB/wQIMAYBAf8CAQAweQYIKwYBBQUHAQEEbTBrMCQG
# CCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKG
# N2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJv
# b3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0
# LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9j
# cmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwHQYD
# VR0OBBYEFBUAEisTmLKZB+0e36K+Vw0rZwLNMB8GA1UdIwQYMBaAFEXroq/0ksuC
# MS1Ri6enIZ3zbcgPMA0GCSqGSIb3DQEBBQUAA4IBAQBGUD7Jtygkpzgdtlspr1LP
# UukxR6tWXHvVDQtBs+/sdR90OPKyXGGinJXDUOSCuSPRujqGcq04eKx1XRcXNHJH
# hZRW0eu7NoR3zCSl8wQZVann4+erYs37iy2QwsDStZS9Xk+xBdIOPRqpFFumhjFi
# qKgz5Js5p8T1zh14dpQlc+Qqq8+cdkvtX8JLFuRLcEwAiR78xXm8TBJX/l/hHrwC
# Xaj++wc4Tw3GXZG5D2dFzdaD7eeSDY2xaYxP+1ngIw/Sqq4AfO6cQg7Pkdcntxbu
# D8O9fAqg7iwIVYUiuOsYGk38KiGtSTGDR5V3cdyxG0tLHBCcdxTBnU8vWpUIKRAm
# MYIEOzCCBDcCAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0
# IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNl
# cnQgU0hBMiBBc3N1cmVkIElEIENvZGUgU2lnbmluZyBDQQIQAsbTxa4q6RSRmx0h
# kVyicTAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkq
# hkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGC
# NwIBFTAjBgkqhkiG9w0BCQQxFgQUE4ug5VfzbE7nAfajzS43NWP2SnAwDQYJKoZI
# hvcNAQEBBQAEggEAit8Wl21aBtU62cAaWXVIlp61wh/XIubQiWGCYhkp/qKixl+j
# QgJqxgE1WtuTR/DJceqlhep7fFzgueDgfa4aHR5ZhT0CsdQkUhIcowXIHeqhb080
# ulvWIoAEF6yiAVnkUVY6ZtQ8E/F1eOsN9PeKp02xOR2YctfXSH6KnCoymelsXHPF
# wKXyezplRlwr7sW9JlTRyotEyBu3w4gs01mlLc+v1D20VELTlcCJmGa+2CRdvJWU
# DNrTO6Bp+fGaCEIxXEHx3TXll1YkvzPK10IoJuOpG10PnG6QRPtng5pMAtR1D3k0
# OzsU3G7XtJEVc5qdhFr+g5e8Sx+/3JBbzZNrcKGCAg8wggILBgkqhkiG9w0BCQYx
# ggH8MIIB+AIBATB2MGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJ
# bmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0
# IEFzc3VyZWQgSUQgQ0EtMQIQAwGaAjr/WLFr1tXq5hfwZjAJBgUrDgMCGgUAoF0w
# GAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMTkwNzE5
# MjAzMTA5WjAjBgkqhkiG9w0BCQQxFgQUedv/IiakLZu3Uo5CMXij9cUnj1QwDQYJ
# KoZIhvcNAQEBBQAEggEAGh5W8a9p9xkb3r8QP6gyGBRvqxFpXnqMZC8w//UjXmOV
# gdFsAjWUfiFPWW/pVAHoMpkRJA6dmd+vwMDoAgW5HhKumzJBIzDJTT5n64xtbuz/
# YOBP/wgCnQLWLBYCB/ArgQBVmVJLMMSNSnp0FMF4PK0qnEFlGohRvegk9/vWgSj9
# azsZ3NwIPOBXncgTKojQIU+D7Q+qoL2kESmANFku8KUrD//n/9ItFn3b9Y3BBsr4
# I23tp90G99fecrhwMAO1Uo0TLOesFK+ePvWHVRMdKwmIaYV29r0ulequJqb9PLmw
# uZ6A6CpYIM9qeidhG3w6i5ferOj/u0E0jeds3KIcYA==
# SIG # End signature block