## Default and minimum timeout value for sessions = 3 minutes ## Maximum timeout value for sessions = 15 minutes ## $sessionOptionsTimeout = 180000; if (($env:MsExchEmsTimeout -ne $null) -and ($env:MsExchEmsTimeout -gt 180000) -and ($env:MsExchEmsTimeout -lt 900001)) { $sessionOptionsTimeout = $env:MsExchEmsTimeout; } ## function Connect-ExchangeServer ($ServerFqdn, [switch]$Auto, [switch]$Prompt, $UserName, $Forest,[switch]$ClearCache) { set-variable VerbosePreference -value Continue :connectScope do { if (!$Auto -and ($ServerFqdn -eq $null) -and !$Prompt) { _PrintUsageAndQuit } $useWIA = $true if (!($userName -eq $null)) { $credential = get-credential $username $useWIA = $false } if (!($ServerFqdn -eq $null)) { if ($Auto -or !($Forest -eq $null)) { _PrintUsageAndQuit } _OpenExchangeRunspace $ServerFqdn $credential $useWIA } if ($Auto) { # We should provide the $credential before $Forest, and we cannot assume useWIA $true here. It should be read from $useWIA _AutoDiscoverAndConnect $credential $Forest -useWIA:$useWIA -CheckCertificates:$false } else { if (!($Forest -eq $null)) { _PrintUsageAndQuit } } Write-Host "Failed to connect to any Exchange Server in the current site." $fqdn=read-host -prompt "Please enter the Server FQDN where you want to connect" _OpenExchangeRunspace $fqdn $credential $useWIA } while ($false) #connectScope if (!($global:remoteSession -eq $null)) { # do not display all the commands - turn off verbose output set-variable VerbosePreference -value SilentlyContinue $serverName = $global:remoteSession.ComputerName $modulePath = "$env:APPDATA\Microsoft\Exchange\RemotePowerShell\$serverName" $remotePSSettinsPath = "HKCU:Software\Microsoft\ExchangeServer\v14\RemotePowerShell\$serverName" if ($ClearCache) { ClearRegistryEntryAndModule $remotePSSettinsPath $modulePath } try { ExportPSSessionAndImportModule $remotePSSettinsPath $modulePath } catch { Write-Warning "Cannot generate Export-Module for the current session, using Import-PSession." } $global:importResults = Get-Module if ($global:importResults -eq $null) { $global:importResults=Import-PSSession $global:remoteSession -WarningAction SilentlyContinue -DisableNameChecking } set-variable VerbosePreference -value Continue Write-Verbose "Connected to $global:connectedFqdn." } } function Discover-ExchangeServer ([System.Management.Automation.PSCredential] $Credential, $Forest, [bool]$UseWIA=$false, [bool]$SuppressError=$false) { set-variable VerbosePreference -value Continue :connectScope do { _AutoDiscoverAndConnect $Credential $Forest $UseWIA $SuppressError } while ($false) #connectScope if (!($global:remoteSession -eq $null)) { $global:remoteSession.ComputerName remove-pssession $global:remoteSession } else { if ($SuppressError -and ($error.Count -ne 0)) { # When we suppress the error message, we still want the last error Write-Error $error[0] } } } function _AutoDiscoverAndConnect ([System.Management.Automation.PSCredential]$Credential, $Forest, [bool]$UseWIA=$false, [bool]$SuppressError=$false) { if ($Forest -eq $null) { $fqdn = _GetHostFqdn if ($fqdn -ne $null) { _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError } $siteDN,$Forest_CurrentSite=_GetSiteAndForest if($siteDN -eq $null) { return #no site - no auto discovery } #Find servers in sites and connect, assuming the default behavior (connect to current site, if failed then connect to adjacent sites) foreach ($site in ($siteDN, '*')) { $servers = _GetExchangeServersInSite $site "/$Forest_CurrentSite " if (($site -ne "*")-and ($servers -eq $null)) { Write-Warning "No Exchange Server is available in the current site. Connecting to a Server in an adjacent site." } if (($site -eq "*")-and ($servers -eq $null)) { Write-Error "No CAS or other servers are available in the current site or adjacent sites. Cannot connect to Remote Powershell in a Management Tools only box and no cmdlets are provided by Remote Powershell." } _ConnectToAnyServer $servers $credential $UseWIA $SuppressError } } else { $servers = _GetExchangeServersInSite "*" "/$Forest" _ConnectToAnyServer $servers $credential $UseWIA $SuppressError } } function _GetSiteAndForest() { $localSite=[System.DirectoryServices.ActiveDirectory.ActiveDirectorySite]::GetComputerSite() if ($localSite -eq $null) { return #no site - no auto discovery } $siteDN=$localSite.GetDirectoryEntry().DistinguishedName #Get the Forest name of the current site explicitly, to avoid problem with connecting to wrong LDAP point when logged on to different user domain $Forest_CurrentSite = $localSite.Domains[0].Forest.Name return $siteDN,$Forest_CurrentSite } function _GetHostFqdn() { if (@(get-item HKLM:\SOFTWARE\Microsoft\ExchangeServer\v14\*role -erroraction:silentlycontinue).length -gt 0) { try { return [System.Net.Dns]::GetHostByName("LocalHost").HostName } catch { Write-Verbose "Exception was thrown while finding the host name in DNS topology. Connecting to local host will be skipped.." return $null } } } function _GetServerFqdnFromNetworkAddress($server) { $server.properties["networkaddress"] | where {$_.ToString().StartsWith("ncacn_ip_tcp")} | %{$_.ToString().SubString(13)} } function _GetExchangeServersInSite($siteDN, $Forest) { $configNC=([ADSI]"LDAP:/$Forest/RootDse").configurationNamingContext $search = new-object DirectoryServices.DirectorySearcher([ADSI]"LDAP:/$Forest/$configNC") $search.Filter = "(&(objectClass=msExchExchangeServer)(versionNumber>=1937801568)(msExchServerSite=$siteDN))" $search.PageSize=1000 $search.PropertiesToLoad.Clear() [void] $search.PropertiesToLoad.Add("msexchcurrentserverroles") [void] $search.PropertiesToLoad.Add("networkaddress") [void] $search.PropertiesToLoad.Add("serialnumber") $search.FindAll() } function _GetCASServers($servers) { $servers | where {!($_.properties["msexchcurrentserverroles"][0] -band 4) -eq 0} } function _GetHubMailboxUMServers($servers) { $servers | where {(($_.properties["msexchcurrentserverroles"][0] -band 4) -eq 0) -and !($_.properties["msexchcurrentserverroles"][0] -band 50) -eq 0} } function _NewExchangeRunspace([String]$fqdn, [System.Management.Automation.PSCredential] $credential=$null, [bool]$UseWIA=$true, [bool]$SuppressError=$false) { $hostFQDN = _GetHostFqdn if (($fqdn -ne $null) -and ($hostFQDN -ne $null) -and ($hostFQDN.ToLower() -eq $fqdn.ToLower())) { $ServicesRunning = _CheckServicesStarted if ($ServicesRunning -eq $false) { return } } Write-Verbose "Connecting to $fqdn" $so = New-PSSessionOption -OperationTimeout $sessionOptionsTimeout -IdleTimeout $sessionOptionsTimeout -OpenTimeout $sessionOptionsTimeout; if ($useWIA) { if ($SuppressError) { $session = new-pssession -connectionURI "http://$fqdn/powershell?serializationLevel=Full" -ConfigurationName Microsoft.Exchange -SessionOption $so -erroraction silentlycontinue } else { $session = new-pssession -connectionURI "http://$fqdn/powershell?serializationLevel=Full" -ConfigurationName Microsoft.Exchange -SessionOption $so #-erroraction silentlycontinue } } else { if ($SuppressError) { $session = new-pssession -connectionURI "http://$fqdn/powershell?serializationLevel=Full" -ConfigurationName Microsoft.Exchange -Authentication Kerberos -credential $credential -SessionOption $so -erroraction silentlycontinue } else { $session = new-pssession -connectionURI "http://$fqdn/powershell?serializationLevel=Full" -ConfigurationName Microsoft.Exchange -Authentication Kerberos -credential $credential -SessionOption $so #-erroraction silentlycontinue } } if (!$?) { # ERROR_ACCESS_DENIED = 5 # ERROR_LOGON_FAILURE = 1326 if (!(5 -eq $error[0].exception.errorcode) -and !(1326 -eq $error[0].exception.errorcode)) { #Write-Verbose "Could not connect to $fqdn" return } else { # no retries if we get 5 (access denied) or 1326 (logon failure) #$REVIEW$ connectedFqdn is not set. Is it okay? break connectScope } } $session } function _OpenExchangeRunspace([String]$fqdn, [System.Management.Automation.PSCredential] $credential, [bool]$UseWIA=$true, [bool]$SuppressError=$false) { $global:remoteSession = _NewExchangeRunspace $fqdn $credential $UseWIA $SuppressError if ($global:remoteSession -ne $null) { $global:connectedFqdn = $fqdn break connectScope } } function CreateOrGetExchangeSession([String]$fqdn, [System.Management.Automation.PSCredential] $credential=$null, [bool]$UseWIA=$true, [bool]$SuppressError=$false) { $existingSession = @(Get-PSSession | Where {$_.ComputerName -eq $fqdn -and $_.Availability -eq 'Available' -and $_.ConfigurationName -eq 'Microsoft.Exchange'}) if ($existingSession.Count -gt 0) { if ($existingSession.Count -gt 1) { Write-Warning "There's more than one available PowerShell session for $fqdn. Reusing the first one." } Write-Verbose "Reusing an existing PowerShell session for $fqdn." return $existingSession[0] } else { Write-Verbose "Creating a new PowerShell session for $fqdn." _NewExchangeRunspace $fqdn $credential $UseWIA $SuppressError } } function _ConnectToAnyServer ($servers, $credential, [bool]$UseWIA=$false, [bool]$SuppressError=$false) { if (($servers -eq $null) -or ($servers.Length -eq 0)) { return } $cas=@(_GetCASServers $servers) $other=@(_GetHubMailboxUMServers $servers) $start=[System.Math]::Abs($env:username.GetHashCode()) for($i=0; $i -lt $cas.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $cas[($i+$start) % $cas.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError } for($i=0; $i -lt $other.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $other[($i+$start) % $other.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError } } function _PrintUsageAndQuit { @" NAME: Connect-ExchangeServer SYNOPSIS: `tDiscovers the best Exchange servers to connect to automatically or based on user input, and tries to create a new remote Powershell session. SYNTAX: `tConnect-ExchangeServer `t`t[-ServerFqdn ] `t`t[-Auto] `t`t[-Prompt] `t`t[-UserName ] `t`t[-Forest ] `t`t[-CheckCertificates] PARAMETERS: `t-ServerFqdn `t`tFQDN of the server to connect to. Incompatible with -Auto. `t-Auto `t`tAutomatically discover and try to connect to appropriate Exchange servers. `t`tFirst the local server will be tried, then ClientAccess servers in the local site, `t`tafter that other server roles (Hub, Mailbox, UM). `t-Prompt `t`tIf no servers have been specified or determined to be available, `t`tthe user will be prompted for target server FQDN. `t-UserName `t`tCredentials for the specified user (instead of the user who is running the script) will be used `t`tfor remote Powershell connection. User will be prompted for password. `t-Forest `t`tForest to perform the discovery in. Could be a short name or FQDN. User running the script must `t`tbe able to authenticate in that forest and have access to Configuration Naming Context. `t`t(I.e. one-way trust from the specified forest to the local forest must be in place). `t`tCredentials specified in the Username parameter are not used for discovery. `t`tOnly allowed with -Auto. `t`tIf specified, Certificates used to establish the SSL connection will be verified. `t`tBy default certification validation is disabled. `t-------------------------- EXAMPLES -------------------------- Connect-ExchangeServer (No parameters)`t Help page is displayed - user has not expressed his intentions Connect-ExchangeServer -Auto`t`t Full auto connect. If we cannot connect for whatever reason, function quietly returns. Connect-ExchangeServer -Auto -Prompt`t Full auto connect. If we cannot connect for whatever reason, user is prompted for target server FQDN Connect-ExchangeServer -Auto -Forest Exchange`t`t Full auto connect in forest named "Exchange". If we cannot connect for whatever reason, function quietly returns. Connect-ExchangeServer -Prompt`t`t User is always prompted for target server FQDN Connect-ExchangeServer -ServerFQDN`t Only specified FQDN is used, no auto discovery. If connection fails, function quietly exits Connect-ExchangeServer -ServerFQDN -Prompt Only specified FQDN is used, no auto discovery. If connection fails, user is prompted for another FQDN "@ break connectScope } function _CheckServicesStarted { #List of services that should be running while connecting to remote server $DependentServices = @('w3svc') foreach ($Service in $DependentServices) { $ServiceState = Get-Service $Service -ea SilentlyContinue $ServiceNameFull = $ServiceState.Name + ' (' + $ServiceState.DisplayName + ')' if ($ServiceState.Status -ne 'Running') { Write-Warning "The service $ServiceNameFull is not running. Connecting to Remote Powershell requires this service to be Running." return $false } } return $true } function ExportPSSessionAndImportModule ($remotePSSettinsPath, $modulePath) { $hashValue = $global:remoteSession.ApplicationPrivateData.ImplicitRemoting.Hash $CurrentUserRemotePSSettings = Get-ItemProperty -path $remotePSSettinsPath -ErrorAction SilentlyContinue if (($CurrentUserRemotePSSettings -eq $null) -or ($CurrentUserRemotePSSettings.Hash -eq $null) -or (-not ($CurrentUserRemotePSSettings.ModulePath)) -or ($CurrentUserRemotePSSettings.Hash -ne $hashValue)) { # Redo Everything, when: # 1. No registry entry found, or # 2. Registry entry exists, but hash value or ModulePath is empty (which is very unlikely) or # 3. Hash value of the saved module didn't match with the hash value of the current session CreateRegistryEntryAndImportModule $remotePSSettinsPath $hashValue $modulePath } else { $modulePath = $CurrentUserRemotePSSettings.ModulePath $module = Get-ChildItem $modulePath -ErrorAction SilentlyContinue | where-object{$_.Extension -eq ".psm1" -or $_.Extension -eq ".psd1" -or $_.Extension -eq ".ps1xml"} if (($module -eq $null) -or ($module.Count -lt 3)) { # If the module folder exists, but any module file is missing, then we should just export the session and import module Export-PSSession -Session $global:remoteSession -OutputModule $modulePath -force | out-null Import-Module -Name $modulePath -ArgumentList $global:remoteSession -DisableNameChecking } else { if ((New-TimeSpan -Start $module[0].LastWriteTime -End (get-date)).TotalHours -gt 72) { # If the module is expired, then we should redo everything CreateRegistryEntryAndImportModule $remotePSSettinsPath $hashValue $modulePath } else { Import-Module -Name $modulePath -ArgumentList $global:remoteSession -DisableNameChecking } } } } function CreateRegistryEntryAndImportModule ($remotePSSettinsPath, $hashValue, $modulePath ) { ClearRegistryEntryAndModule $remotePSSettinsPath $modulePath new-item $remotePSSettinsPath -force | out-null New-ItemProperty -Path $remotePSSettinsPath -Name Hash -Value $hashValue -PropertyType DWord -force | out-null New-ItemProperty -Path $remotePSSettinsPath -Name ModulePath -value $modulePath -PropertyType ExpandString -force | out-null Export-PSSession -Session $global:remoteSession -OutputModule $modulePath -force | out-null Import-Module -Name $modulePath -ArgumentList $global:remoteSession -DisableNameChecking } function ClearRegistryEntryAndModule ($remotePSSettinsPath, $modulePath) { clear-item $remotePSSettinsPath -force -ErrorAction SilentlyContinue Get-ChildItem $modulePath -ErrorAction SilentlyContinue | Remove-Item -force -recurse -ErrorAction SilentlyContinue } # This function is used to discover ECP when EMC connects to localOnPremise function Discover-EcpVirtualDirectoryForEmc ([Microsoft.Exchange.Data.ServerVersion]$CurrentVersion, [bool]$UseWIA=$false, $TargetServerFqdn=$null) { # get the siteDN, forest $siteDN,$Forest_CurrentSite=_GetSiteAndForest if($siteDN -eq $null) { return #no site - no auto discovery } # Get the localhost's fqdn so we can check the vdir on local machine first $hostFqdn = _GetHostFqdn # declare $version to store the return value from TryParseFromSerialNumber [Microsoft.Exchange.Data.ServerVersion]$version=$null # declare the DirectorySearcher of ECP vdir for later use $search = new-object DirectoryServices.DirectorySearcher $search.Filter = "(&(objectClass=msExchEcpVirtualDirectory))" $search.PageSize=1000 $search.PropertiesToLoad.Clear() [void] $search.PropertiesToLoad.Add("msexchmetabasepath") [void] $search.PropertiesToLoad.Add("msexchinternalhostname") [void] $search.PropertiesToLoad.Add("msexchexternalhostname") # When EMC is connected as RemoteOnPremise, it's possible that the server is in the same forest as the host machine # so we check for that before we do autodiscover. This variable is used to do that $shouldDiscover=$false # first look at local site, then expand scope to forest foreach ($site in ($siteDN, '*')) { # Init variables $allServers = _GetExchangeServersInSite $site "/$Forest_CurrentSite " # if $shouldDiscover is false, we should check whether we should do discovery or not first if($shouldDiscover -eq $false){ if($TargetServerFqdn -ne $null) { # TargetServerFqdn is specified, which means we are connecting using remoteOnPremise # so we need to check whether the targetServer is in the same forest or not. foreach ($server in $allServers) { $tempFqdn = _GetServerFqdnFromNetworkAddress $server if (($TargetServerFqdn -eq $tempFqdn)) { $shouldDiscover=$true break } } }else{ $shouldDiscover=$true } if($shouldDiscover -eq $false){ continue } } $servers = _GetCASServers $allServers #continue if there's no CAS if($servers.length -eq 0){ continue } # group the servers by version $localServer=$null $sameVersionServers=@() $newerVersionServers=@() $olderServers=@() foreach ($server in $servers) { # if the version can't be parsed, we will skip this server if([Microsoft.Exchange.Data.ServerVersion]::TryParseFromSerialNumber($server.Properties["serialnumber"][0], [ref]$version)) { # only look for server with same major version if($version.Major -eq $CurrentVersion.Major) { if($version.Equals($CurrentVersion)) { $fqdn = _GetServerFqdnFromNetworkAddress $server if (($hostFQDN -ne $null) -and ($hostFQDN -eq $fqdn)){ # if it's localhost, insert it into the front of the array so it's checked before others $sameVersionServers = @($server)+$sameVersionServers }else{ $sameVersionServers += $server } }elseif($version.ToInt() -gt $CurrentVersion.ToInt()){ $newerVersionServers += $server }else{ $olderServers += $server } } } } # find a suitable vdir, the order here shouldn't be changed foreach ($servers in @($sameVersionServers,$newerVersionServers,$olderServers)) { Write-Verbose "Select from servers $servers" $fbaVdirs=@() $allVdirs=@() foreach($server in $servers) { $search.SearchRoot=[ADSI]$server.Path $vdirs=$search.FindAll(); $tempFba=$null $selected,$tempFba= _SelectVdir $vdirs $useWIA if( $selected -ne $null ) { return _GetUrl $selected }else{ $fbaVdirs+=$tempFba $allVdirs+=$vdirs } } if($fbaVdirs.length -gt 0) { # we can't find a WIA vdir, so just return a fbaVdir return _GetUrl $fbaVdirs[0] } elseif($allVdirs.length -gt 0) { # we can't even find a FBA vdir, so just return any vdir return _GetUrl $vdirs[0] } } } } # select vdir based on the criteria # Parameters # vdirs: a list of vdirs to be selected from # useWIA: True->select a WIA; False->select a FBA # Return: # retVal: vdir that matches the authentication mode requested # fbaVdirs: return the list of fbaVdirs for caller, so we don't have to connect to metabase again function _SelectVdir ($vdirs, [bool]$useWIA) { $fbaVdirs=@() $retVal=$null foreach($vdir in $vdirs) { # connect to the metabase $vdirMetabase = new-object System.DirectoryServices.DirectoryEntry($vdir.Properties["msexchmetabasepath"][0]) # search for WIA vdir if($useWIA) { if(_IsWIA $vdirMetabase) { $retVal=$vdir break } } # see if it's FBA if(_IsFBA $vdirMetabase) { if($useWIA) { # save the vdirs in case we can't find a WIA vdir later $fbaVdirs += $vdir } else { # we are looking for FBA here, so just return $retVal = $vdir break } } } return $retVal, $fbaVdirs } # batch get the metabases from vdirs function _GetMetabases ($vdirs) { foreach($vdir in $vdirs) { new-object System.DirectoryServices.DirectoryEntry($vdirs[0].Properties["msexchmetabasepath"][0]) } } # determine if authentication mode is WIA. WIA corresponds to NTLM, so 4 is used here function _IsWIA ($metabase) { ($metabase.Properties["AuthFlags"][0] -band 4) -eq 4 } # determine if authentication mode is FBA. We are testing whether it's basic authentication # Be aware that basic authentication isn't actually FBA.But it's a bit complicated to read out # refer to sources\dev\management\src\Management\Metabase\OwaIsapiFilter.cs # For simplicity, we can test for basic here since it's basic authentication mode is rarely used. function _IsFBA ($metabase) { ($metabase.Properties["AuthFlags"][0] -band 2) -eq 2 } # get the url from a vdir function _GetUrl ($vdir) { if($vdir.Properties["msexchinternalhostname"] -ne $null) { $vdir.Properties["msexchinternalhostname"] }elseif($vdir.Properties["msexchexternalhostname"] -ne $null) { $vdir.Properties["msexchexternalhostname"] } } # SIG # Begin signature block # MIIbAwYJKoZIhvcNAQcCoIIa9DCCGvACAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUw5yFP/i8UfADsov/caPuLP7j # 2jmgghXYMIIEhTCCA22gAwIBAgIKYQX3HgAAAAAAMjANBgkqhkiG9w0BAQUFADB5 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpN # aWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQTAeFw0wOTA3MTMyMzAwMThaFw0xMDEw # MTMyMzEwMThaMIGDMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQ # MA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u # MQ0wCwYDVQQLEwRNT1BSMR4wHAYDVQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24w # ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC1jKmclIRhGswuIsSgk2QJ # 3oWhsJBd/MlsaLXx7/yOa/T4oG7XUd5goydj1PbftkzSRQunPdhv/u2nGGPTH8aB # 1L8HN5dAK3/nX1o12ZNPq/MqkvCmjYHsBSTc27hhY1NhAjU41rj17ntUpslYNen0 # Fe/aB2wFLU2ktrqbO7gxMH5FvKmhJTkMQ6RHO5ecIERyN89QoE1N9MNl3ETRCDs4 # 3T7FF2xGx61zJMCPicHq6rrNaKkS1lgMUxYM/jkD1oHyPlxX83rbZuEHGNkZAxT2 # 5kWZKlFMkNda76+3OwwpTW0grge3ki7oacqfMELnwzKKCyJKMuicDMZRAyYBbZJz # AgMBAAGjggECMIH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBSHgbff # 7vp3+lkFYzcECtfp2qDg4DAOBgNVHQ8BAf8EBAMCB4AwHwYDVR0jBBgwFoAUV0V0 # HF2w9shDBeCMVC2PMqf+SJYwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5t # aWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvQ29kZVNpZ1BDQS5jcmwwTQYI # KwYBBQUHAQEEQTA/MD0GCCsGAQUFBzAChjFodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL0NvZGVTaWdQQ0EuY3J0MA0GCSqGSIb3DQEBBQUAA4IBAQA2 # IYT1j4MhTYeoP4vnxaQPTDBuWXSbC5d0Fqmx83Ckr8IMMyTzoEr6weQhxrbZ6lxb # kWH3Im3/MfwXTtfNQOOd0uW00vqNbAfad5rKK+4NWUfPBMIQZ/rq6UM7t+bRnNmO # I2BuEpvD2X5cVzLdlA3ffcVIkk1IdreiwFOVPvw6o5N88oUEx8aFOJc2+BKTIgCZ # TnmvlutaIIOs0FxaMLAA4ms5jySJ2j0MpEZ5YjZTatfJzZII+4flVPV8WcXEd32w # wSyYx5dsQ6f4IPiDVGSeYPjiSqVn1Em/VIh9UkTzUcAm0cV88InWEQkowkVFgB2Q # Ir2OogU+PLNPvdc54IiTMIIEuzCCA6OgAwIBAgIKYQTKaQAAAAAACDANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMDcwNjA1MjIwMzIx # WhcNMTIwNjA1MjIxMzIxWjCBpDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNOOkE1QjAtQ0RFMC1EQzk0 # MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIBIjANBgkq # hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr/ha9jSxog+OrM/8GPCtJQ1xu19btzs3 # QRMkHOojxa6smcDcpiPwyqkzMDJqL5ohQgIJJlmbUOlXcYtn65foBHOLeLGYQEaj # WgEoABag2sVOi6kJVJExnP/EkJVFBx2AKAUGcYDLrDhnYezCXxadf7A/0Sr3Mm9z # PXxumDaahu4AOO4X7E9VM0aBekDcpfXSI4ZdKzNPJEiTGrG0fs/fMxu/1VvGLxPz # 5oS3TpOYvADrXB1pxcjI0sQ8sAAU47Kc+aEeCdzV9W18MjEzso9Zm/7KH10iTroS # HfBnwwSJS38D/X3XVIEDXUn1HqsgftJltHEZ6Ex9xpS9hZFtUFrDqQIDAQABo4IB # GTCCARUwHQYDVR0OBBYEFJ6PqHTBQu4YzT296dbuJ7DHNTRnMB8GA1UdIwQYMBaA # FCM0+NlSRnAK7UD7dvuzK7DDNbMPMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly9j # cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY3Jvc29mdFRpbWVT # dGFtcFBDQS5jcmwwWAYIKwYBBQUHAQEETDBKMEgGCCsGAQUFBzAChjxodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jvc29mdFRpbWVTdGFtcFBD # QS5jcnQwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgbAMA0GCSqG # SIb3DQEBBQUAA4IBAQBnpd8oUdxIg/3GZfld+maqso2nVp2iSL4yrG2XD08MRLu7 # GPSQ5+J9xXQA1obzkcDQ0QWJXmKL+mj3Zc/mU6nfdBIhrYwVtKbKQ5PJa+FKsu0P # zrSKOn/3tcy8Epp7zwTEP9kKLHU8kp7PBjZiDgIX5pkn9/tx7/9aemFVurqYh+tx # rHb16IafNmdQQXj8M6TVaXMByHAja3yjV8hoB+RbQcH4Jv1pSQOZ1q/JP6T1nEz5 # Cp3SzUu/ffoWkOw7cUn+BBXK4mraaQu0kz40/srsgEnksnQYzJHnPk63e/VAj2Rb # 1FDVOU1Tzb7UXkeCW9FaepkuRnBrB4UNbAkTYw91MIIGBzCCA++gAwIBAgIKYRZo # NAAAAAAAHDANBgkqhkiG9w0BAQUFADBfMRMwEQYKCZImiZPyLGQBGRYDY29tMRkw # FwYKCZImiZPyLGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQDEyRNaWNyb3NvZnQgUm9v # dCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwHhcNMDcwNDAzMTI1MzA5WhcNMjEwNDAz # MTMwMzA5WjB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwggEiMA0GCSqGSIb3DQEB # AQUAA4IBDwAwggEKAoIBAQCfoWyx39tIkip8ay4Z4b3i48WZUSNQrc7dGE4kD+7R # p9FMrXQwIBHrB9VUlRVJlBtCkq6YXDAm2gBr6Hu97IkHD/cOBJjwicwfyzMkh53y # 9GccLPx754gd6udOo6HBI1PKjfpFzwnQXq/QsEIEovmmbJNn1yjcRlOwhtDlKEYu # J6yGT1VSDOQDLPtqkJAwbofzWTCd+n7Wl7PoIZd++NIT8wi3U21StEWQn0gASkdm # EScpZqiX5NMGgUqi+YSnEUcUCYKfhO1VeP4Bmh1QCIUAEDBG7bfeI0a7xC1Un68e # eEExd8yb3zuDk6FhArUdDbH895uyAc4iS1T/+QXDwiALAgMBAAGjggGrMIIBpzAP # BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBQjNPjZUkZwCu1A+3b7syuwwzWzDzAL # BgNVHQ8EBAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwgZgGA1UdIwSBkDCBjYAUDqyC # YEBWJ5flJRP8KuEKU5VZ5KShY6RhMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAX # BgoJkiaJk/IsZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290 # IENlcnRpZmljYXRlIEF1dGhvcml0eYIQea0WoUqgpa1Mc1j0BxMuZTBQBgNVHR8E # STBHMEWgQ6BBhj9odHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9k # dWN0cy9taWNyb3NvZnRyb290Y2VydC5jcmwwVAYIKwYBBQUHAQEESDBGMEQGCCsG # AQUFBzAChjhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jv # c29mdFJvb3RDZXJ0LmNydDATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0B # AQUFAAOCAgEAEJeKw1wDRDbd6bStd9vOeVFNAbEudHFbbQwTq86+e4+4LtQSooxt # YrhXAstOIBNQmd16QOJXu69YmhzhHQGGrLt48ovQ7DsB7uK+jwoFyI1I4vBTFd1P # q5Lk541q1YDB5pTyBi+FA+mRKiQicPv2/OR4mS4N9wficLwYTp2OawpylbihOZxn # LcVRDupiXD8WmIsgP+IHGjL5zDFKdjE9K3ILyOpwPf+FChPfwgphjvDXuBfrTot/ # xTUrXqO/67x9C0J71FNyIe4wyrt4ZVxbARcKFA7S2hSY9Ty5ZlizLS/n+YWGzFFW # 6J1wlGysOUzU9nm/qhh6YinvopspNAZ3GmLJPR5tH4LwC8csu89Ds+X57H2146So # dDW4TsVxIxImdgs8UoxxWkZDFLyzs7BNZ8ifQv+AeSGAnhUwZuhCEl4ayJ4iIdBD # 6Svpu/RIzCzU2DKATCYqSCRfWupW76bemZ3KOm+9gSd0BhHudiG/m4LBJ1S2sWo9 # iaF2YbRuoROmv6pH8BJv/YoybLL+31HIjCPJZr2dHYcSZAI9La9Zj7jkIeW1sMpj # tHhUBdRBLlCslLCleKuzoJZ1GtmShxN1Ii8yqAhuoFuMJb+g74TKIdbrHk/Jmu5J # 4PcBZW+JC33Iacjmbuqnl84xKf8OxVtc2E0bodj6L54/LlUWa8kTo/0wggaBMIIE # aaADAgECAgphFQgnAAAAAAAMMA0GCSqGSIb3DQEBBQUAMF8xEzARBgoJkiaJk/Is # ZAEZFgNjb20xGTAXBgoJkiaJk/IsZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1p # Y3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw0wNjAxMjUyMzIy # MzJaFw0xNzAxMjUyMzMyMzJaMHkxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xIzAhBgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBMIIB # IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAn43fhTeMsQZWZjZO1ArrNiOR # Hq+rjVjpxM/BnzoKJMTExF6w7hUUxfo+mTNrGWly9HwFX+WZJUTXNRmKkNwojpAM # 79WQYa3e3BhwLYPJb6+FLPjdubkw/XF4HIP9yKm5gmcNerjBCcK8FpdXPxyY02nX # MJCQkI0wH9gm1J57iNniCe2XSUXrBFKBdXu4tSK4Lla718+pTjwKg6KoOsWttgEO # as8itCMfbNUn57d+wbTVMq15JRxChuKdhfRX2htZLy0mkinFs9eFo55gWpTme5x7 # XoI0S23/1O4n0KLc0ZAMzn0OFXyIrDTHwGyYhErJRHloKN8igw24iixIYeL+EQID # AQABo4ICIzCCAh8wEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFFdFdBxdsPbI # QwXgjFQtjzKn/kiWMAsGA1UdDwQEAwIBxjAPBgNVHRMBAf8EBTADAQH/MIGYBgNV # HSMEgZAwgY2AFA6sgmBAVieX5SUT/CrhClOVWeSkoWOkYTBfMRMwEQYKCZImiZPy # LGQBGRYDY29tMRkwFwYKCZImiZPyLGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQDEyRN # aWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHmCEHmtFqFKoKWtTHNY # 9AcTLmUwUAYDVR0fBEkwRzBFoEOgQYY/aHR0cDovL2NybC5taWNyb3NvZnQuY29t # L3BraS9jcmwvcHJvZHVjdHMvbWljcm9zb2Z0cm9vdGNlcnQuY3JsMFQGCCsGAQUF # BwEBBEgwRjBEBggrBgEFBQcwAoY4aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3Br # aS9jZXJ0cy9NaWNyb3NvZnRSb290Q2VydC5jcnQwdgYDVR0gBG8wbTBrBgkrBgEE # AYI3FS8wXjBcBggrBgEFBQcCAjBQHk4AQwBvAHAAeQByAGkAZwBoAHQAIACpACAA # MgAwADAANgAgAE0AaQBjAHIAbwBzAG8AZgB0ACAAQwBvAHIAcABvAHIAYQB0AGkA # bwBuAC4wEwYDVR0lBAwwCgYIKwYBBQUHAwMwDQYJKoZIhvcNAQEFBQADggIBADC8 # sCCkYqCn7zkmYT3crMaZ0IbELvWDMmVeIj6b1ob46LafyovWO3ULoZE+TN1kdIxJ # 8oiMGGds/hVmRrg6RkKXyJE31CSx56zT6kEUg3fTyU8FX6MUUr+WpC8+VlsQdc5T # w84FVGm0ZckkpQ/hJbgauU3lArlQHk+zmAwdlQLuIlmtIssFdAsERXsEWeDYD7Pr # TPhg3cJ4ntG6n2v38+5+RBFA0r26m0sWCG6kvlXkpjgSo0j0HFV6iiDRff6R25SP # L8J7a6ZkhU+j5Sw0KV0Lv/XHOC/EIMRWMfZpzoX4CpHs0NauujgFDOtuT0ycAymq # ovwYoCkMDVxcViNX2hyWDcgmNsFEy+Xh5m+J54/pmLVz03jj7aMBPHTlXrxs9iGJ # ZwXsl521sf2vpulypcM04S+f+fRqOeItBIJb/NCcrnydEfnmtVMZdLo5SjnrfUKz # Sjs3PcJKeyeY5+JOmxtKVDhqIze+ardI7upCDUkkkY63BC6Xb+TnRbuPTf1g2ddZ # wtiA1mA0e7ehkyD+gbiqpVwJ6YoNvihNftfoD+1leNExX7lm299C5wvMAgeN3/8g # BqNFZbSzMo0ukeJNtKnJ+rxrBA6yn+qf3qTJCpb0jffYmKjwhQIIWaQgpiwLGvJS # Bu1p5WQYG+Cjq97KfBRhQ7hl9TajVRMrZyxNGzBMMYIElTCCBJECAQEwgYcweTEL # MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v # bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEjMCEGA1UEAxMaTWlj # cm9zb2Z0IENvZGUgU2lnbmluZyBQQ0ECCmEF9x4AAAAAADIwCQYFKw4DAhoFAKCB # wjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYK # KwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQU3GPop37Xi3UzNS4YN8dW8IsCyXEw # YgYKKwYBBAGCNwIBDDFUMFKgKoAoAEMAbwBuAG4AZQBjAHQARgB1AG4AYwB0AGkA # bwBuAHMALgBwAHMAMaEkgCJodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vZXhjaGFu # Z2UgMA0GCSqGSIb3DQEBAQUABIIBACEAMdze0eEtUxcP6G3FdtGVVzkXQUeXTUcg # WtPBQsHWIEYAzRaQGdCDQ5LVjJ2a7jO4QOTlbWkyiubHOlPiCMPOrgyti0W8B3JD # D0QS6osKsqOGSjbXDdNdV+DtdsjTfFbZ7iSWTZuFcO9bXmb6N9dUMb6mcHFtQirj # vW1YeixIju+Ax6OwTe4Jnpp6SV7PtqOg9Ct+8ggZrbfDuiLhCsj9IeWAv30dNrZE # C+OmdTZ4oWiQ8OfKPIM9icudFE/v4FuoT6H9Yt74cAnTId071K247f0CIFeA8YcW # zwPz3XtG1fwW1sXz2sT3AyGLPW6Bf8Qk0VJa01SeQamcLzLlhk+hggIdMIICGQYJ # KoZIhvcNAQkGMYICCjCCAgYCAQEwgYUwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEhMB8GA1UEAxMYTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB # AgphBMppAAAAAAAIMAcGBSsOAwIaoF0wGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEH # ATAcBgkqhkiG9w0BCQUxDxcNMDkwOTI1MDU1NjAyWjAjBgkqhkiG9w0BCQQxFgQU # BgJZc7VdyObP2w4aQOO3mic84FkwDQYJKoZIhvcNAQEFBQAEggEALEmeIlD2bhiI # PZAF/zl02SG2pQzLzox8GI8rO0WYhxKVFn+lgUPKEv26URCEQPjuIIRRwTUWCF8W # XYWWCMCq3JBDhWTNt1AspbNLegY4Yod0bgcO2uNmMAZch90at0b/R+nvs1pPF7nO # LJohJCWQmel18v7/4Cy4Ig/0PArlbmMT2HyveGxjpyvTUzuFBuho9ov16I79s3DS # 85ZqNxJccj7msRZih7pSPX8PUavcCuLlr9WFsMZKUbj7ccxi+fNGSh9JxNwqghCh # xCpOdo30ObhKpXgRTZObb0v3NdqgN7TODYTy02lV1mOh+t9MRPerbxkPVGIFXjCb # 1P4sPLlXOg== # SIG # End signature block