M365Documentation

3.4.3

Internal/Helper/Invoke-DocGraph.ps1

                                Function Invoke-DocGraph(){

    <#

    .SYNOPSIS

    This function Requests information from Microsoft Graph

    .DESCRIPTION

    This function Requests information from Microsoft Graph and returns the value as Object[]

    .EXAMPLE

    Invoke-DocGraph -url ""

    Returns "Type"

    .NOTES

    NAME: Thomas Kurth 3.3.2021

    Nico Schmidtbauer 26.03.2025

    Updated script to add retry behavior when Graph Api Returns Error 429 - This might happen on busy tenants

    #>

    [OutputType('System.Object[]')]

    [cmdletbinding()]

    param

    (

        [Parameter(Mandatory=$true,ParameterSetName = "FullPath")]

        $FullUrl,

        [Parameter(Mandatory=$true,ParameterSetName = "Path")]

        [string]$Path,

        [Parameter(Mandatory=$false,ParameterSetName = "Path")]

        [string]$BaseUrl = "https://graph.microsoft.com/",

        [Parameter(Mandatory=$false,ParameterSetName = "Path")]

        [switch]$Beta,

        [Parameter(Mandatory=$false,ParameterSetName = "Path")]

        [string]$AcceptLanguage,

        [Parameter(Mandatory=$false,ParameterSetName = "Path")]

        [bool]$FollowNextLink =  $true

    )

    if($PSCmdlet.ParameterSetName -eq "Path"){

        if($Beta){

            $version = "beta"

        } else {

            $version = "v1.0"

        }

        $FullUrl = "$BaseUrl$version$Path"

    }

    try{

        Write-Verbose "Requesting: $FullUrl"

        Test-TokenExpiration

        $header = @{Authorization = "Bearer $($script:token.AccessToken)"}

        if($AcceptLanguage){ $header.Add("Accept-Language",$AcceptLanguage) }

        $header.Add("Accept","application/json")

        # Use try catch, to get a possible exception

        try {

            $value = Invoke-RestMethod -Headers $header -Uri $FullUrl -Method Get

        }

        catch {

            $value = $_

        }

        # If an exception occures, check if the status code is 429, if not, throw the exception, otherwise run in retry.

        if($value.Exception) {

            if([int]$value.Exception.Response.StatusCode -ne "429") {

                throw $value

            }

            else {

                $requestCounter = 1

                # While the exception occures and is 429, retry up to 10 times and write a warning.

                while([int]$value.Exception.Response.StatusCode -eq "429") {

                    $maxRequests = 10

                    Write-Warning -Message "Graph API is currently busy (Too many requests) - Retrying request ($requestCounter/$maxRequests)"

                    try {

                        $value = Invoke-RestMethod -Headers $header -Uri $FullUrl -Method Get

                    }

                    catch {

                        $value = $_

                    }

                    if($requestCounter -gt $maxRequests -and [int]$value.Exception.Response.StatusCode -eq "429") {

                        Write-Warning -Message "Graph API is currently busy (Too many requests) - Retrys limit exceeded"

                        throw $value

                    }

                    Start-Sleep -seconds 1

                }

                # Just making sure if the last call returned an exception again, throw it here.

                if([int]$value.Exception) {

                    throw $value

                }

            }

        }

        if($FollowNextLink -and -not [String]::IsNullOrEmpty($value.'@odata.nextLink')){

            $NextLink = $value.'@odata.nextLink'

            do{

                Test-TokenExpiration

                $header = @{Authorization = "Bearer $($script:token.AccessToken)"} # Need to recreate the header incase the bearer token changed on refresh.

                if($AcceptLanguage){ $header.Add("Accept-Language",$AcceptLanguage) }       

                $header.Add("Accept","application/json")

                # Same exception / retry handling as above, just for possible '@odata.nextLink'

                try {

                    $valueNext = Invoke-RestMethod -Headers $header -Uri $NextLink -Method Get

                }

                catch {

                    $valueNext = $_

                }

                if($valueNext.Exception) {

                    if([int]$valueNext.Exception.Response.StatusCode -ne "429") {

                        throw $valueNext

                    }

                    else {

                        $requestCounter = 1

                        while([int]$valueNext.Exception.Response.StatusCode -eq "429") {

                            $maxRequests = 10

                            Write-Warning -Message "Graph API is currently busy (Too many requests) - Retrying request ($requestCounter/$maxRequests)"

                            try {

                                $valueNext = Invoke-RestMethod -Headers $header -Uri $NextLink -Method Get

                            }

                            catch {

                                $valueNext = $_

                            }

                            if($requestCounter -gt $maxRequests -and [int]$valueNext.Exception.Response.StatusCode -eq "429") {

                                Write-Warning -Message "Graph API is currently busy (Too many requests) - Retrys limit exceeded"

                                throw $valueNext

                            }

                            Start-Sleep -seconds 1

                        }

                        if([int]$valueNext.Exception) {

                            throw $valueNext

                        }

                    }

                }

                $NextLink = $valueNext.'@odata.nextLink'

                $valueNext.value | ForEach-Object { $value.value += $_ }

            } until(-not $NextLink)

        }

    } catch {

        $caughtError = $_

        Write-Verbose "Error on requesting '$FullUrl'"

        try {

            # See if there is a valid error message to return in the json

            if($caughtError.ErrorDetails.Message) {

                $jsonResponse = $caughtError.ErrorDetails.Message | ConvertFrom-Json

            } else {

                $jsonResponse = @{}

            }

        } catch {

            # There was no message or it wasn't formatted as json. Throw original error.

            $jsonResponse = @{}

        }

        if($caughtError.Exception.Response.StatusCode -eq "Forbidden"){

            Write-Warning "Forbidden: Used application does not have sufficiant permission to access. FullUrl: '$FullUrl'" -WarningAction Continue

        } elseif ($caughtError.Exception.Response.StatusCode -eq "Unauthorized"){

            Write-Warning "Unauthorized: The most common cause is an invalid, missing, or expired access token in the HTTP request header. It might also be a missing license assignment. FullUrl: '$FullUrl'" -WarningAction Continue

        } elseif ($caughtError.Exception.Response.StatusCode -eq "NotFound" -and $_.Exception.Response.ResponseUri -like "https://graph.microsoft.com/v1.0/groups*"){

            Write-Verbose "NotFound: Some Profiles/Apps are assigned to groups which do no longer exist. They are not displayed in the output $($_.Exception.Response.ResponseUri). FullUrl: '$FullUrl'" 

        } elseif ($caughtError.Exception.Response.StatusCode -eq "NotFound" -and $_.Exception.Response.ResponseUri -like "https://graph.microsoft.com/v1.0/users*"){

            Write-Verbose "NotFound: Some Profiles/Apps are assigned to users which do no longer exist. They are not displayed in the output $($_.Exception.Response.ResponseUri). FullUrl: '$FullUrl'"

        }  elseif ($caughtError.Exception.Response.StatusCode -eq "NotFound"){

            Write-Warning "NotFound: The configuration or object might not exist in your tenant. FullUrl: '$FullUrl'"

            $value = [PSCustomObject]@{

                Status    = 'Not Found'

            }

        } else  {

            if($jsonResponse.ErrorDetails.Message) {

                # If there was an error we can display, show it.

                throw $jsonResponse.ErrorDetails.Message

            } Else {

                # No mesasge returned from Graph, return raw error.

                throw $_

            }

        }

    }

    return $value

}

# SIG # Begin signature block

# MIIoaQYJKoZIhvcNAQcCoIIoWjCCKFYCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDh5GL4sVlgIT0I

# 54fw9Z3VG/2jh4y8+uuctxrUPyQYfqCCIWYwggWNMIIEdaADAgECAhAOmxiO+dAt

# 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV

# BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa

# Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy

# dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD

# ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC

# ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E

# MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy

# unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF

# xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1

# 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB

# MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR

# WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6

# nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB

# YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S

# UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x

# q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB

# NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP

# TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC

# AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp

# Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv

# bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB

# LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc

# Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov

# Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy

# oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW

# juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF

# mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z

# twGpn1eqXijiuZQwggawMIIEmKADAgECAhAIrUCyYNKcTJ9ezam9k67ZMA0GCSqG

# SIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx

# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRy

# dXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBaFw0zNjA0MjgyMzU5NTlaMGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg

# MjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDVtC9C0Cit

# eLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc9es0JAfhS0/TeEP0F9ce2vnS

# 1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyAVxJrQ5qZ8sU7H/Lvy0daE6ZM

# swEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQIXhFLqGfLOEYwhrMxe6TSXBC

# Mo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/sk+FLEikVoQ11vkunKoAFdE3

# /hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na59zHh3K3kGKDYwSNHR7OhD26j

# q22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pgVItJwZPt4bRc4G/rJvmM1bL5

# OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7BzzosmJQayg9Rc9hUZTO1i4F4z8ujo

# 7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQokbIYViY9XwCFjyDKK05huzU

# tw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jLchApQfDVxW0mdmgRQRNYmtwm

# KwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHMIRroOBl8ZhzNeDhFMJlP/2NP

# TLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQABo4IBWTCCAVUwEgYDVR0TAQH/

# BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHwYDVR0j

# BBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1Ud

# JQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0

# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8E

# PDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVz

# dGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeBDAEDMAgGBmeBDAEEATANBgkq

# hkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bgAhql+Eg08yy25nRm95RysQDK

# r2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7FoFFUP2cvbaF4HZ+N3HLIvda

# qpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZGM1hmYFW9snjdufE5BtfQ/g+

# lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG3RywYFzzDaju4ImhvTnhOE7a

# brs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5UbdldAhQfQDN8A+KVssIhdXNS

# y0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WIIIJw8MzK7/0pNVwfiThV9zeK

# iwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956rEnPLqR0kq3bPKSchh/jwVYb

# KyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuWTatEQOON8BUozu3xGFYHKi8Q

# xAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3E+bnKD+sEq6lLyJsQfmCXBVm

# zGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60bhQjiWQ1tygVQK+pKHJ6l/aCn

# HwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOImYIbqyK+p/pQd52MbOoZWeE4w

# gga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqGSIb3DQEBCwUAMGIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBH

# NDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkxCzAJBgNVBAYTAlVT

# MRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1

# c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphBcr48RsAcrHXbo0Zo

# dLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6pvF4uGjwjqNjfEvUi

# 6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHeHYNnQxqXmRinvuNg

# xVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEdgkFiDNYiOTx4OtiF

# cMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjUjsZvkgFkriK9tUKJ

# m/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bRVFLeGkuAhHiGPMvS

# GmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeSLsJygoLPp66bkDX1

# ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIVNSaz7BX8VtYGqLt9

# MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL6s36czwzsucuoKs7

# Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2ZdSoQbU2rMkpLiQ6bG

# RinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFUeEY0qVjPKOWug/G6

# X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIBADAd

# BgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0jBBgwFoAU7NfjgtJx

# XWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUF

# BwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJo

# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNy

# bDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcNAQEL

# BQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/T8ObXAZz8OjuhUxj

# aaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQE7jU/kXjjytJgnn0

# hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9rEVKChHyfpzee5kH0

# F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y1IsA0QF8dTXqvcnT

# mpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gxdEkMx1NKU4uHQcKf

# ZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3ty9qIijanrUR3anzE

# wlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcytL5TTLL4ZaoBdqbh

# OhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEBYTptMSbhdhGQDpOX

# gpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud/v4+7RWsWCiKi9EO

# LLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiSuEtQvLsNz3Qbp7wG

# WqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZPubdcMIIG7TCCBNWg

# AwIBAgIQCoDvGEuN8QWC0cR2p5V0aDANBgkqhkiG9w0BAQsFADBpMQswCQYDVQQG

# EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0

# IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0Ex

# MB4XDTI1MDYwNDAwMDAwMFoXDTM2MDkwMzIzNTk1OVowYzELMAkGA1UEBhMCVVMx

# FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBTSEEy

# NTYgUlNBNDA5NiBUaW1lc3RhbXAgUmVzcG9uZGVyIDIwMjUgMTCCAiIwDQYJKoZI

# hvcNAQEBBQADggIPADCCAgoCggIBANBGrC0Sxp7Q6q5gVrMrV7pvUf+GcAoB38o3

# zBlCMGMyqJnfFNZx+wvA69HFTBdwbHwBSOeLpvPnZ8ZN+vo8dE2/pPvOx/Vj8Tch

# TySA2R4QKpVD7dvNZh6wW2R6kSu9RJt/4QhguSssp3qome7MrxVyfQO9sMx6ZAWj

# FDYOzDi8SOhPUWlLnh00Cll8pjrUcCV3K3E0zz09ldQ//nBZZREr4h/GI6Dxb2Uo

# yrN0ijtUDVHRXdmncOOMA3CoB/iUSROUINDT98oksouTMYFOnHoRh6+86Ltc5zjP

# KHW5KqCvpSduSwhwUmotuQhcg9tw2YD3w6ySSSu+3qU8DD+nigNJFmt6LAHvH3KS

# uNLoZLc1Hf2JNMVL4Q1OpbybpMe46YceNA0LfNsnqcnpJeItK/DhKbPxTTuGoX7w

# JNdoRORVbPR1VVnDuSeHVZlc4seAO+6d2sC26/PQPdP51ho1zBp+xUIZkpSFA8vW

# doUoHLWnqWU3dCCyFG1roSrgHjSHlq8xymLnjCbSLZ49kPmk8iyyizNDIXj//cOg

# rY7rlRyTlaCCfw7aSUROwnu7zER6EaJ+AliL7ojTdS5PWPsWeupWs7NpChUk555K

# 096V1hE0yZIXe+giAwW00aHzrDchIc2bQhpp0IoKRR7YufAkprxMiXAJQ1XCmnCf

# gPf8+3mnAgMBAAGjggGVMIIBkTAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBTkO/zy

# Me39/dfzkXFjGVBDz2GM6DAfBgNVHSMEGDAWgBTvb1NK6eQGfHrK4pBW9i/USezL

# TjAOBgNVHQ8BAf8EBAMCB4AwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwgZUGCCsG

# AQUFBwEBBIGIMIGFMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wXQYIKwYBBQUHMAKGUWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYyMDI1Q0ExLmNy

# dDBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGln

# aUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAyNUNBMS5j

# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB

# CwUAA4ICAQBlKq3xHCcEua5gQezRCESeY0ByIfjk9iJP2zWLpQq1b4URGnwWBdEZ

# D9gBq9fNaNmFj6Eh8/YmRDfxT7C0k8FUFqNh+tshgb4O6Lgjg8K8elC4+oWCqnU/

# ML9lFfim8/9yJmZSe2F8AQ/UdKFOtj7YMTmqPO9mzskgiC3QYIUP2S3HQvHG1FDu

# +WUqW4daIqToXFE/JQ/EABgfZXLWU0ziTN6R3ygQBHMUBaB5bdrPbF6MRYs03h4o

# bEMnxYOX8VBRKe1uNnzQVTeLni2nHkX/QqvXnNb+YkDFkxUGtMTaiLR9wjxUxu2h

# ECZpqyU1d0IbX6Wq8/gVutDojBIFeRlqAcuEVT0cKsb+zJNEsuEB7O7/cuvTQasn

# M9AWcIQfVjnzrvwiCZ85EE8LUkqRhoS3Y50OHgaY7T/lwd6UArb+BOVAkg2oOvol

# /DJgddJ35XTxfUlQ+8Hggt8l2Yv7roancJIFcbojBcxlRcGG0LIhp6GvReQGgMgY

# xQbV1S3CrWqZzBt1R9xJgKf47CdxVRd/ndUlQ05oxYy2zRWVFjF7mcr4C34Mj3oc

# CVccAvlKV9jEnstrniLvUxxVZE/rptb7IRE2lskKPIJgbaP5t2nGj/ULLi49xTcB

# ZU8atufk+EMF/cWuiC7POGT75qaL6vdCvHlshtjdNXOCIUjsarfNZzCCB3QwggVc

# oAMCAQICEATxuaBOthmGPBQf/T19vOkwDQYJKoZIhvcNAQELBQAwaTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MTAeFw0yMzEwMDkwMDAwMDBaFw0yNjExMjAyMzU5NTlaMHwxCzAJBgNVBAYTAkNI

# MRIwEAYDVQQIEwlTb2xvdGh1cm4xDjAMBgNVBAcTBU9sdGVuMRYwFAYDVQQKEw1i

# YXNlVklTSU9OIEFHMRkwFwYDVQQLExBJbnRlcm5hbCBTY3JpcHRzMRYwFAYDVQQD

# Ew1iYXNlVklTSU9OIEFHMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# ufaKcpNEghlaO8FJ9JxMxyWtjYDMzK6NEc/2Ey9j3eDKs5MtSDaH6jCZwVIoy0gh

# VM7qQp4mDq7VxTy+LF+EvKOUZ7cBFAM9BF+e0r7Wypq0zloEBB//7YJcnqgwzdco

# Fb2tv1NeVwgE5hzbjpp9ZGtp+WOr0PiDQT7uI7WHMz7CjyeZyBf06wkntnwneuKy

# N3XLzWnbJbwGR0ku+uWZyxni/IqO6Aif+r5fdOed2giizFVrDPJRZ8tu9od+DmAJ

# 7B8Am5Ki3EnxlEyHL3oOolignkrZlt+TyFDAOGyA2f1wV+3MhYCngGDIl+sjcQIB

# A8ObAULMU27iFgdtWmPc5NanibHRkUdXgXnWczMFmpTBnbwJV5CJGMDwBtSU8Tnb

# edOmpF6iIh+nKbxLEOVF90WPrG86rp6ou4BjHz+djua9GO/W3R3HmGCspMl53+r8

# 74zx+B01QRA78JDKdENaa6W9VOICHtZ8s1CISrjw7dvI45cmwopIBivVweCo5OXm

# r1eBcKFbsH2wtGdoO5h12aW7yXEm0sqYMWHRsN/DXgCbW5Aq7o1v7CSNpcSZW+wB

# Ncf9surdMLzwT6vbo3GwqbSxrjeLbHOinn9cV9e2ROA4E7PMQLlyPvffcXn9QWAv

# kTYm/gMbpXepQATcupfEzTnSmHMJwEbAqP0XqbcftckCAwEAAaOCAgMwggH/MB8G

# A1UdIwQYMBaAFGg34Ou2O/hfEYb7/mF7CIhl9E5CMB0GA1UdDgQWBBRm81EbqiBD

# YIXuCPS2E6CaB1RXyjA+BgNVHSAENzA1MDMGBmeBDAEEATApMCcGCCsGAQUFBwIB

# FhtodHRwOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwDgYDVR0PAQH/BAQDAgeAMBMG

# A1UdJQQMMAoGCCsGAQUFBwMDMIG1BgNVHR8Ega0wgaowU6BRoE+GTWh0dHA6Ly9j

# cmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNB

# NDA5NlNIQTM4NDIwMjFDQTEuY3JsMFOgUaBPhk1odHRwOi8vY3JsNC5kaWdpY2Vy

# dC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQy

# MDIxQ0ExLmNybDCBlAYIKwYBBQUHAQEEgYcwgYQwJAYIKwYBBQUHMAGGGGh0dHA6

# Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBcBggrBgEFBQcwAoZQaHR0cDovL2NhY2VydHMu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29kZVNpZ25pbmdSU0E0MDk2

# U0hBMzg0MjAyMUNBMS5jcnQwCQYDVR0TBAIwADANBgkqhkiG9w0BAQsFAAOCAgEA

# eDbtA8CjFmSEjjq3jgM7utHOhN56IwIVyL4RuVCxPyRwZ1qg9RRzK6LetRwQ969P

# TSXfJFNP1JWGHRkkmKUH/yk5AdTz8vTFLWeYQSrdY5tf246HMFzjassGQnRMdOUr

# IOf+yeGDRy7ktBZGWCIxRZWtT/naIl1lgplLx3O+a5iRV6eTGq20ns1mXnJHyjQ4

# YoPW77YigKFqeJ0Sc/7MzxO9soqr37pRHrgCjuZYso6ExRorvy8cXFINLF+2cyoi

# XXiimWbKA6gxWte+ZyRgGbgmYgTCDqGSH7bCyIJy7oHhcSU5mOauX4b1IgAVwJDf

# frZpQhcDgAy3w4USlO8wmZ616Kdvj1/FG6/7Wh1/3fyxdNfDGx8h2HA6C5wjbmMP

# NaxwS4Cua7MItgVQgHx3FrKLUkGZZoNogSKX3vXAkF1ezDOec8kOeJgHo148esAV

# py9mMWWBbwAbOnxyiC9uMs135xSxEkai2AFjfNYbIKmmEC6l21dNdxz3RRLJzbsB

# McWZ/IHHvD2L702sNDow4N13vDrZfT2G+TbRgzKfq2iCA3OXSMwwofz24RTxkDof

# BKb7ySKnnE6FZwe4u3NHoUOkfrsMyxpmugnOpFiRf2lK0Qzuu9W4sW0+4PEPnokM

# mvymlpDldO5AIqud0quQfdu70cmTzpHVPPMz9wCDR3AxggZZMIIGVQIBATB9MGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQg

# MjAyMSBDQTECEATxuaBOthmGPBQf/T19vOkwDQYJYIZIAWUDBAIBBQCggYQwGAYK

# KwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg

# tRJ2+/mEMXmFWi5eYFuudlszhlJTmQwTsr+CaT3qbxMwDQYJKoZIhvcNAQEBBQAE

# ggIASgls7JPmdFZi52CdINvJPKaoqsYizrUGZrDGrmCSIO1BmLncZYmbMcjeZVbT

# yE9eJ62D2PqLcIZB0OT9WiBIUc/V3IFaGlHoJLhujTQqW3TGS9Dw+yuOx+n7jB4E

# YwxteCbv293RY+nRsgL0iNJGwsM5emg5/kv2uRaJNz6ATO0Ly+6S8u6YM1AVo88d

# HbF3bFZYko95AHk5rzHW+4TZpsrP5uAy0aS8aHBVfBCScWG5IDE3EtFdM2Ropzit

# QMsdoYuxYYqI9Awqlz9nLFGyl0olusuEOdz9s5vZgd7sjJPJrLoWK1HuT5m1f6jk

# UdGfut7eHLKJAPfs2beci2ElCUoI0avZn0MBwTGk156JKMQZskZPefwRR9O1nMSg

# JQSQcHBv0XPNC7hlX1BSl95gjXAPnyLj6nfsmZ7XK2sdk1VhKCdJ8e63/seZ5oqy

# 19aXnEzN1fS/vvPGcsj/Cz9Idgzg7nRYdX9BbJINp6pJT4L1exFXj2rbKQivhKJ5

# MLSIGiLtFLGiUsr7GoQD8N6KH6QG2gSgCj3uk2JdakgIAiaq3d7540CYY3ecDE5b

# tmcxC3dtVZgh57cOCcDvqg74HQHzgx/cUN4n3EDEXiy9uHMM7VIfVevcLU7wSo5p

# KlhtrYS1UNO6n3nI7kALCe7eLgc2O7TKk51liPt+BqNNGaOhggMmMIIDIgYJKoZI

# hvcNAQkGMYIDEzCCAw8CAQEwfTBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGln

# aUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgVGltZVN0

# YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0ExAhAKgO8YS43xBYLRxHanlXRo

# MA0GCWCGSAFlAwQCAQUAoGkwGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkq

# hkiG9w0BCQUxDxcNMjUwOTMwMTMxMjA3WjAvBgkqhkiG9w0BCQQxIgQgafX3CY8t

# tYUd+qI8NOTM/2DNSuKB4OqdTP+tFblr8W0wDQYJKoZIhvcNAQEBBQAEggIAUI2C

# Rd1djKxPzyAM48SFoLuUA0q+5kALP4UXxSQsJKqS73kLtmV/tVnyerFxdCPdqPaV

# oqQ+5DLn1K7uQuxMKKFldxZjLu6yqFfCfNpAKUD68yJhMVPPCEXZnyWX5R32T7M2

# 6GV6mB893hdXgEedPSLRbh4Fy1TvH7pALoDGfjT350HqWRYz/0qq4Wcojh0T61xI

# kmxchcYh0ZlwfYC5FQzkV7VERmE/mKJmQHRq7Qox92gMWFqsSESEGKdeZkWCGHhb

# c+lUuf2WUdeuPDk8OXOf8O0JLTIxpoaaFYS+woVsNAskV9Y0kklSrP9O0Z6CklCW

# c9KYaBwA1AiJp5q3ompGltP0OiYa5z2eMevye6TG/IVM76pW9t6ufHkJOLFeY4I2

# lP/jG3Jnyla8v8vg86Kwd1XV2cdFRyLQLBC8abu0FwiH+dDBEzJ23V6YNByJLdn7

# qZrY7FUir8BZv1mTWUyg6Mj5qDLQKxuO8TxFxG4CbrJYKfGy7alFu9JXzcQIl6TR

# jVERWXG45hyNe4QR9oSjg39xP+YP9flIemqxAgrR2/hSt7kcw7G5gTTV8NVQ85zB

# gVEjs+q3JuSxAfA47qVN+cc91hLQ392k6upihq3XKPmbWa0zJs49rsyhAAhVIYKX

# GbDHKEQgHR7MxZWJ+n6ICxG4F51X9uoWnzu23JM=

# SIG # End signature block