AksGMSA

1.3.0

Utils.psm1

                                function Invoke-CommandLine {

    <#

    .SYNOPSIS

        Execute a command, and check its exit code.

    .PARAMETER Command

        Command to execute. It can be a binary file path, or a binary file name found in PATH.

    .PARAMETER Arguments

        Arguments to pass to the command.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String]$Command,

        [String]$Arguments

    )

    & $Command $Arguments.Split(" ")

    if($LASTEXITCODE) {

        Throw "$Command $Arguments returned a non zero exit code ${LASTEXITCODE}."

    }

}

function Add-ToPathEnvVar {

    <#

    .SYNOPSIS

        Append paths to the PATH environment variable.

    .PARAMETER Path

        List of paths to be appended to the PATH environment variable.

    .PARAMETER Target

        The PATH environment variable target. Valid values are: Machine, User.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String[]]$Path,

        [Parameter(Mandatory=$false)]

        [ValidateSet([System.EnvironmentVariableTarget]::User, [System.EnvironmentVariableTarget]::Machine)]

        [System.EnvironmentVariableTarget]$Target=[System.EnvironmentVariableTarget]::User

    )

    $pathEnvVar = [Environment]::GetEnvironmentVariable("PATH", $Target).Split(';')

    $currentSessionPath = $env:PATH.Split(';')

    foreach($p in $Path) {

        if($p -notin $pathEnvVar) {

            $pathEnvVar += $p

        }

        if($p -notin $currentSessionPath) {

            $currentSessionPath += $p

        }

    }

    $env:PATH = $currentSessionPath -join ';'

    $newPathEnvVar = $pathEnvVar -join ';'

    [Environment]::SetEnvironmentVariable("PATH", $newPathEnvVar, $Target)

}

function Start-FileDownload {

    <#

    .SYNOPSIS

        Download a file from the given URL.

    .PARAMETER URL

        The file download URL.

    .PARAMETER Destination

        The local path where the file will be downloaded.

    .PARAMETER RetryCount

        The number of retries for the download operation.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String]$URL,

        [Parameter(Mandatory=$true)]

        [String]$Destination,

        [Int]$RetryCount=10

    )

    Start-ExecuteWithRetry `

        -ScriptBlock { Invoke-CommandLine -Command "curl.exe" -Arguments "-L -s -o $Destination $URL" } `

        -MaxRetryCount $RetryCount `

        -RetryMessage "Failed to download $URL. Retrying"

}

function Invoke-Kubectl {

    <#

    .SYNOPSIS

        Execute a kubectl command.

    .PARAMETER Arguments

        Arguments to pass to the command.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String]$Arguments

    )

    Invoke-CommandLine -Command "kubectl.exe" -Arguments $Arguments

}

function Install-KubernetesManifests {

    <#

    .SYNOPSIS

        Install the Kubernetes manifests given as parameter. The manifests are written into a temporary file, which is given to 'kubectl apply -f <file_path>'.

    .PARAMETER Manifests

        The Kubernetes manifests.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String[]]$Manifests

    )

    $tempFile = New-TemporaryFile

    try {

        foreach($manifest in $Manifests) {

            Set-Content -Path $tempFile -Value $manifest

            Invoke-Kubectl "apply -f ${tempFile}"

        }

    } finally {

        Remove-Item $tempFile

    }

}

function Uninstall-KubernetesManifests {

    <#

    .SYNOPSIS

        Uninstall the Kubernetes manifests given as parameter. The manifests are written into a temporary file, which is given to 'kubectl delete -f <file_path>'.

    .PARAMETER Manifests

        The Kubernetes manifests.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [String[]]$Manifests

    )

    $tempFile = New-TemporaryFile

    try {

        foreach($manifest in $Manifests) {

            Set-Content -Path $tempFile -Value $manifest

            Invoke-Kubectl "delete --ignore-not-found=true -f ${tempFile}"

        }

    } finally {

        Remove-Item $tempFile

    }

}

function Start-ExecuteWithRetry {

    <#

    .SYNOPSIS

        Execute the given PowerShell script block until it succeeds, or until the maximum retries count is reached.

    .PARAMETER ScriptBlock

        The script block to run.

    .PARAMETER MaxRetryCount

        The number of retries before we throw an exception.

    .PARAMETER RetryInterval

        Number of seconds to sleep between retries.

    .PARAMETER RetryMessage

        Warning message logged on every failed retry.

    .PARAMETER ArgumentList

        Arguments to pass to your wrapped commandlet/command.

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [ScriptBlock]$ScriptBlock,

        [Int]$MaxRetryCount=10,

        [Int]$RetryInterval=3,

        [String]$RetryMessage,

        [Array]$ArgumentList=@()

    )

    $currentErrorActionPreference = $ErrorActionPreference

    $ErrorActionPreference = "Continue"

    $retryCount = 0

    while ($true) {

        try {

            $res = Invoke-Command -ScriptBlock $ScriptBlock -ArgumentList $ArgumentList

            $ErrorActionPreference = $currentErrorActionPreference

            return $res

        } catch [System.Exception] {

            $retryCount++

            if ($retryCount -gt $MaxRetryCount) {

                $ErrorActionPreference = $currentErrorActionPreference

                Throw $_

            } else {

                $prefixMsg = "Retry(${retryCount}/${MaxRetryCount})"

                if($RetryMessage) {

                    Write-Host "${prefixMsg} - $RetryMessage"

                } elseif($_) {

                    Write-Host "${prefixMsg} - $($_.ToString())"

                }

                Start-Sleep $RetryInterval

            }

        }

    }

}

function Get-UniqueId {

    <#

    .SYNOPSIS

        Get an unique id as string. This is based on the value returned from the cmdlet 'New-Guid'.

    .PARAMETER Length

        The length of the id string. Minimum allowed is 4, and the maximum is 32. Defaults to 8.

    #>

    Param(

        [ValidateRange(4, 32)]

        [Int]$Length=8

    )

    return (New-Guid).Guid.Replace("-", "").Substring(0, $Length)

}

function Get-InputParameter {

    <#

    .SYNOPSIS

        Get an input parameter by interactively asking the user with a prompt.

    .PARAMETER Prompt

        The prompt text.

    .PARAMETER Description

        The input parameter description.

    .PARAMETER Default

        The input parameter default value. Only used when 'Optional' flag is used, and the input parameter is empty.

    .PARAMETER Type

        The input parameter will be casted to this type.

    .PARAMETER Optional

        If this is enabled, the function allows empty input parameters given by the user.

    .PARAMETER AsSecureString

        Flag used if the input parameter is a password. The returned value will

        be a secure string.

    .PARAMETER ValidationScriptBlock

        The script block used to validate the input given. It should raise an

        exception (with a meaningful message) if something is wrong with the input

        parameter (which referred as $_ in the script block).

    #>

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        [String]$Prompt,

        [String]$Description,

        $Default,

        [ValidateScript({

            if(!($_ -as [type])) {

                Throw "Type '$_' is invalid."

            }

            $true

        })]

        [String]$Type="String",

        [Switch]$Optional,

        [Switch]$AsSecureString,

        [ScriptBlock]$ValidationScriptBlock={$true}

    )

    if($Description) {

        Write-Host -ForegroundColor Green $Description

    }

    if($AsSecureString) {

        $Type = "SecureString"

    }

    do {

        $valid = $true

        try {

            $param = Read-Host -Prompt $Prompt -AsSecureString:$AsSecureString

            if(!$param) {

                if(!$Optional) {

                    Throw "This input parameter is mandatory."

                }

                $param = $Default

            }

            if($AsSecureString -and ![System.Net.NetworkCredential]::new('', $param).Password) {

                Throw "The secret input cannot be empty."

            }

            if($AsSecureString) {

                $paramAgain = Read-Host -Prompt "${Prompt} (again)" -AsSecureString:$AsSecureString

                if([System.Net.NetworkCredential]::new('', $param).Password -ne [System.Net.NetworkCredential]::new('', $paramAgain).Password) {

                    Throw "The repeated secret input parameter does not match."

                }

            }

            $paramType = $Type -as [Type]

            if($paramType.BaseType -eq [Array]) {

                $param = $param.Split(',').Trim()

            }

            $param = [System.Management.Automation.LanguagePrimitives]::ConvertTo($param, $paramType)

            $param | Where-Object $ValidationScriptBlock | Out-Null

        } catch [System.Exception] {

            Write-Warning $_.ToString()

            $valid = $false

        }

    } while(!$valid)

    return $param

}

# SIG # Begin signature block

# MIInvAYJKoZIhvcNAQcCoIInrTCCJ6kCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCqT1gdsE4Yrkq6

# xnvoCy6NcVE63EApk/R1oO9sH4eHPqCCDYUwggYDMIID66ADAgECAhMzAAACU+OD

# 3pbexW7MAAAAAAJTMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjEwOTAyMTgzMzAwWhcNMjIwOTAxMTgzMzAwWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDLhxHwq3OhH+4J+SX4qS/VQG8HybccH7tnG+BUqrXubfGuDFYPZ29uCuHfQlO1

# lygLgMpJ4Geh6/6poQ5VkDKfVssn6aA1PCzIh8iOPMQ9Mju3sLF9Sn+Pzuaie4BN

# rp0MuZLDEXgVYx2WNjmzqcxC7dY9SC3znOh5qUy2vnmWygC7b9kj0d3JrGtjc5q5

# 0WfV3WLXAQHkeRROsJFBZfXFGoSvRljFFUAjU/zdhP92P+1JiRRRikVy/sqIhMDY

# +7tVdzlE2fwnKOv9LShgKeyEevgMl0B1Fq7E2YeBZKF6KlhmYi9CE1350cnTUoU4

# YpQSnZo0YAnaenREDLfFGKTdAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUlZpLWIccXoxessA/DRbe26glhEMw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ2NzU5ODAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AKVY+yKcJVVxf9W2vNkL5ufjOpqcvVOOOdVyjy1dmsO4O8khWhqrecdVZp09adOZ

# 8kcMtQ0U+oKx484Jg11cc4Ck0FyOBnp+YIFbOxYCqzaqMcaRAgy48n1tbz/EFYiF

# zJmMiGnlgWFCStONPvQOBD2y/Ej3qBRnGy9EZS1EDlRN/8l5Rs3HX2lZhd9WuukR

# bUk83U99TPJyo12cU0Mb3n1HJv/JZpwSyqb3O0o4HExVJSkwN1m42fSVIVtXVVSa

# YZiVpv32GoD/dyAS/gyplfR6FI3RnCOomzlycSqoz0zBCPFiCMhVhQ6qn+J0GhgR

# BJvGKizw+5lTfnBFoqKZJDROz+uGDl9tw6JvnVqAZKGrWv/CsYaegaPePFrAVSxA

# yUwOFTkAqtNC8uAee+rv2V5xLw8FfpKJ5yKiMKnCKrIaFQDr5AZ7f2ejGGDf+8Tz

# OiK1AgBvOW3iTEEa/at8Z4+s1CmnEAkAi0cLjB72CJedU1LAswdOCWM2MDIZVo9j

# 0T74OkJLTjPd3WNEyw0rBXTyhlbYQsYt7ElT2l2TTlF5EmpVixGtj4ChNjWoKr9y

# TAqtadd2Ym5FNB792GzwNwa631BPCgBJmcRpFKXt0VEQq7UXVNYBiBRd+x4yvjqq

# 5aF7XC5nXCgjbCk7IXwmOphNuNDNiRq83Ejjnc7mxrJGMIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGY0wghmJAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAJT44Pelt7FbswAAAAA

# AlMwDQYJYIZIAWUDBAIBBQCggbAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIDbn

# WHxCe4pUqg9hKC6+aU3tat+FCKE863SDn4+acIayMEQGCisGAQQBgjcCAQwxNjA0

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEcgBpodHRwczovL3d3dy5taWNyb3NvZnQu

# Y29tIDANBgkqhkiG9w0BAQEFAASCAQBG6bgNRn9qgi8JjuLVwn6tlykuoMJVLX0S

# TqDG0T60iC5WtoQYHFH/HxMnfe1uOStPoxGr1TM5ANNiX25o/LBF8F2B63+5Et/N

# Y4qJYPBnMM63aVUAvuglP7dZAvOiMEb1WJfb1PMTSGh2l7GFNatiNWr1wn7uH24l

# JQQEfYregpNueNik+FKKpgNNr5K+zMCPuM6qtLOgzauIgSztOK1IGoRouJ8ESsmd

# m74XjYaFUhJEITl3t6fsDP7R65E0BZlABHUHi5DKucnq/iojs7p7e+hi97JJIgom

# wdysykdCMX1tCApkRGeIpKPoWvvbq0qnIcT6vVUKBadmDiYsYVlfoYIXFTCCFxEG

# CisGAQQBgjcDAwExghcBMIIW/QYJKoZIhvcNAQcCoIIW7jCCFuoCAQMxDzANBglg

# hkgBZQMEAgEFADCCAVgGCyqGSIb3DQEJEAEEoIIBRwSCAUMwggE/AgEBBgorBgEE

# AYRZCgMBMDEwDQYJYIZIAWUDBAIBBQAEIHrZU3dYT7dmSO6CmqGcIY2YDFmFyc3n

# +L8nW/WKKYkHAgZiCK5tDP0YEjIwMjIwMzE3MjIxMDE1LjczWjAEgAIB9KCB2KSB

# 1TCB0jELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UE

# CxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQL

# Ex1UaGFsZXMgVFNTIEVTTjo4NkRGLTRCQkMtOTMzNTElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEWUwggcUMIIE/KADAgECAhMzAAABjAGX

# Ykc2dmY7AAEAAAGMMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMB4XDTIxMTAyODE5Mjc0NFoXDTIzMDEyNjE5Mjc0NFowgdIxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv

# c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVz

# IFRTUyBFU046ODZERi00QkJDLTkzMzUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDT

# SGhMoRP5IaxrLD70EV2b65n6S8Q8Yt3mwXxeVPdTLhgapPzr4OvwbeTqr+VFqCLF

# Eq+f6DYAVEv1W5moLW5O9rt1k30KGKi0ccWbLJBk9qVd0lMLycoituBMxcDCH+Zu

# GeahrGwj2MaWK9iCLkY04Tu7pNXhQ62dU/yKiFNR80wqFlol3OZYOOFYLsuM9ciF

# qb1CFGRXOuTF8kpzn0CxoYPc++JGSAegbF+l1Yc89pbyKIQeNzg8OYIqW5bcn4h1

# Tfwf4yQo+Z6QLsa1FMtcoEK5YpdLxONlj/CQ1zNY0Sj6Xknc5l0d5WKDGnMKd6yR

# l9wdfGsJfaG57uom9auSwVK2Rls4bshiZp9gxCtka6WXvY+dLWgh1B1idHn+eBy9

# JBvXUZDSQ0wPOIqxJ37mJ9RphsktnRcTE1XiotcJLrkOP7wXKAKO02+QOIHkez0j

# sr3PFmxRvt8opIYRn3IDQmBNZtwA8Jg+24AdUnxQppP3rukmbv6veGBx7fxVTf2y

# l54ceBoJLi9et6VMuJQwCXQ62TmdwpApzaQae+7A/ZEJLeQQQUDGifAufynJ53Kt

# 5lNsExAGp/WjeSPSKU4nv9/8/dzWudpg7TUYMmia/ui2lvnP7WGtKgizy77p6u4k

# oJOKF3SL/xtzrsAoXvrCla69b0GFtQxOxaTDDivjZwIDAQABo4IBNjCCATIwHQYD

# VR0OBBYEFJbOU4apgiFgiHlWnT6Iyt1Ai1IjMB8GA1UdIwQYMBaAFJ+nFV0AXmJd

# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0l

# BAwwCgYIKwYBBQUHAwgwDQYJKoZIhvcNAQELBQADggIBANdoxUVYwgmp1uVBkrqi

# Sztx0JTB48CaYQh52zK6yBQwhCVCpqN8I/2IbnzI4VJHHaTn2PaEAFJkHEWZuRWP

# CFgQLXIk9Cb3jriBTPkb645bnWLy5554HeHaL4OahY0o1K6Ug3J9IaBbo8IMKJGo

# 7eqfwphXMvOh6Z8+Kv9RXHkICBVwQMAy3FtGtMdcEAFfIJrppDf6O6RYHlpDMvDq

# qEeHPscg5T2r9D1jY2dUEo9/MiXA+NvY2tAZ9CddOyx8UP3w6lEerTtlTHbWDimz

# xXfeFJKQna4PCG2nlW0UacX4DHMUGUK9zfcs9OZexzOXLr7JCABHCY0d40DbrZao

# sskzzgjPw5LVV8TU3rJgKQuODzX7MZeyO8waaMGWLLFnBdYZYmayi8HpPqHUat+a

# 8wq504T3YPrtJHfNPcN0DknAv1MDNfxSGLRoZi2fm41QMVvEijMhEyktWk/9g4ue

# D6va/yzyXJa/Rp+PBlgcEnrgxZU3Edxo22PORi1CN1nluHKRrp1f4O1AP1uHfOOL

# RKWt9UMgvERvo6PKq18aPuJZm8mtvgCohWAdBoPOC6LERL2J60WKQd9/qn3sLmqh

# tNNsrA3QAQ/erm17Ij00g5WUmXSCLkht3nweJ/cks7q+n7nIdeOhIv8yWEWa8a1p

# iZDAPsrNOb24AMXgHM/+bHa/MIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA

# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg

# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2

# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS

# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r

# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k

# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu

# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09

# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR

# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC

# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD

# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR

# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB

# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq

# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ

# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt

# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB

# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP

# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu

# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2

# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d

# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk

# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp

# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp

# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY

# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB

# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB

# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V

# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq

# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V

# M1izoXBm8qGCAtQwggI9AgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg

# T3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4NkRG

# LTRCQkMtOTMzNTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj

# ZaIjCgEBMAcGBSsOAwIaAxUANKLyFOur9DyimnB4bK5ks0Qmr9WggYMwgYCkfjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIFAOXe

# A1AwIhgPMjAyMjAzMTgwMjU4MjRaGA8yMDIyMDMxOTAyNTgyNFowdDA6BgorBgEE

# AYRZCgQBMSwwKjAKAgUA5d4DUAIBADAHAgEAAgISwDAHAgEAAgIRWzAKAgUA5d9U

# 0AIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6Eg

# oQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAOMjcjyj7g0dEg9bfjAGXgkb

# 9lm5LAAZ+q0SQOiqP69Fmu/rVhB7JMDzoEmewl2a9mNMQXMyZ9QOvpXlQkWptDTo

# 9dv+5u/GVhuLsky2NqWtS2eNIPBqEu4+73+lGr1Ds07vRmsgoyr+H/sACXS5DCHb

# 8z19kN4tZ3LJC0rnlzfgMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgUENBIDIwMTACEzMAAAGMAZdiRzZ2ZjsAAQAAAYwwDQYJYIZIAWUDBAIBBQCg

# ggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg

# faxLgn3P035c+pXRSGVH55djGCuUI5N9PwBOWLS+AjAwgfoGCyqGSIb3DQEJEAIv

# MYHqMIHnMIHkMIG9BCDVrYv4FSqQzwZ/xOYhBZ2B4pNOthcjA6h864mIGJhpnjCB

# mDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAk

# BgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABjAGXYkc2

# dmY7AAEAAAGMMCIEICpUjj/Ogo9SKnWivTeX1ckFXsY0EVOn5rlw+cyTyiYtMA0G

# CSqGSIb3DQEBCwUABIICAFOpgH5gW8C8HBm98Ui/bEByq6sABXTjl2wUe6A88ZwX

# LUlAJ9ezTyS3QvuQ1Bnaf76Zhh1vpiJ8piA/jB3L2365Ei5IePWI/6ElD9vJd89b

# 5b8UtKgya22qvkEC6/+IXOFfprHJ2VNYJVhkCvmxQSDCrwpVxqW+kRZzyGA6QBKS

# 6H942ZB6+ooDxnTvl3oB9tIO+GLljFGwXG6DJNCIwMFNSOwAkv7GzMPe6/xD++sl

# QR0W/8kxThveH03QFVJyd2L3LJ0Xdew8Q4dFWmgNb+gMe3cZ3fS91wnIEhuNHQlS

# a9xMu5lPYF01Ip4goavfhQ1ITyGBPKy5QJtBoHVbXgHkTjypnB+1MbpD9S/YWg/T

# ZhNPjiu9mxa+nuDqYg3sUau+W1pj8LzU2tNLl9UNNOMCcm8GMGhMx6pxsKXMdPv6

# FDxwaXMRIAxj8fPxAok4/vurgs4WiH8ah/lmpZAVwDf3u6Y7VcR9bUpYeg/sBqBf

# 7dmwZBShzRSxk3SAF9YhB/GB4L1Nit30p5O3PMg3ZXkiIoL4l2iAtkK1/zsM/Uin

# Bz4s8QK1dF9qh7bl49+0x8+TtZFqbI5//Gs9Zo39dBqW3f1AH+DB8J2PzobOEnYR

# k7R/EhUKfohjbYRibS44URfvJQzhNKJGKLhoiJ30RYjPuVqqYe9HoH8R7FmFV+IG

# SIG # End signature block