# .SYNOPSIS
# This script sets MRS settings in the MRS or Migration Service Config file (including WLM delay configuration in the registry for MRS).
#
# .DESCRIPTION
# Purpose of the script is to allow configuring MRS or Migration Service configuration settings.
# This script is typically executed by Ops or product team on-call and is designed to be used only on Exchange Datacenters.
# MRS runs only on ClientAccessServer. Migration Service runs only on mailbox servers. Hence, this script should only be targeted at either of these servers.
#
# .PARAMETER Delays
# This is the throttling setting. 2 means WLM delay throttling is enabled. 1 means WLM delay throttling is disabled. 0 means it remains untouched.
#
# .PARAMETER SettingNameValuePairs
# This is the string containing the name value pairs for MRS or Migration service settings
# in either MRSConfiguration or AppSettings sections.
# The expected format is "Name1=Value1_Name2=Value2_Name3=Value3".
# If the setting is in MRSConfiguration section, it should exist previously. If the setting is in AppSettings section
# (of either MRS or Migration Service files) and doesn't exist already, it will be added.
#
# .PARAMETER xPath
# This is the string specifying the xpath of an Xml attribute to modify in the MRS or Migration service config file.
# The xpath must be valid i.e. the specified attribute must already exist in order to be modified. The xPath is case-sensitive.
# This parameter along with xPathValue may be used for settings that are not in MRSConfiguration or AppSettings sections of the configuration file.
#
# .PARAMETER xPathValue
# This is the string specifying the new value for the attribute specified by the -xPath parameter.
#
# .PARAMETER ConfigToUpdate
# This is the parameter specifying which configuration file is to be altered. Use 'MRS' to denote MSExchangeMailboxReplication.exe.config,
# Migration to denote Microsoft.Exchange.ServiceHost.exe.config and LoadBalance to denote MSExchangeMigrationWorkflow.exe.config.
#
# .PARAMETER RemoveNode
# This is the parameter specifying that the node selected by the xPath expression is to be removed from the config.
#
# .PARAMETER AddNode
# This is the parameter specifying that the value specified by xPathValue is going to get added as a child of the node selected by xPath.
#
# .PARAMETER RestartService
# If this switch is provided then the service that's config is being changed will be restarted. If the switch isn't provided no restart will occur.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -Delays 0
# This causes the WLM throttling for MRS setting to remain untouched.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -Delays 1
# This causes WLM to throttle MRS with delays.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -Delays 2
# This causes WLM to stop throttling MRS with delays.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -SettingNameValuePairs "MaxActiveMovesPerSourceMDB=5_MaxActiveMovesPerTargetMDB=3_MaxActiveMovesPerSourceServer=50_MaxActiveMovesPerTargetServer=20_MaxTotalRequestsPerMRS=100" -ConfigToUpdate MRS
# This modifies only the four MRS config settings provided in the SettingNameValuePairs parameter string.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -Delays 2 -SettingNameValuePairs "MaxActiveMovesPerSourceMDB=5_MaxActiveMovesPerTargetMDB=3_MaxActiveMovesPerSourceServer=50_MaxActiveMovesPerTargetServer=20_MaxTotalRequestsPerMRS=100" -MRS
# This causes WLM to throttle MRS with delays as well as changes the MRS config settings specified.
#
# .EXAMPLE
# .\ConfigureMRSSettings.ps1 -SettingNameValuePairs "SyncMigrationEnabledMigrationTypes=IMAP,Exchange" -ConfigToUpdate Migration
# This modifies the SyncMigrationEnabledMigrationTypes setting provided in the Migration config file.
#
# .EXAMPLE
# .\ConfigureMRSSettings.ps1 -SettingNameValuePairs "K1=V1:V11" -ConfigToUpdate Migration
# This adds the new row K1 in the AppSettings section of the Migration config file.
#
# .EXAMPLE
# .\ConfigureMRSSettings.ps1 -xPath "/configuration/BandConfiguration" -ConfigToUpdate LoadBalance -xPathValue '' -AddNode
# This adds the new node Band with attributes MinSizeMb=100, MaxSizeMb=5000, Enabled=True and Profile=SizeBased to the LoadBalance config file.
#
# .EXAMPLE
# .\ConfigureMRSSettings.ps1 -xPath "/configuration/BandConfiguration/band[@MinSizeMb=250]" -ConfigToUpdate LoadBalance -RemoveNode
# This removes the Band node with MinSizeMb=250 from the LoadBalance config file.
#
# .EXAMPLE
# .\ConfigureMRSSettings.ps1 -xPath "/configuration/BandConfiguration/band[@MinSizeMb=250]/@MinSizeMb" -ConfigToUpdate LoadBalance -xPathValue "200"
# This changes Band node with MinSizeMb=250 from the LoadBalance config file to have MinSizeMb=200.
#
# .EXAMPLE
# ConfigureMrsSettings.ps1 -xPath "//configuration/system.serviceModel/bindings/customBinding/binding/httpsTransport/@maxReceivedMessageSize" -xPathValue "5050505050" -ConfigToUpdate mrs
# This causes the maxReceivedMessageSize under the specified path to be modified to 5050505050, in the MRS config file.
#
# Copyright (c) Microsoft Corporation. All rights reserved.
#
# THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK
# OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER.
[CmdletBinding(DefaultParameterSetName="basic")]
param(
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[string]$SettingNameValuePairs,
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[Int32]$Delays,
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[Parameter(Mandatory=$true, ParameterSetName="xpathadd")]
[Parameter(Mandatory=$true, ParameterSetName="xpathremove")]
[string]$xPath,
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[Parameter(Mandatory=$true, ParameterSetName="xpathadd")]
[string]$xPathValue,
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[Parameter(Mandatory=$true, ParameterSetName="xpathadd")]
[Parameter(Mandatory=$true, ParameterSetName="xpathremove")]
[ValidateSet("mrs", "migration", "loadbalance")]
[string]$ConfigToUpdate,
[Parameter(Mandatory=$true, ParameterSetName="xpathremove")]
[Switch]$RemoveNode,
[Parameter(Mandatory=$true, ParameterSetName="xpathadd")]
[Switch]$AddNode,
[Parameter(Mandatory=$false, ParameterSetName="basic")]
[Parameter(Mandatory=$false, ParameterSetName="xpathadd")]
[Parameter(Mandatory=$false, ParameterSetName="xpathremove")]
[switch]$RestartService
)
function FileIsMRS($inputFile)
{
return ($inputFile.ToLower().Equals("mrs"))
}
function FileIsMigration($inputFile)
{
return ($inputFile.ToLower().Equals("migration"))
}
function HaveSettings()
{
if (![string]::IsNullOrEmpty($xPath))
{
# this takes care of both AdddNode and regular update configuration cases
if (![string]::IsNullOrEmpty($xPathValue))
{
return $true
}
if ($RemoveNode)
{
return $true
}
}
if (![string]::IsNullOrEmpty($SettingNameValuePairs))
{
return $true
}
return $false
}
function VerifyUsage()
{
[bool]$configChanged = HaveSettings
if ($Delays -eq 0 -and !$configChanged)
{
throw "No change requested. Please run Get-help ConfigureMrsSettings.ps1 -examples to view usage."
}
if ($Delays -eq 0)
{
if ([string]::IsNullOrEmpty($ConfigToUpdate))
{
throw "Either Delay or ConfigToUpdate must be specified. Please run Get-help ConfigureMrsSettings.ps1 -examples to view usage."
}
}
}
function GetServiceToRestart()
{
$sName = ""
switch ($ConfigToUpdate)
{
"mrs" { $sName = "MSExchangeMailboxReplication" }
"migration" { $sName = "MSExchangeServiceHost" }
"loadbalance" { $sName = "MSExchangeMigrationWorkflow" }
default { throw "Unknown config: $ConfigToUpdate" }
}
$service = Get-Service $sName
if ($service -eq $null)
{
throw "Could not find $sName. This script must be targeted only against ClientAccessServer for MRS and Mailbox Server for Migration Service and Load Balance."
}
return $sName
}
function ConfigureWlmDelay()
{
if ($Delays -eq 0)
{
return
}
if ($Delays -eq 2)
{
Write-Host "Configuring WLM to ENABLE MRS delays..."
$valueToSet = 1
}
else
{
Write-Host "Configuring WLM to DISABLE MRS delays..."
$valueToSet = 0
}
# Configure WLM to switch throttling ON/OFF for MRS.
$keyHive = "HKLM:\system\CurrentControlSet\services\MSExchange ResourceHealth"
$keyName = "MRS"
$mrsValue = Get-ItemProperty -Path $keyHive -Name $keyName
if ($mrsValue -eq $null)
{
throw "Could not find Registry key ${keyHive}:$keyName."
}
Write-Host "Current setting for ${keyHive}:$keyName is: $mrsValue"
Set-ItemProperty -Path $keyHive -Name $keyName -Value $valueToSet
$mrsValue = Get-ItemProperty -Path $keyHive -Name $keyName
Write-Host "Setting was set to: $mrsValue"
Write-Host "WLM Registry configuration successful."
RestartService "MSExchangeMailboxReplication"
}
#Get the install path - must handle both V14 or V15 target servers.
function GetMSIInstallPath()
{
$DirPath = $null
# Check higher version first
$DirPath=(get-itemproperty -Path "HKLM:\software\microsoft\exchangeServer\v15\setup" -ErrorAction SilentlyContinue)
if ($DirPath -ne $null)
{
Write-Host "Found E15 install path"
}
else
{
$DirPath=(get-itemproperty -Path "HKLM:\software\microsoft\exchangeServer\v14\setup" -ErrorAction SilentlyContinue)
if ($DirPath -ne $null)
{
Write-Host "Found E14 install path"
}
else
{
throw "MSIInstallPath was not found"
}
}
$path = $DirPath.MSIInstallPath.TrimEnd("\")
Write-Host "Found Dir path = $path"
return $path
}
function Supports-Removal
{
param(
[Parameter(Mandatory=$true, ValueFromPipeline=$true, Position=0)]
[System.Xml.XmlNode]$Node
)
process
{
# a null node cannot be removed
if ($Node -eq $null)
{
return $false
}
# top of hierarchy is not removable
if ($node.ParentNode -eq $null)
{
return $false
}
# these are the nodes that can be removed
switch ($node.Name)
{
"BandConfiguration" { return $true }
"WeightConfiguration" { return $true }
"LoadBalanceConfiguration" { return $true }
}
# anything else is removable if the parent is removable
return Supports-Removal $node.ParentNode
}
}
function Get-NodePath
{
param(
[Parameter(Mandatory=$true, ValueFromPipeline=$true, Position=0)]
[System.Xml.XmlNode]$Node
)
process
{
if ($node.NodeType -eq [System.Xml.XmlNodeType]::Attribute)
{
$nodeName = "@{0}" -f $node.Name
}
else
{
$nodeName = $node.Name
}
if ($node.ParentNode -eq $nul)
{
return "/$nodeName"
}
$parentNode = Get-NodePath $node.ParentNode
return $("{0}/{1}" -f @($parentNode, $nodeName))
}
}
function ConfigureSettings
{
[bool]$continue = HaveSettings
if (!$continue)
{
return
}
$NameValuePairs = new-object "System.Collections.Generic.Dictionary``2[System.String, System.String]"
[string[]]$arrayOfValues = $SettingNameValuePairs.Split("_")
foreach ($value in $arrayOfValues)
{
[string[]] $nameValue = $value.Split("=")
if ($nameValue.Count -eq 2)
{
$NameValuePairs.Add($nameValue[0], $nameValue[1])
Write-Host "Adding element to dictionary: $nameValue[0], $nameValue[1]"
}
}
Write-Host "SettingNameValuePairs has $($SettingNameValuePairs.count) elements."
Write-Host "$SettingNameValuePairs"
$ConfigPath = ""
[string]$ExchangeInstallDir= GetMSIInstallPath
switch ($ConfigToUpdate)
{
"mrs"
{
Write-Host "Updating MRS Config settings..."
$ConfigPath = "$ExchangeInstallDir\bin\MSExchangeMailboxReplication.exe.config"
}
"migration"
{
Write-Host "Updating Migration Config settings..."
$ConfigPath = "$ExchangeInstallDir\bin\Microsoft.Exchange.Servicehost.exe.config"
}
"loadbalance"
{
Write-Host "Updating Load Balancing settings..."
$ConfigPath = "$ExchangeInstallDir\bin\MSExchangeMigrationWorkflow.exe.config"
}
default { throw "Unknown config: $ConfigToUpdate" }
}
if (-not (Test-Path $ConfigPath -PathType Leaf))
{
throw "Could not find the config file for $env:COMPUTERNAME. File Path tried was: $ConfigPath"
}
else
{
[xml]$Config = get-content $ConfigPath
[int]$settings = 0
$svcName = GetServiceToRestart
# SettingNameValuePair settings apply to all config modes
if ($NameValuePairs.count -GT 0)
{
foreach ($parameterName in $NameValuePairs.Keys)
{
if ($parameterName -ne "Delays")
{
$parameterValue = $($NameValuePairs[$parameterName])
$addedNameValueSettingToMrs = $false
if (FileIsMRS($ConfigToUpdate))
{
if ((get-member -inputObject $Config.Configuration.MRSConfiguration -name $parameterName -WarningAction:SilentlyContinue) -ne $null)
{
# First, look in the MRSConfiguration section (settings used by MRS)
$oldValue = $Config.Configuration.MRSConfiguration.$parameterName
$Config.Configuration.MRSConfiguration.$parameterName = "$parameterValue"
Write-Host "$parameterName will be changed from $oldValue to $parameterValue"
$addedNameValueSettingToMrs = $true
}
}
# Add or modify setting in AppSettings section if it wasn't already added to MRSConfiguration section above.
if (!$addedNameValueSettingToMrs)
{
# AppSettings section settings apply to both MRS and Migration Service.
if (($Config.configuration.appSettings.selectsinglenode("add[@key='" + $parameterName + "']")) -ne $null)
{
# Modify existing setting value
$oldValue = $Config.Configuration.appSettings.selectsinglenode("add[@key='" + $parameterName + "']").value
$Config.Configuration.appSettings.selectsinglenode("add[@key='" + $parameterName + "']").value = "$parameterValue"
Write-Host "$parameterName will be changed from $oldValue to $parameterValue"
}
else
{
# Setting doesn't exist. Add new element under appSettings.
$appS = $Config.configuration.appSettings
$oldInnerXml = $appS.InnerXml
$newElement = [string]::Format('', $parameterName, $parameterValue)
$newInnerXml = [string]::Concat($oldInnerXml, $newElement)
$appS.InnerXml = $newInnerXml
Write-Host "Setting $parameterName not found. Will add new element under appSettings: $newElement"
}
}
$settings++
}
}
}
# XPath settings apply to all config modes
if (![string]::IsNullOrEmpty($xPath) -and (![string]::IsNullOrEmpty($xPathValue) -or $RemoveNode))
{
Write-host "xPath = $xPath"
Write-host "xPathValue = $xPathValue"
#Retrieve the node specified by the xPath provided.
$node = $Config.selectsinglenode("$xPath")
if ($node -eq $null)
{
throw "XPath $xPath not found in $ConfigToUpdate config"
}
if ($PSCmdlet.ParameterSetName -eq "basic")
{
$oldValue = $node."#text"
Write-Host "$xPath will be changed from $oldValue to $xPathValue"
# Modify the value of the Xpath-selected node.
$node."#text" = "$xPathValue"
$settings++
}
elseif ($PSCmdlet.ParameterSetName -eq "xpathadd")
{
Write-Host "Adding node"
$oldInnerXml = $node.InnerXml
$newInnerXml = [string]::Concat($oldInnerXml, $xPathValue)
$node.InnerXml = $newInnerXml
$settings++
}
elseif ($PSCmdlet.ParameterSetName -eq "xpathremove")
{
Write-Host "Removing node"
if (Supports-Removal $node)
{
$node.ParentNode.RemoveChild($node) | out-null
$settings++
}
else
{
throw "Node $(Get-NodePath $node) is not part of one of the supported hierarchies for removal"
}
}
}
#Save updated settings back to the file
$Config.Save($configPath)
Write-Host "Successfully updated or added $settings Config settings in config for Service: $svcName."
}
if ($RestartService)
{
RestartService $svcName
}
}
function RestartService($svcName)
{
Write-Host "Restarting $svcName to pick up changed configuration..."
[string]$ExchangeInstallDir = GetMSIInstallPath
$restartScriptPath = Join-Path $ExchangeInstallDir "DataCenter\RestartService.ps1"
& "$restartScriptPath" -ServiceName "$svcName"
}
#Main
Write-Host "Num of Parameters passed in = $($PSBoundParameters.count)"
Write-Host "Parameterset name = $($PSCmdlet.ParameterSetName)"
VerifyUsage
ConfigureWlmDelay
ConfigureSettings
# SIG # Begin signature block
# MIIawQYJKoZIhvcNAQcCoIIasjCCGq4CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUmoy4tusKbwfl9GqX6BzOphmh
# cyqgghV6MIIEuzCCA6OgAwIBAgITMwAAAFrtL/TkIJk/OgAAAAAAWjANBgkqhkiG
# 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw
# HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTQwNTIzMTcxMzE1
# WhcNMTUwODIzMTcxMzE1WjCBqzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# DTALBgNVBAsTBE1PUFIxJzAlBgNVBAsTHm5DaXBoZXIgRFNFIEVTTjpCOEVDLTMw
# QTQtNzE0NDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC
# ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMhIt9q0L/7KcnVbHqJqY0T
# vJS16X0pZdp/9B+rDHlhZlRhlgfw1GBLMZsJr30obdCle4dfdqHSxinHljqjXxeM
# duC3lgcPx2JhtLaq9kYUKQMuJrAdSgjgfdNcMBKmm/a5Dj1TFmmdu2UnQsHoMjUO
# 9yn/3lsgTLsvaIQkD6uRxPPOKl5YRu2pRbRptlQmkRJi/W8O5M/53D/aKWkfSq7u
# wIJC64Jz6VFTEb/dqx1vsgpQeAuD7xsIsxtnb9MFfaEJn8J3iKCjWMFP/2fz3uzH
# 9TPcikUOlkYUKIccYLf1qlpATHC1acBGyNTo4sWQ3gtlNdRUgNLpnSBWr9TfzbkC
# AwEAAaOCAQkwggEFMB0GA1UdDgQWBBS+Z+AuAhuvCnINOh1/jJ1rImYR9zAfBgNV
# HSMEGDAWgBQjNPjZUkZwCu1A+3b7syuwwzWzDzBUBgNVHR8ETTBLMEmgR6BFhkNo
# dHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNyb3Nv
# ZnRUaW1lU3RhbXBQQ0EuY3JsMFgGCCsGAQUFBwEBBEwwSjBIBggrBgEFBQcwAoY8
# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNyb3NvZnRUaW1l
# U3RhbXBQQ0EuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUA
# A4IBAQAgU4KQrqZNTn4zScizrcTDfhXQEvIPJ4p/W78+VOpB6VQDKym63VSIu7n3
# 2c5T7RAWPclGcLQA0fI0XaejIiyqIuFrob8PDYfQHgIb73i2iSDQLKsLdDguphD/
# 2pGrLEA8JhWqrN7Cz0qTA81r4qSymRpdR0Tx3IIf5ki0pmmZwS7phyPqCNJp5mLf
# cfHrI78hZfmkV8STLdsWeBWqPqLkhfwXvsBPFduq8Ki6ESus+is1Fm5bc/4w0Pur
# k6DezULaNj+R9+A3jNkHrTsnu/9UIHfG/RHpGuZpsjMnqwWuWI+mqX9dEhFoDCyj
# MRYNviGrnPCuGnxA1daDFhXYKPvlMIIE7DCCA9SgAwIBAgITMwAAAMps1TISNcTh
# VQABAAAAyjANBgkqhkiG9w0BAQUFADB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBD
# QTAeFw0xNDA0MjIxNzM5MDBaFw0xNTA3MjIxNzM5MDBaMIGDMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMQ0wCwYDVQQLEwRNT1BSMR4wHAYDVQQD
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
# ggEKAoIBAQCWcV3tBkb6hMudW7dGx7DhtBE5A62xFXNgnOuntm4aPD//ZeM08aal
# IV5WmWxY5JKhClzC09xSLwxlmiBhQFMxnGyPIX26+f4TUFJglTpbuVildGFBqZTg
# rSZOTKGXcEknXnxnyk8ecYRGvB1LtuIPxcYnyQfmegqlFwAZTHBFOC2BtFCqxWfR
# +nm8xcyhcpv0JTSY+FTfEjk4Ei+ka6Wafsdi0dzP7T00+LnfNTC67HkyqeGprFVN
# TH9MVsMTC3bxB/nMR6z7iNVSpR4o+j0tz8+EmIZxZRHPhckJRIbhb+ex/KxARKWp
# iyM/gkmd1ZZZUBNZGHP/QwytK9R/MEBnAgMBAAGjggFgMIIBXDATBgNVHSUEDDAK
# BggrBgEFBQcDAzAdBgNVHQ4EFgQUH17iXVCNVoa+SjzPBOinh7XLv4MwUQYDVR0R
# BEowSKRGMEQxDTALBgNVBAsTBE1PUFIxMzAxBgNVBAUTKjMxNTk1K2I0MjE4ZjEz
# LTZmY2EtNDkwZi05YzQ3LTNmYzU1N2RmYzQ0MDAfBgNVHSMEGDAWgBTLEejK0rQW
# WAHJNy4zFha5TJoKHzBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jv
# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNDb2RTaWdQQ0FfMDgtMzEtMjAx
# MC5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1p
# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY0NvZFNpZ1BDQV8wOC0zMS0yMDEwLmNy
# dDANBgkqhkiG9w0BAQUFAAOCAQEAd1zr15E9zb17g9mFqbBDnXN8F8kP7Tbbx7Us
# G177VAU6g3FAgQmit3EmXtZ9tmw7yapfXQMYKh0nfgfpxWUftc8Nt1THKDhaiOd7
# wRm2VjK64szLk9uvbg9dRPXUsO8b1U7Brw7vIJvy4f4nXejF/2H2GdIoCiKd381w
# gp4YctgjzHosQ+7/6sDg5h2qnpczAFJvB7jTiGzepAY1p8JThmURdwmPNVm52Iao
# AP74MX0s9IwFncDB1XdybOlNWSaD8cKyiFeTNQB8UCu8Wfz+HCk4gtPeUpdFKRhO
# lludul8bo/EnUOoHlehtNA04V9w3KDWVOjic1O1qhV0OIhFeezCCBbwwggOkoAMC
# AQICCmEzJhoAAAAAADEwDQYJKoZIhvcNAQEFBQAwXzETMBEGCgmSJomT8ixkARkW
# A2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9z
# b2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTEwMDgzMTIyMTkzMloX
# DTIwMDgzMTIyMjkzMloweTELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0
# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh
# dGlvbjEjMCEGA1UEAxMaTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EwggEiMA0G
# CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCycllcGTBkvx2aYCAgQpl2U2w+G9Zv
# zMvx6mv+lxYQ4N86dIMaty+gMuz/3sJCTiPVcgDbNVcKicquIEn08GisTUuNpb15
# S3GbRwfa/SXfnXWIz6pzRH/XgdvzvfI2pMlcRdyvrT3gKGiXGqelcnNW8ReU5P01
# lHKg1nZfHndFg4U4FtBzWwW6Z1KNpbJpL9oZC/6SdCnidi9U3RQwWfjSjWL9y8lf
# RjFQuScT5EAwz3IpECgixzdOPaAyPZDNoTgGhVxOVoIoKgUyt0vXT2Pn0i1i8UU9
# 56wIAPZGoZ7RW4wmU+h6qkryRs83PDietHdcpReejcsRj1Y8wawJXwPTAgMBAAGj
# ggFeMIIBWjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTLEejK0rQWWAHJNy4z
# Fha5TJoKHzALBgNVHQ8EBAMCAYYwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEE
# AYI3FQIEFgQU/dExTtMmipXhmGA7qDFvpjy82C0wGQYJKwYBBAGCNxQCBAweCgBT
# AHUAYgBDAEEwHwYDVR0jBBgwFoAUDqyCYEBWJ5flJRP8KuEKU5VZ5KQwUAYDVR0f
# BEkwRzBFoEOgQYY/aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJv
# ZHVjdHMvbWljcm9zb2Z0cm9vdGNlcnQuY3JsMFQGCCsGAQUFBwEBBEgwRjBEBggr
# BgEFBQcwAoY4aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNy
# b3NvZnRSb290Q2VydC5jcnQwDQYJKoZIhvcNAQEFBQADggIBAFk5Pn8mRq/rb0Cx
# MrVq6w4vbqhJ9+tfde1MOy3XQ60L/svpLTGjI8x8UJiAIV2sPS9MuqKoVpzjcLu4
# tPh5tUly9z7qQX/K4QwXaculnCAt+gtQxFbNLeNK0rxw56gNogOlVuC4iktX8pVC
# nPHz7+7jhh80PLhWmvBTI4UqpIIck+KUBx3y4k74jKHK6BOlkU7IG9KPcpUqcW2b
# Gvgc8FPWZ8wi/1wdzaKMvSeyeWNWRKJRzfnpo1hW3ZsCRUQvX/TartSCMm78pJUT
# 5Otp56miLL7IKxAOZY6Z2/Wi+hImCWU4lPF6H0q70eFW6NB4lhhcyTUWX92THUmO
# Lb6tNEQc7hAVGgBd3TVbIc6YxwnuhQ6MT20OE049fClInHLR82zKwexwo1eSV32U
# jaAbSANa98+jZwp0pTbtLS8XyOZyNxL0b7E8Z4L5UrKNMxZlHg6K3RDeZPRvzkbU
# 0xfpecQEtNP7LN8fip6sCvsTJ0Ct5PnhqX9GuwdgR2VgQE6wQuxO7bN2edgKNAlt
# HIAxH+IOVN3lofvlRxCtZJj/UBYufL8FIXrilUEnacOTj5XJjdibIa4NXJzwoq6G
# aIMMai27dmsAHZat8hZ79haDJLmIz2qoRzEvmtzjcT3XAH5iR9HOiMm4GPoOco3B
# oz2vAkBq/2mbluIQqBC0N1AI1sM9MIIGBzCCA++gAwIBAgIKYRZoNAAAAAAAHDAN
# BgkqhkiG9w0BAQUFADBfMRMwEQYKCZImiZPyLGQBGRYDY29tMRkwFwYKCZImiZPy
# LGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQDEyRNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp
# Y2F0ZSBBdXRob3JpdHkwHhcNMDcwNDAzMTI1MzA5WhcNMjEwNDAzMTMwMzA5WjB3
# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk
# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhN
# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
# ggEKAoIBAQCfoWyx39tIkip8ay4Z4b3i48WZUSNQrc7dGE4kD+7Rp9FMrXQwIBHr
# B9VUlRVJlBtCkq6YXDAm2gBr6Hu97IkHD/cOBJjwicwfyzMkh53y9GccLPx754gd
# 6udOo6HBI1PKjfpFzwnQXq/QsEIEovmmbJNn1yjcRlOwhtDlKEYuJ6yGT1VSDOQD
# LPtqkJAwbofzWTCd+n7Wl7PoIZd++NIT8wi3U21StEWQn0gASkdmEScpZqiX5NMG
# gUqi+YSnEUcUCYKfhO1VeP4Bmh1QCIUAEDBG7bfeI0a7xC1Un68eeEExd8yb3zuD
# k6FhArUdDbH895uyAc4iS1T/+QXDwiALAgMBAAGjggGrMIIBpzAPBgNVHRMBAf8E
# BTADAQH/MB0GA1UdDgQWBBQjNPjZUkZwCu1A+3b7syuwwzWzDzALBgNVHQ8EBAMC
# AYYwEAYJKwYBBAGCNxUBBAMCAQAwgZgGA1UdIwSBkDCBjYAUDqyCYEBWJ5flJRP8
# KuEKU5VZ5KShY6RhMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/Is
# ZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmlj
# YXRlIEF1dGhvcml0eYIQea0WoUqgpa1Mc1j0BxMuZTBQBgNVHR8ESTBHMEWgQ6BB
# hj9odHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9taWNy
# b3NvZnRyb290Y2VydC5jcmwwVAYIKwYBBQUHAQEESDBGMEQGCCsGAQUFBzAChjho
# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jvc29mdFJvb3RD
# ZXJ0LmNydDATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQUFAAOCAgEA
# EJeKw1wDRDbd6bStd9vOeVFNAbEudHFbbQwTq86+e4+4LtQSooxtYrhXAstOIBNQ
# md16QOJXu69YmhzhHQGGrLt48ovQ7DsB7uK+jwoFyI1I4vBTFd1Pq5Lk541q1YDB
# 5pTyBi+FA+mRKiQicPv2/OR4mS4N9wficLwYTp2OawpylbihOZxnLcVRDupiXD8W
# mIsgP+IHGjL5zDFKdjE9K3ILyOpwPf+FChPfwgphjvDXuBfrTot/xTUrXqO/67x9
# C0J71FNyIe4wyrt4ZVxbARcKFA7S2hSY9Ty5ZlizLS/n+YWGzFFW6J1wlGysOUzU
# 9nm/qhh6YinvopspNAZ3GmLJPR5tH4LwC8csu89Ds+X57H2146SodDW4TsVxIxIm
# dgs8UoxxWkZDFLyzs7BNZ8ifQv+AeSGAnhUwZuhCEl4ayJ4iIdBD6Svpu/RIzCzU
# 2DKATCYqSCRfWupW76bemZ3KOm+9gSd0BhHudiG/m4LBJ1S2sWo9iaF2YbRuoROm
# v6pH8BJv/YoybLL+31HIjCPJZr2dHYcSZAI9La9Zj7jkIeW1sMpjtHhUBdRBLlCs
# lLCleKuzoJZ1GtmShxN1Ii8yqAhuoFuMJb+g74TKIdbrHk/Jmu5J4PcBZW+JC33I
# acjmbuqnl84xKf8OxVtc2E0bodj6L54/LlUWa8kTo/0xggSxMIIErQIBATCBkDB5
# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk
# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpN
# aWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQQITMwAAAMps1TISNcThVQABAAAAyjAJ
# BgUrDgMCGgUAoIHKMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQB
# gjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBRwlPFHJyXn2F5H
# NKhWT6cMA06UUzBqBgorBgEEAYI3AgEMMVwwWqAygDAAQwBvAG4AZgBpAGcAdQBy
# AGUATQBSAFMAUwBlAHQAdABpAG4AZwBzAC4AcABzADGhJIAiaHR0cDovL3d3dy5t
# aWNyb3NvZnQuY29tL2V4Y2hhbmdlIDANBgkqhkiG9w0BAQEFAASCAQBDbAt1ZQ7B
# r9MP2OQqSwwkV30MvDycoO+smalZKS6wYafP/KrbvypaIpAGtqXZ78o7dmwOdLos
# JUc3eJoMRoyhOAR0xQnNMaYGlJXGB13pkcQoEIaV1fukpvjZXE/LsU/fNCUzCyoC
# iTpMlGG39kk0FcJfprVdNbmBsbCbSfP49ad2hxy+a1FBMvv6BWGtjCPDlV9Lkey+
# yGi3mg10zep9eghGNUUUfehaNy/TewvOCu/WGr0JUu5TPKWhoYGINF9k2hIk0yQE
# xyj3NOfVo2PXSRZzP8I+AmcZJQu8tIPiaW7M0Kq7cGdoFrpZ35JOMhH705ltPz9P
# oC527XBVMeqYoYICKDCCAiQGCSqGSIb3DQEJBjGCAhUwggIRAgEBMIGOMHcxCzAJ
# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jv
# c29mdCBUaW1lLVN0YW1wIFBDQQITMwAAAFrtL/TkIJk/OgAAAAAAWjAJBgUrDgMC
# GgUAoF0wGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcN
# MTQwNzExMDUwNTQ2WjAjBgkqhkiG9w0BCQQxFgQUTf6s5DCMG+UquRrlT2yl6tvS
# YGMwDQYJKoZIhvcNAQEFBQAEggEAk5Rt7WdzOL2Wbw8qxeDo1nak0ikqtZ0zStgm
# TibPe6C3Fo+HS7Tpk0drL4UW7TyepGNTwReV4EF0cSTETnAKKYY0AzVcP/OUeCPm
# Kl3B/2Otb/tGzOBL+h4zyvF3cL6qnn50KpE0oQF3P0gVYqSCLJfNc24e8u9FtVjw
# 8HyLhxf96Fiz8qhmc0tjTUhIIey9kWAejn7XId+0CKnhfEPLf09QAnGDvee9WQ29
# Jsktea7Th6p2tyqW8OJly0Oxa+ujbHmos9CTHTAKPuT4ZIPkbKJSm3LNfCYnBNGj
# 0WMOyB83NfgKrK4S05QDw57fT5E26GtIoIHS6BfA3pAIjobXOw==
# SIG # End signature block