EntraProvisionOnDemand

1.0.2

Public/Invoke-EntraProvisionOnDemandBatch.ps1

                                function Invoke-EntraProvisionOnDemandBatch {

    <#

    .SYNOPSIS

        Triggers on-demand provisioning for multiple objects from a file or pipeline.

    .DESCRIPTION

        Processes multiple objects for on-demand provisioning with built-in throttling

        to respect Microsoft Graph API rate limits (5 requests per 10 seconds).

        Supports CSV input files or pipeline input from other cmdlets.

    .PARAMETER ServicePrincipalId

        The ID of the service principal (Enterprise Application) with provisioning.

    .PARAMETER JobId

        The ID of the synchronization job.

    .PARAMETER InputFile

        Path to a CSV file containing objects to provision. The CSV must have a column

        named 'DistinguishedName', 'ObjectId', 'DN', or 'Identity'.

    .PARAMETER InputObject

        Array of objects to provision. Each object should have an ObjectId or 

        DistinguishedName property.

    .PARAMETER ObjectTypeName

        The type of objects to provision. Default is 'user'. Can also be 'group'.

    .PARAMETER RuleId

        Optional. The specific synchronization rule ID to apply.

    .PARAMETER ThrottleSeconds

        Seconds to wait between API requests for rate limiting. Default is 1 second.

        Adjust higher if experiencing throttling (e.g., 2 seconds for 5 requests per 10 seconds).

    .PARAMETER StopOnError

        If specified, stops processing on the first error.

    .PARAMETER PassThru

        If specified, returns result objects for each provisioning operation.

        Without this switch, only a summary is returned.

    .EXAMPLE

        Invoke-EntraProvisionOnDemandBatch -ServicePrincipalId $appId -JobId $jobId `

            -InputFile "C:\users-to-provision.csv"

        Provisions all users in the CSV file.

    .EXAMPLE

        Get-ADUser -Filter {Department -eq 'IT'} | Select-Object DistinguishedName |

            Invoke-EntraProvisionOnDemandBatch -ServicePrincipalId $appId -JobId $jobId

        Provisions users from AD pipeline input.

    .EXAMPLE

        Get-EntraProvisioningLog -JobId $jobId -Status 'Failure' -StartTime (Get-Date).AddDays(-1) |

            Select-Object @{N='ObjectId';E={$_.SourceIdentity.Id}} |

            Invoke-EntraProvisionOnDemandBatch -ServicePrincipalId $appId -JobId $jobId

        Re-provisions failed users from provisioning logs.

    .OUTPUTS

        Returns a summary object with success/failure counts, or detailed results with -PassThru.

    #>

    [CmdletBinding(DefaultParameterSetName = 'File', SupportsShouldProcess)]

    param(

        [Parameter(Mandatory = $true)]

        [string]$ServicePrincipalId,

        [Parameter(Mandatory = $true)]

        [string]$JobId,

        [Parameter(Mandatory = $true, ParameterSetName = 'File')]

        [ValidateScript({ Test-Path $_ -PathType Leaf })]

        [string]$InputFile,

        [Parameter(Mandatory = $true, ParameterSetName = 'Pipeline', ValueFromPipeline = $true)]

        [object[]]$InputObject,

        [Parameter(Mandatory = $false)]

        [ValidateSet('user', 'group', 'User', 'Group')]

        [string]$ObjectTypeName = 'user',

        [Parameter(Mandatory = $false)]

        [string]$RuleId,

        [Parameter(Mandatory = $false)]

        [ValidateRange(0, 60)]

        [int]$ThrottleSeconds = 1,

        [Parameter(Mandatory = $false)]

        [switch]$StopOnError,

        [Parameter(Mandatory = $false)]

        [switch]$PassThru

    )

    begin {

        # Initialize counters

        $stats = @{

            Total     = 0

            Success   = 0

            Failed    = 0

            Skipped   = 0

            StartTime = Get-Date

        }

        $results = @()

        $objectsToProcess = @()

        # Load from file if specified

        if ($PSCmdlet.ParameterSetName -eq 'File') {

            Write-Host "Loading objects from: $InputFile" -ForegroundColor Cyan

            $csvData = Import-Csv -Path $InputFile

            foreach ($row in $csvData) {

                # Try to find the object identifier column

                $objectId = $row.DistinguishedName ?? $row.ObjectId ?? $row.DN ?? $row.Identity ?? $row.objectId

                if (-not $objectId) {

                    Write-Warning "Row does not contain a valid object identifier (DistinguishedName, ObjectId, DN, or Identity). Skipping."

                    continue

                }

                $objectsToProcess += [PSCustomObject]@{

                    ObjectId       = $objectId

                    DisplayName    = $row.DisplayName ?? $row.displayName

                    ObjectTypeName = $row.ObjectTypeName ?? $ObjectTypeName

                }

            }

            Write-Host "Loaded $($objectsToProcess.Count) objects from CSV." -ForegroundColor Cyan

        }

    }

    process {

        # Handle pipeline input

        if ($PSCmdlet.ParameterSetName -eq 'Pipeline') {

            foreach ($obj in $InputObject) {

                $objectId = $null

                if ($obj -is [string]) {

                    $objectId = $obj

                }

                else {

                    $objectId = $obj.DistinguishedName ?? $obj.ObjectId ?? $obj.DN ?? $obj.Identity ?? $obj.objectId

                }

                if ($objectId) {

                    $objectsToProcess += [PSCustomObject]@{

                        ObjectId       = $objectId

                        DisplayName    = $obj.DisplayName ?? $obj.displayName

                        ObjectTypeName = $obj.ObjectTypeName ?? $ObjectTypeName

                    }

                }

            }

        }

    }

    end {

        if ($objectsToProcess.Count -eq 0) {

            Write-Warning "No objects to process."

            return

        }

        $stats.Total = $objectsToProcess.Count

        Write-Host ""

        Write-Host "Starting batch provisioning for $($stats.Total) objects..." -ForegroundColor Cyan

        Write-Host "Throttle: $ThrottleSeconds seconds between requests" -ForegroundColor Gray

        Write-Host ""

        $current = 0

        foreach ($obj in $objectsToProcess) {

            $current++

            # Build display string with optional DisplayName

            $displayStr = if ($obj.DisplayName) { "$($obj.DisplayName) ($($obj.ObjectId))" } else { $obj.ObjectId }

            if ($PSCmdlet.ShouldProcess($obj.ObjectId, "Provision on demand ($current of $($stats.Total))")) {

                Write-ProvisioningProgress -Message "Processing: $displayStr" -Status 'Processing' -Current $current -Total $stats.Total

                try {

                    $result = Invoke-EntraProvisionOnDemand -ServicePrincipalId $ServicePrincipalId `

                        -JobId $JobId -ObjectId $obj.ObjectId -ObjectTypeName $obj.ObjectTypeName `

                        -RuleId $RuleId -DisplayName $obj.DisplayName

                    if ($result.Status -eq 'Success') {

                        $stats.Success++

                    }

                    else {

                        $stats.Failed++

                        if ($StopOnError) {

                            Write-Warning "Stopping on error as requested."

                            break

                        }

                    }

                    if ($PassThru) {

                        $results += $result

                    }

                }

                catch {

                    $stats.Failed++

                    Write-ProvisioningProgress -Message "Error: $displayStr - $_" -Status 'Failed'

                    if ($PassThru) {

                        $results += New-ProvisioningResult -ObjectId $obj.ObjectId -ObjectTypeName $obj.ObjectTypeName `

                            -Status 'Failed' -Message $_.Exception.Message

                    }

                    if ($StopOnError) {

                        Write-Warning "Stopping on error as requested."

                        break

                    }

                }

                # Throttle between requests (except for last item)

                if ($current -lt $stats.Total -and $ThrottleSeconds -gt 0) {

                    Start-Sleep -Seconds $ThrottleSeconds

                }

            }

            else {

                $stats.Skipped++

                if ($PassThru) {

                    $results += New-ProvisioningResult -ObjectId $obj.ObjectId -ObjectTypeName $obj.ObjectTypeName `

                        -Status 'Skipped' -Message 'Skipped by user (WhatIf)'

                }

            }

        }

        # Clear progress bar

        Write-Progress -Activity "Entra Provisioning" -Completed

        # Calculate duration

        $stats.EndTime = Get-Date

        $stats.Duration = $stats.EndTime - $stats.StartTime

        # Display summary

        Write-Host ""

        Write-Host "========================================" -ForegroundColor Cyan

        Write-Host "Batch Provisioning Complete" -ForegroundColor Cyan

        Write-Host "========================================" -ForegroundColor Cyan

        Write-Host "Total:    $($stats.Total)" -ForegroundColor White

        Write-Host "Success:  $($stats.Success)" -ForegroundColor Green

        Write-Host "Failed:   $($stats.Failed)" -ForegroundColor Red

        Write-Host "Skipped:  $($stats.Skipped)" -ForegroundColor Yellow

        Write-Host "Duration: $($stats.Duration.ToString('hh\:mm\:ss'))" -ForegroundColor Gray

        Write-Host "========================================" -ForegroundColor Cyan

        Write-Host ""

        # Return results

        if ($PassThru) {

            return $results

        }

        else {

            return [PSCustomObject]@{

                PSTypeName = 'EntraProvisionOnDemand.BatchResult'

                Total      = $stats.Total

                Success    = $stats.Success

                Failed     = $stats.Failed

                Skipped    = $stats.Skipped

                StartTime  = $stats.StartTime

                EndTime    = $stats.EndTime

                Duration   = $stats.Duration

            }

        }

    }

}

# SIG # Begin signature block

# MIIoYgYJKoZIhvcNAQcCoIIoUzCCKE8CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAIyXwHArP4gKRD

# cBIYnBGlbOFeXvHlM4Y+cucThnJE3qCCIV8wggWNMIIEdaADAgECAhAOmxiO+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/cWuiC7POGT75qaL6vdCvHlshtjdNXOCIUjsarfNZzCCB20wggVV

# oAMCAQICEAnI7Fw0fQcgWcyoNeinb/gwDQYJKoZIhvcNAQELBQAwaTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MTAeFw0yMzAzMjkwMDAwMDBaFw0yNjA2MjIyMzU5NTlaMHUxCzAJBgNVBAYTAkFV

# MRgwFgYDVQQIEw9OZXcgU291dGggV2FsZXMxFDASBgNVBAcTC0NoZXJyeWJyb29r

# MRowGAYDVQQKExFEYXJyZW4gSiBSb2JpbnNvbjEaMBgGA1UEAxMRRGFycmVuIEog

# Um9iaW5zb24wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDHrKfntVGe

# XaDp6S/nqZuiKuhmIqivGTXM9VwXuzO3gV8FcuLWD+QciGujTkWBLHpVViPV5jtT

# PnD0uo0TK6WW/cbVB/jaSmTvnkrYYEwLZxDtXVmgCumOwB/2VY5oDk1mVwVYm4wB

# PyUCiH2cseB5uRTh+oat27JQPkVEKaNzUMTb9gLs3JCkMG1uwKFyDbnY9HbmAog2

# LIZ//Zh884C9FaTWEaZoBGu1loHNSR9e1fkmJWn+qjFqWKFrjg8Lg5bUh9qee6gC

# Nv+Ceq1GBL57O0GfbICFHRpVK+fen6dGOI7sqclRhO0a9GvD7Qci1lLqcle2eZCj

# 6/zEY3q1wJgZ3+gHYSN5GOho89+en2ZDwOPVLgiFxYMk2U/OAKOipcPtEaie9CQ7

# eOPVJMu4XWvofIdj4lHX+610Gplee5mOufpRwJnOPlIE7lrJ6cJ07jZZG2cUZwsN

# g/lt6raNmgYQ3m3Iimc4r34gFpVn03B7QqcveoDOS/jgeOXsw6VOigB9YcEUozkV

# JVucqBU11Gz1AUX5VNztm2dMHQCXslGGh1gGsjaMhX7ina5gi7SMe9ujtOnc/SoP

# nCX/tWXSeynFL2YEdnfBdfRVeRtQlTJzs4TGUdnZyHieYdBIHDijR5d4TChXVUce

# JYVvLXK0EDeGU9hIBnyPXwXNItxl0xQNMQIDAQABo4ICAzCCAf8wHwYDVR0jBBgw

# FoAUaDfg67Y7+F8Rhvv+YXsIiGX0TkIwHQYDVR0OBBYEFAUxVql07mJzafndN3rN

# ijPSXRlIMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzCBtQYD

# VR0fBIGtMIGqMFOgUaBPhk1odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNl

# cnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQyMDIxQ0ExLmNybDBT

# oFGgT4ZNaHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0

# Q29kZVNpZ25pbmdSU0E0MDk2U0hBMzg0MjAyMUNBMS5jcmwwPgYDVR0gBDcwNTAz

# BgZngQwBBAEwKTAnBggrBgEFBQcCARYbaHR0cDovL3d3dy5kaWdpY2VydC5jb20v

# Q1BTMIGUBggrBgEFBQcBAQSBhzCBhDAkBggrBgEFBQcwAYYYaHR0cDovL29jc3Au

# ZGlnaWNlcnQuY29tMFwGCCsGAQUFBzAChlBodHRwOi8vY2FjZXJ0cy5kaWdpY2Vy

# dC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQy

# MDIxQ0ExLmNydDAJBgNVHRMEAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBYQAlozzK3

# Gn8A32eZnv51K5L+MmICIud+XHXTwJv9rMBg07s0lQVRyDAafC1i5s1zwNRm8QTp

# gOC/L7w4IxKUBfSPT4eTDWIGIYNMUqQCKffygKHODkJ8JckRjzfgo2smONMcU8+P

# 4R6IVoOK5yTCLlRI5DLSpzHU26Z6lPOcO/AEJXw+/b/4FkNnS9U959fBzhI07fFU

# rq8ZBIUOSN0h/Aq/WIVL/eDm1iFGzilLeUhu5v3fstpn5CkUjpkZbi0qGCz1m8d+

# aQK7GJGj6Y3+WJeY4iT2NxkMxFP0kVVtK68AwG7SkjdIClrWcYozw27PGkFGAoox

# X43ujlhheEZ5j0kIdBX/AMsz0HMfS40P/Fu4FBC7BOiBblz+W49ouoHi8uuS0XuO

# kGZWA6v2zGs1KGUE5Y3v4bOqZDi+H9Sr+7WyWZjBDVVVESTZng0Xo7zZYh2mhhAL

# /4hdGaO6ar4+MAgghht4/7DUeVkkWJ8X+cUOK/YvYGapOMo8JPwyQltq5ijQlKMT

# SGVodhCJTEg88NwzCpNspWXYmPywIuRpmwshi7erE8/yBNcNTWMK6f8+r+CPdZQ4

# HV4Pn05IYcbeO4VpozDg92WFUhc0JoPGpdYkP/ukWCoH7MMOuLSJMvCTjmV/97LP

# 7ocSlIzycWCZDsEMFMqAGM43LvwBOwctKzGCBlkwggZVAgEBMH0waTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MQIQCcjsXDR9ByBZzKg16Kdv+DANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3

# AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisG

# AQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCD8aMng+t5L

# Guw0GwwWz2kmNSQIYURp6FK8NQFdNkkkjjANBgkqhkiG9w0BAQEFAASCAgBHM0k/

# Jv0MmoSSssQtFXu1z0O+UdA3LOe5auulzJIqgFGd5TnPo8HkTlBVTYq1xFaetI4N

# OSmgprNaPaw90Pqb/YlFLf2e7er9H7mEzgxvc91hNwk5Pr9PXhCUDp+kPi1tCQyD

# m6RQUHT0HHj+Lipyr8LjG7evC/4kHtj4d+ErCcPFOx7yS+ceRFOXu0DVojRqy/ld

# g2eFMCui+p+S4kpdjF+tB16pB7tthfyzrrBJ29dGBpQMoh4EVUvuveTZrp6NQFdP

# BUhe0CEN2NNuUQlfDo2XYGdkITXqPnaB34Ep4CQjyXIyQWsBR1XJ9EPPar3PDBGd

# iVP0E7dDxyMbPYNTARmZq47zLdjRQUyqWTRSk0D5pIlegCgAXwu3NEFYIAbtQSCb

# LxUloh0yB/z344RpaSOtteRPA2iTNYGVBIS4VUZ+90V1gDRPc9csFoxj4Zig63hb

# 280hbV1vsctiiaJCgUs+AnVYOzVl+cAQTB+Vvepw82HQf5I19BzUwzVxu3xBdoHV

# kGjfMx4QvCIW+NxsqQhfFnJ/7nKcpAztCKzAC8CMIBDCQhzCduaU6jiswHUqHf4z

# JdgI+ORzl42FKZpna2b3sW9UHGCAObNviUJhyw9VeTPh4l40q+WhWgCBkPV5R5B5

# f4Bk3B3v14jHtVUYTbRPi6yoGlajXbaqSutvW6GCAyYwggMiBgkqhkiG9w0BCQYx

# ggMTMIIDDwIBATB9MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwg

# SW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcg

# UlNBNDA5NiBTSEEyNTYgMjAyNSBDQTECEAqA7xhLjfEFgtHEdqeVdGgwDQYJYIZI

# AWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJ

# BTEPFw0yNjAzMTIwNDQ2MzZaMC8GCSqGSIb3DQEJBDEiBCC5+LArrvaUBg5YR+HO

# 3jP+cfyjlAIQ1NhOA4C//ztqlzANBgkqhkiG9w0BAQEFAASCAgC/YIjgLOOzo2hF

# AQ7LeVCMt3SDqlasm9A104n4CZvlG2kYQ1qxGsf3klR+8W/Wdbhd2Iy+/KHI3Zji

# F6KgguUdtJaeEgXuBb4KhVQIVovoPkuF4MzZ0ZBuOu/XtAIKcSKEL5mKbLGV0CYM

# 5YWmV8gV+R+rz9qeT/d2zGGUa9l2JT99EbRnYQ7brdGeMCT+YeF1ZKaBuAio4oj8

# ZYJvlLpFJRuDifPsmHS+hqRWTgAJeCDI6J6YrlaBGSFgRlvBKNh6RIufuY9/HFpl

# bgquplFetdD9ta5+v86LcWhE8DsM/OrRA4F+acJ56GK02kJhvlX+LIsBt1xDDj2b

# FaxnOpFOr0TFb0iYskrzP0siT//q7YnF6aSw8I3ncgJZDGIlyVaLD8F/bwzx3z5E

# yJliXZeOlukYn47VfgMc1m5FyHFWTMPCiP8feH16xo+f1tVVGh2yMjeIxVhylMo9

# FMrXLuDtydFPECD+qvqC8U2WeZCfsaFwyJmOndP/zy+bgoFKe4jYwg5+ZUSVq5hd

# x/clsdZuoWXBAeIlmlAud/v58jZEFx5UCfPFR4oe09svLNxtzbc7D4d+jiCewR/6

# 5KtpRZ9WhSar8+04hT6B86MRXPicj98NXdt1y1aQRiB9Q0yGsYah0EAFIKCWHzAW

# MdWG09nzFnuUEAejx/GPUbU5w/VW2Q==

# SIG # End signature block