Graphimo

0.0.3

Graphimo.psm1

                                function Remove-EmptyValue { 

    [alias('Remove-EmptyValues')]

    [CmdletBinding()]

    param([alias('Splat', 'IDictionary')][Parameter(Mandatory)][System.Collections.IDictionary] $Hashtable,

        [string[]] $ExcludeParameter,

        [switch] $Recursive,

        [int] $Rerun)

    foreach ($Key in [string[]] $Hashtable.Keys) { if ($Key -notin $ExcludeParameter) { if ($Recursive) { if ($Hashtable[$Key] -is [System.Collections.IDictionary]) { if ($Hashtable[$Key].Count -eq 0) { $Hashtable.Remove($Key) } else { Remove-EmptyValue -Hashtable $Hashtable[$Key] -Recursive:$Recursive } } else { if ($null -eq $Hashtable[$Key] -or ($Hashtable[$Key] -is [string] -and $Hashtable[$Key] -eq '') -or ($Hashtable[$Key] -is [System.Collections.IList] -and $Hashtable[$Key].Count -eq 0)) { $Hashtable.Remove($Key) } } } else { if ($null -eq $Hashtable[$Key] -or ($Hashtable[$Key] -is [string] -and $Hashtable[$Key] -eq '') -or ($Hashtable[$Key] -is [System.Collections.IList] -and $Hashtable[$Key].Count -eq 0)) { $Hashtable.Remove($Key) } } } }

    if ($Rerun) { for ($i = 0; $i -lt $Rerun; $i++) { Remove-EmptyValue -Hashtable $Hashtable -Recursive:$Recursive } }

}

function Connect-O365Graph {

    [cmdletBinding(DefaultParameterSetName = 'ClearText')]

    param(

        [parameter(Mandatory, ParameterSetName = 'ClearText')][string][alias('ClientID')] $ApplicationID,

        [parameter(Mandatory, ParameterSetName = 'ClearText')][string][alias('ClientSecret')] $ApplicationKey,

        [parameter(Mandatory, ParameterSetName = 'Credential')][PSCredential] $Credential,

        [parameter(Mandatory, ParameterSetName = 'ClearText')]

        [parameter(Mandatory, ParameterSetName = 'Credential')]

        [string] $TenantDomain,

        [parameter(ParameterSetName = 'ClearText')]

        [parameter(ParameterSetName = 'Credential')]

        [ValidateSet("https://manage.office.com", "https://graph.microsoft.com", "https://graph.microsoft.com/beta")] $Resource = "https://manage.office.com"

    )

    # https://dzone.com/articles/getting-access-token-for-microsoft-graph-using-oau-1

    if ($Credential) {

        $Body = @{

            grant_type    = "client_credentials"

            resource      = $Resource

            client_id     = $Credential.UserName

            client_secret = $Credential.GetNetworkCredential().Password

        }

    } else {

        $Body = @{

            grant_type    = "client_credentials"

            resource      = $Resource

            client_id     = $ApplicationID

            client_secret = $ApplicationKey

        }

    }

    try {

        $Authorization = Invoke-RestMethod -Method Post -Uri "https://login.microsoftonline.com/$($TenantDomain)/oauth2/token" -Body $body -ErrorAction Stop

        @{

            'Authorization' = "$($Authorization.token_type) $($Authorization.access_token)"

        }

    } catch {

        $ErrorMessage = $_.Exception.Message -replace "`n", " " -replace "`r", " "

        Write-Warning -Message "Connect-O365Graph - Error: $ErrorMessage"

        @{

            'Authorization' = ''

            'Error'         = $ErrorMessage

        }

    }

}

function Get-GraphAzureGuest {

    [cmdletBinding()]

    param(

        [Parameter(Mandatory)][System.Collections.IDictionary] $Authorization,

        [switch] $AsHashTable

    )

    $GuestsDictionary = [ordered]@{}

    $URI = "https://graph.microsoft.com/v1.0/users?`$filter=userType eq 'Guest'"

    if ($AsHashTable) {

        $Guests = Invoke-O365Graph -Uri $URI -Method GET -Headers $Authorization -FullUri

        foreach ($Guest in $Guests) {

            $GuestsDictionary[$Guest.mail] = $Guest

        }

        $GuestsDictionary

    } else {

        Invoke-O365Graph -Uri $URI -Method GET -Headers $Authorization -FullUri

    }

}

function Get-GraphCalendarEvents {

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string] $UserPrincipalName,

        [string] $CalendarID,

        [datetime] $DateStart,

        [datetime] $DateEnd

    )

    #$Date1 = (Get-Date $DateStart -UFormat '+%Y-%m-%dT%H:%M:%S.000Z')

    #$Date2 = (Get-Date $DateEnd -UFormat '+%Y-%m-%dT%H:%M:%S.000Z')

    $Date1 = $DateStart

    $Date2 = $DateEnd

    $URI = "/users/$UserPrincipalName/calendars/$($CalendarID)/calendarView?startDateTime=$Date1&endDateTime=$Date2"

    $OneCalendar = Invoke-O365Graph -Uri $URI -Method GET -Headers $Headers

    $OneCalendar

}

function Get-GraphUser {

    [alias('Get-GraphUsers')]

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string[]] $Property,

        [validateSet('Guest')][string] $UserType,

        [uri] $PrimaryUri = 'https://graph.microsoft.com/v1.0',

        [switch] $AsHashTable

    )

    $UsersDictionary = [ordered]@{}

    $URI = '/users'

    if ($Property -and $UserType) {

        $URI = "$($URI)?" + "`$select=" + $($Property -join ",") + "&`$filter=userType eq 'Guest'"

    } elseif ($Property) {

        $URI = "$($URI)?" + "`$select=" + $($Property -join ",")

    } elseif ($UserType) {

        $URI = "$($URI)?" + "`$filter=userType eq 'Guest'"

    }

    if ($AsHashTable) {

        $Users = Invoke-O365Graph -Uri $URI -Method GET -Headers $Headers -PrimaryUri $PrimaryUri

        foreach ($User in $Users) {

            $UsersDictionary[$User.mail] = $User

        }

        $UsersDictionary

    } else {

        Invoke-O365Graph -Uri $URI -Method GET -Headers $Headers -PrimaryUri $PrimaryUri

    }

}

function Get-GraphUserCalendars {

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string] $UserPrincipalName

    )

    Invoke-O365Graph -Uri "/users/$UserPrincipalName/calendars" -Method GET -Headers $Headers

}

function Import-GraphAzureGuest {

    [cmdletBinding()]

    param(

        [Parameter(Mandatory)][System.Collections.IDictionary] $Authorization,

        [string] $Name,

        [Parameter(Mandatory)][string] $EmailAddress,

        [switch] $SendInvitationMessage,

        [string] $InviteRedirectUrl = "https://portal.office.com"

    )

    $URI = '/invitations'

    $body = [ordered]@{

        'invitedUserDisplayName'  = $Name

        'invitedUserEmailAddress' = $EmailAddress

        'inviteRedirectUrl'       = $InviteRedirectUrl

        'sendInvitationMessage'   = $SendInvitationMessage.IsPresent

    }

    Invoke-O365Graph -Uri $URI -Method POST -Headers $Authorization -Body $Body

}

function Invoke-O365Graph {

    [cmdletBinding()]

    param(

        [uri] $PrimaryUri = 'https://graph.microsoft.com/v1.0',

        [uri] $Uri,

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [validateset('GET', 'DELETE', 'POST', 'PATCH')][string] $Method = 'GET',

        [string] $ContentType = "application/json; charset=UTF-8",

        [System.Collections.IDictionary] $Body,

        [switch] $FullUri

    )

    if ($Authorization.Error) {

        Write-Warning "Invoke-O365Graph - Authorization error. Skipping."

        return

    }

    $RestSplat = @{

        Headers     = $Headers

        Method      = $Method

        ContentType = $ContentType

        Body        = $Body | ConvertTo-Json -Depth 5

    }

    if ($FullUri) {

        $RestSplat.Uri = $Uri

    } else {

        $RestSplat.Uri = -join ($PrimaryUri, $Uri)

    }

    try {

        Write-Verbose "Invoke-O365Graph - Querying $($RestSplat.Uri)"

        $OutputQuery = Invoke-RestMethod @RestSplat -Verbose:$false

        if ($Method -in 'GET') {

            if ($OutputQuery.value) {

                $OutputQuery.value

            }

            if ($OutputQuery.'@odata.nextLink') {

                $RestSplat.Uri = $OutputQuery.'@odata.nextLink'

                $MoreData = Invoke-O365Graph @RestSplat -FullUri

                if ($MoreData) {

                    $MoreData

                }

            }

        } elseif ($Method -in 'POST') {

            $OutputQuery

        } else {

            return $true

        }

    } catch {

        $RestError = $_.ErrorDetails.Message

        if ($RestError) {

            try {

                $ErrorMessage = ConvertFrom-Json -InputObject $RestError

                $ErrorMy = -join ('JSON Error:' , $ErrorMessage.error.code, ' ', $ErrorMessage.error.message, ' Additional Error: ', $_.Exception.Message)

                Write-Warning $ErrorMy

            } catch {

                Write-Warning $_.Exception.Message

            }

        } else {

            Write-Warning $_.Exception.Message

        }

        if ($Method -ne 'GET', 'POST') {

            return $false

        }

    }

}

function Remove-GraphMailboxCalendar {

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string] $UserPrincipalName,

        [string] $CalendarID

    )

    $URI = "/users/$UserPrincipalName/calendars/$($CalendarID)"

    Invoke-O365Graph -Uri $URI -Method DELETE -Headers $Headers

}

function Remove-GraphMailboxCalendarEvent {

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string] $UserPrincipalName,

        [string] $CalendarID,

        [string] $EventID,

        [int] $Batches = 30,

        [switch] $All

    )

    if ($All) {

        [int] $StartDay = -9200

        [int] $FinalDay = 60000

        do {

            $EndDay = $StartDay + $Batches

            $Date1 = (Get-Date).AddDays($StartDay)

            $Date2 = (Get-Date).AddDays($EndDay)

            #Write-Verbose "Remove-GraphMailboxCalendarEvent - Processing user $UserPrincipalName for $CalendarID from $Date1 to $Date2"

            #Write-Color "Remove-GraphMailboxCalendarEvent - Processing user $UserPrincipalName for $CalendarID from $Date1 to $Date2" -Color DarkMagenta

            $CalendarEvents = Get-GraphCalendarEvents -UserPrincipalName $UserPrincipalName -Headers $Headers -DateStart $Date1 -DateEnd $Date2 -CalendarID $CalendarID

            #Write-Color "Count of Events ", $CalendarEvents.Count, ' for dates ', $Date1, ' and ', $Date2 -Color yellow, white, yellow, white, yellow, white, yellow

            #Write-Color "Remove-GraphMailboxCalendarEvent - Processing user $UserPrincipalName / found $($CalendarEvents.Count) events from $Date1 to $Date2" -Color Blue

            Write-Verbose "Remove-GraphMailboxCalendarEvent - Processing user $UserPrincipalName / found $($CalendarEvents.Count) events from $Date1 to $Date2"

            foreach ($Event in $CalendarEvents) {

                # Write-Color "Deleting $UserPrincipalName $URIEvent $CalendarID $EventID" -Color Yellow, White, Blue

                $Output = Remove-GraphMailboxCalendarEvent -Headers $Headers -UserPrincipalName $UserPrincipalName -CalendarID $CalendarID -EventID $Event.ID

            }

            $StartDay = $StartDay + $Batches

        } while ($EndDay -lt $FinalDay)

    } else {

        if ($EventID) {

            $URIEvent = "/users/$UserPrincipalName/calendars/$($CalendarID)/events/$($EventID)"

            #Write-Verbose "Remove-GraphMailboxCalendarEvent - Processing user $UserPrincipalName / deleting event $($EventID)"

            #Write-Color "Deleting $URIEvent" -Color Yellow, White, Blue

            Invoke-O365Graph -Uri $URIEvent -Method DELETE -Headers $Headers

        }

    }

}

function Remove-GraphUser {

    [cmdletBinding()]

    param(

        [alias('Authorization')][System.Collections.IDictionary] $Headers,

        [string] $UserPrincipalName,

        [string] $UserID

    )

    if ($UserID) {

        $URI = "/users/$UserID"

    } else {

        $URI = "/users/$UserPrincipalName"

    }

    Invoke-O365Graph -Uri $URI -Method DELETE -Headers $Headers

}

function Set-GraphAzureUser {

    [cmdletBinding()]

    param(

        [Parameter(Mandatory)][System.Collections.IDictionary] $Authorization,

        [string] $UserID,

        [string] $UserPrincipalName,

        [string] $Name,

        [alias('FirstName')][string] $GivenName,

        [alias('LastName')][string] $Surname,

        [string] $JobTitle,

        [string] $EmployeeId,

        [string] $City,

        [string] $Country,

        [string] $Department,

        [string] $PostalCode,

        [string] $State,

        [string] $StreetAddress,

        [string] $BusinessPhones,

        [string] $MobilePhone,

        [string] $OfficeLocation,

        [string] $CompanyName,

        [string] $DisplayName,

        [switch] $ShowInAddressList

    )

    if ($UserID) {

        $URI = "/users/$UserID"

    } else {

        $URI = "/users/$UserPrincipalName"

    }

    $Body = [ordered]@{

        'jobTitle'          = $JobTitle

        'employeeId'        = $EmployeeId

        'givenName'         = $givenName

        'surname'           = $Surname

        'city'              = $City

        'country'           = $Country

        'department'        = $Department

        'postalCode'        = $PostalCode

        'state'             = $State

        'streetAddress'     = $StreetAddress

        'businessPhones'    = if ($businessPhones) { @($businessPhones) } else {}

        "mobilePhone"       = $mobilePhone

        "officeLocation"    = $OfficeLocation

        'companyName'       = $CompanyName

        'displayName'       = $DisplayName

        'showInAddressList' = $ShowInAddressList.IsPresent

    }

    Remove-EmptyValue -Hashtable $Body

    if ($Body.Count -gt 0) {

        Invoke-O365Graph -Uri $URI -Method PATCH -Headers $Authorization -Body $Body

    }

}

Export-ModuleMember -Function @('Connect-O365Graph', 'Get-GraphAzureGuest', 'Get-GraphCalendarEvents', 'Get-GraphUser', 'Get-GraphUserCalendars', 'Import-GraphAzureGuest', 'Invoke-O365Graph', 'Remove-GraphMailboxCalendar', 'Remove-GraphMailboxCalendarEvent', 'Remove-GraphUser', 'Set-GraphAzureUser') -Alias @('Get-GraphUsers')

# SIG # Begin signature block

# MIIdWQYJKoZIhvcNAQcCoIIdSjCCHUYCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUHn1bN8za5X/WbCxoxlP1Fr2p

# tfegghhnMIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0B

# AQUFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVk

# IElEIFJvb3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQsw

# CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu

# ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg

# Q0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg

# +XESpa7cJpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lT

# XDGEKvYPmDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5

# a3/UsDg+wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g

# 0I6QNcZ4VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1

# roV9Iq4/AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whf

# GHdPAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0G

# A1UdDgQWBBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLL

# gjEtUYunpyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3

# cmbYMuRCdWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmr

# EthngYTffwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+

# fT8r87cmNW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5Q

# Z7dsvfPxH2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu

# 838fYxAe+o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw

# 8jCCBP4wggPmoAMCAQICEA1CSuC+Ooj/YEAhzhQA8N0wDQYJKoZIhvcNAQELBQAw

# cjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQ

# d3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVk

# IElEIFRpbWVzdGFtcGluZyBDQTAeFw0yMTAxMDEwMDAwMDBaFw0zMTAxMDYwMDAw

# MDBaMEgxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjEgMB4G

# A1UEAxMXRGlnaUNlcnQgVGltZXN0YW1wIDIwMjEwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQDC5mGEZ8WK9Q0IpEXKY2tR1zoRQr0KdXVNlLQMULUmEP4d

# yG+RawyW5xpcSO9E5b+bYc0VkWJauP9nC5xj/TZqgfop+N0rcIXeAhjzeG28ffnH

# bQk9vmp2h+mKvfiEXR52yeTGdnY6U9HR01o2j8aj4S8bOrdh1nPsTm0zinxdRS1L

# sVDmQTo3VobckyON91Al6GTm3dOPL1e1hyDrDo4s1SPa9E14RuMDgzEpSlwMMYpK

# jIjF9zBa+RSvFV9sQ0kJ/SYjU/aNY+gaq1uxHTDCm2mCtNv8VlS8H6GHq756Wwog

# L0sJyZWnjbL61mOLTqVyHO6fegFz+BnW/g1JhL0BAgMBAAGjggG4MIIBtDAOBgNV

# HQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD

# CDBBBgNVHSAEOjA4MDYGCWCGSAGG/WwHATApMCcGCCsGAQUFBwIBFhtodHRwOi8v

# d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwHwYDVR0jBBgwFoAU9LbhIB3+Ka7S5GGlsqIl

# ssgXNW4wHQYDVR0OBBYEFDZEho6kurBmvrwoLR1ENt3janq8MHEGA1UdHwRqMGgw

# MqAwoC6GLGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtdHMu

# Y3JsMDKgMKAuhixodHRwOi8vY3JsNC5kaWdpY2VydC5jb20vc2hhMi1hc3N1cmVk

# LXRzLmNybDCBhQYIKwYBBQUHAQEEeTB3MCQGCCsGAQUFBzABhhhodHRwOi8vb2Nz

# cC5kaWdpY2VydC5jb20wTwYIKwYBBQUHMAKGQ2h0dHA6Ly9jYWNlcnRzLmRpZ2lj

# ZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURUaW1lc3RhbXBpbmdDQS5jcnQw

# DQYJKoZIhvcNAQELBQADggEBAEgc3LXpmiO85xrnIA6OZ0b9QnJRdAojR6OrktIl

# xHBZvhSg5SeBpU0UFRkHefDRBMOG2Tu9/kQCZk3taaQP9rhwz2Lo9VFKeHk2eie3

# 8+dSn5On7UOee+e03UEiifuHokYDTvz0/rdkd2NfI1Jpg4L6GlPtkMyNoRdzDfTz

# ZTlwS/Oc1np72gy8PTLQG8v1Yfx1CAB2vIEO+MDhXM/EEXLnG2RJ2CKadRVC9S0y

# OIHa9GCiurRS+1zgYSQlT7LfySmoc0NR2r1j1h9bm/cuG08THfdKDXF+l7f0P4Tr

# weOjSaH6zqe/Vs+6WXZhiV9+p7SOZ3j5NpjhyyjaW4emii8wggUwMIIEGKADAgEC

# AhAECRgbX9W7ZnVTQ7VvlVAIMA0GCSqGSIb3DQEBCwUAMGUxCzAJBgNVBAYTAlVT

# MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j

# b20xJDAiBgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0xMzEw

# MjIxMjAwMDBaFw0yODEwMjIxMjAwMDBaMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQK

# EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNV

# BAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwggEi

# MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQD407Mcfw4Rr2d3B9MLMUkZz9D7

# RZmxOttE9X/lqJ3bMtdx6nadBS63j/qSQ8Cl+YnUNxnXtqrwnIal2CWsDnkoOn7p

# 0WfTxvspJ8fTeyOU5JEjlpB3gvmhhCNmElQzUHSxKCa7JGnCwlLyFGeKiUXULaGj

# 6YgsIJWuHEqHCN8M9eJNYBi+qsSyrnAxZjNxPqxwoqvOf+l8y5Kh5TsxHM/q8grk

# V7tKtel05iv+bMt+dDk2DZDv5LVOpKnqagqrhPOsZ061xPeM0SAlI+sIZD5SlsHy

# DxL0xY4PwaLoLFH3c7y9hbFig3NBggfkOItqcyDQD2RzPJ6fpjOp/RnfJZPRAgMB

# AAGjggHNMIIByTASBgNVHRMBAf8ECDAGAQH/AgEAMA4GA1UdDwEB/wQEAwIBhjAT

# BgNVHSUEDDAKBggrBgEFBQcDAzB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGG

# GGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2Nh

# Y2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDCB

# gQYDVR0fBHoweDA6oDigNoY0aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lD

# ZXJ0QXNzdXJlZElEUm9vdENBLmNybDA6oDigNoY0aHR0cDovL2NybDMuZGlnaWNl

# cnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDBPBgNVHSAESDBGMDgG

# CmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQu

# Y29tL0NQUzAKBghghkgBhv1sAzAdBgNVHQ4EFgQUWsS5eyoKo6XqcQPAYPkt9mV1

# DlgwHwYDVR0jBBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8wDQYJKoZIhvcNAQEL

# BQADggEBAD7sDVoks/Mi0RXILHwlKXaoHV0cLToaxO8wYdd+C2D9wz0PxK+L/e8q

# 3yBVN7Dh9tGSdQ9RtG6ljlriXiSBThCk7j9xjmMOE0ut119EefM2FAaK95xGTlz/

# kLEbBw6RFfu6r7VRwo0kriTGxycqoSkoGjpxKAI8LpGjwCUR4pwUR6F6aGivm6dc

# IFzZcbEMj7uo+MUSaJ/PQMtARKUT8OZkDCUIQjKyNookAv4vcn4c10lFluhZHen6

# dGRrsutmQ9qzsIzV6Q3d9gEgzpkxYz0IGhizgZtPxpMQBvwHgfqL2vmCSfdibqFT

# +hKUGIUukpHqaGxEMrJmoecYpJpkUe8wggUxMIIEGaADAgECAhAKoSXW1jIbfkHk

# Bdo2l8IVMA0GCSqGSIb3DQEBCwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxE

# aWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMT

# G0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0xNjAxMDcxMjAwMDBaFw0z

# MTAxMDcxMjAwMDBaMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJ

# bmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0

# IFNIQTIgQXNzdXJlZCBJRCBUaW1lc3RhbXBpbmcgQ0EwggEiMA0GCSqGSIb3DQEB

# AQUAA4IBDwAwggEKAoIBAQC90DLuS82Pf92puoKZxTlUKFe2I0rEDgdFM1EQfdD5

# fU1ofue2oPSNs4jkl79jIZCYvxO8V9PD4X4I1moUADj3Lh477sym9jJZ/l9lP+Cb

# 6+NGRwYaVX4LJ37AovWg4N4iPw7/fpX786O6Ij4YrBHk8JkDbTuFfAnT7l3ImgtU

# 46gJcWvgzyIQD3XPcXJOCq3fQDpct1HhoXkUxk0kIzBdvOw8YGqsLwfM/fDqR9mI

# UF79Zm5WYScpiYRR5oLnRlD9lCosp+R1PrqYD4R/nzEU1q3V8mTLex4F0IQZchfx

# FwbvPc3WTe8GQv2iUypPhR3EHTyvz9qsEPXdrKzpVv+TAgMBAAGjggHOMIIByjAd

# BgNVHQ4EFgQU9LbhIB3+Ka7S5GGlsqIlssgXNW4wHwYDVR0jBBgwFoAUReuir/SS

# y4IxLVGLp6chnfNtyA8wEgYDVR0TAQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMC

# AYYwEwYDVR0lBAwwCgYIKwYBBQUHAwgweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUF

# BzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6

# Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5j

# cnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9E

# aWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRp

# Z2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwUAYDVR0gBEkw

# RzA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2lj

# ZXJ0LmNvbS9DUFMwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4IBAQBxlRLp

# UYdWac3v3dp8qmN6s3jPBjdAhO9LhL/KzwMC/cWnww4gQiyvd/MrHwwhWiq3BTQd

# aq6Z+CeiZr8JqmDfdqQ6kw/4stHYfBli6F6CJR7Euhx7LCHi1lssFDVDBGiy23UC

# 4HLHmNY8ZOUfSBAYX4k4YU1iRiSHY4yRUiyvKYnleB/WCxSlgNcSR3CzddWThZN+

# tpJn+1Nhiaj1a5bA9FhpDXzIAbG5KHW3mWOFIoxhynmUfln8jA/jb7UBJrZspe6H

# USHkWGCbugwtK22ixH67xCUrRwIIfEmuE7bhfEJCKMYYVs9BNLZmXbZ0e/VWMyIv

# IjayS6JKldj1po5SMIIFPTCCBCWgAwIBAgIQBNXcH0jqydhSALrNmpsqpzANBgkq

# hkiG9w0BAQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5j

# MRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBT

# SEEyIEFzc3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMB4XDTIwMDYyNjAwMDAwMFoX

# DTIzMDcwNzEyMDAwMFowejELMAkGA1UEBhMCUEwxEjAQBgNVBAgMCcWabMSFc2tp

# ZTERMA8GA1UEBxMIS2F0b3dpY2UxITAfBgNVBAoMGFByemVteXPFgmF3IEvFgnlz

# IEVWT1RFQzEhMB8GA1UEAwwYUHJ6ZW15c8WCYXcgS8WCeXMgRVZPVEVDMIIBIjAN

# BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv7KB3iyBrhkLUbbFe9qxhKKPBYqD

# Bqlnr3AtpZplkiVjpi9dMZCchSeT5ODsShPuZCIxJp5I86uf8ibo3vi2S9F9AlfF

# jVye3dTz/9TmCuGH8JQt13ozf9niHecwKrstDVhVprgxi5v0XxY51c7zgMA2g1Ub

# +3tii0vi/OpmKXdL2keNqJ2neQ5cYly/GsI8CREUEq9SZijbdA8VrRF3SoDdsWGf

# 3tZZzO6nWn3TLYKQ5/bw5U445u/V80QSoykszHRivTj+H4s8ABiforhi0i76beA6

# Ea41zcH4zJuAp48B4UhjgRDNuq8IzLWK4dlvqrqCBHKqsnrF6BmBrv+BXQIDAQAB

# o4IBxTCCAcEwHwYDVR0jBBgwFoAUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHQYDVR0O

# BBYEFBixNSfoHFAgJk4JkDQLFLRNlJRmMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUE

# DDAKBggrBgEFBQcDAzB3BgNVHR8EcDBuMDWgM6Axhi9odHRwOi8vY3JsMy5kaWdp

# Y2VydC5jb20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDA1oDOgMYYvaHR0cDovL2Ny

# bDQuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwTAYDVR0gBEUw

# QzA3BglghkgBhv1sAwEwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNl

# cnQuY29tL0NQUzAIBgZngQwBBAEwgYQGCCsGAQUFBwEBBHgwdjAkBggrBgEFBQcw

# AYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tME4GCCsGAQUFBzAChkJodHRwOi8v

# Y2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRTSEEyQXNzdXJlZElEQ29kZVNp

# Z25pbmdDQS5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAQEAmr1s

# z4lsLARi4wG1eg0B8fVJFowtect7SnJUrp6XRnUG0/GI1wXiLIeow1UPiI6uDMsR

# XPHUF/+xjJw8SfIbwava2eXu7UoZKNh6dfgshcJmo0QNAJ5PIyy02/3fXjbUREHI

# NrTCvPVbPmV6kx4Kpd7KJrCo7ED18H/XTqWJHXa8va3MYLrbJetXpaEPpb6zk+l8

# Rj9yG4jBVRhenUBUUj3CLaWDSBpOA/+sx8/XB9W9opYfYGb+1TmbCkhUg7TB3gD6

# o6ESJre+fcnZnPVAPESmstwsT17caZ0bn7zETKlNHbc1q+Em9kyBjaQRcEQoQQNp

# ezQug9ufqExx6lHYDjGCBFwwggRYAgEBMIGGMHIxCzAJBgNVBAYTAlVTMRUwEwYD

# VQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAv

# BgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EC

# EATV3B9I6snYUgC6zZqbKqcwCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcCAQwxCjAI

# oAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIB

# CzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFM3pkGOOfNIuHq5yuVtR

# D6njW8EDMA0GCSqGSIb3DQEBAQUABIIBAK86pDOgayGS+r9DbwdKaUQNB99Y44yb

# gMQ8thq8pN4H+P7wxm0y3uouBZscjfBf0IeVZ3GWni5gE0pG3DiTTdETwn9lSyQL

# ol9QWHw9U5/rvX/NTNFaIuGcA11/qL2bEHHQdS7ZMKT4jl9YIkAvv91xeKdsI/PR

# l+J7BA1+uG+uzB5d/H+cQk4ZEcg9yGKuzhkUOlwAmrHSxONlNRfGhruZvE2LzwFI

# Z8f/e1fIhtMJw7ZwkrwW34TeDk1DHMSqOnIVre+B8jS9TQJwUl6ofnw9KVeQHkQ4

# 52s0V+S+lfepDv/93LAgRNwnn//zfJPl1xKX1Tj8OAwY0Gz3nVUW462hggIwMIIC

# LAYJKoZIhvcNAQkGMYICHTCCAhkCAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNV

# BAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8G

# A1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBDQQIQ

# DUJK4L46iP9gQCHOFADw3TANBglghkgBZQMEAgEFAKBpMBgGCSqGSIb3DQEJAzEL

# BgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIxMDQwODEwMTgyOFowLwYJKoZI

# hvcNAQkEMSIEIA88jzDrUqmUEu+LuKcYBW8kqM91OP3YbkW3mMxNN398MA0GCSqG

# SIb3DQEBAQUABIIBABH/mFT01elexgl7nvpba8JZu2faacM8c4Wu1Aub1qOB4lrF

# yX9BXBbYH/CiPueChM2E+1v/ODwuAejWZR9EkfF2FtdxA7pvcJbaR5nTPvNSQ0WN

# s8wprvkZ32H2pZmYJvcHmkgNsi2SPd28lo8293/Ebp9XZuc2T6I4sojavUuncSOe

# KaZ/xWs561w6hMxZfH3/8wxCzvUc/ET++Yz8UZrxsilZpXlmxd4BLEG22lHjtW5n

# vX9Ri7XHTPQrLoct3mrNZuc69thg5bqecVl5DZez2PTUDCGfeFVgEYHx88dh3qMq

# Xsdymo42QDtJqPdVN/9MBJcF/esWp++BjToBuOU=

# SIG # End signature block