# Copyright (c) 2005 Microsoft Corporation. All rights reserved. # # ServiceControl.ps1 # # This script performs 3 functions: # 1. Saves or removes the state of currently running functions # 2. Stops services that use exchange files so they can be updated # 3. Starts services based on the state taken in step 1 # See the Usage function for details # Disable the confirmation for destructive tasks $confirmPreference = "None" # # "Member variables" for the service control functions # $script:serviceStateFile = "$env:TMP\StoppedServices.xml" $script:serviceRegistryDataFile = "$env:TMP\ServiceRegistryData.xml" $script:services = @( ) $script:servicesRegistryData = @( ) $script:previouslyStartedServices = @{ } $script:logDir = "$env:SYSTEMDRIVE\ExchangeSetupLogs" $script:knownRoles = @( 'AdminTools', 'Bridgehead', 'ClientAccess', 'Gateway', 'Mailbox', 'UnifiedMessaging' ) $script:serviceControlError = $null # DEVS: Put services for your role here $script:servicesToControl = @{} $script:servicesToControl['AdminTools'] = @( ) $script:servicesToControl['ClientAccess'] = @( 'OnePoint', 'MOM', 'MSExchangeMonitoring', 'MSExchangeIMAP4', 'MSExchangePOP3' , 'MSExchangeADTopology' , 'ADTopologyService', 'MSExchangeFDS', 'IISAdmin', 'MSExchangeServiceHost', 'W3Svc') $script:servicesToControl['Gateway'] = @( 'OnePoint', 'MOM', 'MSExchangeMonitoring', 'WorkerService', 'MSExchangeTransport', 'MSExchangeTransportLogSearch', 'MSExchangeEdgeSync', 'MSExchangeAntispamUpdate', 'EdgeCredentialSvc') $script:servicesToControl['Mailbox'] = @( 'OnePoint', 'MOM', 'MSExchangeMonitoring', 'IISAdmin', 'MSExchangeIS', 'MSExchangeMailboxAssistants', 'MSExchangeSA', 'MSFTESQL-Exchange', 'MSExchangeMailSubmission', 'MSExchMailSubmissionSvc', 'MSExchangeADTopology' , 'ADTopologyService', 'MSExchangeRepl', 'clussvc', 'MSExchangeTransportLogSearch', 'MSExchangeServiceHost', 'W3Svc', 'MSExchangeSearch', 'HTTPFilter' ) $script:servicesToControl['Bridgehead'] = @( 'OnePoint', 'MOM', 'MSExchangeMonitoring', 'AdminService', 'MSExchangeTransport' , 'MSExchangeADTopology' , 'ADTopologyService', 'MSExchangeEdgeSync', 'MSExchangeTransportLogSearch', 'MSExchangeAntispamUpdate' ) $script:servicesToControl['UnifiedMessaging'] = @( 'OnePoint', 'MOM', 'MSExchangeMonitoring', 'Exchange UM Service' , 'MSExchangeADTopology' , 'ADTopologyService', 'MSExchangeFDS', 'MSExchangeUM', 'MSSpeechService') # list of installed services, this should be calculated based on the registry values $script:installedRoles = @() # snapin key $script:snapinKey = 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellSnapIns\Microsoft.Exchange.Management.PowerShell.Setup' # setup key $script:setupKey = 'HKLM:\SOFTWARE\Microsoft\Exchange\v8.0\Setup' ############################################################################### # # Service state management functions # These functions are used to determine if a service was running or not before setup started # # SaveServiceState # Saves the state of all services to a well known location # Returns: # void function SaveServiceState { Log "Saving service state to '$script:serviceStateFile'..." get-service | export-clixml $script:serviceStateFile } # SaveServiceRegistryData # Saves the registry data from the Services path # Returns: # void function SaveServiceRegistryData { Log "Saving services registry data" get-itemproperty HKLM:\SYSTEM\CurrentControlSet\Services\* | export-clixml $script:serviceRegistryDataFile } # LoadServiceState # Retrieves the previously saved service state # Returns: # void function LoadServiceState { if( get-childitem $script:serviceStateFile -ea SilentlyContinue ) { Log "Reading service state from '$script:serviceStateFile'..." $script:services = import-clixml $script:serviceStateFile Log ("Loaded state for {0} services" -F $script:services.Length) } else { Log "Service state file not present: $script:serviceStateFile" } } # LoadServiceRegistryData # Retrieves the previously saved service registry data # Returns: # void function LoadServiceRegistryData { if( get-childitem $script:serviceRegistryDataFile -ea SilentlyContinue ) { Log "Reading service registry data from '$script:serviceRegistryDataFile'" $script:servicesRegistryData = import-clixml $script:serviceRegistryDataFile Log ("Loaded state for {0} services registry" -F $script:servicesRegistryData.Length) } else { Log "Service registry data file not present: $script:serviceRegistryDataFile" } } # RemoveServiceState # Removes previously saved service state # Returns: # void function RemoveServiceState { Log "Removing service state from '$script:serviceStateFile'..." remove-item $script:serviceStateFile -ea SilentlyContinue } # RemoveServiceRegistryData # Removes previously saved service registry data file # Returns: # void function RemoveServiceRegistryData { Log "Removing service registry data from '$script:serviceRegistryDataFile'..." remove-item $script:serviceRegistryDataFile -ea SilentlyContinue } # WasRunning( serviceName ) # Determines if the service was running when the state was recorded # Params: # serviceName - Name of the service to check # Returns: # True if the service existed and was in the running state. # False on any other condition including the service not existing # or starting, but not running function WasRunning([String] $serviceName) { $ret = $false $s = $script:services | where { $_.ServiceName -ieq $serviceName } if( $s.ServiceName -eq $null ) { if( $serviceName -ieq 'MSExchangeADTopology' ) { # Try old name. $s = $script:services | where { $_.ServiceName -ieq 'ADTopologyService' } } elseif( $serviceName -ieq 'MSExchangeMailSubmission' ) { # Try old name. $s = $script:services | where { $_.ServiceName -ieq 'MSExchMailSubmissionSvc' } } elseif( $serviceName -ieq 'MSExchangeMailboxAssistants' ) { # Try old name. $s = $script:services | where { $_.ServiceName -ieq 'MSExchangeMA' } } } if( $s.ServiceName -eq $null ) { Log "'$serviceName' did not exist." } elseif( $s.Status -eq [System.ServiceProcess.ServiceControllerStatus]::Running ) { Log "'$serviceName' was running." $ret = $true } else { Log "'$serviceName' was not running." } return $ret } ############################################################################### # # Main service control functions # These functions start and stop services for a given server role # # StopServices( roleName ) # Stops services for the specified role # Params: # Args[0] - name of the role to stop services for # Returns: # True if was able to stop all services for the specified role # False on any error # Notes: # It is not an error to stop services that do not exist because # they may be created in the build that is about to install function StopServices { $role = $Args[0] Status "Stopping services for '$role'..." foreach( $serviceName in $script:servicesToControl[$role] ) { Log "Stopping service '$serviceName'." stop-setupservice -ServiceName $serviceName -ev script:serviceControlError if( $script:serviceControlError[0] -ne $null ) { Log ($script:serviceControlError[0].ToString()) return $false } } return $true } # DisableServices # Disables services for a particular role # Params: # Args[0] - name of the role to disable services for # Returns: # True if was able to disable all services for the specified role # False on any error function DisableServices { $role = $Args[0] Status "Disabling services for '$role'..." foreach( $serviceName in $script:servicesToControl[$role] ) { Log "Disabling service '$serviceName'." $serviceHandle = get-service $serviceName -ea SilentlyContinue if($serviceHandle -eq $null) { Log "Ignoring service '$serviceName'" } else { set-service $serviceName -startuptype disabled -ev script:serviceControlError if( $script:serviceControlError[0] -ne $null ) { Log ($script:serviceControlError[0].ToString()) return $false } } } return $true } # EnableServices( roleName ) # Enables services for the specified role. We don't need any additional logic to take care # of dependencies between services as all the services are enabled for a role. # Params: # Args[0] - name of the role to enable services for # Returns: # True, if for all existing services starup type can be restored. False otherwise. function EnableServices { $role = $Args[0] Status "Enabling services for '$role'..." LoadServiceRegistryData foreach( $serviceName in $script:servicesToControl[$role] ) { Log "Enabling service '$serviceName'." $service = get-service $serviceName -ea SilentlyContinue if($service -ne $null) { $serviceRegistryData = $script:servicesRegistryData | where {$_.PSChildName -ieq $serviceName} if( $serviceRegistryData -ne $null ) { switch ($serviceRegistryData.Start) { {$_ -ieq 2} { set-service $serviceName -startuptype automatic -ErrorAction SilentlyContinue -ev setServiceError break } {$_ -ieq 3} { set-service $serviceName -startuptype manual -ErrorAction SilentlyContinue -ev setServiceError break } {$_ -ieq 4} { set-service $serviceName -startuptype disabled -ErrorAction SilentlyContinue -ev setServiceError break } default { # start values 0 and 1 are for Boot and System respectively Log "Only Start values 2,3 and 4 are recognized for Win32 service, '$serviceName' has '$serviceRegistryData.Start'" break } } } else { # this is not an error as the sevice might have just been installed Log "'$serviceName' did not exist, this is not an error as the sevice might have just been installed" } if($setServiceError -ne $null -and $setServiceError[0] -ne $null) { Log ($setServiceError[0].ToString()) if($servicesNotEnabled -ne $null) { $servicesNotEnabled+=', ' + $serviceName } else { $servicesNotEnabled=$serviceName } } } } if($servicesNotEnabled -ne $null) { Status "Unable to enable service(s): '$servicesNotEnabled'." return $false } return $true } # StartServices( roleName ) # Restores Exchange services and dependents for the specified role # to the state recorded during SaveServiceState # Params: # Args[0] - name of the role to restore services for # Returns: # True if was able to restore all services for the specified role # False on any error # Notes: # If the saved service state is not available, this function # assumes the services were stared function StartServices { $role = $Args[0] Status "Starting services for $role..." LoadServiceState foreach( $serviceName in $script:servicesToControl[$role] ) { $depth = [int]0 if( -not( RestoreServiceAndDependents $serviceName $depth ) ) { Status "Unable to restore service '$serviceName'." return $false } } return $true } # RestoreServiceAndDependents(serviceName, depth) # Recursively start a service and its dependents if they # were started when the snapshot was made # Params: # Args[0] - Name of the service to start # Args[1] - The recursion depth of this call # Returns: # True if was able to restore all services and dependents # False on any error # Notes: # If the saved service state is not available, this function # assumes the services were stared function RestoreServiceAndDependents { $serviceName = $Args[0] $depth = $Args[1] Log "($depth) Enter: RestoreServiceAndDependents '$serviceName'." $service = get-service $serviceName -ea SilentlyContinue # Filter out cases where we don't need to start the service if( -Not(WasRunning $serviceName) ) { Log "($depth) $serviceName was not previously running." } elseif( $script:previouslyStartedServices[$serviceName] ) { Log "($depth) Already started $serviceName..." } elseif( $service -eq $null ) { Log "($depth) Ignoring non-existent service '$serviceName'." } else { # We actually need to start this service. Use two steps: # 1. Start the service # 2. Recursively do the same thing for each dependent service # Start the service Log "($depth) Starting $serviceName..." start-setupservice -serviceName $serviceName -ev script:serviceControlError if( $script:serviceControlError[0] -ne $null ) { Log ("{0}: {1}" -f $depth, $script:serviceControlError[0].ToString()) return $false } $script:previouslyStartedServices[$serviceName] = $true # Start its dependents Log ("({2}) {0} has {1} dependents." -F $service.Name, $service.DependentServices.Length, $depth) foreach( $d in $service.DependentServices ) { $newdepth = (1+$depth) if( -not( RestoreServiceAndDependents $d.Name $newdepth ) ) { Log "($depth) Unable to start dependent of '$serviceName'" return $false } } } Log "($depth) Exit: RestoreServiceAndDependents '$serviceName'" return $true } ############################################################################### # # Utility Functions # These functions factor out common logic # # IsKnownRole( role ) # Determine if the specified name is a valid role name # Params: # Args[0] - Name of the role in question # Returns: # True if the name is a valid role # False otherwise function IsKnownRole { $role = $Args[0] if( $script:knownRoles -ieq $role ) { Log "$role is a known role" return $true } else { Log "$role is an unknown role" return $false } } # Log( $entry ) # Append a string to a well known text file with a time stamp # Params: # Args[0] - Entry to write to log # Returns: # void function Log { $entry = $Args[0] $line = "[{0}] {1}" -F $(get-date).ToString("HH:mm:ss"), $entry add-content -Path "$logDir\ServiceControl.log" -Value $line } # Status( $entry ) # Log and write entry to console # Params: # Args[0] - Entry to write to log # Returns: # void function Status { $entry = $Args[0] Log $entry #write-host $entry } # Usage # Display the usage of this script # Returns: # Void function Usage { write-output 'Usage: ServiceControl.ps1 [,...]' write-output " `tOne of {Start Stop Save Remove}" write-output "`t- Start`tStarts the services for the specified role(s)" write-output "`t- Stops`tStarts the services for the specified role(s)" write-output "`t- Save`tSaves a snapshot of the state of all services" write-output "`t- Remove`tRemoves the previously taken snapshot" write-output " `tOne of {$knownRoles}" write-output "`r`n`tA role only needs to be specified for the start and stop operations." } # GetExchangeInstallPath # Gets the install path for Exchange Server. If Exchange is not installed then # null is returned. # Returns # string function GetExchangeInstallPath { $path = $null if(test-path $script:setupKey) { $msiInstallPath = (get-itemproperty -Path $script:setupKey).MsiInstallPath if($msiInstallPath -ne $null) { $path = [System.IO.Path]::Combine( ` $msiInstallPath, ` 'bin') } } return $path } # GetInstalledBuildVersion # Gets the major build version for Exchange Server. If Exchange is not installed # then 0 is returned. # Returns: # int function GetInstalledBuildVersion { $build = 0 if(test-path $script:setupKey) { $build = $(get-itemproperty -Path $script:setupKey).MsiBuildMajor } return $build } # SetSnapinRegistryValues # Creates the snapin key if not present and sets the values. # Params: # Args[0] - Exchange server install path # Args[1] - Exchange server build version # Returns: # bool (true if snapin key was created, false otherwise) function SetSnapinRegistryValues { $snapinKeyCreated = $false $path = $Args[0] $build = $Args[1] $snapinValues = @{ "ApplicationBase"="$path" "AssemblyName"="Microsoft.Exchange.PowerShell.Configuration, Version=8.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" "Description"="Setup Tasks for the Exchange Server (v$build)" "CustomPSSnapInType"="Microsoft.Exchange.Management.PowerShell.SetupPSSnapIn" "ModuleName"="$path\Microsoft.Exchange.PowerShell.configuration.dll" "PowerShellVersion"="1.0" "Vendor"="Microsoft" "Version"="8.0.0.0" } if(!(test-path $script:snapinKey)) { new-item -path $script:snapinKey $snapinKeyCreated = $true foreach($setting in $snapinValues.Keys) { Log "Setting $setting to $($snapinValues[$setting])" set-itemproperty -Path $script:snapinKey -Name $setting -Value $snapinValues[$setting] } } return $snapinKeyCreated } # AddSnapins # Adds the required snapins to access start-setupservice and stop-setupservice # Returns: # void function AddSnapins { add-PSSnapin -Name Microsoft.Exchange.Management.PowerShell.Setup add-PSSnapin -Name Microsoft.Exchange.Management.PowerShell.Admin } # RemoveSnapins # Removes snapins loaded by AddSnapins # Returns: # void function RemoveSnapins { remove-PSSnapin -Name Microsoft.Exchange.Management.PowerShell.Setup remove-PSSnapin -Name Microsoft.Exchange.Management.PowerShell.Admin } # RemoveSnapinRegistry # Removes the snapin key from the registry if it was created by the script # Params: # Args[0] - snapin key was created # Returns: # void function RemoveSnapinRegistry { $snapinKeyCreated = $Args[0] if( $snapinKeyCreated ) { remove-item -path $script:snapinKey } } # CleanupForSnapin # Removes the snapin key and unloads the snapins # Params: # Args[0] - snapin key was created # Returns: # void function CleanupForSnapin { RemoveSnapinRegistry $Args[0] RemoveSnapins } # GetInstalledRoles # Gets the installed roles from the registry and stores the information in script:installedRoles # Returns # Void function GetInstalledRoles { # Exchange might not be installed on the machine, so there won't be an existing # registry. We silentlycontinue on errors. $roleRegistryInfoSet = get-itemproperty HKLM:SOFTWARE\Microsoft\Exchange\v8.0\* -ea SilentlyContinue foreach( $roleRegistryInfo in $roleRegistryInfoSet ) { switch( $roleRegistryInfo.PSChildName) { {$_ -ieq "AdminTools"} { $script:installedRoles += "AdminTools" Log "Adding to installed roles list: AdminTools" break } {$_ -ieq "EdgeTransportRole"} { $script:installedRoles += "Gateway" Log "Adding to installed roles list: Gateway" break } {$_ -ieq "HubTransportRole"} { $script:installedRoles += "Bridgehead" Log "Adding to installed roles list: Bridgehead" break } {$_ -ieq "ClientAccessRole"} { $script:installedRoles += "ClientAccess" Log "Adding to installed roles list: ClientAccess" break } {$_ -ieq "UnifiedMessagingRole"} { $script:installedRoles += "UnifiedMessaging" Log "Adding to installed roles list: UnifiedMessaging" break } {$_ -ieq "MailboxRole"} { $script:installedRoles += "Mailbox" Log "Adding to installed roles list: Mailbox" break } default { # There are other things like 'Hygiene' in the registry as well, so we ignore this # information break } } } } ############################################################################### # # Main # Log ************************************************ Log ("* ServiceControl.ps1: {0}" -F $(get-date) ) Log "Performing service control with options: $Args" $ret = $false if ($Args.Length -eq 0) { Status "Must specify an operation" Usage return } $activity = $null write-Progress -Activity 'Service Control' -Id 0 -Status 'In Progress' -PercentComplete 0 switch ($Args[0]) { {$_ -ieq "Save"} { $activity = 'Archiving Service State' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 SaveServiceState SaveServiceRegistryData $ret = $true break } {$_ -ieq "Remove"} { $activity = 'Removing State Archive' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 RemoveServiceState RemoveServiceRegistryData $ret = $true break } {$_ -ieq "Stop" } { if( $Args.Length -lt 2 ) { Status "Must specify one or more roles." Usage break } $activity = 'Stopping Services' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 # Loop through each role and terminate on error $ret = $true Log "Will stop services for the roles '$Args[1]'" foreach( $role in $Args[1] ) { Log "Stopping services for role '$role'" if( -not( IsKnownRole $role ) ) { $ret = $false Status ("Unknown role '{0}'." -F $role) Usage break } if( -not( StopServices $role ) ) { $ret = $false Status ("Unable to stop all services for '{0}'." -F $role) break } } break } {$_ -ieq "DisableServices" } { if( $Args.Length -lt 2 ) { Status "Must specify one or more roles." Usage break } $activity = 'Disabling Services' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 # Loop through each role $ret = $true Log "Will disable services for the roles '$Args[1]'" foreach( $role in $Args[1] ) { Log "Disabling services for role '$role'" if( -not( IsKnownRole $role ) ) { $ret = $false Status ("Unknown role '{0}'." -F $role) Usage break } if( -not( DisableServices $role ) ) { $ret = $false Status ("Unable to disable all services for '{0}'." -F $role) break } } break } {$_ -ieq "Start" } { if( $Args.Length -lt 2 ) { Status "Must specify one or more roles." Usage break } $activity = 'Stating Services' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 # Loop through each role and terminate on error $ret = $true foreach( $role in $Args[1] ) { if( -not( IsKnownRole $role ) ) { $ret = $false Status ("Unknown role '{0}'." -F $role) Usage break } if( -not( StartServices $role ) ) { $ret = $false Status ("Unable to restore all services for '{0}'." -F $role) break } } break } {$_ -ieq "EnableServices" } { if( $Args.Length -lt 2 ) { Status "Must specify one or more roles." Usage break } $activity = 'Enabling Services' write-Progress -Activity $activity -Id 0 -Status 'In Progress' -PercentComplete 10 # Loop through each role and terminate on error $ret = $true Log "Will enable services for the roles '$Args[1]'" foreach( $role in $Args[1] ) { Log "Enabling services for role '$role'" if( -not( IsKnownRole $role ) ) { $ret = $false Status ("Unknown role '{0}'." -F $role) Usage break } if( -not( EnableServices $role ) ) { $ret = $false Status ("Unable to enable all services for '{0}'." -F $role) break } } break } {$_ -ieq "BeforePatch"} { # This is the set of stuff we need to do before applying a patch # We stop all the services and disable them. Before doing this we need # to store the service state and registry information $ret = $true $path = GetExchangeInstallPath $build = GetInstalledBuildVersion if(($path -eq $null) -or ($build -eq 0)) { $ret = $false Status ("Exchange server is not installed") } else { # Set the snapin registry values so that the script can access start-setupservice # and stop-startupservice $keyCreated = SetSnapinRegistryValues $path $build AddSnapins trap { CleanupForSnapin $keyCreated Log "Error: " + $_.Message break } # Save the service information Log "Saving service and registry data" SaveServiceState SaveServiceRegistryData GetInstalledRoles # Stop and disable the services foreach( $role in $script:installedRoles ) { Log "Stopping services for role '$role'" if( -not( StopServices $role ) ) { $ret = $false Status ("Unable to stop all services for '{0}'." -F $role) } elseif( -not( DisableServices $role ) ) { $ret = $false Status ("Unable to disable all services for '{0}'." -F $role) } } CleanupForSnapin $keyCreated } break } {$_ -ieq "AfterPatch"} { # Here we do stuff that is required after a patch is applied # We enable services for the installed roles, start the services based on # the data saved and then remove the files that store service related data $ret = $true $path = GetExchangeInstallPath $build = GetInstalledBuildVersion if(($path -eq $null) -or ($build -eq 0)) { $ret = $false Status ("Exchange server is not installed") } else { # Set the snapin registry values so that the script can access start-setupservice # and stop-startupservice $keyCreated = SetSnapinRegistryValues $path $build AddSnapins trap { CleanupForSnapin $keyCreated Log "Error: " + $_.Message break } GetInstalledRoles # Enable and start services foreach( $role in $script:installedRoles ) { Log "Enabling services for role '$role'" if( -not( EnableServices $role ) ) { $ret = $false Status ("Unable to enable all services for '{0}'." -F $role) } elseif( -not( StartServices $role ) ) { $ret = $false Status ("Unable to restore all services for '{0}'." -F $role) } } # Remove saved service data RemoveServiceState RemoveServiceRegistryData CleanupForSnapin $keyCreated } break } default { Status "Unknown operation: '$_'" Usage break } } write-Progress -Activity $activity -Id 0 -Status 'Completed' -Completed if( $ret -eq $true ) { Log "Script completed succesfully." } else { Log "Script completed with one or more errors." } # SIG # Begin signature block # MIIXBAYJKoZIhvcNAQcCoIIW9TCCFvECAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQU8MGL/QpLupgU4+6PvcImPYtY # bIigghHRMIIDxDCCAy2gAwIBAgIQR78Zld+NUkZD99ttSA0xpDANBgkqhkiG9w0B # AQUFADCBizELMAkGA1UEBhMCWkExFTATBgNVBAgTDFdlc3Rlcm4gQ2FwZTEUMBIG # A1UEBxMLRHVyYmFudmlsbGUxDzANBgNVBAoTBlRoYXd0ZTEdMBsGA1UECxMUVGhh # d3RlIENlcnRpZmljYXRpb24xHzAdBgNVBAMTFlRoYXd0ZSBUaW1lc3RhbXBpbmcg # Q0EwHhcNMDMxMjA0MDAwMDAwWhcNMTMxMjAzMjM1OTU5WjBTMQswCQYDVQQGEwJV # UzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xKzApBgNVBAMTIlZlcmlTaWduIFRp # bWUgU3RhbXBpbmcgU2VydmljZXMgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCpyrKkzM0grwp9iayHdfC0TvHfwQ+/Z2G9o2Qc2rv5yjOrhDCJWH6M # 22vdNp4Pv9HsePJ3pn5vPL+Trw26aPRslMq9Ui2rSD31ttVdXxsCn/ovax6k96Oa # phrIAuF/TFLjDmDsQBx+uQ3eP8e034e9X3pqMS4DmYETqEcgzjFzDVctzXg0M5US # mRK53mgvqubjwoqMKsOLIYdmvYNYV291vzyqJoddyhAVPJ+E6lTBCm7E/sVK3bkH # EZcifNs+J9EeeOyfMcnx5iIZ28SzR0OaGl+gHpDkXvXufPF9q2IBj/VNC97QIlao # lc2uiHau7roN8+RN2aD7aKCuFDuzh8G7AgMBAAGjgdswgdgwNAYIKwYBBQUHAQEE # KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC52ZXJpc2lnbi5jb20wEgYDVR0T # AQH/BAgwBgEB/wIBADBBBgNVHR8EOjA4MDagNKAyhjBodHRwOi8vY3JsLnZlcmlz # aWduLmNvbS9UaGF3dGVUaW1lc3RhbXBpbmdDQS5jcmwwEwYDVR0lBAwwCgYIKwYB # BQUHAwgwDgYDVR0PAQH/BAQDAgEGMCQGA1UdEQQdMBukGTAXMRUwEwYDVQQDEwxU # U0EyMDQ4LTEtNTMwDQYJKoZIhvcNAQEFBQADgYEASmv56ljCRBwxiXmZK5a/gqwB # 1hxMzbCKWG7fCCmjXsjKkxPnBFIN70cnLwA4sOTJk06a1CJiFfc/NyFPcDGA8Ys4 # h7Po6JcA/s9Vlk4k0qknTnqut2FB8yrO58nZXt27K4U+tZ212eFX/760xX71zwye # 8Jf+K9M7UhsbOCf3P0owggP/MIIC56ADAgECAhAN6Svw1NgpiBgyBQlemnaIMA0G # CSqGSIb3DQEBBQUAMFMxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5WZXJpU2lnbiwg # SW5jLjErMCkGA1UEAxMiVmVyaVNpZ24gVGltZSBTdGFtcGluZyBTZXJ2aWNlcyBD # QTAeFw0wMzEyMDQwMDAwMDBaFw0wODEyMDMyMzU5NTlaMFcxCzAJBgNVBAYTAlVT # MRcwFQYDVQQKEw5WZXJpU2lnbiwgSW5jLjEvMC0GA1UEAxMmVmVyaVNpZ24gVGlt # ZSBTdGFtcGluZyBTZXJ2aWNlcyBTaWduZXIwggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQCyUChI3dNoeoQYRGZ1XX7EuJ9jJv89Q5x8ETgQJVVz2XUnaf1O # uSBc0wr5oBsq7VVWIWHYHtvkvDNrx+/dozdljhuTDLZTHlx8ZjVfBYpF/nZO31OA # ooEgna6IXKII9+Uw+e4iN0xCCs7fxh/E1lXpgT+1UqMsqgF68qKqjTX+n+ZdagWf # PWvjv5bA/sxg+UDnB6BE64FRbqUq8raKECjtj9wGoIZQmntKCA0wHcoQnmv36Viu # BKlAmbIo6I8WrDzjU29L0zWdtW9kHbOWLLs953nrbXr5FuYmra/vmVO3QCyVuHmq # /tRSqyl0fkLsOR6iahbmWbskaNgAgEMQh4BrAgMBAAGjgcowgccwNAYIKwYBBQUH # AQEEKDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC52ZXJpc2lnbi5jb20wDAYD # VR0TAQH/BAIwADAzBgNVHR8ELDAqMCigJqAkhiJodHRwOi8vY3JsLnZlcmlzaWdu # LmNvbS90c3MtY2EuY3JsMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB # /wQEAwIGwDAkBgNVHREEHTAbpBkwFzEVMBMGA1UEAxMMVFNBMjA0OC0xLTU0MA0G # CSqGSIb3DQEBBQUAA4IBAQCHeHDaTlIBIFvgecmCMMT9uRmWvZEAw73Nzcb0Dtj/ # +U3AM2IwEcX1dBvUkt5fnCATsXxFvlDNg+eAF4OnJ5NnE0b7yriYQQPMm1FbBYt/ # qG/zG1AbJC7yaY1sIve7yhaV7Qx0wGh32euZYofBc5D4iXR6I6ujmHuXsfePKXFN # LnUbSEHa8LUNIFTWd6CXgmNp/QnPivB1uwmb2fkRVSaaYTK+egKwe4a+osOLIix4 # 0TV2vJJzXPm55kwVCiPM5NLUNC5JQBU8D2B6JMalZu+Wz3DrPuf0DX7c0XyjdnFp # wZxPRzA1IbGirxpiPCvZjqoqB3vYGLNce+KdpW/+PImtMIIEyzCCA7OgAwIBAgIQ # aguZT8AADKsR2CLvfWx5fjANBgkqhkiG9w0BAQQFADBwMSswKQYDVQQLEyJDb3B5 # cmlnaHQgKGMpIDE5OTcgTWljcm9zb2Z0IENvcnAuMR4wHAYDVQQLExVNaWNyb3Nv # ZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBSb290IEF1dGhvcml0 # eTAeFw0wMjA1MjMwODAwMDBaFw0xMTA5MjUwODAwMDBaMIGmMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSswKQYDVQQLEyJDb3B5cmlnaHQgKGMp # IDIwMDAgTWljcm9zb2Z0IENvcnAuMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBT # aWduaW5nIFBDQTCCASAwDQYJKoZIhvcNAQEBBQADggENADCCAQgCggEBAMPMII28 # 3/8+UO56wtQkJfZ2ziH/zSpWTsqct4KyNXktAMSoCNVjybel9unBwdaxjJaiB/oP # toJSmuuCxr0QxajA7muEjlMbu1D6ZAGJwRbUgmgAQHhE9RI4TvtjUeD6PbnlN7Hf # YwcjO3FANEf0a65G9SdzHiLLQhkeUbZSmtOj0BPGGT9xBm3ylSFEX0LtwMmZZCC4 # wTT8okTme7IdL7im3vSh35shD/5YMUFVOH6vWOfk7Fl5Jav3Ki8RPzh4PkJ/p2jk # fiJoF+ZKksR4RFJHoU+EiZObwGd76gn7hgN99plxPCunZpjM3y3iKwIaDzRIZfU8 # Eq/xhxwdJlJvzAMCAQOjggEqMIIBJjATBgNVHSUEDDAKBggrBgEFBQcDAzCBogYD # VR0BBIGaMIGXgBBb0HDvaXKeI1F+FLJNjv/LoXIwcDErMCkGA1UECxMiQ29weXJp # Z2h0IChjKSAxOTk3IE1pY3Jvc29mdCBDb3JwLjEeMBwGA1UECxMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMSEwHwYDVQQDExhNaWNyb3NvZnQgUm9vdCBBdXRob3JpdHmC # DwDBAIs8PIgR0T72Y+zfQDASBgkrBgEEAYI3FQEEBQIDAwADMB0GA1UdDgQWBBQl # +CtLXchyVK3l9qAqFxb7wflTgTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL # BgNVHQ8EBAMCAUYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQQFAAOCAQEA # n2RKdOFpJ1r4BlMnl8ce0YFz0c66gfQa6pOXh6/cjzoCtYsQv9MudHQBO7RAE+5R # XzzDMptP1ulZyigAlnIV63EvmJjAA+E1QukIL2Ixmfwx89xCrtxPj8w43nBBOGAN # PCCSKxicB/5Wk6nSS4i9mUoiAoVvROyR5hneK7gVsptw+sXrToMsOnGgMljyNVLb # kYhA728b5ylCtHDNfWxvGsjbnPrRXor30iyaAF/Z9MKzn3vUO/5TdCpnHYEnonXo # QJgHGIsYIAtGct/v9+w2be5ryWZTHb01quXLHWpyE0WAHtldh2aKHCymysthAwPe # CckBsVnAsP3mZpfL+gk7fDCCBTMwggQboAMCAQICCmFGnssABAAAAGUwDQYJKoZI # hvcNAQEFBQAwgaYxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # KzApBgNVBAsTIkNvcHlyaWdodCAoYykgMjAwMCBNaWNyb3NvZnQgQ29ycC4xIzAh # BgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBMB4XDTA2MDQwNDE5NDM0 # NloXDTA3MTAwNDE5NTM0NlowdDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjEeMBwGA1UEAxMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMIIBIjANBgkq # hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzYGWOK5covLB397Qq5WN1jydH4vDXYYu # XfCxcvWrrIhqtdqxInsLyMilS5FeIhPp+fUjnbX0bnau7+6kPMfEwFlcP6uzczMm # pmKBYXmhYvRuiJXQbt3Hn9KkURF2YbpwimWhlhaJp12B0ERm5dtWnkDK/Nx2JC5E # MADl1n17lRHVWB2j6E8LyYjcotZTmWzKY8qZapqSXkxNEegv01tbXl9So3MtpbuE # RQ2MGRV2ywjamqZwFehN7Gn9XbJrj+0pUTc4i8ZGSRWUUJiw9Gik194JcWd0nneM # HYVrl+rnX0XM4OZxDdFjAJN7MZiOC7QTvbPQ7vHfIe6pYGHuN0M9wwIDAQABo4IB # kjCCAY4wDgYDVR0PAQH/BAQDAgbAMB0GA1UdDgQWBBTu2WupdVPNT+4bThkGHqOc # q8+U/TATBgNVHSUEDDAKBggrBgEFBQcDAzCBqQYDVR0jBIGhMIGegBQl+CtLXchy # VK3l9qAqFxb7wflTgaF0pHIwcDErMCkGA1UECxMiQ29weXJpZ2h0IChjKSAxOTk3 # IE1pY3Jvc29mdCBDb3JwLjEeMBwGA1UECxMVTWljcm9zb2Z0IENvcnBvcmF0aW9u # MSEwHwYDVQQDExhNaWNyb3NvZnQgUm9vdCBBdXRob3JpdHmCEGoLmU/AAB2rEdrE # AqFmJ7owSwYDVR0fBEQwQjBAoD6gPIY6aHR0cDovL2NybC5taWNyb3NvZnQuY29t # L3BraS9jcmwvcHJvZHVjdHMvQ29kZVNpZ25QQ0EyLmNybDBPBggrBgEFBQcBAQRD # MEEwPwYIKwYBBQUHMAKGM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2Vy # dHMvQ29kZVNpZ25QQ0EyLmNydDANBgkqhkiG9w0BAQUFAAOCAQEAONnvlTibXJgU # XVRuad8CyOez+9PCTa0vq39UDdoytvhq5g37IRp3PqVoerSVfopc8kPEg5tlfYhQ # UXyCFPWDc9eivlzKAnDOJmwXvFIUpYnAt+ShzKF1nZFxPRvAVgBWtfiEJtpeM/vW # JXpemtqm+/TyQRqsVUatSNyROBNYCUnx8zGHH7wEjlsSZQPpC1HQoQyKmb3ZwajQ # CBUlIbW2V4kc0VuGNaXK/aqH7Kk3P7dDa+Mg8UW8fq7p8VWyoUi8Zb5TNNnJ6AZj # BAZ4blD/SLub6kNah9utCoD1WcUs5OV/W0rlMnnuIoWSDC2zUFvGwkBYWKvSzeMv # wc3sbZ83eTGCBJ0wggSZAgEBMIG1MIGmMQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMSswKQYDVQQLEyJDb3B5cmlnaHQgKGMpIDIwMDAgTWljcm9z # b2Z0IENvcnAuMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQQIK # YUaeywAEAAAAZTAJBgUrDgMCGgUAoIG6MBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3 # AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEW # BBSfvqgHABrCU6BcGZ1e4hfwSqHd1zBaBgorBgEEAYI3AgEMMUwwSqAsgCoATQBp # AGMAcgBvAHMAbwBmAHQAIABDAG8AcgBwAG8AcgBhAHQAaQBvAG6hGoAYaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tMA0GCSqGSIb3DQEBAQUABIIBABxKV2P8Qu+CoKwE # Qk8aguoTglmkKI6vcmGyuDtlAvJtwDJ+hUle/oq+cYlyTzv6EbGL9xdN95l+fifA # 7F+yO+2EmJzjCNH6Pkr7xGLahobEbsgYSDnl09szNNxXPlEEUyKosw8n/Hn7H8qH # TMNFIp7MV7/q9fhefAyB53xGj8i+zb79vG1BoH/n6ZZqFdCIVuoH/Xbz23SyvJKU # MchY6LQ+6gzNwWSD1YstEAlAhRQr/GynahRhLPYs4RuVmWbRvjjlFFlWoQVFmhBq # jVPPv/05BZDbHNNGBXVsxAq8ZZEHYH24OKbwzu/7cwvl3w/dkL18doh/kRPy/uds # LJ4IHlqhggH/MIIB+wYJKoZIhvcNAQkGMYIB7DCCAegCAQEwZzBTMQswCQYDVQQG # EwJVUzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xKzApBgNVBAMTIlZlcmlTaWdu # IFRpbWUgU3RhbXBpbmcgU2VydmljZXMgQ0ECEA3pK/DU2CmIGDIFCV6adogwDAYI # KoZIhvcNAgUFAKBZMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcN # AQkFMQ8XDTA2MTAxMDIzNTkzN1owHwYJKoZIhvcNAQkEMRIEECt9x/SYKl4L4wzH # CIfP9CowDQYJKoZIhvcNAQEBBQAEggEAnF6SIcq40Y4kYTVD5bHBhejTa1Yd+Pjz # MibRl8WKFK0KHfjqhpW/SoUAeBz2NDfuM/LPVMX54P3GJ+3pu5etqdXjxTcDpWLz # 2xQY4f09viOgxsOtAWsV7z4Obxu3QoKsTvSiPaDFpRX6Lfkj12AUxIRK4gGczxs/ # gpINJybhyNyXO5NNAtt3Huc+tJ475UdFvk/j7hSyaTSoYZ2oJ7+NKPUN5KuTzpk/ # KH3dxSZpnU9FGRCAc9b8+D0UplXi1y4nae36wN5/QzifhsUMjEBF+TYjpocbnbxb # UaXV1hpridajzcmhcxzjPxsR38qpapGBQXXzdVWleRnihUO0OViBXw== # SIG # End signature block