J81.NSToolkit

2402.222.2

J81.NSToolkit.Common/Public/Get-NSSession.ps1

                                function Get-NSSession {

    <#

    .SYNOPSIS

        Verify and retrieve an active session variable

    .DESCRIPTION

        Verify and retrieve an active session variable

    .PARAMETER NSSession

        Specify an active session (Output from Connect-NSNode)

    .EXAMPLE

        PS C:\>Get-NSSession

        Get the active session and if not found, try to connect

    .NOTES

        File Name : Get-NSSession

        Version   : v2401.3122.0

        Author    : John Billekens

        Requires  : PowerShell v5.1 and up

                    NS 13.0 and up

    .LINK

        https://blog.j81.nl

    #>

    [CmdletBinding()]

    param(

        [Object]$NSSession = $nsToolkitCommon.ModuleValues.NSSession

    )

    Write-Verbose "Get-NSSession: Starting"

    $IsActive = $false

    if ($null -eq $NSSession -or ([String]::IsNullOrEmpty($NSSession))) {

        $NSSession = [PSObject]@{

            ManagementURL     = $null

            WebSession        = $null

            Username          = $null

            Version           = "UNKNOWN"

            IsConnected       = $false

            SessionExpiration = $null

        }

    } elseif ( ($null -ne $NSSession.SessionExpiration) -and ($NSSession.SessionExpiration -is [DateTime]) -and ($NSSession.SessionExpiration -le (Get-Date)) ) {

        $IsActive = $false

    } elseif ($NSSession.IsConnected -and ($NSSession.SessionExpiration -gt (Get-Date).AddSeconds(120))) {

        $IsActive = $true

    } else {

        $IsActive = $false

    }

    Write-Verbose "isActive: $IsActive"

    $MessageText = ". E.g. https://citrixacd.domain.local"

    if ($IsActive -eq $false) {

        if ($NSSession -eq [PSCustomObject] -and (-Not ($NSSession | Get-Member -Name "IsConnected" -ErrorAction SilentlyContinue -MemberType NoteProperty))) {

            $NSSession | Add-Member -MemberType NoteProperty -Name "IsConnected" -Value $false

        } else {

            $NSSession.IsConnected = $false

        }

        try {

            Write-Verbose "Check if the NSSession variable contains a hostname"

            if ($null -ne $NSSession -and (-Not [String]::IsNullOrEmpty($( try { $NSSession.ManagementURL.ToString() } catch { $null } )))) {

                $ManagementURL = [Uri]$NSSession.ManagementURL.ToString().TrimEnd('/')

                $MessageText = ": $ManagementURL"

                Write-Verbose "Valid ManagementURL found"

            } elseif (-Not [String]::IsNullOrEmpty($($nsToolkitCommon.ModuleValues.ManagementURL)) ) {

                $ManagementURL = $nsToolkitCommon.ModuleValues.ManagementURL

                Write-Verbose "Valid ManagementURL found (From module variable)"

            } elseif (-Not [String]::IsNullOrEmpty($(Get-Variable -Name ManagementURL -Scope 0 -ValueOnly -ErrorAction SilentlyContinue)) ) {

                $ManagementURL = [Uri](Get-Variable -Name ManagementURL -Scope 0 -ValueOnly -ErrorAction SilentlyContinue)

                $MessageText = ": $ManagementURL"

                Write-Verbose "Valid ManagementURL found"

            } elseif (-Not [String]::IsNullOrEmpty($(Get-Variable -Name ManagementURL -Scope Script -ValueOnly -ErrorAction SilentlyContinue)) ) {

                $ManagementURL = [Uri](Get-Variable -Name ManagementURL -Scope Script -ValueOnly -ErrorAction SilentlyContinue)

                $MessageText = ": $ManagementURL"

                Write-Verbose "Valid ManagementURL found"

            } elseif (-Not [String]::IsNullOrEmpty($(Get-Variable -Name ManagementURL -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) ) {

                $ManagementURL = [Uri](Get-Variable -Name ManagementURL -Scope Global -ValueOnly -ErrorAction SilentlyContinue)

                $MessageText = ": $ManagementURL"

                Write-Verbose "Valid ManagementURL found"

            }

            Write-Verbose "ManagementURL: $($ManagementURL.ToString().TrimEnd('/'))"

        } catch {

            Write-Verbose "Caught an error, $($_.Exception.Message)"

        }

        Write-Verbose "NSSession: $($NSSession | Out-String)"

        if (-Not [String]::IsNullOrEmpty($($NSSession.Username))) {

            $Username = $NSSession.Username

        } else {

            $Username = "nsroot"

        }

        $validCredential = $false

        try {

            Write-Verbose "Test if Variable NSCredential (Module) is a valid credential"

            $tempCredential = $nsToolkitCommon.ModuleValues.Credential

            if (-not ($null -eq $tempCredential) -and `

                    -Not [String]::IsNullOrEmpty($tempCredential) -and `

                    -Not ($tempCredential -eq [System.Management.Automation.PSCredential]::Empty) -and `

                    $tempCredential -is [System.Management.Automation.PSCredential] -and `

                    -Not [String]::IsNullOrEmpty($($tempCredential.Username)) ) {

                Write-Verbose "Get (if it exists) the NSCredential variable (Module) for the NS Credential"

                $NSCredential = $nsToolkitCommon.ModuleValues.Credential

                $validCredential = $true

                Write-Verbose "Valid Credential found"

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        try {

            Write-Verbose "Test if Variable NSCredential (Scope:0) is a valid credential"

            $tempCredential = Get-Variable -Name NSCredential -Scope 0 -ValueOnly -ErrorAction SilentlyContinue

            if (-not ($null -eq $tempCredential) -and `

                    $validCredential -eq $false -and `

                    -Not [String]::IsNullOrEmpty($tempCredential) -and `

                    -Not ($tempCredential -eq [System.Management.Automation.PSCredential]::Empty) -and `

                    $tempCredential -is [System.Management.Automation.PSCredential] -and `

                    -Not [String]::IsNullOrEmpty($($tempCredential.Username)) ) {

                Write-Verbose "Get (if it exists) the NSCredential variable (Scope:0) for the NS Credential"

                $NSCredential = $tempCredential

                $validCredential = $true

                Write-Verbose "Valid Credential found"

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        try {

            Write-Verbose "Test if Variable NSCredential (Scope:Script) is a valid credential"

            $tempCredential = Get-Variable -Name NSCredential -Scope Script -ValueOnly -ErrorAction SilentlyContinue

            if (-not ($null -eq $tempCredential) -and `

                    $validCredential -eq $false -and `

                    -Not [String]::IsNullOrEmpty($tempCredential) -and `

                    -Not ($tempCredential -eq [System.Management.Automation.PSCredential]::Empty) -and `

                    $tempCredential -is [System.Management.Automation.PSCredential] -and `

                    -Not [String]::IsNullOrEmpty($($tempCredential.Username)) ) {

                Write-Verbose "Get (if it exists) the NSCredential variable (Scope:Script) for the NS Credential"

                $NSCredential = $tempCredential

                $validCredential = $true

                Write-Verbose "Valid Credential found"

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        try {

            Write-Verbose "Test if Variable NSCredential (Scope:Script) is a valid credential"

            $tempCredential = Get-Variable -Name NSCredential -Scope Global -ValueOnly -ErrorAction SilentlyContinue

            if (-not ($null -eq $tempCredential) -and `

                    $validCredential -eq $false -and `

                    -Not [String]::IsNullOrEmpty($tempCredential) -and `

                    -Not ($tempCredential -eq [System.Management.Automation.PSCredential]::Empty) -and `

                    $tempCredential -is [System.Management.Automation.PSCredential] -and `

                    -Not [String]::IsNullOrEmpty($($tempCredential.Username)) ) {

                Write-Verbose "Get (if it exists) the NSCredential variable (Scope:Global) for the NS Credential"

                $NSCredential = $tempCredential

                $validCredential = $true

                Write-Verbose "Valid Credential found"

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        Write-Verbose "Credential: $($NSCredential.Username)"

        #If no ManagementURL is available then request a URL

        try {

            if (($null -eq $ManagementURL) -or ([String]::IsNullOrEmpty($ManagementURL))) {

                $ManagementURL = $(Read-Host -Prompt "Enter the NetScaler Management URL$($MessageText)")

                Save-NSLogonParams -ManagementURL $ManagementURL

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        try {

            #Test if NSCredential is a valid credential

            if ($validCredential -eq $false) {

                Write-Verbose "No valid credential was found, requesting credential."

                $NSCredential = (Get-Credential -Message "Enter username and password for the NetScaler`r`nE.g. nsroot / P@ssw0rd" -UserName $Username)

                Save-NSLogonParams -Credential $NSCredential

            }

        } catch {

            Write-Verbose "Caught an (non blocking) error, $($_.Exception.Message)"

        }

        try {

            $NSSession = Connect-NSNode -ManagementURL $ManagementURL -Credential $NSCredential -PassThru

        } catch {

            Write-Error "Caught an error while connecting, $($_.Exception.Message)"

        }

    }

    if (($null -eq $NSSession) -or `

        ([String]::IsNullOrEmpty($NSSession)) -or `

        ([String]::IsNullOrEmpty($(Get-Variable -ErrorAction SilentlyContinue | Where-Object Name -EQ "NSSession")))) {

        Write-Verbose "Empty Session variable, trying to connect"

        $NSSession = Connect-NSNode -ManagementURL $(Read-Host -Prompt "Enter the NetScaler Management URL$($MessageText)") -Credential (Get-Credential) -PassThru

    }

    if (($null -eq $NSSession) -or [String]::IsNullOrEmpty($NSSession) -or (-Not $NSSession.IsConnected)) {

        throw "Connect to the NetScaler Appliance first!"

    } else {

        Save-NSLogonParams -NSSession $NSSession

        Write-Verbose "Active Session found, returning Session data"

        Write-Output $NSSession

    }

    Write-Verbose "Get-NSSession: Ended"

}

# SIG # Begin signature block

# MIIkmgYJKoZIhvcNAQcCoIIkizCCJIcCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBXc8fdEifMEi1O

# kzAzlNgCL1PrezdArNxXY8asKNSTT6CCHl4wggTzMIID26ADAgECAhAsJ03zZBC0

# i/247uUvWN5TMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAkdCMRswGQYDVQQI

# ExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGDAWBgNVBAoT

# D1NlY3RpZ28gTGltaXRlZDEkMCIGA1UEAxMbU2VjdGlnbyBSU0EgQ29kZSBTaWdu

# aW5nIENBMB4XDTIxMDUwNTAwMDAwMFoXDTI0MDUwNDIzNTk1OVowWzELMAkGA1UE

# BhMCTkwxEjAQBgNVBAcMCVZlbGRob3ZlbjEbMBkGA1UECgwSSm9oYW5uZXMgQmls

# bGVrZW5zMRswGQYDVQQDDBJKb2hhbm5lcyBCaWxsZWtlbnMwggEiMA0GCSqGSIb3

# DQEBAQUAA4IBDwAwggEKAoIBAQCsfgRG81keOHalHfCUgxOa1Qy4VNOnGxB8SL8e

# rjP9SfcF13McP7F1HGka5Be495pTZ+duGbaQMNozwg/5Dg9IRJEeBabeSSJJCbZo

# SNpmUu7NNRRfidQxlPC81LxTVHxJ7In0MEfCVm7rWcri28MRCAuafqOfSE+hyb1Z

# /tKyCyQ5RUq3kjs/CF+VfMHsJn6ZT63YqewRkwHuc7UogTTZKjhPJ9prGLTer8UX

# UgvsGRbvhYZXIEuy+bmx/iJ1yRl1kX4nj6gUYzlhemOnlSDD66YOrkLDhXPMXLym

# AN7h0/W5Bo//R5itgvdGBkXkWCKRASnq/9PTcoxW6mwtgU8xAgMBAAGjggGQMIIB

# jDAfBgNVHSMEGDAWgBQO4TqoUzox1Yq+wbutZxoDha00DjAdBgNVHQ4EFgQUZWMy

# gC0i1u2NZ1msk2Mm5nJm5AswDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAw

# EwYDVR0lBAwwCgYIKwYBBQUHAwMwEQYJYIZIAYb4QgEBBAQDAgQQMEoGA1UdIARD

# MEEwNQYMKwYBBAGyMQECAQMCMCUwIwYIKwYBBQUHAgEWF2h0dHBzOi8vc2VjdGln

# by5jb20vQ1BTMAgGBmeBDAEEATBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3Js

# LnNlY3RpZ28uY29tL1NlY3RpZ29SU0FDb2RlU2lnbmluZ0NBLmNybDBzBggrBgEF

# BQcBAQRnMGUwPgYIKwYBBQUHMAKGMmh0dHA6Ly9jcnQuc2VjdGlnby5jb20vU2Vj

# dGlnb1JTQUNvZGVTaWduaW5nQ0EuY3J0MCMGCCsGAQUFBzABhhdodHRwOi8vb2Nz

# cC5zZWN0aWdvLmNvbTANBgkqhkiG9w0BAQsFAAOCAQEARjv9ieRocb1DXRWm3XtY

# jjuSRjlvkoPd9wS6DNfsGlSU42BFd9LCKSyRREZVu8FDq7dN0PhD4bBTT+k6AgrY

# KG6f/8yUponOdxskv850SjN2S2FeVuR20pqActMrpd1+GCylG8mj8RGjdrLQ3QuX

# qYKS68WJ39WWYdVB/8Ftajir5p6sAfwHErLhbJS6WwmYjGI/9SekossvU8mZjZwo

# Gbu+fjZhPc4PhjbEh0ABSsPMfGjQQsg5zLFjg/P+cS6hgYI7qctToo0TexGe32DY

# fFWHrHuBErW2qXEJvzSqM5OtLRD06a4lH5ZkhojhMOX9S8xDs/ArDKgX1j1Xm4Tu

# DjCCBYEwggRpoAMCAQICEDlyRDr5IrdR19NsEN0xNZUwDQYJKoZIhvcNAQEMBQAw

# ezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G

# A1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNV

# BAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczAeFw0xOTAzMTIwMDAwMDBaFw0y

# ODEyMzEyMzU5NTlaMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKTmV3IEplcnNl

# eTEUMBIGA1UEBxMLSmVyc2V5IENpdHkxHjAcBgNVBAoTFVRoZSBVU0VSVFJVU1Qg

# TmV0d29yazEuMCwGA1UEAxMlVVNFUlRydXN0IFJTQSBDZXJ0aWZpY2F0aW9uIEF1

# dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIASZRc2DsPb

# CLPQrFcNdu3NJ9NMrVCDYeKqIE0JLWQJ3M6Jn8w9qez2z8Hc8dOx1ns3KBErR9o5

# xrw6GbRfpr19naNjQrZ28qk7K5H44m/Q7BYgkAk+4uh0yRi0kdRiZNt/owbxiBhq

# kCI8vP4T8IcUe/bkH47U5FHGEWdGCFHLhhRUP7wz/n5snP8WnRi9UY41pqdmyHJn

# 2yFmsdSbeAPAUDrozPDcvJ5M/q8FljUfV1q3/875PbcstvZU3cjnEjpNrkyKt1ya

# tLcgPcp/IjSufjtoZgFE5wFORlObM2D3lL5TN5BzQ/Myw1Pv26r+dE5px2uMYJPe

# xMcM3+EyrsyTO1F4lWeL7j1W/gzQaQ8bD/MlJmszbfduR/pzQ+V+DqVmsSl8MoRj

# VYnEDcGTVDAZE6zTfTen6106bDVc20HXEtqpSQvf2ICKCZNijrVmzyWIzYS4sT+k

# OQ/ZAp7rEkyVfPNrBaleFoPMuGfi6BOdzFuC00yz7Vv/3uVzrCM7LQC/NVV0CUnY

# SVgaf5I25lGSDvMmfRxNF7zJ7EMm0L9BX0CpRET0medXh55QH1dUqD79dGMvsVBl

# CeZYQi5DGky08CVHWfoEHpPUJkZKUIGy3r54t/xnFeHJV4QeD2PW6WK61l9VLupc

# xigIBCU5uA4rqfJMlxwHPw1S9e3vL4IPAgMBAAGjgfIwge8wHwYDVR0jBBgwFoAU

# oBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYDVR0OBBYEFFN5v1qqK0rPVIDh2JvAnfKy

# A2bLMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MBEGA1UdIAQKMAgw

# BgYEVR0gADBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsLmNvbW9kb2NhLmNv

# bS9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDA0BggrBgEFBQcBAQQoMCYwJAYI

# KwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmNvbW9kb2NhLmNvbTANBgkqhkiG9w0BAQwF

# AAOCAQEAGIdR3HQhPZyK4Ce3M9AuzOzw5steEd4ib5t1jp5y/uTW/qofnJYt7wNK

# fq70jW9yPEM7wD/ruN9cqqnGrvL82O6je0P2hjZ8FODN9Pc//t64tIrwkZb+/UNk

# fv3M0gGhfX34GRnJQisTv1iLuqSiZgR2iJFODIkUzqJNyTKzuugUGrxx8VvwQQuY

# AAoiAxDlDLH5zZI3Ge078eQ6tvlFEyZ1r7uq7z97dzvSxAKRPRkA0xdcOds/exgN

# Rc2ThZYvXd9ZFk8/Ub3VRRg/7UqO6AZhdCMWtQ1QcydER38QXYkqa4UxFMToqWpM

# gLxqeM+4f452cpkMnf7XkQgWoaNflTCCBfUwggPdoAMCAQICEB2iSDBvmyYY0ILg

# ln0z02owDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpO

# ZXcgSmVyc2V5MRQwEgYDVQQHEwtKZXJzZXkgQ2l0eTEeMBwGA1UEChMVVGhlIFVT

# RVJUUlVTVCBOZXR3b3JrMS4wLAYDVQQDEyVVU0VSVHJ1c3QgUlNBIENlcnRpZmlj

# YXRpb24gQXV0aG9yaXR5MB4XDTE4MTEwMjAwMDAwMFoXDTMwMTIzMTIzNTk1OVow

# fDELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G

# A1UEBxMHU2FsZm9yZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQwIgYDVQQD

# ExtTZWN0aWdvIFJTQSBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQCGIo0yhXoYn0nwli9jCB4t3HyfFM/jJrYlZilAhlRGdDFi

# xRDtsocnppnLlTDAVvWkdcapDlBipVGREGrgS2Ku/fD4GKyn/+4uMyD6DBmJqGx7

# rQDDYaHcaWVtH24nlteXUYam9CflfGqLlR5bYNV+1xaSnAAvaPeX7Wpyvjg7Y96P

# v25MQV0SIAhZ6DnNj9LWzwa0VwW2TqE+V2sfmLzEYtYbC43HZhtKn52BxHJAteJf

# 7wtF/6POF6YtVbC3sLxUap28jVZTxvC6eVBJLPcDuf4vZTXyIuosB69G2flGHNyM

# fHEo8/6nxhTdVZFuihEN3wYklX0Pp6F8OtqGNWHTAgMBAAGjggFkMIIBYDAfBgNV

# HSMEGDAWgBRTeb9aqitKz1SA4dibwJ3ysgNmyzAdBgNVHQ4EFgQUDuE6qFM6MdWK

# vsG7rWcaA4WtNA4wDgYDVR0PAQH/BAQDAgGGMBIGA1UdEwEB/wQIMAYBAf8CAQAw

# HQYDVR0lBBYwFAYIKwYBBQUHAwMGCCsGAQUFBwMIMBEGA1UdIAQKMAgwBgYEVR0g

# ADBQBgNVHR8ESTBHMEWgQ6BBhj9odHRwOi8vY3JsLnVzZXJ0cnVzdC5jb20vVVNF

# UlRydXN0UlNBQ2VydGlmaWNhdGlvbkF1dGhvcml0eS5jcmwwdgYIKwYBBQUHAQEE

# ajBoMD8GCCsGAQUFBzAChjNodHRwOi8vY3J0LnVzZXJ0cnVzdC5jb20vVVNFUlRy

# dXN0UlNBQWRkVHJ1c3RDQS5jcnQwJQYIKwYBBQUHMAGGGWh0dHA6Ly9vY3NwLnVz

# ZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggIBAE1jUO1HNEphpNveaiqMm/EA

# AB4dYns61zLC9rPgY7P7YQCImhttEAcET7646ol4IusPRuzzRl5ARokS9At3Wpwq

# QTr81vTr5/cVlTPDoYMot94v5JT3hTODLUpASL+awk9KsY8k9LOBN9O3ZLCmI2pZ

# aFJCX/8E6+F0ZXkI9amT3mtxQJmWunjxucjiwwgWsatjWsgVgG10Xkp1fqW4w2y1

# z99KeYdcx0BNYzX2MNPPtQoOCwR/oEuuu6Ol0IQAkz5TXTSlADVpbL6fICUQDRn7

# UJBhvjmPeo5N9p8OHv4HURJmgyYZSJXOSsnBf/M6BZv5b9+If8AjntIeQ3pFMcGc

# TanwWbJZGehqjSkEAnd8S0vNcL46slVaeD68u28DECV3FTSK+TbMQ5Lkuk/xYpMo

# JVcp+1EZx6ElQGqEV8aynbG8HArafGd+fS7pKEwYfsR7MUFxmksp7As9V1DSyt39

# ngVR5UR43QHesXWYDVQk/fBO4+L4g71yuss9Ou7wXheSaG3IYfmm8SoKC6W59J7u

# mDIFhZ7r+YMp08Ysfb06dy6LN0KgaoLtO0qqlBCk4Q34F8W2WnkzGJLjtXX4oemO

# CiUe5B7xn1qHI/+fpFGe+zmAEc3btcSnqIBv5VPU4OOiwtJbGvoyJi1qV3AcPKRY

# LqPzW0sH3DJZ84enGm1YMIIG7DCCBNSgAwIBAgIQMA9vrN1mmHR8qUY2p3gtuTAN

# BgkqhkiG9w0BAQwFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJz

# ZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNU

# IE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBB

# dXRob3JpdHkwHhcNMTkwNTAyMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjB9MQswCQYD

# VQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdT

# YWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxJTAjBgNVBAMTHFNlY3Rp

# Z28gUlNBIFRpbWUgU3RhbXBpbmcgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw

# ggIKAoICAQDIGwGv2Sx+iJl9AZg/IJC9nIAhVJO5z6A+U++zWsB21hoEpc5Hg7Xr

# xMxJNMvzRWW5+adkFiYJ+9UyUnkuyWPCE5u2hj8BBZJmbyGr1XEQeYf0RirNxFrJ

# 29ddSU1yVg/cyeNTmDoqHvzOWEnTv/M5u7mkI0Ks0BXDf56iXNc48RaycNOjxN+z

# xXKsLgp3/A2UUrf8H5VzJD0BKLwPDU+zkQGObp0ndVXRFzs0IXuXAZSvf4DP0REK

# V4TJf1bgvUacgr6Unb+0ILBgfrhN9Q0/29DqhYyKVnHRLZRMyIw80xSinL0m/9NT

# IMdgaZtYClT0Bef9Maz5yIUXx7gpGaQpL0bj3duRX58/Nj4OMGcrRrc1r5a+2kxg

# zKi7nw0U1BjEMJh0giHPYla1IXMSHv2qyghYh3ekFesZVf/QOVQtJu5FGjpvzdeE

# 8NfwKMVPZIMC1Pvi3vG8Aij0bdonigbSlofe6GsO8Ft96XZpkyAcSpcsdxkrk5WY

# nJee647BeFbGRCXfBhKaBi2fA179g6JTZ8qx+o2hZMmIklnLqEbAyfKm/31X2xJ2

# +opBJNQb/HKlFKLUrUMcpEmLQTkUAx4p+hulIq6lw02C0I3aa7fb9xhAV3PwcaP7

# Sn1FNsH3jYL6uckNU4B9+rY5WDLvbxhQiddPnTO9GrWdod6VQXqngwIDAQABo4IB

# WjCCAVYwHwYDVR0jBBgwFoAUU3m/WqorSs9UgOHYm8Cd8rIDZsswHQYDVR0OBBYE

# FBqh+GEZIA/DQXdFKI7RNV8GEgRVMA4GA1UdDwEB/wQEAwIBhjASBgNVHRMBAf8E

# CDAGAQH/AgEAMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBEGA1UdIAQKMAgwBgYEVR0g

# ADBQBgNVHR8ESTBHMEWgQ6BBhj9odHRwOi8vY3JsLnVzZXJ0cnVzdC5jb20vVVNF

# UlRydXN0UlNBQ2VydGlmaWNhdGlvbkF1dGhvcml0eS5jcmwwdgYIKwYBBQUHAQEE

# ajBoMD8GCCsGAQUFBzAChjNodHRwOi8vY3J0LnVzZXJ0cnVzdC5jb20vVVNFUlRy

# dXN0UlNBQWRkVHJ1c3RDQS5jcnQwJQYIKwYBBQUHMAGGGWh0dHA6Ly9vY3NwLnVz

# ZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggIBAG1UgaUzXRbhtVOBkXXfA3oy

# Cy0lhBGysNsqfSoF9bw7J/RaoLlJWZApbGHLtVDb4n35nwDvQMOt0+LkVvlYQc/x

# QuUQff+wdB+PxlwJ+TNe6qAcJlhc87QRD9XVw+K81Vh4v0h24URnbY+wQxAPjeT5

# OGK/EwHFhaNMxcyyUzCVpNb0llYIuM1cfwGWvnJSajtCN3wWeDmTk5SbsdyybUFt

# Z83Jb5A9f0VywRsj1sJVhGbks8VmBvbz1kteraMrQoohkv6ob1olcGKBc2NeoLvY

# 3NdK0z2vgwY4Eh0khy3k/ALWPncEvAQ2ted3y5wujSMYuaPCRx3wXdahc1cFaJqn

# yTdlHb7qvNhCg0MFpYumCf/RoZSmTqo9CfUFbLfSZFrYKiLCS53xOV5M3kg9mzSW

# mglfjv33sVKRzj+J9hyhtal1H3G/W0NdZT1QgW6r8NDT/LKzH7aZlib0PHmLXGTM

# ze4nmuWgwAxyh8FuTVrTHurwROYybxzrF06Uw3hlIDsPQaof6aFBnf6xuKBlKjTg

# 3qj5PObBMLvAoGMs/FwWAKjQxH/qEZ0eBsambTJdtDgJK0kHqv3sMNrxpy/Pt/36

# 0KOE2See+wFmd7lWEOEgbsausfm2usg1XTN2jvF8IAwqd661ogKGuinutFoAsYyr

# 4/kKyVRd1LlqdJ69SK6YMIIG9TCCBN2gAwIBAgIQOUwl4XygbSeoZeI72R0i1DAN

# BgkqhkiG9w0BAQwFADB9MQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBN

# YW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdvIExp

# bWl0ZWQxJTAjBgNVBAMTHFNlY3RpZ28gUlNBIFRpbWUgU3RhbXBpbmcgQ0EwHhcN

# MjMwNTAzMDAwMDAwWhcNMzQwODAyMjM1OTU5WjBqMQswCQYDVQQGEwJHQjETMBEG

# A1UECBMKTWFuY2hlc3RlcjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSwwKgYD

# VQQDDCNTZWN0aWdvIFJTQSBUaW1lIFN0YW1waW5nIFNpZ25lciAjNDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBAKSTKFJLzyeHdqQpHJk4wOcO1NEc7GjL

# AWTkis13sHFlgryf/Iu7u5WY+yURjlqICWYRFFiyuiJb5vYy8V0twHqiDuDgVmTt

# oeWBIHIgZEFsx8MI+vN9Xe8hmsJ+1yzDuhGYHvzTIAhCs1+/f4hYMqsws9iMepZK

# GRNcrPznq+kcFi6wsDiVSs+FUKtnAyWhuzjpD2+pWpqRKBM1uR/zPeEkyGuxmegN

# 77tN5T2MVAOR0Pwtz1UzOHoJHAfRIuBjhqe+/dKDcxIUm5pMCUa9NLzhS1B7cuBb

# /Rm7HzxqGXtuuy1EKr48TMysigSTxleGoHM2K4GX+hubfoiH2FJ5if5udzfXu1Cf

# +hglTxPyXnypsSBaKaujQod34PRMAkjdWKVTpqOg7RmWZRUpxe0zMCXmloOBmvZg

# ZpBYB4DNQnWs+7SR0MXdAUBqtqgQ7vaNereeda/TpUsYoQyfV7BeJUeRdM11EtGc

# b+ReDZvsdSbu/tP1ki9ShejaRFEqoswAyodmQ6MbAO+itZadYq0nC/IbSsnDlEI3

# iCCEqIeuw7ojcnv4VO/4ayewhfWnQ4XYKzl021p3AtGk+vXNnD3MH65R0Hts2B0t

# EUJTcXTC5TWqLVIS2SXP8NPQkUMS1zJ9mGzjd0HI/x8kVO9urcY+VXvxXIc6ZPFg

# SwVP77kv7AkTAgMBAAGjggGCMIIBfjAfBgNVHSMEGDAWgBQaofhhGSAPw0F3RSiO

# 0TVfBhIEVTAdBgNVHQ4EFgQUAw8xyJEqk71j89FdTaQ0D9KVARgwDgYDVR0PAQH/

# BAQDAgbAMAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwSgYD

# VR0gBEMwQTA1BgwrBgEEAbIxAQIBAwgwJTAjBggrBgEFBQcCARYXaHR0cHM6Ly9z

# ZWN0aWdvLmNvbS9DUFMwCAYGZ4EMAQQCMEQGA1UdHwQ9MDswOaA3oDWGM2h0dHA6

# Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1JTQVRpbWVTdGFtcGluZ0NBLmNybDB0

# BggrBgEFBQcBAQRoMGYwPwYIKwYBBQUHMAKGM2h0dHA6Ly9jcnQuc2VjdGlnby5j

# b20vU2VjdGlnb1JTQVRpbWVTdGFtcGluZ0NBLmNydDAjBggrBgEFBQcwAYYXaHR0

# cDovL29jc3Auc2VjdGlnby5jb20wDQYJKoZIhvcNAQEMBQADggIBAEybZVj64HnP

# 7xXDMm3eM5Hrd1ji673LSjx13n6UbcMixwSV32VpYRMM9gye9YkgXsGHxwMkysel

# 8Cbf+PgxZQ3g621RV6aMhFIIRhwqwt7y2opF87739i7Efu347Wi/elZI6WHlmjl3

# vL66kWSIdf9dhRY0J9Ipy//tLdr/vpMM7G2iDczD8W69IZEaIwBSrZfUYngqhHmo

# 1z2sIY9wwyR5OpfxDaOjW1PYqwC6WPs1gE9fKHFsGV7Cg3KQruDG2PKZ++q0kmV8

# B3w1RB2tWBhrYvvebMQKqWzTIUZw3C+NdUwjwkHQepY7w0vdzZImdHZcN6CaJJ5O

# X07Tjw/lE09ZRGVLQ2TPSPhnZ7lNv8wNsTow0KE9SK16ZeTs3+AB8LMqSjmswaT5

# qX010DJAoLEZKhghssh9BXEaSyc2quCYHIN158d+S4RDzUP7kJd2KhKsQMFwW5kK

# QPqAbZRhe8huuchnZyRcUI0BIN4H9wHU+C4RzZ2D5fjKJRxEPSflsIZHKgsbhHZ9

# e2hPjbf3E7TtoC3ucw/ZELqdmSx813UfjxDElOZ+JOWVSoiMJ9aFZh35rmR2kehI

# /shVCu0pwx/eOKbAFPsyPfipg2I2yMO+AIccq/pKQhyJA9z1XHxw2V14Tu6fXiDm

# CWp8KwijSPUV/ARP380hHHrl9Y4a1LlAMYIFkjCCBY4CAQEwgZAwfDELMAkGA1UE

# BhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2Fs

# Zm9yZDEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSQwIgYDVQQDExtTZWN0aWdv

# IFJTQSBDb2RlIFNpZ25pbmcgQ0ECECwnTfNkELSL/bju5S9Y3lMwDQYJYIZIAWUD

# BAIBBQCggYQwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0BCQMx

# DAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkq

# hkiG9w0BCQQxIgQg4mTzyqg1IfEY8vIrdPW4sxI944EjLq3536hp1V4T7/4wDQYJ

# KoZIhvcNAQEBBQAEggEABncpbZAFY/GjhaDFZzGjq7w+V2e+U1Po08dbgGwJ4L2N

# 2PRCh876BZACfKcL085HjPqTqe0Qt7vpcnFq7QTnZVuCTaESTpV4fhvaf1zRwxg7

# b+vFi6Ert6YCdPsyWU38DJ9UepQsUysxlD/9slHFgjcOUSmEHWjmAbc7IulUjgRi

# LWq6vIz4KpMWWqp9/Vs0YJDzmYck7mF3kScxmJtYTfHKZnF0DnVw0eOzb8szJ/wK

# AQgkZ4mJZpmVW0ROaE/OBWEOVLC1e3s0GdclKw+pb1SAZuFfsPlWP6yDdjwdiZP4

# ipl3NtR0Ig1dnxer9xP6cZQLxqTKtDneosUkE0H9HqGCA0swggNHBgkqhkiG9w0B

# CQYxggM4MIIDNAIBATCBkTB9MQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRl

# ciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRgwFgYDVQQKEw9TZWN0aWdv

# IExpbWl0ZWQxJTAjBgNVBAMTHFNlY3RpZ28gUlNBIFRpbWUgU3RhbXBpbmcgQ0EC

# EDlMJeF8oG0nqGXiO9kdItQwDQYJYIZIAWUDBAICBQCgeTAYBgkqhkiG9w0BCQMx

# CwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yNDAxMzEyMTI4MzBaMD8GCSqG

# SIb3DQEJBDEyBDA13PhnjRrol2ETl+pHfhhrU+SCn8Ig+oAqFZYrrz3VI3AatnNY

# 9v5BUUp9IW/kM60wDQYJKoZIhvcNAQEBBQAEggIATW6cyWOEM6LSG/1M8fwTcqSW

# ckyeP+PmO80biDWQztL3hyd0BTfrRgqYmegT2NyyfJ7HKB2Jbk5HsiYZxgcj89qr

# LBfoFSpCrh0D8kk55+utlZr7aTkaWJdQrdl3cFa77JZGPBOJP3e369xPwVpZ2c0Z

# LLz3UmzoK354ktZIgcskzwyjDiqzZPkBu/kELXXZxEK4EKEQV3hhDsUldF/QS+OB

# 9cHfFubgIlE/zW3FIxGCcc7OUP+eR0Xv4fKcq91kKlVOfuKRmZKqiRjqZKe8aABF

# /Xd3D+7rsrk0zokZiNVI6V52E+szLKDWA+JXi/srLYpe04vOjDsuwQCK/Ydj86dK

# xhJhU7cyb4pPcCRCdeNXBPPupbbR/77/incwZHIC1cgOQzKTYkbGr0URh3zC1LJC

# tP025lycV6+WpPddsUJI2sb5rit495FqYKUhk4bUflFNtRSzFwNBnoDsUhY27FSQ

# o+vdPAcjK9zDf68G1q43JhR3Y184BNpnIFPB2pq4TuxZ3hcBttCYLzOvF3m/nnR7

# 4V7YoYLqQGj5KMabKd5LNeiZneeiyjLL1P6N6oDVgHpyKfPGjPxB2vbHq0TQHjXt

# spfgb0F5QWt8BrgGFG73zhQ8BOHCyDyd84Ma2/EBtyLd+X3cexXp1ADUNzXEaEy1

# VyMHM40qb07MOXfu3fs=

# SIG # End signature block