ExchangeOnlineManagement

0.3374.0

ExchangeOnlineManagement.psm1

                                # Import the REST module so that the EXO* cmdlets are present before Connect-ExchangeOnline in the powershell instance.

$RestModule = "Microsoft.Exchange.Management.RestApiClient.dll"

$RestModulePath = [System.IO.Path]::Combine($PSScriptRoot, $RestModule)

Import-Module $RestModulePath

$ExoPowershellModule = "Microsoft.Exchange.Management.ExoPowershellGalleryModule.dll"

$ExoPowershellModulePath = [System.IO.Path]::Combine($PSScriptRoot, $ExoPowershellModule)

Import-Module $ExoPowershellModulePath

############# Helper Functions Begin #############

    <#

    Details to be printed on the console when the Connect-ExchangeOnline function is run

    #>

    function Print-Details

    {

        Write-Host -ForegroundColor Yellow ""

        Write-Host -ForegroundColor Yellow "----------------------------------------------------------------------------"

        Write-Host -ForegroundColor Yellow "We have released new management cmdlets which are faster and more reliable."

        Write-Host -ForegroundColor Yellow ""

        Write-Host -ForegroundColor Yellow "|--------------------------------------------------------------------------|"

        Write-Host -ForegroundColor Yellow "|    Old Cmdlets                    |    New/Reliable/Faster Cmdlets       |"

        Write-Host -ForegroundColor Yellow "|--------------------------------------------------------------------------|"

        Write-Host -ForegroundColor Yellow "|    Get-CASMailbox                 |    Get-EXOCASMailbox                 |"

        Write-Host -ForegroundColor Yellow "|    Get-Mailbox                    |    Get-EXOMailbox                    |"

        Write-Host -ForegroundColor Yellow "|    Get-MailboxFolderPermission    |    Get-EXOMailboxFolderPermission    |"

        Write-Host -ForegroundColor Yellow "|    Get-MailboxFolderStatistics    |    Get-EXOMailboxFolderStatistics    |"

        Write-Host -ForegroundColor Yellow "|    Get-MailboxPermission          |    Get-EXOMailboxPermission          |"

        Write-Host -ForegroundColor Yellow "|    Get-MailboxStatistics          |    Get-EXOMailboxStatistics          |"

        Write-Host -ForegroundColor Yellow "|    Get-MobileDeviceStatistics     |    Get-EXOMobileDeviceStatistics     |"

        Write-Host -ForegroundColor Yellow "|    Get-Recipient                  |    Get-EXORecipient                  |"

        Write-Host -ForegroundColor Yellow "|    Get-RecipientPermission        |    Get-EXORecipientPermission        |"

        Write-Host -ForegroundColor Yellow "|--------------------------------------------------------------------------|"

        Write-Host -ForegroundColor Yellow ""

        Write-Host -ForegroundColor Yellow "To get additional information, run: Get-Help Connect-ExchangeOnline"

        Write-Host -ForegroundColor Yellow "----------------------------------------------------------------------------"

        Write-Host -ForegroundColor Yellow ""

    }

    <#

    .Synopsis Validates a given Uri

    #>

    function Test-Uri

    {

        [CmdletBinding()]

        [OutputType([bool])]

        Param

        (

            # Uri to be validated

            [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)]

            [string]

            $UriString

        )

        [Uri]$uri = $UriString -as [Uri]

        $uri.AbsoluteUri -ne $null -and $uri.Scheme -eq 'https'

    }

    <#

    .Synopsis Is Cloud Shell Environment

    #>

    function global:IsCloudShellEnvironment()

    {

        if ((-not (Test-Path env:"ACC_CLOUD")) -or ((get-item env:"ACC_CLOUD").Value -ne "PROD"))

        {

            return $false

        }

        return $true

    }

    <#

    .Synopsis Override Get-PSImplicitRemotingSession function for reconnection

    #>

    function global:UpdateImplicitRemotingHandler()

    {

        $modules = Get-Module tmp_*

        foreach ($module in $modules)

        {

            [bool]$moduleProcessed = $false

            [string] $moduleUrl = $module.Description

            [int] $queryStringIndex = $moduleUrl.IndexOf("?")

            if ($queryStringIndex -gt 0)

            {

                $moduleUrl = $moduleUrl.SubString(0,$queryStringIndex)

            }

            if ($moduleUrl.EndsWith("/PowerShell-LiveId", [StringComparison]::OrdinalIgnoreCase) -or $moduleUrl.EndsWith("/PowerShell", [StringComparison]::OrdinalIgnoreCase))

            {

                & $module { ${function:Get-PSImplicitRemotingSession} = `

                {

                    param(

                        [Parameter(Mandatory = $true, Position = 0)]

                        [string]

                        $commandName

                    )

                    if (($script:PSSession -eq $null) -or ($script:PSSession.Runspace.RunspaceStateInfo.State -ne 'Opened'))

                    {

                        Set-PSImplicitRemotingSession `

                            (& $script:GetPSSession `

                                -InstanceId $script:PSSession.InstanceId.Guid `

                                -ErrorAction SilentlyContinue )

                    }

                    if (($script:PSSession -ne $null) -and ($script:PSSession.Runspace.RunspaceStateInfo.State -eq 'Disconnected'))

                    {

                        # If we are handed a disconnected session, try re-connecting it before creating a new session.

                        Set-PSImplicitRemotingSession `

                            (& $script:ConnectPSSession `

                                -Session $script:PSSession `

                                -ErrorAction SilentlyContinue)

                    }

                    if (($script:PSSession -eq $null) -or ($script:PSSession.Runspace.RunspaceStateInfo.State -ne 'Opened'))

                    {

                        # Import the module once more to ensure that New-ExoPSSession is present

                        Import-Module $global:ModulePath;

                        Write-PSImplicitRemotingMessage ('Creating a new Remote PowerShell session using MFA for implicit remoting of "{0}" command ...' -f $commandName)

                        if (($isCloudShell = IsCloudShellEnvironment) -eq $false)

                        {

                            $session = New-ExoPSSession -UserPrincipalName $global:UserPrincipalName -ExchangeEnvironmentName $global:ExchangeEnvironmentName -ConnectionUri $global:ConnectionUri -AzureADAuthorizationEndpointUri $global:AzureADAuthorizationEndpointUri -PSSessionOption $global:PSSessionOption -Credential $global:Credential -BypassMailboxAnchoring:$global:BypassMailboxAnchoring -DelegatedOrg $global:DelegatedOrganization -Reconnect:$true

                        }

                        else

                        {

                            $session = New-ExoPSSession -ExchangeEnvironmentName $global:ExchangeEnvironmentName -ConnectionUri $global:ConnectionUri -AzureADAuthorizationEndpointUri $global:AzureADAuthorizationEndpointUri -PSSessionOption $global:PSSessionOption -BypassMailboxAnchoring:$global:BypassMailboxAnchoring -DelegatedOrg $global:DelegatedOrganization -Reconnect:$true

                        }

                        if ($session -ne $null)

                        {

                            Set-PSImplicitRemotingSession -CreatedByModule $true -PSSession $session

                        }

                        RemoveBrokenOrClosedPSSession

                    }

                    if (($script:PSSession -eq $null) -or ($script:PSSession.Runspace.RunspaceStateInfo.State -ne 'Opened'))

                    {

                        throw 'No session has been associated with this implicit remoting module'

                    }

                    return [Management.Automation.Runspaces.PSSession]$script:PSSession

                }}

            }

        }

    }

    <#

    .Synopsis Remove broken and closed sessions

    #>

    function global:RemoveBrokenOrClosedPSSession()

    {

        $psBroken = Get-PSSession | where-object {$_.State -like "*Broken*"}

        $psClosed = Get-PSSession | where-object {$_.State -like "*Closed*"}

        if ($psBroken.count -gt 0)

        {

            for ($index = 0; $index -lt $psBroken.count; $index++)

            {

                Remove-PSSession -session $psBroken[$index]

            }

        }

        if ($psClosed.count -gt 0)

        {

            for ($index = 0; $index -lt $psClosed.count; $index++)

            {

                Remove-PSSession -session $psClosed[$index]

            }

        }

    }

    <#

    .SYNOPSIS Extract organization name from UserPrincipalName

    #>

    function Get-OrgNameFromUPN

    {

        param([string] $UPN)

        $fields = $UPN -split '@'

        return $fields[-1]

    }

    <#

    .SYNOPSIS Get the command from the given module

    #>

    function global:Get-WrappedCommand

    {

        param(

        [string] $CommandName,

        [string] $ModuleName,

        [string] $CommandType)

        $cmd = Get-Command -Name $CommandName -Module $ModuleName -CommandType $CommandType -All

        return $cmd

    }

############# Helper Functions End #############

###### Begin Main ######

function Connect-ExchangeOnline 

{

    [CmdletBinding()]

    param(

        # Connection Uri for the Remote PowerShell endpoint

        [string] $ConnectionUri = '',

        # Azure AD Authorization endpoint Uri that can issue the OAuth2 access tokens

        [string] $AzureADAuthorizationEndpointUri = '',

        # Exchange Environment name

        [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment] $ExchangeEnvironmentName = 'O365Default',

        # PowerShell session options to be used when opening the Remote PowerShell session

        [System.Management.Automation.Remoting.PSSessionOption] $PSSessionOption = $null,

        # Switch to bypass use of mailbox anchoring hint.

        [switch] $BypassMailboxAnchoring = $false,

        # Delegated Organization Name

        [string] $DelegatedOrganization = ''

    )

    DynamicParam

    {

        if (($isCloudShell = IsCloudShellEnvironment) -eq $false)

        {

            $attributes = New-Object System.Management.Automation.ParameterAttribute

            $attributes.Mandatory = $false

            $attributeCollection = New-Object System.Collections.ObjectModel.Collection[System.Attribute]

            $attributeCollection.Add($attributes)

            # User Principal Name or email address of the user

            $UserPrincipalName = New-Object System.Management.Automation.RuntimeDefinedParameter('UserPrincipalName', [string], $attributeCollection)

            $UserPrincipalName.Value = ''

            # User Credential to Logon

            $Credential = New-Object System.Management.Automation.RuntimeDefinedParameter('Credential', [System.Management.Automation.PSCredential], $attributeCollection)

            $Credential.Value = $null

            # Switch to collect telemetry on command execution. 

            $EnableErrorReporting = New-Object System.Management.Automation.RuntimeDefinedParameter('EnableErrorReporting', [switch], $attributeCollection)

            $EnableErrorReporting.Value = $false

            # Where to store EXO command telemetry data. By default telemetry is stored in the directory "%TEMP%/EXOTelemetry" in the file : EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.

            $LogDirectoryPath = New-Object System.Management.Automation.RuntimeDefinedParameter('LogDirectoryPath', [string], $attributeCollection)

            $LogDirectoryPath.Value = ''

            # Create a new attribute and valiate set against the LogLevel

            $LogLevelAttribute = New-Object System.Management.Automation.ParameterAttribute

            $LogLevelAttribute.Mandatory = $false

            $LogLevelAttributeCollection = New-Object System.Collections.ObjectModel.Collection[System.Attribute]

            $LogLevelAttributeCollection.Add($LogLevelAttribute)

            $LogLevelList = @([Microsoft.Online.CSE.RestApiPowerShellModule.Instrumentation.LogLevel]::Default, [Microsoft.Online.CSE.RestApiPowerShellModule.Instrumentation.LogLevel]::All)

            $ValidateSet = New-Object System.Management.Automation.ValidateSetAttribute($LogLevelList)

            $LogLevel = New-Object System.Management.Automation.RuntimeDefinedParameter('LogLevel', [Microsoft.Online.CSE.RestApiPowerShellModule.Instrumentation.LogLevel], $LogLevelAttributeCollection)

            $LogLevel.Attributes.Add($ValidateSet)

# EXO params start

            # Switch to track perfomance 

            $TrackPerformance = New-Object System.Management.Automation.RuntimeDefinedParameter('TrackPerformance', [bool], $attributeCollection)

            $TrackPerformance.Value = $false

            # Flag to enable or disable showing the number of objects written

            $ShowProgress = New-Object System.Management.Automation.RuntimeDefinedParameter('ShowProgress', [bool], $attributeCollection)

            $ShowProgress.Value = $false

            # Switch to enable/disable Multi-threading in the EXO cmdlets

            $UseMultithreading = New-Object System.Management.Automation.RuntimeDefinedParameter('UseMultithreading', [bool], $attributeCollection)

            $UseMultithreading.Value = $true

            # Pagesize Param

            $PageSize = New-Object System.Management.Automation.RuntimeDefinedParameter('PageSize', [uint32], $attributeCollection)

            $PageSize.Value = 1000

# EXO params end

            $paramDictionary = New-object System.Management.Automation.RuntimeDefinedParameterDictionary

            $paramDictionary.Add('UserPrincipalName', $UserPrincipalName)

            $paramDictionary.Add('Credential', $Credential)

            $paramDictionary.Add('EnableErrorReporting', $EnableErrorReporting)

            $paramDictionary.Add('LogDirectoryPath', $LogDirectoryPath)

            $paramDictionary.Add('LogLevel', $LogLevel)

            $paramDictionary.Add('TrackPerformance', $TrackPerformance)

            $paramDictionary.Add('ShowProgress', $ShowProgress)

            $paramDictionary.Add('UseMultithreading', $UseMultithreading)

            $paramDictionary.Add('PageSize', $PageSize)

            return $paramDictionary

        }

        else

        {

            $attributes = New-Object System.Management.Automation.ParameterAttribute

            $attributes.Mandatory = $false

            $attributeCollection = New-Object System.Collections.ObjectModel.Collection[System.Attribute]

            $attributeCollection.Add($attributes)

            # Switch to MSI auth 

            $Device = New-Object System.Management.Automation.RuntimeDefinedParameter('Device', [switch], $attributeCollection)

            $Device.Value = $false

            $paramDictionary = New-object System.Management.Automation.RuntimeDefinedParameterDictionary

            $paramDictionary.Add('Device', $Device)

            return $paramDictionary

        }

    }

    process {

        # Validate parameters

        if (($ConnectionUri -ne '') -and (-not (Test-Uri $ConnectionUri)))

        {

            throw "Invalid ConnectionUri parameter '$ConnectionUri'"

        }

        if (($AzureADAuthorizationEndpointUri -ne '') -and (-not (Test-Uri $AzureADAuthorizationEndpointUri)))

        {

            throw "Invalid AzureADAuthorizationEndpointUri parameter '$AzureADAuthorizationEndpointUri'"

        }

        Print-Details;

        if (($ConnectionUri -ne '') -and ($AzureADAuthorizationEndpointUri -eq ''))

        {

            Write-Host -ForegroundColor Green "Using ConnectionUri:'$ConnectionUri', in the environment:'$ExchangeEnvironmentName'."

        }

        if (($AzureADAuthorizationEndpointUri -ne '') -and ($ConnectionUri -eq ''))

        {

            Write-Host -ForegroundColor Green "Using AzureADAuthorizationEndpointUri:'$AzureADAuthorizationEndpointUri', in the environment:'$ExchangeEnvironmentName'."

        }

        # Keep track of error count at beginning.

        $errorCountAtStart = $global:Error.Count;

        $EXOTelemetryFilePath = $null;

        try

        {

            # Cleanup old ps sessions

            Get-PSSession | Remove-PSSession

            $ExoPowershellModule = "Microsoft.Exchange.Management.ExoPowershellGalleryModule.dll";

            $ModulePath = [System.IO.Path]::Combine($PSScriptRoot, $ExoPowershellModule);

            $global:ExchangeEnvironmentName = $ExchangeEnvironmentName;

            $global:ConnectionUri = $ConnectionUri;

            $global:AzureADAuthorizationEndpointUri = $AzureADAuthorizationEndpointUri;

            $global:PSSessionOption = $PSSessionOption;

            $global:BypassMailboxAnchoring = $BypassMailboxAnchoring;

            $global:DelegatedOrganization = $DelegatedOrganization;

            if ($isCloudShell -eq $false)

            {

                $global:UserPrincipalName = $UserPrincipalName.Value;

                $global:Credential = $Credential.Value;

            }

            else

            {

                $global:Device = $Device.Value;

            }

            Import-Module $ModulePath;

            $global:ModulePath = $ModulePath;

            if ($isCloudShell -eq $false)

            {

                $PSSession = New-ExoPSSession -ExchangeEnvironmentName $ExchangeEnvironmentName -ConnectionUri $ConnectionUri -AzureADAuthorizationEndpointUri $AzureADAuthorizationEndpointUri -UserPrincipalName $UserPrincipalName.Value -PSSessionOption $PSSessionOption -Credential $Credential.Value -BypassMailboxAnchoring:$BypassMailboxAnchoring -DelegatedOrg $DelegatedOrganization

            }

            else

            {

                $PSSession = New-ExoPSSession -ExchangeEnvironmentName $ExchangeEnvironmentName -ConnectionUri $ConnectionUri -AzureADAuthorizationEndpointUri $AzureADAuthorizationEndpointUri -PSSessionOption $PSSessionOption -BypassMailboxAnchoring:$BypassMailboxAnchoring -Device:$Device.Value -DelegatedOrg $DelegatedOrganization

            }

            if ($PSSession -ne $null)

            {

                $PSSessionModuleInfo = Import-PSSession $PSSession -AllowClobber -DisableNameChecking

                # Import the above module globally. This is needed as with using psm1 files, 

                # any module which is dynamically loaded in the nested module does not reflect globally.

                Import-Module $PSSessionModuleInfo.Path -Global -DisableNameChecking

                UpdateImplicitRemotingHandler

                # Import the REST module

                $RestPowershellModule = "Microsoft.Exchange.Management.RestApiClient.dll";

                $RestModulePath = [System.IO.Path]::Combine($PSScriptRoot, $RestPowershellModule);

                Import-Module $RestModulePath -Cmdlet Set-ExoAppSettings;

                # If we are configured to collect telemetry, add telemetry wrappers. 

                if ($EnableErrorReporting.Value -eq $true)

                {

                    $FilePath = Add-EXOClientTelemetryWrapper -Organization (Get-OrgNameFromUPN -UPN $UserPrincipalName.Value) -PSSessionModuleName $PSSessionModuleInfo.Name -LogDirectoryPath $LogDirectoryPath.Value

                    $EXOTelemetryFilePath = $FilePath[0]

                    Import-Module $FilePath[1] -DisableNameChecking

                    # Set the AppSettings

                    Set-ExoAppSettings -ShowProgress $ShowProgress.Value -PageSize $PageSize.Value -UseMultithreading $UseMultithreading.Value -TrackPerformance $TrackPerformance.Value -ExchangeEnvironmentName $ExchangeEnvironmentName -ConnectionUri $ConnectionUri -AzureADAuthorizationEndpointUri $AzureADAuthorizationEndpointUri -EnableErrorReporting $true -LogDirectoryPath $LogDirectoryPath.Value -LogLevel $LogLevel.Value

                }

                else 

                {

                    # Set the AppSettings disabling the logging

                    Set-ExoAppSettings -ShowProgress $ShowProgress.Value -PageSize $PageSize.Value -UseMultithreading $UseMultithreading.Value -TrackPerformance $TrackPerformance.Value -ExchangeEnvironmentName $ExchangeEnvironmentName -ConnectionUri $ConnectionUri -AzureADAuthorizationEndpointUri $AzureADAuthorizationEndpointUri -EnableErrorReporting $false

                }

            }

        }

        catch

        {

            throw $_

        }

        Finally 

        {

            # If telemetry is enabled, log errors generated from this cmdlet also. 

            if ($EnableErrorReporting.Value -eq $true)

            {

                $errorCountAtProcessEnd = $global:Error.Count 

                # If we have any errors during this cmdlet execution, log it. 

                if ($errorCountAtProcessEnd -gt $errorCountAtStart)

                {

                    if (!$EXOTelemetryFilePath)

                    {

                        $EXOTelemetryFilePath = New-EXOClientTelemetryFilePath

                    }

                    # Log errors which are encountered during Connect-ExchangeOnline execution. 

                    Write-Warning("Writing Connect-ExchangeOnline errors to " + $EXOTelemetryFilePath)

                    Push-EXOTelemetryRecord -TelemetryFilePath $EXOTelemetryFilePath -CommandName Connect-ExchangeOnline -OrganizationName  $global:ExPSTelemetryOrganization -ScriptName $global:ExPSTelemetryScriptName  -ScriptExecutionGuid $global:ExPSTelemetryScriptExecutionGuid -ErrorObject $global:Error -ErrorRecordsToConsider ($errorCountAtProcessEnd - $errorCountAtStart) 

                }

            }

        }

    }

}

# SIG # Begin signature block

# MIIdwAYJKoZIhvcNAQcCoIIdsTCCHa0CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUu/C1hQqIAl3uuw8j7QxSY8Wl

# TdCgghhuMIIE3jCCA8agAwIBAgITMwAAATGN4b6nnwo14AAAAAABMTANBgkqhkiG

# 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw

# HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTkwOTA2MjA0MDA2

# WhcNMjAxMjA0MjA0MDA2WjCBzjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEpMCcGA1UECxMgTWljcm9zb2Z0IE9wZXJhdGlvbnMgUHVlcnRvIFJp

# Y28xJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjE0OEMtQzRCOS0yMDY2MSUwIwYD

# VQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIBIjANBgkqhkiG9w0B

# AQEFAAOCAQ8AMIIBCgKCAQEA44MW746WlNnuhV4MNgY8hZbuKvs8jXFCQGmtGbkk

# jAXvOntKezUhFewTM3cTzk9Y7ktGmX/IXwdVf4p4/EijDrtP/0sM2VT/WUCSQ0OW

# Lf3t1uN4+5Q/J4xBoWOLu8wyJplsj1LVk2c+1ZBuRi9lWMcKd0z+bOf3N5DBDYqF

# p/YiUmZ1eg+/mIDvUfXzIL7YQ3m5GwxujGjDlXsGD3ZLtJ7ubl/NPJASHIrZ+JnD

# zLWybUeGQFwmGbHcOTt8o2rGO4+B5NKtJYveB3VoBWKwPgknL0HD12MMH2gXYyFS

# FVGlESd1Wmig51WsEXf3Derh0zCZTklL8V3e6prwe09aaQIDAQABo4IBCTCCAQUw

# HQYDVR0OBBYEFC1z8U9/hhkUeN6Hw36S/RTKrvmaMB8GA1UdIwQYMBaAFCM0+NlS

# RnAK7UD7dvuzK7DDNbMPMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY3Jvc29mdFRpbWVTdGFtcFBD

# QS5jcmwwWAYIKwYBBQUHAQEETDBKMEgGCCsGAQUFBzAChjxodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jvc29mdFRpbWVTdGFtcFBDQS5jcnQw

# EwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJKoZIhvcNAQEFBQADggEBAGxFjYUTibWy

# u6Lq9jxdFDXSk32GAl1spdfdYGtetReYauvnqwMNAlOfjvb3vaHXhwtFyjpH+zKG

# 74+/POkWo0Ml8sYKH0d8HMSx0jkNp9wVBkn2vOt8NS2PIODI9j/ib7pE/1nqjbf6

# rIv0JiyGaOq4654Dt5Gv636uYyMnrh+DBi41vOsbJiBqaojbmCOXf5VHro91joUp

# 27lIUCBcSXG2fYSO3BSso1wfJzdUxgffRotNCr1o9oIIf4lgaPomPJNpDA3nOSQc

# NwWC1pkQUE+PSPWFMYxFddUTfiR9DN2J9rzgIGCCSHJAUEGFDW5hgYX7RtIa736g

# w3Uwm+op7jQwggX/MIID56ADAgECAhMzAAABUZ6Nj0Bxow5BAAAAAAFRMA0GCSqG

# SIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwHhcNMTkw

# NTAyMjEzNzQ2WhcNMjAwNTAyMjEzNzQ2WjB0MQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24w

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVWsaGaUcdNB7xVcNmdfZi

# VBhYFGcn8KMqxgNIvOZWNH9JYQLuhHhmJ5RWISy1oey3zTuxqLbkHAdmbeU8NFMo

# 49Pv71MgIS9IG/EtqwOH7upan+lIq6NOcw5fO6Os+12R0Q28MzGn+3y7F2mKDnop

# Vu0sEufy453gxz16M8bAw4+QXuv7+fR9WzRJ2CpU62wQKYiFQMfew6Vh5fuPoXlo

# N3k6+Qlz7zgcT4YRmxzx7jMVpP/uvK6sZcBxQ3WgB/WkyXHgxaY19IAzLq2QiPiX

# 2YryiR5EsYBq35BP7U15DlZtpSs2wIYTkkDBxhPJIDJgowZu5GyhHdqrst3OjkSR

# AgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEEAYI3TAgBBggrBgEFBQcDAzAd

# BgNVHQ4EFgQUV4Iarkq57esagu6FUBb270Zijc8wUAYDVR0RBEkwR6RFMEMxKTAn

# BgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMRYwFAYDVQQF

# Ew0yMzAwMTIrNDU0MTM1MB8GA1UdIwQYMBaAFEhuZOVQBdOCqhc3NyK1bajKdQKV

# MFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcmwwYQYIKwYBBQUH

# AQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp

# b3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcnQwDAYDVR0T

# AQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAWg+ArS4Anq7KrogslIQnoMHSXUPr

# /RqOIhJX+32ObuY3MFvdlRElbSsSJxrRy/OCCZdSse+f2AqQ+F/2aYwBDmUQbeMB

# 8n0pYLZnOPifqe78RBH2fVZsvXxyfizbHubWWoUfNW/FJlZlLXwJmF3BoL8E2p09

# K3hagwz/otcKtQ1+Q4+DaOYXWleqJrJUsnHs9UiLcrVF0leL/Q1V5bshob2OTlZq

# 0qzSdrMDLWdhyrUOxnZ+ojZ7UdTY4VnCuogbZ9Zs9syJbg7ZUS9SVgYkowRsWv5j

# V4lbqTD+tG4FzhOwcRQwdb6A8zp2Nnd+s7VdCuYFsGgI41ucD8oxVfcAMjF9YX5N

# 2s4mltkqnUe3/htVrnxKKDAwSYliaux2L7gKw+bD1kEZ/5ozLRnJ3jjDkomTrPct

# okY/KaZ1qub0NUnmOKH+3xUK/plWJK8BOQYuU7gKYH7Yy9WSKNlP7pKj6i417+3N

# a/frInjnBkKRCJ/eYTvBH+s5guezpfQWtU4bNo/j8Qw2vpTQ9w7flhH78Rmwd319

# +YTmhv7TcxDbWlyteaj4RK2wk3pY1oSz2JPE5PNuNmd9Gmf6oePZgy7Ii9JLLq8S

# nULV7b+IP0UXRY9q+GdRjM2AEX6msZvvPCIoG0aYHQu9wZsKEK2jqvWi8/xdeeeS

# I9FN6K1w4oVQM4MwggYHMIID76ADAgECAgphFmg0AAAAAAAcMA0GCSqGSIb3DQEB

# BQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/IsZAEZFgltaWNy

# b3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv

# cml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0MDMxMzAzMDlaMHcxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ+h

# bLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP7tGn0UytdDAgEesH1VSVFUmUG0KS

# rphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySHnfL0Zxws/HvniB3q506jocEjU8qN

# +kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUoRi4nrIZPVVIM5AMs+2qQkDBuh/NZ

# MJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABKR2YRJylmqJfk0waBSqL5hKcRRxQJ

# gp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSfrx54QTF3zJvfO4OToWECtR0Nsfz3

# m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGnMA8GA1UdEwEB/wQFMAMBAf8wHQYD

# VR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMPMAsGA1UdDwQEAwIBhjAQBgkrBgEE

# AYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQOrIJgQFYnl+UlE/wq4QpTlVnkpKFj

# pGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jv

# c29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9y

# aXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1UdHwRJMEcwRaBDoEGGP2h0dHA6Ly9j

# cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL21pY3Jvc29mdHJvb3Rj

# ZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYIKwYBBQUHMAKGOGh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljcm9zb2Z0Um9vdENlcnQuY3J0MBMG

# A1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUAA4ICAQAQl4rDXANENt3p

# tK132855UU0BsS50cVttDBOrzr57j7gu1BKijG1iuFcCy04gE1CZ3XpA4le7r1ia

# HOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV3U+rkuTnjWrVgMHmlPIGL4UD6ZEq

# JCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5nGctxVEO6mJcPxaYiyA/4gcaMvnM

# MUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tOi3/FNSteo7/rvH0LQnvUU3Ih7jDK

# u3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbMUVbonXCUbKw5TNT2eb+qGHpiKe+i

# myk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXjpKh0NbhOxXEjEiZ2CzxSjHFaRkMU

# vLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh0EPpK+m79EjMLNTYMoBMJipIJF9a

# 6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLaxaj2JoXZhtG6hE6a/qkfwEm/9ijJs

# sv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWwymO0eFQF1EEuUKyUsKV4q7OglnUa

# 2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma7kng9wFlb4kLfchpyOZu6qeXzjEp

# /w7FW1zYTRuh2Povnj8uVRZryROj/TCCB3owggVioAMCAQICCmEOkNIAAAAAAAMw

# DQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv

# cml0eSAyMDExMB4XDTExMDcwODIwNTkwOVoXDTI2MDcwODIxMDkwOVowfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP

# ADCCAgoCggIBAKvw+nIQHC6t2G6qghBNNLrytlghn0IbKmvpWlCquAY4GgRJun/D

# DB7dN2vGEtgL8DjCmQawyDnVARQxQtOJDXlkh36UYCRsr55JnOloXtLfm1OyCizD

# r9mpK656Ca/XllnKYBoF6WZ26DJSJhIv56sIUM+zRLdd2MQuA3WraPPLbfM6XKEW

# 9Ea64DhkrG5kNXimoGMPLdNAk/jj3gcN1Vx5pUkp5w2+oBN3vpQ97/vjK1oQH01W

# KKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd6IlPhBryoS9Z5JA7La4zWMW3Pv4y

# 07MDPbGyr5I4ftKdgCz1TlaRITUlwzluZH9TupwPrRkjhMv0ugOGjfdf8NBSv4yU

# h7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOnqWbsYR9q4ShJnV+I4iVd0yFLPlLE

# tVc/JAPw0XpbL9Uj43BdD1FGd7P4AOG8rAKCX9vAFbO9G9RVS+c5oQ/pI0m8GLhE

# fEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkwp6uO3+xbn6/83bBm4sGXgXvt1u1L

# 50kppxMopqd9Z4DmimJ4X7IvhNdXnFy/dygo8e1twyiPLI9AN0/B4YVEicQJTMXU

# pUMvdJX3bvh4IFgsE11glZo+TzOE2rCIF96eTvSWsLxGoGyY0uDWiIwLAgMBAAGj

# ggHtMIIB6TAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQUSG5k5VAF04KqFzc3

# IrVtqMp1ApUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG

# MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEj

# iTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br

# aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBe

# BggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDCB

# nwYDVR0gBIGXMIGUMIGRBgkrBgEEAYI3LgMwgYMwPwYIKwYBBQUHAgEWM2h0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvZG9jcy9wcmltYXJ5Y3BzLmh0bTBA

# BggrBgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwAXwBwAG8AbABpAGMAeQBfAHMAdABh

# AHQAZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAZ/KGpZjgVHkaLtPY

# dGcimwuWEeFjkplCln3SeQyQwWVfLiw++MNy0W2D/r4/6ArKO79HqaPzadtjvyI1

# pZddZYSQfYtGUFXYDJJ80hpLHPM8QotS0LD9a+M+By4pm+Y9G6XUtR13lDni6WTJ

# RD14eiPzE32mkHSDjfTLJgJGKsKKELukqQUMm+1o+mgulaAqPyprWEljHwlpblqY

# luSD9MCP80Yr3vw70L01724lruWvJ+3Q3fMOr5kol5hNDj0L8giJ1h/DMhji8MUt

# zluetEk5CsYKwsatruWy2dsViFFFWDgycScaf7H0J/jeLDogaZiyWYlobm+nt3TD

# QAUGpgEqKD6CPxNNZgvAs0314Y9/HG8VfUWnduVAKmWjw11SYobDHWM2l4bf2vP4

# 8hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1HxS+YWG18NzGGwS+30HHDiju3mUv

# 7Jf2oVyW2ADWoUa9WfOXpQlLSBCZgB/QACnFsZulP0V3HjXG0qKin3p6IvpIlR+r

# +0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9azI2h15q/6/IvrC4DqaTuv/DDtBEyO

# 3991bWORPdGdVk5Pv4BXIqF4ETIheu9BCrE/+6jMpF3BoYibV3FWTkhFwELJm3Zb

# CoBIa/15n8G9bW1qyVJzEw16UM0xggS8MIIEuAIBATCBlTB+MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQgQ29k

# ZSBTaWduaW5nIFBDQSAyMDExAhMzAAABUZ6Nj0Bxow5BAAAAAAFRMAkGBSsOAwIa

# BQCggdAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFI01nSzhEYZxvBBatEG9/FPp

# d45iMHAGCisGAQQBgjcCAQwxYjBgoDyAOgBFAHgAYwBoAGEAbgBnAGUATwBuAGwA

# aQBuAGUATQBhAG4AYQBnAGUAbQBlAG4AdAAuAHAAcwBtADGhIIAeaHR0cDovL21p

# Y3Jvc29mdC5jb20vRXhjaGFuZ2UgMA0GCSqGSIb3DQEBAQUABIIBAHIOpud3EgZw

# czRvuDFRK0qXP7V3jceLHGWTvvz48HTW7Pa5AnrvfSFCSRDOSMdsAhSDfIBDHCHU

# aDDk8GOzos+aIm6/Kc5wwDygKOniDJANQgSTuVeM3ZNKkp2NX2NzIrfHGGFKblDv

# 4Jdct2QApxbV6CI9wI//Z98zMd3iWHbtdWNRxeXl/PJp90ha0o4hF0KrRjV/UzLD

# KucPFQD3dICan8w6Y70QLnjrSjjuyqVLaHWayzZeBEu4x3WgZri1Mr+2HWUD6N0z

# Qq6FoFnYRacxUb/xNKa2JyPQ07hQ9hFyUAIlAIqYqiCT42rTx95IDg9/BaNBg8aw

# z69Ut+QxNJKhggIoMIICJAYJKoZIhvcNAQkGMYICFTCCAhECAQEwgY4wdzELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEhMB8GA1UEAxMYTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgUENBAhMzAAABMY3hvqefCjXgAAAAAAExMAkGBSsOAwIa

# BQCgXTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0x

# OTEwMTkwNzQ5MzFaMCMGCSqGSIb3DQEJBDEWBBT7w9IzJVcHpC2JcZ306H7rBd1T

# EjANBgkqhkiG9w0BAQUFAASCAQDPHltRd5jaQ1rZgM+otR2fKxxvDOtgquL5kEZL

# Q6FPS4ybL0M10N5wf647kJw8L82zqYPPGlx0+hk7LeVpV6V0OvAwGGefdPQ64ChX

# tKymAAaEnXj/IOApeOvC1qWOYJCL64Tlq4WkbTOz94kLqvpmZDFjcv6jGoxPJ1O9

# LSYcXndSCwqBRd3kbnCSgutuSQeC2H2nUseumz6QFtSjhPSItL77WNsJQwJeLKTk

# StC02E7euQUpE2FkL+C7gGc4OcU6CddwM6BLxdimHCVri8zzPyd1bU++wbrHDWHM

# oaAorgFCJvifkxlLCwxm9lbJMY5EN9vCzMglbK5ObuLGBbvv

# SIG # End signature block