# Copyright (c) 2010 Microsoft Corporation. All rights reserved.
# This script contains all the common Powershell functions required to connect to remote PS, both in Enterprise and Datacenter
#load hashtable of localized string
Import-LocalizedData -BindingVariable CommonConnectFunctions_LocalizedStrings -FileName CommonConnectFunctions.strings.psd1
## PROMPT ####################################################################
## PowerShell can support very rich prompts, this simple one prints the current
## working directory and updates the console window title to show the machine
## name and directory.
function prompt
{
$cwd = (get-location).Path
$host.UI.RawUI.WindowTitle = ($CommonConnectFunctions_LocalizedStrings.res_0004 -f $global:connectedFqdn)
$host.UI.Write("Yellow", $host.UI.RawUI.BackGroundColor, "[PS]")
" $cwd>"
}
## generates a tip of the day
function get-tip
{
param($local:number=$null)
if( ($global:exrandom -eq $null) -or ($exrandom -isnot [System.Random]))
{
$global:exrandom = new-object System.Random
}
$exchculture = [System.Threading.Thread]::CurrentThread.CurrentUICulture
$foundculture = $false
while($exchculture -ne [Globalization.CultureInfo]::InvariantCulture -and !$foundculture)
{
if ( test-path "$($global:exbin)\$($exchculture.Name)\extips.xml" )
{
$foundculture = $true
}
else
{
$exchculture = $exchculture.Parent
}
}
if($foundculture -eq $true)
{
$exchculture = $exchculture.Name
}
else
{
$exchculture = 'en'
}
if (test-path "$($global:exbin)\$exchculture\extips.xml")
{
$local:tips = [xml](get-content $global:exbin\$exchculture\extips.xml)
if($local:number -eq $null)
{
$local:temp = $global:exrandom.Next( 0, $local:tips.topic.developerConceptualDocument.introduction.table.row.Count )
}
else
{
$local:temp = $local:number
}
$local:nav = $tips.topic.developerConceptualDocument.introduction.table.row[$local:temp].entry.CreateNavigator()
write-host -fore Yellow ( $CommonConnectFunctions_LocalizedStrings.res_0000 -f $local:temp )
[void] $nav.MoveToFirstChild()
do
{
write-host $nav.Value
}
while( $nav.MoveToNext() )
""
}
else
{
($CommonConnectFunctions_LocalizedStrings.res_0005 -f "$($global:exbin)\$exchculture\extips.xml")
}
trap
{
continue
}
}
function ImportPSSession ([bool]$ClearCache, [switch]$AllowClobber)
{
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\v15\RemotePowerShell\$serverName"
if ($ClearCache)
{
Write-Host -fore Yellow $CommonConnectFunctions_LocalizedStrings.res_0001
ClearRegistryEntryAndModule $remotePSSettinsPath $modulePath
}
try
{
if ($AllowClobber)
{
ExportPSSessionAndImportModule $remotePSSettinsPath $modulePath -AllowClobber
}
else
{
ExportPSSessionAndImportModule $remotePSSettinsPath $modulePath
}
}
catch
{
Write-Warning $CommonConnectFunctions_LocalizedStrings.res_0002
}
$global:importResults = Get-Module
if ($global:importResults -eq $null)
{
if ($AllowClobber)
{
$global:importResults=Import-PSSession $global:remoteSession -WarningAction SilentlyContinue -DisableNameChecking -AllowClobber
}
else
{
$global:importResults=Import-PSSession $global:remoteSession -WarningAction SilentlyContinue -DisableNameChecking
}
}
set-variable VerbosePreference -value Continue
Write-Verbose ($CommonConnectFunctions_LocalizedStrings.res_0003 -f $global:connectedFqdn)
}
}
function ExportPSSessionAndImportModule ($remotePSSettinsPath, $modulePath, [switch]$AllowClobber)
{
$hashValue = $global:remoteSession.ApplicationPrivateData.ImplicitRemoting.Hash
$CurrentUserRemotePSSettings = Get-ItemProperty -path $remotePSSettinsPath -ErrorAction SilentlyContinue
# PS3.0, Get-ItemProperty will return DWORD data as UInt32, instead of Int32 in PS2.0.
# If $hashValue is negative, (CurrentUserRemotePSSettings.Hash -ne $hashValue) will always be $true
# We use bitwise xor operation to work around
if (($CurrentUserRemotePSSettings -eq $null) `
-or ($CurrentUserRemotePSSettings.Hash -eq $null) `
-or (-not ($CurrentUserRemotePSSettings.ModulePath)) `
-or (($hashValue -bxor $CurrentUserRemotePSSettings.Hash) -ne 0))
{
# 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
if ($AllowClobber)
{
CreateRegistryEntryAndImportModule $remotePSSettinsPath $hashValue $modulePath -AllowClobber
}
else
{
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
if ($AllowClobber)
{
Export-PSSession -Session $global:remoteSession -OutputModule $modulePath -force -AllowClobber | out-null
}
else
{
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
if ($AllowClobber)
{
CreateRegistryEntryAndImportModule $remotePSSettinsPath $hashValue $modulePath -AllowClobber
}
else
{
CreateRegistryEntryAndImportModule $remotePSSettinsPath $hashValue $modulePath
}
}
else
{
Import-Module -Name $modulePath -ArgumentList $global:remoteSession -DisableNameChecking
}
}
}
}
function CreateRegistryEntryAndImportModule ($remotePSSettinsPath, $hashValue, $modulePath, [switch]$AllowClobber )
{
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
if ($AllowClobber)
{
Export-PSSession -Session $global:remoteSession -OutputModule $modulePath -force -AllowClobber | out-null
}
else
{
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
}
##########################################################################################################################
#
# Contains cmdlets which create a PSCredential object by consuming user
# input in the form of a liveID (like user@hotmail.com) and password.
#
# This module depends on SSPIPromptForCredentials win32 API for generating Nego2/LiveSSP token
# PSHostUserInterface method PromptForCredential will not work for Nego2
#
######### PInvoke code which retrieves PSCredential using SSPIPromptForCredentials #########
$getLiveIDCredCode = @"
using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;
using System.Globalization;
using System.Management.Automation;
using System.Management.Automation.Runspaces;
namespace Microsoft.PowerShell.Commands
{
[StructLayout(LayoutKind.Sequential)]
public struct CREDUI_INFO
{
public int cbSize;
public IntPtr hwndParent;
[MarshalAs(UnmanagedType.LPWStr)]
public string pszMessageText;
[MarshalAs(UnmanagedType.LPWStr)]
public string pszCaptionText;
public IntPtr hbmBanner;
}
public class LiveIDCredential
{
private const string NEGOSSP_NAME_W = "Negotiate";
private const string NEGOSSP_2_W = "Nego2";
public static PSCredential GetLiveIDCredential(string captionText,
string messageText,
string connectionUri)
{
// This will throw if the connectionUri is not a valid uri string.
Uri connUri = new UriBuilder(connectionUri).Uri;
WSManConnectionInfo cInfo = new WSManConnectionInfo(
connUri, (string)null, (System.Management.Automation.PSCredential)null);
cInfo.AuthenticationMechanism = AuthenticationMechanism.Negotiate;
Runspace remoteRunspace = RunspaceFactory.CreateRunspace(cInfo);
try
{
remoteRunspace.Open();
}
catch (Exception)
{
}
CREDUI_INFO credUiInfo = new CREDUI_INFO();
credUiInfo.pszCaptionText = captionText;
credUiInfo.pszMessageText = messageText;
credUiInfo.hwndParent = IntPtr.Zero;
credUiInfo.hbmBanner = IntPtr.Zero;
credUiInfo.cbSize = Marshal.SizeOf(credUiInfo);
IntPtr ppAuthIdentity = IntPtr.Zero;
bool fSave = false;
string targetName = connUri.Host;
int result = SspiPromptForCredentials(targetName,
ref credUiInfo,
0,
NEGOSSP_NAME_W,
IntPtr.Zero,
ref ppAuthIdentity,
ref fSave,
1);
if (0 != result)
{
throw new System.InvalidOperationException(
string.Format(CultureInfo.InvariantCulture,
"SspiPromptForCredentials failed with error {0}", result));
}
StringBuilder pszUserName = new StringBuilder();
StringBuilder pszDomainName = new StringBuilder();
StringBuilder pszPassword = new StringBuilder();
result = SspiEncodeAuthIdentityAsStrings(ppAuthIdentity,
ref pszUserName,
ref pszDomainName,
ref pszPassword);
if (0 != result)
{
throw new System.InvalidOperationException(
string.Format(CultureInfo.InvariantCulture,
"SspiEncodeAuthIdentityAsStrings failed with error {0}", result));
}
System.Security.SecureString pwd = new System.Security.SecureString();
for (int i = 0; i < pszPassword.Length; i++)
{
pwd.AppendChar(pszPassword[i]);
}
string userName = null;
if (pszDomainName != null)
{
userName = string.Format(CultureInfo.InvariantCulture,
"{0}\\{1}", pszDomainName.ToString(), pszUserName.ToString());
}
else
{
userName = pszUserName.ToString();
}
PSCredential credToReturn = new PSCredential(userName, pwd);
return credToReturn;
}
///
///
///
///
/// A pointer to a null-terminated string that indicates the
/// service principal name (SPN) or the security context of the
/// destination server.
///
///
/// A pointer to a CREDUI_INFO structure that contains information
/// for customizing the appearance of the dialog box.
///
///
/// A Windows error code, defined in WinError.h, that is displayed in the dialog box.
/// If credentials previously collected were not valid, the caller uses this parameter
/// to pass the error message from the API that collected the credentials (for example, Winlogon)
/// to this function. The corresponding error message is formatted and displayed in the dialog box.
/// Set the value of this parameter to zero to display no error message.
///
///
/// contains the name of authentication package
///
///
///
///
/// A pointer to a Boolean value that, on input, specifies whether the Save check box is
/// selected in the dialog box that this function displays. On output, the value of this
/// parameter specifies whether the Save check box was selected when the user clicks the
/// Submit button in the dialog box. Set this parameter to NULL to ignore the Save check box.
///
/// This parameter is ignored if the CREDUIWIN_CHECKBOX flag is not set in the dwFlags parameter.
///
///
/// 1. SSPIPFC_CHECKBOX 0x1 -- If applications need to show the
/// checkbox to save credentials, the SSPIPFC_CHECKBOX should be set.
/// 2. SSPIPRFC_SAVE_CRED_BY_CALLER 0x2
/// By default, the credential provier() saves the credentials to Credman/KeyRing
/// with CRED_PERSIST_ENTERPRISE persistence(http://msdn2.microsoft.com/en-us/library/aa374788(VS.85).aspx),
/// but the caller can overrides this behavior by supplying SSPIPFC_SAVE_CRED_BY_CALLER.
/// When this flag is set, the credential provider does not save the credentials to credman/keyring.
///
///
[DllImport("credui", SetLastError = false, CharSet = CharSet.Unicode)]
private static extern int SspiPromptForCredentials(
string pszTargetName,
ref CREDUI_INFO pUiInfo,
int dwAuthError,
string pszPackage,
IntPtr pInputAuthIdentity,
ref IntPtr ppAuthIdentity,
ref bool pfSave,
int dwFlags);
[DllImport("sspicli", SetLastError = false, CharSet = CharSet.Unicode)]
private static extern int SspiEncodeAuthIdentityAsStrings(
IntPtr pAuthIdentity,
ref StringBuilder pszUserName,
ref StringBuilder pszDomainName,
ref StringBuilder pszPackedCredentialsString);
}
}
"@
######### END: PInvoke #####################################################################
function EnsureLiveIDCredentialTypeIsLoaded
{
if (!('Microsoft.PowerShell.Commands.GetLiveIDCredential' -as [type]))
{
# LiveIDCredential Type is not loaded. So load it using Add-Type
try
{
add-type -TypeDefinition $getLiveIDCredCode
}
catch
{
# We can ignore any TYPE_ALREADY_EXISTS exception
if ($error[0].FullyQualifiedErrorId -notmatch "TYPE_ALREADY_EXISTS")
{
throw
}
}
}
}
function Get-ExLiveIDCredential
{
[CmdletBinding()]
param(
[Parameter(Position=0)]
[string]$connectionUri
)
begin
{
EnsureLiveIDCredentialTypeIsLoaded
$captionText = "LiveID Credential";
$messageText = "Supply credentials for connecting to {0}" -f $connectionUri
[Microsoft.PowerShell.Commands.LiveIDCredential]::GetLiveIDCredential($captionText,$messageText,$connectionUri)
}
}
##########################################################################################################################
# SIG # Begin signature block
# MIIazQYJKoZIhvcNAQcCoIIavjCCGroCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUZtWie4cb/LSCKBSq55hefD06
# pE+gghWCMIIEwzCCA6ugAwIBAgITMwAAAEyh6E3MtHR7OwAAAAAATDANBgkqhkiG
# 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw
# HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTMxMTExMjIxMTMx
# WhcNMTUwMjExMjIxMTMxWjCBszELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp
# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
# b3JhdGlvbjENMAsGA1UECxMETU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNO
# OkMwRjQtMzA4Ni1ERUY4MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsdj6GwYrd6jk
# lF18D+Z6ppLuilQdpPmEdYWXzMtcltDXdS3ZCPtb0u4tJcY3PvWrfhpT5Ve+a+i/
# ypYK3EbxWh4+AtKy4CaOAGR7vjyT+FgyeYfSGl0jvJxRxA8Q+gRYtRZ2buy8xuW+
# /K2swUHbqs559RyymUGneiUr/6t4DVg6sV5Q3mRM4MoVKt+m6f6kZi9bEAkJJiHU
# Pw0vbdL4d5ADbN4UEqWM5zYf9IelsEEXb+NNdGbC/aJxRjVRzGsXUWP6FZSSml9L
# KLrmFkVJ6Sy1/ouHr/ylbUPcpjD6KSjvmw0sXIPeEo1qtNtx71wUWiojKP+BcFfx
# jAeaE9gqUwIDAQABo4IBCTCCAQUwHQYDVR0OBBYEFLkNrbNN9NqfGrInJlUNIETY
# mOL0MB8GA1UdIwQYMBaAFCM0+NlSRnAK7UD7dvuzK7DDNbMPMFQGA1UdHwRNMEsw
# SaBHoEWGQ2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3Rz
# L01pY3Jvc29mdFRpbWVTdGFtcFBDQS5jcmwwWAYIKwYBBQUHAQEETDBKMEgGCCsG
# AQUFBzAChjxodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jv
# c29mdFRpbWVTdGFtcFBDQS5jcnQwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJKoZI
# hvcNAQEFBQADggEBAAmKTgav6O2Czx0HftcqpyQLLa+aWyR/lHEMVYgkGlIVY+KQ
# TQVKmEqc++GnbWhVgrkp6mmpstXjDNrR1nolN3hnHAz72ylaGpc4KjlWRvs1gbnk
# PUZajuT8dTdYWUmLTts8FZ1zUkvreww6wi3Bs5tSLeA1xbnBV7PoPaE8RPIjFh4K
# qlk3J9CVUl6ofz9U8IHh3Jq9ZdV49vdMObvd4NY3DpGah4xz53FkUvc+A9jGzXK4
# NDSYW4zT9Qim63jGUaANDm/0azxAGmAWLKkGUp0cE5DObwIe6nucs/b4l2DyZdHR
# H4c6wXXwQo167Yxysnv7LIq0kUdU4i5pzBZUGlkwggTsMIID1KADAgECAhMzAAAA
# ymzVMhI1xOFVAAEAAADKMA0GCSqGSIb3DQEBBQUAMHkxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xIzAhBgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBMB4XDTE0MDQyMjE3MzkwMFoXDTE1MDcyMjE3MzkwMFowgYMxCzAJ
# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xDTALBgNVBAsTBE1PUFIx
# HjAcBgNVBAMTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIwDQYJKoZIhvcNAQEB
# BQADggEPADCCAQoCggEBAJZxXe0GRvqEy51bt0bHsOG0ETkDrbEVc2Cc66e2bho8
# P/9l4zTxpqUhXlaZbFjkkqEKXMLT3FIvDGWaIGFAUzGcbI8hfbr5/hNQUmCVOlu5
# WKV0YUGplOCtJk5MoZdwSSdefGfKTx5xhEa8HUu24g/FxifJB+Z6CqUXABlMcEU4
# LYG0UKrFZ9H6ebzFzKFym/QlNJj4VN8SOTgSL6RrpZp+x2LR3M/tPTT4ud81MLrs
# eTKp4amsVU1Mf0xWwxMLdvEH+cxHrPuI1VKlHij6PS3Pz4SYhnFlEc+FyQlEhuFv
# 57H8rEBEpamLIz+CSZ3VlllQE1kYc/9DDK0r1H8wQGcCAwEAAaOCAWAwggFcMBMG
# A1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBQfXuJdUI1Whr5KPM8E6KeHtcu/
# gzBRBgNVHREESjBIpEYwRDENMAsGA1UECxMETU9QUjEzMDEGA1UEBRMqMzE1OTUr
# YjQyMThmMTMtNmZjYS00OTBmLTljNDctM2ZjNTU3ZGZjNDQwMB8GA1UdIwQYMBaA
# FMsR6MrStBZYAck3LjMWFrlMmgofMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9j
# cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY0NvZFNpZ1BDQV8w
# OC0zMS0yMDEwLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6
# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljQ29kU2lnUENBXzA4LTMx
# LTIwMTAuY3J0MA0GCSqGSIb3DQEBBQUAA4IBAQB3XOvXkT3NvXuD2YWpsEOdc3wX
# yQ/tNtvHtSwbXvtUBTqDcUCBCaK3cSZe1n22bDvJql9dAxgqHSd+B+nFZR+1zw23
# VMcoOFqI53vBGbZWMrrizMuT269uD11E9dSw7xvVTsGvDu8gm/Lh/idd6MX/YfYZ
# 0igKIp3fzXCCnhhy2CPMeixD7v/qwODmHaqelzMAUm8HuNOIbN6kBjWnwlOGZRF3
# CY81WbnYhqgA/vgxfSz0jAWdwMHVd3Js6U1ZJoPxwrKIV5M1AHxQK7xZ/P4cKTiC
# 095Sl0UpGE6WW526Xxuj8SdQ6geV6G00DThX3DcoNZU6OJzU7WqFXQ4iEV57MIIF
# vDCCA6SgAwIBAgIKYTMmGgAAAAAAMTANBgkqhkiG9w0BAQUFADBfMRMwEQYKCZIm
# iZPyLGQBGRYDY29tMRkwFwYKCZImiZPyLGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQD
# EyRNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwHhcNMTAwODMx
# MjIxOTMyWhcNMjAwODMxMjIyOTMyWjB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBD
# QTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJyWVwZMGS/HZpgICBC
# mXZTbD4b1m/My/Hqa/6XFhDg3zp0gxq3L6Ay7P/ewkJOI9VyANs1VwqJyq4gSfTw
# aKxNS42lvXlLcZtHB9r9Jd+ddYjPqnNEf9eB2/O98jakyVxF3K+tPeAoaJcap6Vy
# c1bxF5Tk/TWUcqDWdl8ed0WDhTgW0HNbBbpnUo2lsmkv2hkL/pJ0KeJ2L1TdFDBZ
# +NKNYv3LyV9GMVC5JxPkQDDPcikQKCLHN049oDI9kM2hOAaFXE5WgigqBTK3S9dP
# Y+fSLWLxRT3nrAgA9kahntFbjCZT6HqqSvJGzzc8OJ60d1ylF56NyxGPVjzBrAlf
# A9MCAwEAAaOCAV4wggFaMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMsR6MrS
# tBZYAck3LjMWFrlMmgofMAsGA1UdDwQEAwIBhjASBgkrBgEEAYI3FQEEBQIDAQAB
# MCMGCSsGAQQBgjcVAgQWBBT90TFO0yaKleGYYDuoMW+mPLzYLTAZBgkrBgEEAYI3
# FAIEDB4KAFMAdQBiAEMAQTAfBgNVHSMEGDAWgBQOrIJgQFYnl+UlE/wq4QpTlVnk
# pDBQBgNVHR8ESTBHMEWgQ6BBhj9odHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtp
# L2NybC9wcm9kdWN0cy9taWNyb3NvZnRyb290Y2VydC5jcmwwVAYIKwYBBQUHAQEE
# SDBGMEQGCCsGAQUFBzAChjhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2Nl
# cnRzL01pY3Jvc29mdFJvb3RDZXJ0LmNydDANBgkqhkiG9w0BAQUFAAOCAgEAWTk+
# fyZGr+tvQLEytWrrDi9uqEn361917Uw7LddDrQv+y+ktMaMjzHxQmIAhXaw9L0y6
# oqhWnONwu7i0+Hm1SXL3PupBf8rhDBdpy6WcIC36C1DEVs0t40rSvHDnqA2iA6VW
# 4LiKS1fylUKc8fPv7uOGHzQ8uFaa8FMjhSqkghyT4pQHHfLiTviMocroE6WRTsgb
# 0o9ylSpxbZsa+BzwU9ZnzCL/XB3Nooy9J7J5Y1ZEolHN+emjWFbdmwJFRC9f9Nqu
# 1IIybvyklRPk62nnqaIsvsgrEA5ljpnb9aL6EiYJZTiU8XofSrvR4Vbo0HiWGFzJ
# NRZf3ZMdSY4tvq00RBzuEBUaAF3dNVshzpjHCe6FDoxPbQ4TTj18KUicctHzbMrB
# 7HCjV5JXfZSNoBtIA1r3z6NnCnSlNu0tLxfI5nI3EvRvsTxngvlSso0zFmUeDord
# EN5k9G/ORtTTF+l5xAS00/ss3x+KnqwK+xMnQK3k+eGpf0a7B2BHZWBATrBC7E7t
# s3Z52Ao0CW0cgDEf4g5U3eWh++VHEK1kmP9QFi58vwUheuKVQSdpw5OPlcmN2Jsh
# rg1cnPCiroZogwxqLbt2awAdlq3yFnv2FoMkuYjPaqhHMS+a3ONxPdcAfmJH0c6I
# ybgY+g5yjcGjPa8CQGr/aZuW4hCoELQ3UAjWwz0wggYHMIID76ADAgECAgphFmg0
# AAAAAAAcMA0GCSqGSIb3DQEBBQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAX
# BgoJkiaJk/IsZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290
# IENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0MDMx
# MzAzMDlaMHcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD
# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAf
# BgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcNAQEB
# BQADggEPADCCAQoCggEBAJ+hbLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP7tGn
# 0UytdDAgEesH1VSVFUmUG0KSrphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySHnfL0
# Zxws/HvniB3q506jocEjU8qN+kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUoRi4n
# rIZPVVIM5AMs+2qQkDBuh/NZMJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABKR2YR
# JylmqJfk0waBSqL5hKcRRxQJgp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSfrx54
# QTF3zJvfO4OToWECtR0Nsfz3m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGnMA8G
# A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMPMAsG
# A1UdDwQEAwIBhjAQBgkrBgEEAYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQOrIJg
# QFYnl+UlE/wq4QpTlVnkpKFjpGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZMBcG
# CgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJvb3Qg
# Q2VydGlmaWNhdGUgQXV0aG9yaXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1UdHwRJ
# MEcwRaBDoEGGP2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1
# Y3RzL21pY3Jvc29mdHJvb3RjZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYIKwYB
# BQUHMAKGOGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljcm9z
# b2Z0Um9vdENlcnQuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEB
# BQUAA4ICAQAQl4rDXANENt3ptK132855UU0BsS50cVttDBOrzr57j7gu1BKijG1i
# uFcCy04gE1CZ3XpA4le7r1iaHOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV3U+r
# kuTnjWrVgMHmlPIGL4UD6ZEqJCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5nGct
# xVEO6mJcPxaYiyA/4gcaMvnMMUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tOi3/F
# NSteo7/rvH0LQnvUU3Ih7jDKu3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbMUVbo
# nXCUbKw5TNT2eb+qGHpiKe+imyk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXjpKh0
# NbhOxXEjEiZ2CzxSjHFaRkMUvLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh0EPp
# K+m79EjMLNTYMoBMJipIJF9a6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLaxaj2J
# oXZhtG6hE6a/qkfwEm/9ijJssv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWwymO0
# eFQF1EEuUKyUsKV4q7OglnUa2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma7kng
# 9wFlb4kLfchpyOZu6qeXzjEp/w7FW1zYTRuh2Povnj8uVRZryROj/TGCBLUwggSx
# AgEBMIGQMHkxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD
# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xIzAh
# BgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBAhMzAAAAymzVMhI1xOFV
# AAEAAADKMAkGBSsOAwIaBQCggc4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw
# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFE8X
# odOBLqs/N2jHg1kG7fa6lE7IMG4GCisGAQQBgjcCAQwxYDBeoDaANABDAG8AbQBt
# AG8AbgBDAG8AbgBuAGUAYwB0AEYAdQBuAGMAdABpAG8AbgBzAC4AcABzADGhJIAi
# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL2V4Y2hhbmdlIDANBgkqhkiG9w0BAQEF
# AASCAQBlZjUC8FhdT4dtNjQZD3/43p3G5YsXIYJBeTi94zp58UAegR6B6MJawH/c
# BQAjX60w6/tdXJrT0QhrdccQ4XAtJbE5impjuG/ewATWiG6vx8eFC2jcd8jxIoQc
# /PEgHTa+2JQ8Mn1xyMRAy/mwl0zaBMfjFOiNymhX0djEmiwLGc2SXgFxTzp7Sbr0
# cZJdLr/gZ29vUQiIj6Ei/yN29x7BpRP7SvkMOmC+rdibq04jcDweluucz1NKqJDj
# tH1MRD9T+fj3fuan+JCcivJiVP6DPEHj61vOphvC/4Ns81aCyL3hCl+yWTLBlCr+
# Esr9l0+f6j17yyQngSik4LQvpj2EoYICKDCCAiQGCSqGSIb3DQEJBjGCAhUwggIR
# AgEBMIGOMHcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD
# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAf
# BgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQQITMwAAAEyh6E3MtHR7OwAA
# AAAATDAJBgUrDgMCGgUAoF0wGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkq
# hkiG9w0BCQUxDxcNMTQwODEzMDQ0MjIwWjAjBgkqhkiG9w0BCQQxFgQUx2aR8XWG
# XljiE31WFWaX565/PPQwDQYJKoZIhvcNAQEFBQAEggEAPytoBKXLWIEbY9JR1PDk
# zC6V5RAsKDz6N0hK6sMwp4qEyhZQs6/zQfhmy2YXd/CNHTpZ4vB0KbROevHVgDJO
# azho5m1+Jx9YcJ5UqDQ+0x2O9JbWOOzRrGFN/L102/y9+w7kuY8wvjwjDNT6Gpkn
# jkaCN7FpsLTa2x77sDrz2zknmDi2YLA98W+i2Ur/+SMNW+Ot0opoI0sKV6a8Kmnf
# G4LUDpEqJCrnngmctpKTFsaJN+oMQ+r2/BIzCz/H7GFsiL71TnksnOHZWAorY1Lm
# u0JhOO7M6RVYeRp9bvZuOrI92JPMlLbjddRbBKrvnWys3v7X6DWjoP2Br6AdahLh
# lA==
# SIG # End signature block