#======================================= # ConfigureSplitPerms.ps1 # # THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY # KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A # PARTICULAR PURPOSE. # # Description: Script to configure a split recipient permission model. # Requires Exchange 2007 SP1 or later # # Script Model Used: Christian Schindler (NTx BOCG) # Script Development: Ross Smith IV (Microsoft) # Script Contributions: Sebastian Bengochea (Microsoft) # # Version: 1.5 # Last Updated: 5/25/2007 #======================================= # # To get help, just add the "-help" paramter # #======================================= # Parameter definition #======================================= Param( [string] $User, [string] $Identity, [switch] $RemovePerms, [switch] $UM ) #======================================= # Function that validates the script parameters #======================================= function ValidateParams { $validInputs = $true $errorString = "" if ($User -eq "") { $validInputs = $false $errorString += "`n`nMissing Parameter: The -User parameter is required. Please pass in the name of a valid user or security group." + "`n" } if ($Identity -eq "") { $validInputs = $false $errorString += "`n`nMissing Parameter: The -Identity parameter is required. Please pass in the name of a valid organizational unit." + "`n" } if (!$validInputs) {Write-error "$errorString"} return $validInputs } #======================================= # Function that returns true if the incoming argument is a help request #======================================= function IsHelpRequest { param($argument) return ($argument -eq "-?" -or $argument -eq "-help"); } #======================================= # Function that displays the help related to this script following # the same format provided by get-help or -? #======================================= function Usage { @" NAME: ConfigureSplitPerms.ps1 SYNOPSIS: Adds/Removes appropriate Access Control Entries so that you can manage recipients in certain containers within the domain partition and operate in a split permission model. For more information on what is granted, please see: http://technet.microsoft.com/en-us/library/bb232100.aspx SYNTAX: ConfigureSplitPerms.ps1 `t[-User ] `t[-Identity ] `t[-UM] `t[-RemovePerms] PARAMETERS: -User (required) The user parameter specifies the user or security group that will have the permissions granted or removed. -Identity (required) The Identity parameter specifies the identity of the object that is getting permissions added. -UM (optional) This parameter will override the default behavior and only grant or remove the necessary permissions for the user or security group to manage Unified Messaging related attributes. For more information, please see http://technet.microsoft.com/en-us/library/bb232176.aspx. -RemovePerms (optional) Removes the permissions previously assigned for the user/group against the organizational unit. -------------------------- EXAMPLE 1 -------------------------- .\ConfigureSplitPerms.ps1 -User CONTOSO\Joe -Identity "OU=Accounts,DC=contoso,DC=com" -> Execution will grant Joe the necessary rights to manage all recipients in the identified OU. -------------------------- EXAMPLE 2 -------------------------- .\ConfigureSplitPerms.ps1 -User CONTOSO\Joe -Identity "OU=Accounts,DC=contoso,DC=com" -RemovePerms -> Execution will remove Joe from having the permissions to manage the recipients in the identified OU. -------------------------- EXAMPLE 3 -------------------------- .\ConfigureSplitPerms.ps1 -User CONTOSO\Jessica -Identity "OU=Accounts,DC=contoso,DC=com" -UM -> Execution will grant Jessica the necessary rights to manage the UM properties for mailboxes in the identified OU. "@ } #======================================= # Check for Usage Statement Request #======================================= $args | foreach { if (IsHelpRequest $_) { Usage; exit; } } #======================================= # Validate the parameters and Execute the functions #======================================= $ifValidParams = ValidateParams; if (!$ifValidParams) { exit; } #======================================= # Get Exchange Org DN Function #======================================= function GetExchangeOrg { # Get Exchange Organization Distinguished Name $rootdom = "LDAP://rootDSE" $RootDomain = [System.DirectoryServices.DirectoryEntry] $rootdom $ConfigurationNC = $RootDomain.Get("configurationNamingContext") $OrgContainer = "cn=Microsoft Exchange,cn=services,$ConfigurationNC" $OrgSearch = New-Object DirectoryServices.DirectorySearcher $OrgSearch.SearchRoot = [System.DirectoryServices.DirectoryEntry] "LDAP://$orgContainer" $OrgSearch.Filter = '(objectCategory=msExchOrganizationContainer)' $OrgResult = $OrgSearch.FindOne() if ($OrgResult -eq $NULL) { Write-Host "Could not find a valid Exchange Organization!" exit; } else { $global:OrgDN = $OrgResult.Properties.distinguishedname } #Determine if Permissions are already applied on certain objects $global:ExAGPermLookup = Get-ADPermission -Identity "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN" -User "$User" $global:ExALPermLookup = Get-ADPermission -Identity "CN=Address Lists Container,$OrgDN" -User $User $global:ExRPPermLookup = Get-ADPermission -Identity "CN=Recipient Policies,$OrgDN" -User $User $global:ExVOPermLookup = Get-ExchangeAdministrator -Identity $User | where {$_.Role -eq "ViewOnlyAdmin"} } #======================================= # Configure Split Recipient Permissions Function #======================================= function ConfigureSplitPerms { #Remove Permissions if ($RemovePerms) { Write-Host "Removing Split Permission Model for $User on $Identity." #to remove user/group from having Exchange-related attributes on objects within the OU Remove-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties Exchange-Information,Exchange-Personal-Information,legacyExchangeDN,displayName,adminDisplayName,displayNamePrintable,publicDelegates,garbageCollPeriod,textEncodedORAddress,showInAddressBook,proxyAddresses,mail write-host "" #to remove user/group from having Generic Read permission for all objects within the OU Remove-ADPermission -Identity "$Identity" -User "$User" -AccessRights GenericRead write-host "" #to remove user/group from having the permission to manage dynamic distribution groups within the OU Remove-ADPermission -Identity "$Identity" -User "$User" -AccessRights GenericAll -ChildObjectTypes msExchDynamicDistributionList write-host "" #to remove user/group from having the extended right to access the Recipient Update Service if ($ExAGPermLookup -ne $NULL) { Remove-ADPermission -Identity "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN" -User "$User" -InheritedObjectType ms-Exch-Exchange-Server -ExtendedRights ms-Exch-Recipient-Update-Access -InheritanceType Descendents write-host "" } else {write-host "Permissions have already been removed for $User to access the Recipient Update Service."} #to remove user/group from having the ability to update the address lists for the recipients they manage if ($ExALPermLookup -ne $NULL) { Remove-ADPermission -Identity "CN=Address Lists Container,$OrgDN" -User $User -AccessRights WriteProperty -Properties msExchLastAppliedRecipientFilter,msExchRecipientFilterFlags write-host "" } else { write-host "Permissions have already been removed for $User to update the address lists for the recipients they manage." write-host "" } #to remove user/group from having the ability to update e-mail address policies for the recipients they manage if ($ExRPPermLookup -ne $NULL) { Remove-ADPermission -Identity "CN=Recipient Policies,$OrgDN" -User $User -AccessRights WriteProperty -Properties msExchLastAppliedRecipientFilter,msExchRecipientFilterFlags write-host "" } else { write-host "Permissions have already been removed for $User to update e-mail address policies for the recipients they manage." write-host "" } #removes user/group from View Only Administrator role if ($ExVOPermLookup -ne $NULL) {Remove-ExchangeAdministrator -Identity $User -Role ViewOnlyAdmin} else {"The $User has already been removed from the Exchange View Only Administrator role."} } #Add Permissions else { Write-Host "Applying Split Permission Model for $User on $Identity." #to grant user/group the ability to manage Exchange-related attributes on objects within the OU Add-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties Exchange-Information,Exchange-Personal-Information,legacyExchangeDN,displayName,adminDisplayName,displayNamePrintable,publicDelegates,garbageCollPeriod,textEncodedORAddress,showInAddressBook,proxyAddresses,mail write-host "" #to grant user/group the Generic Read permission for all objects within the OU Add-ADPermission -Identity "$Identity" -User "$User" -AccessRights GenericRead write-host "" #to grant user/group the appropriate permission to manage dynamic distribution groups within the OU Add-ADPermission -Identity "$Identity" -User "$User" -AccessRights GenericAll -ChildObjectTypes msExchDynamicDistributionList write-host "" #to grant the user/group the extended right to access the Recipient Update Service if ($ExAGPermLookup -eq $NULL) { Add-ADPermission -Identity "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN" -User "$User" -InheritedObjectType ms-Exch-Exchange-Server -ExtendedRights ms-Exch-Recipient-Update-Access -InheritanceType Descendents write-host "" } else { write-host "Permissions are already assigned for $User to access the Recipient Update Service." write-host "" } #to grant the user/group the ability to update the address lists for the recipients they manage if ($ExALPermLookup -eq $NULL) { Add-ADPermission -Identity "CN=Address Lists Container,$OrgDN" -User $User -AccessRights WriteProperty -Properties msExchLastAppliedRecipientFilter,msExchRecipientFilterFlags write-host "" } else { write-host "Permissions are already assigned for $User to update the address lists for the recipients they manage." write-host "" } #to grant the user/group the ability to update e-mail address policies for the recipients they manage if ($ExRPPermLookup -eq $NULL) { Add-ADPermission -Identity "CN=Recipient Policies,$OrgDN" -User $User -AccessRights WriteProperty -Properties msExchLastAppliedRecipientFilter,msExchRecipientFilterFlags write-host "" } else { write-host "Permissions are already assigned for $User to update e-mail address policies for the recipients they manage." write-host "" } #adds user to View Only Admin role if ($ExVOPermLookup -eq $NULL) {Add-ExchangeAdministrator -Identity $User -Role ViewOnlyAdmin} else {"The $User has already been added to the Exchange View Only Administrator role."} } } #======================================= # Configure UM Split Recipient Permissions Function #======================================= function ConfigureUMSplitPerms { #Remove Permissions if ($RemovePerms) { Write-Host "Removing UM Split Permission Model for $User on $Identity." #to remove the user/group from having the ability to manage Exchange-related UM attributes on User objects within the OU Remove-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties proxyAddresses,msExchUMDtmfMap,msExchUMPinChecksum,msExchUMEnabledFlags,msExchUMOperatorNumber,msExchUMListInDirectorySearch,msExchUMRecipientDialPlanLink,msExchUMTemplateLink,msExchUMServerWritableFlags,msExchUMAudioCodec -InheritedObjectType user -InheritanceType Descendents write-host "" #tto remove the user/group from having the ability to manage Exchange-related UM attributes on inetOrgPerson objects within the OU Remove-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties proxyAddresses,msExchUMDtmfMap,msExchUMPinChecksum,msExchUMEnabledFlags,msExchUMOperatorNumber,msExchUMListInDirectorySearch,msExchUMRecipientDialPlanLink,msExchUMTemplateLink,msExchUMServerWritableFlags,msExchUMAudioCodec -InheritedObjectType inetOrgPerson -InheritanceType Descendents write-host "" #to remove user/group from having the extended right to access the Recipient Update Service if ($ExAGPermLookup -ne $NULL) { Remove-ADPermission -Identity "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN" -User "$User" -InheritedObjectType ms-Exch-Exchange-Server -ExtendedRights ms-Exch-Recipient-Update-Access -InheritanceType Descendents write-host "" } else { write-host "Permissions have already been removed for $User to access the Recipient Update Service." write-host "" } #removes user/group from View Only Administrator role if ($ExVOPermLookup -ne $NULL) {Remove-ExchangeAdministrator -Identity $User -Role ViewOnlyAdmin} else {"The $User has already been removed from the Exchange View Only Administrator role."} } #Add Permissions else { Write-Host "Applying UM Split Permission Model for $User on $Identity." #to grant user/group the ability to manage Exchange-related attributes on User objects within the OU Add-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties proxyAddresses,msExchUMDtmfMap,msExchUMPinChecksum,msExchUMEnabledFlags,msExchUMOperatorNumber,msExchUMListInDirectorySearch,msExchUMRecipientDialPlanLink,msExchUMTemplateLink,msExchUMServerWritableFlags,msExchUMAudioCodec -InheritedObjectType user -InheritanceType Descendents write-host "" #to grant user/group the ability to manage Exchange-related attributes on inetOrgPerson objects within the OU Add-ADPermission -Identity "$Identity" -User "$User" -AccessRights ReadProperty,WriteProperty -Properties proxyAddresses,msExchUMDtmfMap,msExchUMPinChecksum,msExchUMEnabledFlags,msExchUMOperatorNumber,msExchUMListInDirectorySearch,msExchUMRecipientDialPlanLink,msExchUMTemplateLink,msExchUMServerWritableFlags,msExchUMAudioCodec -InheritedObjectType inetOrgPerson -InheritanceType Descendents write-host "" #to grant the user/group the extended right to access the Recipient Update Service if ($ExAGPermLookup -eq $NULL) { Add-ADPermission -Identity "CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN" -User "$User" -InheritedObjectType ms-Exch-Exchange-Server -ExtendedRights ms-Exch-Recipient-Update-Access -InheritanceType Descendents write-host "" } else { write-host "Permissions are already assigned for $User to access the Recipient Update Service." write-host "" } #adds user to View Only Admin role if ($ExVOPermLookup -eq $NULL) {Add-ExchangeAdministrator -Identity $User -Role ViewOnlyAdmin} else {"The $User has already been added to the Exchange View Only Administrator role."} } } #======================================= # Execute functions #======================================= if ($UM) {GetExchangeOrg; ConfigureUMSplitPerms;} else {GetExchangeOrg; ConfigureSplitPerms;} # SIG # Begin signature block # MIIkDgYJKoZIhvcNAQcCoIIj/zCCI/sCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUMtsNCkdAB88Wz76wMpMHwknu # CVqggh7hMIIEEjCCAvqgAwIBAgIPAMEAizw8iBHRPvZj7N9AMA0GCSqGSIb3DQEB # BAUAMHAxKzApBgNVBAsTIkNvcHlyaWdodCAoYykgMTk5NyBNaWNyb3NvZnQgQ29y # cC4xHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEhMB8GA1UEAxMYTWlj # cm9zb2Z0IFJvb3QgQXV0aG9yaXR5MB4XDTk3MDExMDA3MDAwMFoXDTIwMTIzMTA3 # MDAwMFowcDErMCkGA1UECxMiQ29weXJpZ2h0IChjKSAxOTk3IE1pY3Jvc29mdCBD # b3JwLjEeMBwGA1UECxMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhN # aWNyb3NvZnQgUm9vdCBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCpAr3BcOY78k4bKJ+XeF4w6qKpjSVf+P6VTKO3/p2iID58UaKboo9g # MmvRQmR57qx2yVTa8uuchhyPn4Rms8VremIj1h083g8BkuiWxL8tZpqaaCaZ0Dos # vwy1WCbBRucKPjiWLKkoOajsSYNC44QPu5psVWGsgnyhYC13TOmZtGQ7mlAcMQgk # FJ+p55ErGOY9mGMUYFgFZZ8dN1KH96fvlALGG9O/VUWziYC/OuxUlE6u/ad6bXRO # rxjMlgkoIQBXkGBpN7tLEgc8Vv9b+6RmCgim0oFWV++2O14WgXcE2va+roCV/rDN # f9anGnJcPMq88AijIjCzBoXJsyB3E4XfAgMBAAGjgagwgaUwgaIGA1UdAQSBmjCB # l4AQW9Bw72lyniNRfhSyTY7/y6FyMHAxKzApBgNVBAsTIkNvcHlyaWdodCAoYykg # MTk5NyBNaWNyb3NvZnQgQ29ycC4xHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEhMB8GA1UEAxMYTWljcm9zb2Z0IFJvb3QgQXV0aG9yaXR5gg8AwQCLPDyI # EdE+9mPs30AwDQYJKoZIhvcNAQEEBQADggEBAJXoC8CN85cYNe24ASTYdxHzXGAy # n54Lyz4FkYiPyTrmIfLwV5MstaBHyGLv/NfMOztaqTZUaf4kbT/JzKreBXzdMY09 # nxBwarv+Ek8YacD80EPjEVogT+pie6+qGcgrNyUtvmWhEoolD2Oj91Qc+SHJ1hXz # UqxuQzIH/YIX+OVnbA1R9r3xUse958Qw/CAxCYgdlSkaTdUdAqXxgOADtFv0sd3I # V+5lScdSVLa0AygS/5DW8AiPfriXxas3LOR65Kh343agANBqP8HSNorgQRKoNWob # ats14dQcBOSoRQTIWjM4bk0cDWK3CqKM09VUP0bNHFWmcNsSOoeTdZ+n0qAwggQS # MIIC+qADAgECAg8AwQCLPDyIEdE+9mPs30AwDQYJKoZIhvcNAQEEBQAwcDErMCkG # A1UECxMiQ29weXJpZ2h0IChjKSAxOTk3IE1pY3Jvc29mdCBDb3JwLjEeMBwGA1UE # CxMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhNaWNyb3NvZnQgUm9v # dCBBdXRob3JpdHkwHhcNOTcwMTEwMDcwMDAwWhcNMjAxMjMxMDcwMDAwWjBwMSsw # KQYDVQQLEyJDb3B5cmlnaHQgKGMpIDE5OTcgTWljcm9zb2Z0IENvcnAuMR4wHAYD # VQQLExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBS # b290IEF1dGhvcml0eTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkC # vcFw5jvyThson5d4XjDqoqmNJV/4/pVMo7f+naIgPnxRopuij2Aya9FCZHnurHbJ # VNry65yGHI+fhGazxWt6YiPWHTzeDwGS6JbEvy1mmppoJpnQOiy/DLVYJsFG5wo+ # OJYsqSg5qOxJg0LjhA+7mmxVYayCfKFgLXdM6Zm0ZDuaUBwxCCQUn6nnkSsY5j2Y # YxRgWAVlnx03Uof3p++UAsYb079VRbOJgL867FSUTq79p3ptdE6vGMyWCSghAFeQ # YGk3u0sSBzxW/1v7pGYKCKbSgVZX77Y7XhaBdwTa9r6ugJX+sM1/1qcaclw8yrzw # CKMiMLMGhcmzIHcThd8CAwEAAaOBqDCBpTCBogYDVR0BBIGaMIGXgBBb0HDvaXKe # I1F+FLJNjv/LoXIwcDErMCkGA1UECxMiQ29weXJpZ2h0IChjKSAxOTk3IE1pY3Jv # c29mdCBDb3JwLjEeMBwGA1UECxMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYD # VQQDExhNaWNyb3NvZnQgUm9vdCBBdXRob3JpdHmCDwDBAIs8PIgR0T72Y+zfQDAN # BgkqhkiG9w0BAQQFAAOCAQEAlegLwI3zlxg17bgBJNh3EfNcYDKfngvLPgWRiI/J # OuYh8vBXkyy1oEfIYu/818w7O1qpNlRp/iRtP8nMqt4FfN0xjT2fEHBqu/4STxhp # wPzQQ+MRWiBP6mJ7r6oZyCs3JS2+ZaESiiUPY6P3VBz5IcnWFfNSrG5DMgf9ghf4 # 5WdsDVH2vfFSx73nxDD8IDEJiB2VKRpN1R0CpfGA4AO0W/Sx3chX7mVJx1JUtrQD # KBL/kNbwCI9+uJfFqzcs5HrkqHfjdqAA0Go/wdI2iuBBEqg1ahtq2zXh1BwE5KhF # BMhaMzhuTRwNYrcKoozT1VQ/Rs0cVaZw2xI6h5N1n6fSoDCCBGAwggNMoAMCAQIC # Ci6rEdxQ/1ydy8AwCQYFKw4DAh0FADBwMSswKQYDVQQLEyJDb3B5cmlnaHQgKGMp # IDE5OTcgTWljcm9zb2Z0IENvcnAuMR4wHAYDVQQLExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBSb290IEF1dGhvcml0eTAeFw0wNzA4 # MjIyMjMxMDJaFw0xMjA4MjUwNzAwMDBaMHkxCzAJBgNVBAYTAlVTMRMwEQYDVQQI # EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv # ZnQgQ29ycG9yYXRpb24xIzAhBgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNpZ25pbmcg # UENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAt3l91l2zRTmoNKwx # 2vklNUl3wPsfnsdFce/RRujUjMNrTFJi9JkCw03YSWwvJD5lv84jtwtIt3913UW9 # qo8OUMUlK/Kg5w0jH9FBJPpimc8ZRaWTSh+ZzbMvIsNKLXxv2RUeO4w5EDndvSn0 # ZjstATL//idIprVsAYec+7qyY3+C+VyggYSFjrDyuJSjzzimUIUXJ4dO3TD2AD30 # xvk9gb6G7Ww5py409rQurwp9YpF4ZpyYcw2Gr/LE8yC5TxKNY8ss2TJFGe67SpY7 # UFMYzmZReaqth8hWPp+CUIhuBbE1wXskvVJmPZlOzCt+M26ERwbRntBKhgJuhgCk # wIffUwIDAQABo4H6MIH3MBMGA1UdJQQMMAoGCCsGAQUFBwMDMIGiBgNVHQEEgZow # gZeAEFvQcO9pcp4jUX4Usk2O/8uhcjBwMSswKQYDVQQLEyJDb3B5cmlnaHQgKGMp # IDE5OTcgTWljcm9zb2Z0IENvcnAuMR4wHAYDVQQLExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBSb290IEF1dGhvcml0eYIPAMEAizw8 # iBHRPvZj7N9AMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMwdznYAcFuv8drE # TppRRC6jRGPwMAsGA1UdDwQEAwIBhjAJBgUrDgMCHQUAA4IBAQB7q65+SibyzrxO # dKJYJ3QqdbOG/atMlHgATenK6xjcacUOonzzAkPGyofM+FPMwp+9Vm/wY0SpRADu # lsia1Ry4C58ZDZTX2h6tKX3v7aZzrI/eOY49mGq8OG3SiK8j/d/p1mkJkYi9/uEA # uzTz93z5EBIuBesplpNCayhxtziP4AcNyV1ozb2AQWtmqLu3u440yvIDEHx69dLg # Qt97/uHhrP7239UNs3DWkuNPtjiifC3UPds0C2I3Ap+BaiOJ9lxjj7BauznXYIxV # hBoz9TuYoIIMol+Lsyy3oaXLq9ogtr8wGYUgFA0qvFL0QeBeMOOSKGmHwXDi86er # zoBCcnYOMIIEajCCA1KgAwIBAgIKYQ94TQAAAAAAAzANBgkqhkiG9w0BAQUFADB5 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpN # aWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQTAeFw0wNzA4MjMwMDIzMTNaFw0wOTAy # MjMwMDMzMTNaMHQxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # HjAcBgNVBAMTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIwDQYJKoZIhvcNAQEB # BQADggEPADCCAQoCggEBAKLbCo3PwsFJm82qOjStI1lr22y+ISK3lMjqrr/G1SbC # MhGLvNpdLPs2Vh4VK66PDd0Uo24oTH8WP0GsjUCxRogN2YGUrZcG0FdEdlzq8fwO # 4n90ozPLdOXv42GhfgO3Rf/VPhLVsMpeDdB78rcTDfxgaiiFdYy3rbyF6Be0kL71 # FrZiXe0R3zruIVuLr4Bzw0XjlYl3YJvnrXfBN40zFC8T22LJrhqpT5hnrdQgOTBx # 4I1nRuLGHPQNUHRBL+gFJGoha0mwksSyOcdCpW1cGEqrj9eOgz54CkfYpLKEI8Pi # 8ntmsUp0vSZBS5xhFGBOMMiC89ALcHzuVU130ghVdoECAwEAAaOB+DCB9TAOBgNV # HQ8BAf8EBAMCBsAwHQYDVR0OBBYEFPMhQI58UfhUS5jlF9dqgzQFLiboMBMGA1Ud # JQQMMAoGCCsGAQUFBwMDMB8GA1UdIwQYMBaAFMwdznYAcFuv8drETppRRC6jRGPw # MEQGA1UdHwQ9MDswOaA3oDWGM2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kv # Y3JsL3Byb2R1Y3RzL0NTUENBLmNybDBIBggrBgEFBQcBAQQ8MDowOAYIKwYBBQUH # MAKGLGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvQ1NQQ0EuY3J0 # MA0GCSqGSIb3DQEBBQUAA4IBAQBAV29TZ54ggzQBDuYXSzyt69iBf+4NeXR3T5dH # GPMAFWl+22KQov1noZzkKCn6VdeZ/lC/XgmzuabtgvOYHm9Z+vXx4QzTiwg+Fhcg # 0cC1RUcIJmBXCUuU8AjMuk1u8OJIEig1iyFy31+2r2kSJJTu6TQJ235ub5IKUsoq # TEmqMiyG6KHMXSa8vDzgW7KDC7o1HE+ERUf/u5ShWQeplt14vVd/padOzPKtnJpB # 4stcJD7cfzRHTvbPyHud67bJnGMUU6+tmu/Xv8+goauVynorhyzAx9n8bAPavzit # 8dFcGRcPwPfKgKYQCBrdkCPnsKFMPuqwESZ4DsEsuaRrx488MIIEnTCCA4WgAwIB # AgIKYRQspwAAAAAABjANBgkqhkiG9w0BAQUFADB5MQswCQYDVQQGEwJVUzETMBEG # A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj # cm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgVGltZXN0YW1w # aW5nIFBDQTAeFw0wNzA2MTIyMzU0NTFaFw0xMjA2MTMwMDA0NTFaMIGmMQswCQYD # VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe # MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMScwJQYDVQQLEx5uQ2lwaGVy # IERTRSBFU046MjdGNC1ENDQwLTU0RjMxJzAlBgNVBAMTHk1pY3Jvc29mdCBUaW1l # c3RhbXBpbmcgU2VydmljZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB # AJHLpHsUc9Pn1IaTwAN92ESk4bO1+Lj9vCpTAsqvkd2hGYM6MXj0lkQN5uDuRWaz # vPYCdOo0OLzTdzwjtHD8BzLOnvNFQ+Z0U0xOL1u8UwU+gfzhw1bB5CaT23y6Y+CR # bFZyquugixZ4ZYiXTuJ7IovNqlmezXjHOGKLQ41PxudDzEFF4vvZMe/Y/75pMcrs # drn0IbSQNBf+yRD5uIbPXqHRUrJGWCG4OVeBbwiKX2x1FcCQNnattthJpEh9dp4J # E+zCAH3jh7yXDw4c9ZpG1aTsa8Oqc0j47pOE+SUSSo4EgOB0UOIRaeD1+2LhZmx5 # MwSmJ3GENTZjEitZEwZ5xXUCAwEAAaOB+DCB9TAdBgNVHQ4EFgQUN1XZlgmRta5b # 2j/2WaH+SvSBlqAwHwYDVR0jBBgwFoAUb+hOP5e5NKtLho+8nOqsO0FDxtAwRAYD # VR0fBD0wOzA5oDegNYYzaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwv # cHJvZHVjdHMvdHNwY2EuY3JsMEgGCCsGAQUFBwEBBDwwOjA4BggrBgEFBQcwAoYs # aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy90c3BjYS5jcnQwEwYD # VR0lBAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgbAMA0GCSqGSIb3DQEBBQUA # A4IBAQAlnG+HOS0aiLECAz678khs6jwNDq7u5geVDmK6RyeP0w2qaCIfKfrP/L7a # 7aQvqPJylA50J7P0rIwARchNnF4BBN6PW8nlViqe5pM98d0BIccGweJBWTJx/VgW # IbPzGuQGq1sAaBl3fPj3t7unIslUK4jSiJzPLNA6XzoIfBVh9QIoFZ85bcZqL/gw # eK5Z5Oxq+LWUVpY198M4DDyCGUDOgIooagJZH0BsC8LvsD81euuleWqL0Qoi5mD4 # CxASrCFgFK28yTXXv/2Y11oBNAV6ZrKOnPG74aHJdvD1shxMTUAZWbhGq0zIrEyU # QuMnrvlTP5PKY3wll8uXxDae+a6gMIIEnTCCA4WgAwIBAgIKYRQspwAAAAAABjAN # BgkqhkiG9w0BAQUFADB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv # bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0 # aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgVGltZXN0YW1waW5nIFBDQTAeFw0wNzA2 # MTIyMzU0NTFaFw0xMjA2MTMwMDA0NTFaMIGmMQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMScwJQYDVQQLEx5uQ2lwaGVyIERTRSBFU046MjdGNC1E # NDQwLTU0RjMxJzAlBgNVBAMTHk1pY3Jvc29mdCBUaW1lc3RhbXBpbmcgU2Vydmlj # ZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJHLpHsUc9Pn1IaTwAN9 # 2ESk4bO1+Lj9vCpTAsqvkd2hGYM6MXj0lkQN5uDuRWazvPYCdOo0OLzTdzwjtHD8 # BzLOnvNFQ+Z0U0xOL1u8UwU+gfzhw1bB5CaT23y6Y+CRbFZyquugixZ4ZYiXTuJ7 # IovNqlmezXjHOGKLQ41PxudDzEFF4vvZMe/Y/75pMcrsdrn0IbSQNBf+yRD5uIbP # XqHRUrJGWCG4OVeBbwiKX2x1FcCQNnattthJpEh9dp4JE+zCAH3jh7yXDw4c9ZpG # 1aTsa8Oqc0j47pOE+SUSSo4EgOB0UOIRaeD1+2LhZmx5MwSmJ3GENTZjEitZEwZ5 # xXUCAwEAAaOB+DCB9TAdBgNVHQ4EFgQUN1XZlgmRta5b2j/2WaH+SvSBlqAwHwYD # VR0jBBgwFoAUb+hOP5e5NKtLho+8nOqsO0FDxtAwRAYDVR0fBD0wOzA5oDegNYYz # aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvdHNwY2Eu # Y3JsMEgGCCsGAQUFBwEBBDwwOjA4BggrBgEFBQcwAoYsaHR0cDovL3d3dy5taWNy # b3NvZnQuY29tL3BraS9jZXJ0cy90c3BjYS5jcnQwEwYDVR0lBAwwCgYIKwYBBQUH # AwgwDgYDVR0PAQH/BAQDAgbAMA0GCSqGSIb3DQEBBQUAA4IBAQAlnG+HOS0aiLEC # Az678khs6jwNDq7u5geVDmK6RyeP0w2qaCIfKfrP/L7a7aQvqPJylA50J7P0rIwA # RchNnF4BBN6PW8nlViqe5pM98d0BIccGweJBWTJx/VgWIbPzGuQGq1sAaBl3fPj3 # t7unIslUK4jSiJzPLNA6XzoIfBVh9QIoFZ85bcZqL/gweK5Z5Oxq+LWUVpY198M4 # DDyCGUDOgIooagJZH0BsC8LvsD81euuleWqL0Qoi5mD4CxASrCFgFK28yTXXv/2Y # 11oBNAV6ZrKOnPG74aHJdvD1shxMTUAZWbhGq0zIrEyUQuMnrvlTP5PKY3wll8uX # xDae+a6gMIIEnTCCA4WgAwIBAgIQaguZT8AAJasR20UfWHpnojANBgkqhkiG9w0B # AQUFADBwMSswKQYDVQQLEyJDb3B5cmlnaHQgKGMpIDE5OTcgTWljcm9zb2Z0IENv # cnAuMR4wHAYDVQQLExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1p # Y3Jvc29mdCBSb290IEF1dGhvcml0eTAeFw0wNjA5MTYwMTA0NDdaFw0xOTA5MTUw # NzAwMDBaMHkxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD # VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xIzAh # BgNVBAMTGk1pY3Jvc29mdCBUaW1lc3RhbXBpbmcgUENBMIIBIjANBgkqhkiG9w0B # AQEFAAOCAQ8AMIIBCgKCAQEA3Ddu+6/IQkpxGMjOSD5TwPqrFLosMrsST1LIg+0+ # M9lJMZIotpFk4B9QhLrCS9F/Bfjvdb6Lx6jVrmlwZngnZui2t++Fuc3uqv0SpAtZ # Iikvz0DZVgQbdrVtZG1KVNvd8d6/n4PHgN9/TAI3lPXAnghWHmhHzdnAdlwvfbYl # BLRWW2ocY/+AfDzu1QQlTTl3dAddwlzYhjcsdckO6h45CXx2/p1sbnrg7D6Pl55x # Dl8qTxhiYDKe0oNOKyJcaEWL3i+EEFCy+bUajWzuJZsT+MsQ14UO9IJ2czbGlXqi # zGAG7AWwhjO3+JRbhEGEWIWUbrAfLEjMb5xD4GrofyaOawIDAQABo4IBKDCCASQw # EwYDVR0lBAwwCgYIKwYBBQUHAwgwgaIGA1UdAQSBmjCBl4AQW9Bw72lyniNRfhSy # TY7/y6FyMHAxKzApBgNVBAsTIkNvcHlyaWdodCAoYykgMTk5NyBNaWNyb3NvZnQg # Q29ycC4xHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEhMB8GA1UEAxMY # TWljcm9zb2Z0IFJvb3QgQXV0aG9yaXR5gg8AwQCLPDyIEdE+9mPs30AwEAYJKwYB # BAGCNxUBBAMCAQAwHQYDVR0OBBYEFG/oTj+XuTSrS4aPvJzqrDtBQ8bQMBkGCSsG # AQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTAD # AQH/MA0GCSqGSIb3DQEBBQUAA4IBAQCUTRExwnxQuxGOoWEHAQ6McEWN73NUvT8J # BS3/uFFThRztOZG3o1YL3oy2OxvR+6ynybexUSEbbwhpfmsDoiJG7Wy0bXwiuEbT # hPOND74HijbB637pcF1Fn5LSzM7djsDhvyrNfOzJrjLVh7nLY8Q20Rghv3beO5qz # G3OeIYjYtLQSVIz0nMJlSpooJpxgig87xxNleEi7z62DOk+wYljeMOnpOR3jifLa # OYH5EyGMZIBjBgSW8poCQy97Roi6/wLZZflK3toDdJOzBW4MzJ3cKGF8SPEXnBEh # OAIch6wGxZYyuOVAxlM9vamJ3uhmN430IpaczLB3VFE61nJEsiP2MYIElzCCBJMC # AQEwgYcweTELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEjMCEG # A1UEAxMaTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0ECCmEPeE0AAAAAAAMwCQYF # Kw4DAhoFAKCBwjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3 # AgELMQ4wDAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQULIYmrQPBAbZtWgZ4 # XpDpwhcGITkwYgYKKwYBBAGCNwIBDDFUMFKgNIAyAE0AaQBjAHIAbwBzAG8AZgB0 # ACAARQB4AGMAaABhAG4AZwBlACAAUwBjAHIAaQBwAHShGoAYaHR0cDovL3d3dy5t # aWNyb3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBAEuOuAX66Kp/+2Z2ED5tFHeK # zfwW6M0e2FDTWfLMBKaXDNVv3xMqKFjX/l736O3ieSavToeUUwHJ3Izf+nD0OSfC # p2kip+/mtc9fHyvlwSWGoBFUcOYHAxgScDTh/NgF2cLfWQgJGD32kQV0cSl6wDJQ # IVfM170DY8VpDGBwdgOO1GYDJOEDpOAsElBdZIWXp7qQwDvU+JuvVyCmlQcrLS1S # o7MxjKgpeWjliES6EvvDmwIQvl2yftdXetdyMa8Dvwjcg7d7QADcxEIeXuOddnOt # oYFQJOMBQvwPtRw9c03njNRGcm2uh6pTkpwr0YTGQdFRVc51LVoDXouTmyTNTOmh # ggIfMIICGwYJKoZIhvcNAQkGMYICDDCCAggCAQEwgYcweTELMAkGA1UEBhMCVVMx # EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT # FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEjMCEGA1UEAxMaTWljcm9zb2Z0IFRpbWVz # dGFtcGluZyBQQ0ECCmEULKcAAAAAAAYwBwYFKw4DAhqgXTAYBgkqhkiG9w0BCQMx # CwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0wNzA5MTIyMDIzMzlaMCMGCSqG # SIb3DQEJBDEWBBQM8BsrX/DBsJ92nQBrciE9U230LjANBgkqhkiG9w0BAQUFAASC # AQB2/6AuBODucy0Uy0yKhHP+2xALZrFK2TnAQGUZxEThoW72hEna18cROEXSAppP # EkQ5zoUKaXOJz00YZH1oPGNhmBdk5Zwo+uHqd/iEx/9I5jQQvVxd5Elo2VSccZ6z # cXTXrUfEODEc1tY39um9JNgoyz/IRHej8bMIvh9nA3O4xaWzoIQjLiYdROH0AYaA # HtCi4erP6AMJncdsshnw+sf2Dn6J3QVVNDI0fqh/bOfXx3T6wxzSjPw339qk/pj8 # 9mxl+6f8ZTJEq2Cj2ls3ErpzTi412bauGiQ1AXFE1/X1RDn6oFqiwF9veQu9z5Q0 # r+4BSuyVm6g9w1uEFoYXlltB # SIG # End signature block