StoreBroker/Helpers.ps1
|
# Copyright (C) Microsoft Corporation. All rights reserved. function Initialize-HelpersGlobalVariables { <# .SYNOPSIS Initializes the global variables that are "owned" by the Helpers script file. .DESCRIPTION Initializes the global variables that are "owned" by the Helpers script file. Global variables are used sparingly to enables users a way to control certain extensibility points with this module. The Git repo for this module can be found here: http://aka.ms/StoreBroker .NOTES Internal-only helper method. The only reason this exists is so that we can leverage CodeAnalysis.SuppressMessageAttribute, which can only be applied to functions. Otherwise, we would have just had the relevant initialization code directly above the function that references the variable. We call this immediately after the declaration so that the variables are available for reference in any function below. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="We are initializing multiple variables.")] param() # We only set their values if they don't already have values defined. # We use -ErrorAction SilentlyContinue during the Get-Variable check since it throws an exception # by default if the variable we're getting doesn't exist, and we just want the bool result. if (!(Get-Variable -Name SBLoggingEnabled -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBLoggingEnabled = $true } # $Home relies on existence of $env:HOMEDRIVE and $env:HOMEPATH which are only # set when a user logged in interactively, which may not be the case for some build machines. # $env:USERPROFILE is the equivalent of $Home, and should always be available. if (!(Get-Variable -Name SBLogPath -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { if (-not [System.String]::IsNullOrEmpty($env:USERPROFILE)) { $global:SBLogPath = $(Join-Path $env:USERPROFILE "Documents\StoreBroker.log") } else { $global:SBLoggingEnabled = $false } } if (!(Get-Variable -Name SBNotifyDefaultDomain -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBNotifyDefaultDomain = $null } if (!(Get-Variable -Name SBNotifySmtpServer -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBNotifySmtpServer = $null } if (!(Get-Variable -Name SBNotifyDefaultFrom -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBNotifyDefaultFrom = $env:username } if (!(Get-Variable -Name SBNotifyCredential -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBNotifyCredential = [PSCredential]$null } if (!(Get-Variable -Name SBUseUTC -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBUseUTC = $false } if (!(Get-Variable -Name SBWebRequestTimeoutSec -Scope Global -ValueOnly -ErrorAction SilentlyContinue)) { $global:SBWebRequestTimeoutSec = 0 } } # We need to be sure to call this explicitly so that the global variables get initialized. Initialize-HelpersGlobalVariables function Wait-JobWithAnimation { <# .SYNOPSIS Waits for a background job to complete by showing a cursor and elapsed time. .DESCRIPTION Waits for a background job to complete by showing a cursor and elapsed time. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER jobName The name of the job that we are waiting to complete. .EXAMPLE Wait-JobWithAnimation Job1 Waits for a job named "Job1" to exit the "Running" state. While waiting, shows a waiting cursor and the elapsed time. .NOTES This is not a stand-in replacement for Wait-Job. It does not provide the full set of configuration options that Wait-Job does. #> [CmdletBinding()] Param( [Parameter(Mandatory)] [string] $JobName, [string] $Description = "" ) $animationFrames = '|','/','-','\' $framesPerSecond = 9 # We'll wrap the description (if provided) in brackets for display purposes. if ($Description -ne "") { $Description = "[$Description]" } $iteration = 0 while (((Get-Job -Name $JobName).state -eq 'Running')) { Write-InteractiveHost "`r$($animationFrames[$($iteration % $($animationFrames.Length))]) Elapsed: $([int]($iteration / $framesPerSecond)) second(s) $Description" -NoNewline -f Yellow Start-Sleep -Milliseconds ([int](1000/$framesPerSecond)) $iteration++ } if ((Get-Job -Name $JobName).state -eq 'Completed') { Write-InteractiveHost "`rDONE - Operation took $([int]($iteration / $framesPerSecond)) second(s) $Description" -NoNewline -f Green # We forcibly set Verbose to false here since we don't need it printed to the screen, since we just did above -- we just need to log it. Write-Log "DONE - Operation took $([int]($iteration / $framesPerSecond)) second(s) $Description" -Level Verbose -Verbose:$false } else { Write-InteractiveHost "`rDONE (FAILED) - Operation took $([int]($iteration / $framesPerSecond)) second(s) $Description" -NoNewline -f Red # We forcibly set Verbose to false here since we don't need it printed to the screen, since we just did above -- we just need to log it. Write-Log "DONE (FAILED) - Operation took $([int]($iteration / $framesPerSecond)) second(s) $Description" -Level Verbose -Verbose:$false } Write-InteractiveHost "" } function Format-SimpleTableString { <# .SYNOPSIS Gets a string representation of the provided object as a table, with some additional formatting applied to make it easier to append to existing string output. .DESCRIPTION Gets a string representation of the provided object as a table, with some additional formatting applied to make it easier to append to existing string output. Will remove any leading or trailing empty lines, and adds the ability to ident all of the content the indicated number of spaces. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Object The object to be formatted as a table. .PARAMETER IndentationLevel The number of spaces that this should be indented. Defaults to 0. .EXAMPLE Format-SimpleTableString @{"Name" = "Foo"; "Value" = "Bar"} Formats to a table with no indentation, and no leading or trailing empty lines. .EXAMPLE Format-SimpleTableString @{"Name" = "Foo"; "Value" = "Bar"} -IndentationLevel 5 Formats to a table with no leading or trailing empty lines, and every line is indented with 5 spaces. .EXAMPLE @{"Name" = "Foo"; "Value" = "Bar"} | Format-SimpleTableString Formats to a table with no indentation, and no leading or trailing empty lines. This works due to pipeline input. .INPUTS Hashtables (generally), but can also be arrays as well. .OUTPUTS System.String .NOTES Because this uses pipeline input, if you pass an array via $Object, PowerShell will unwrap it so that each element is processed individually. That doesn't work well when we're trying to then pass the array once again to Format-Table. So, we'll simply re-create an array from the individual elements, and then send that on to Format-Table. #> [CmdletBinding()] Param( [Parameter( ValueFromPipeline, Mandatory)] $Object, [ValidateRange(1,30)] [Int16] $IndentationLevel = 0 ) Begin { $objects = @() } Process { $objects += $Object } End { if ($objects.count -gt 0) { Write-Output "$(" " * $IndentationLevel)$(($objects | Format-Table | Out-String).TrimStart($([Environment]::NewLine)).TrimEnd([Environment]::NewLine).Replace([Environment]::NewLine, "$([Environment]::NewLine)$(" " * $IndentationLevel)"))" } } } function DeepCopy-Object <# .SYNOPSIS Creates a deep copy of a serializable object. .DESCRIPTION Creates a deep copy of a serializable object. By default, PowerShell performs shallow copies (simple references) when assigning objects from one variable to another. This will create full exact copies of the provided object so that they can be manipulated independently of each other, provided that the object being copied is serializable. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Object The object that is to be copied. This must be serializable or this will fail. .EXAMPLE $bar = DeepCopy-Object $foo Assuming that $foo is serializable, $bar will now be an exact copy of $foo, but any changes that you make to one will not affect the other. .RETURNS An exact copy of the PSObject that was just deep copied. #> { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseApprovedVerbs", "", Justification="Intentional. This isn't exported, and needed to be explicit relative to Copy-Object.")] param( [Parameter(Mandatory)] [PSCustomObject] $Object ) $memoryStream = New-Object System.IO.MemoryStream $binaryFormatter = New-Object System.Runtime.Serialization.Formatters.Binary.BinaryFormatter $binaryFormatter.Serialize($memoryStream, $Object) $memoryStream.Position = 0 $DeepCopiedObject = $binaryFormatter.Deserialize($memoryStream) $memoryStream.Close() return $DeepCopiedObject } function Get-SHA512Hash { <# .SYNOPSIS Gets the SHA512 hash of the requested string. .DESCRIPTION Gets the SHA512 hash of the requested string. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER PlainText The plain text that you want the SHA512 hash for. .EXAMPLE Get-SHA512Hash -PlainText "Hello World" Returns back the string "2C74FD17EDAFD80E8447B0D46741EE243B7EB74DD2149A0AB1B9246FB30382F27E853D8585719E0E67CBDA0DAA8F51671064615D645AE27ACB15BFB1447F459B" which represents the SHA512 hash of "Hello World" .OUTPUTS System.String - A SHA512 hash of the provided string #> [CmdletBinding()] param( [Parameter(Mandatory)] [AllowNull()] [AllowEmptyString()] [string] $PlainText ) $sha512= New-Object -TypeName System.Security.Cryptography.SHA512CryptoServiceProvider $utf8 = New-Object -TypeName System.Text.UTF8Encoding return [System.BitConverter]::ToString($sha512.ComputeHash($utf8.GetBytes($PlainText))) -replace '-', '' } function Get-EscapedJsonValue { <# .SYNOPSIS Escapes special characters within a string for use within a JSON value. .DESCRIPTION Escapes special characters within a string for use within a JSON value. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Value The string that needs to be escaped .EXAMPLE Get-EscapedJsonValue -Value 'This is my "quote". Look here: c:\windows\' Returns back the string 'This is my \"quote\". Look here: c:\\windows\\' .OUTPUTS System.String - A string with special characters escaped for use within JSON. .NOTES Normalizes newlines and carriage returns to always be \r\n. #> [CmdletBinding()] param( [Parameter( Mandatory, ValueFromPipeline)] [AllowNull()] [AllowEmptyString()] [string] $Value ) # The syntax of -replace is a bit confusing, so it's worth a note here. # The first parameter is a regular expression match pattern. The second parameter is a replacement string. # So, when we try to do "-replace '\\', '\\", that's matching a single backslash (which has to be # escaped within the match regular expression as a double-backslash), and replacing it with a # string containing literally two backslashes. # (And as a reminder, PowerShell's escape character is actually the backtick (`) and not backslash (\).) # \, ", <tab> $escaped = $Value -replace '\\', '\\' -replace '"', '\"' -replace '\t', '\t' # Now normalize actual CR's and LF's with their control codes. We'll ensure all variations are uniformly formatted as \r\n $escaped = $escaped -replace '\r\n', '\r\n' -replace '\r', '\r\n' -replace '\n', '\r\n' return $escaped } function ConvertTo-Array { <# .SYNOPSIS Converts a value (or pipeline input) into an array. .DESCRIPTION Converts a value (or pipeline input) into an array. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Value The value to convert into an array .EXAMPLE $foo = @{ "a" = 1; "b" = 2}; $foo.Keys | ConvertTo-Array Returns back an array of the keys (as opposed to a KeyCollection) .OUTPUTS [Object[]] #> param( [Parameter( Mandatory, ValueFromPipeline)] [Object] $Value ) Begin { $output = @(); } Process { $output += $_; } End { return ,$output; } } function Write-Log { <# .SYNOPSIS Writes logging information to screen and log file simultaneously. .DESCRIPTION Writes logging information to screen and log file simultaneously. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Message The message to be logged. .PARAMETER Level The type of message to be logged. .PARAMETER Indent The number of spaces to indent the line in the log file. .PARAMETER Path The log file path. Defaults to $env:USERPROFILE\Documents\StoreBroker.log .EXAMPLE Write-Log -Message "Everything worked." -Path C:\Debug.log Writes the message "It's all good!" to the screen as well as to a log file at "c:\Debug.log", with the caller's username and a date/time stamp prepended to the message. .EXAMPLE Write-Log -Message "There may be a problem..." -Level Warning -Indent 2 Writes the message "There may be a problem..." to the warning pipeline indented two spaces, as well as to the default log file with the caller's username and a date/time stamp prepended to the message. .INPUTS System.String .NOTES $global:SBLogPath indicates where the log file will be created. $global:SBLoggingEnabled determines if log entries will be made to the log file. If $false, log entries will ONLY go to the relevant output pipeline. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] param( [Parameter( Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()] [string] $Message, [ValidateSet('Error', 'Warning', 'Info', 'Verbose', 'Debug')] [string] $Level = 'Info', [ValidateRange(1, 30)] [Int16] $Indent = 0, [IO.FileInfo] $Path = "$global:SBLogPath" ) Process { $date = Get-Date $dateString = $date.ToString("yyyy-MM-dd HH:mm:ss") if ($global:SBUseUTC) { $dateString = $date.ToUniversalTime().ToString("yyyy-MM-dd HH:mm:ssZ") } $logFileMessage = '{0}{1} : {2} : {3} : {4}' -f (" " * $Indent), $dateString, $env:username, $Level.ToUpper(), $Message $consoleMessage = '{0}{1} : {2} : {3}' -f (" " * $Indent), $dateString, $env:username, $Message switch ($Level) { 'Error' { Write-Error $consoleMessage } 'Warning' { Write-Warning $consoleMessage } 'Verbose' { Write-Verbose $consoleMessage } 'Debug' { Write-Debug $consoleMessage } 'Info' { # We'd prefer to use Write-Information to enable users to redirect that pipe if # they want, unfortunately it's only available on v5 and above. We'll fallback to # using Write-Host for earlier versions (since we still need to support v4). if ($PSVersionTable.PSVersion.Major -ge 5) { Write-Information $consoleMessage -InformationAction Continue } else { Write-InteractiveHost $consoleMessage } } } try { if ($global:SBLoggingEnabled) { $logFileMessage | Out-File -FilePath $Path -Append } } catch { $output = @() $output += "Failed to add log entry to [$Path]. The error was: '$_'." if (Test-Path -Path $Path -PathType Leaf) { # The file exists, but likely is being held open by another process. # Let's do best effort here and if we can't log something, just report # it and move on. $output += "This is non-fatal, and your command will continue. Your log file will be missing this entry:" $output += $consoleMessage Write-Warning ($output -join [Environment]::NewLine) } else { # If the file doesn't exist and couldn't be created, it likely will never # be valid. In that instance, let's stop everything so that the user can # fix the problem, since they have indicated that they want this logging to # occur. throw ($output -join [Environment]::NewLine) } } } } function New-TemporaryDirectory { <# .SYNOPSIS Creates a new subdirectory within the users's temporary directory and returns the path. .DESCRIPTION Creates a new subdirectory within the users's temporary directory and returns the path. The Git repo for this module can be found here: http://aka.ms/StoreBroker .EXAMPLE New-TemporaryDirectory Creates a new directory with a GUID under $env:TEMP .OUTPUTS System.String - The path to the newly created temporary directory #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param() $guid = [System.GUID]::NewGuid() while (Test-Path -PathType Container (Join-Path -Path $env:TEMP -ChildPath $guid)) { $guid = [System.GUID]::NewGuid() } $tempFolderPath = Join-Path -Path $env:TEMP -ChildPath $guid Write-Log "Creating temporary directory: $tempFolderPath" -Level Verbose New-Item -ItemType directory -Path $tempFolderPath } function Send-SBMailMessage { <# .SYNOPSIS Sends an email message. .DESCRIPTION A StoreBroker wrapper around Send-MailMessage. This will automatically CC the sender if they aren't in the receipient list already. This will automatically add a default domain name to any incomplete email address. Users can configure a number of global variables to change the behavior of this method. These variables are given default values upon module load $global:SBNotifyDefaultDomain - The default domain name to append to any incomplete email address [defaults to $null] $global:SBNotifyDefaultFrom - The default sender's email address [defaults to the logged-in user's username] $global:SBNotifySmtpServer - The SMTP Server to be used [defaults to $null] $global:SBNotifyCredential - The credentials needed to send mail through that SMTP Server [defaults to $null] The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Subject The subject of the email message. .PARAMETER Body The body of the email message. .PARAMETER To This can be a single email address, or a list of email address to send the email to. .EXAMPLE Send-SBMailMessage -Subject "Test" -Body "Hello" Assuming the user hasn't modified the global SBNotify* global variables, this will send a new email message with the subject "Test" and body "Hello" from $($env:username)@microsoft.com, and To that same email address, using Microsoft's internal SMTP server that doesn't require additional authentication information beyond logged-in user domain credentials. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] param( [string] $Subject, [string] $Body, [string[]] $To = $global:SBNotifyDefaultFrom ) # Normalize all the "To" email addresses and make sure that they have a domain name attached to them $fixedTo = @() $To | ForEach-Object { if ($_ -like "*@*") { $fixedTo += $_ } else { $fixedTo += "$_@$global:SBNotifyDefaultDomain" } } # Do the same for the "From" email address $fixedFrom = $global:SBNotifyDefaultFrom if ($fixedFrom -notlike "*@*") { $fixedFrom = "$fixedFrom@$global:SBNotifyDefaultDomain" } $params = @{} $params.Add("To", $fixedTo) $params.Add("From", $fixedFrom) $params.Add("Subject", $Subject) $params.Add("Body", $Body) $params.Add("SmtpServer", $global:SBNotifySmtpServer) # We'll always CC the sender if they're not already sending the mail to themselves if (-not $fixedTo.Contains($fixedFrom)) { $params.Add("CC", $fixedFrom) } # Only add the Credential if the user had to specify it if ($null -ne $global:SBNotifyCredential) { $params.Add("Credential", $global:SBNotifyCredential) } if ($PSCmdlet.ShouldProcess($Params, "Send-MailMessage")) { $maxRetries = 5; # Some SMTP servers are flakey, so we'll allow for retrying on failure. $retryBackoffSeconds = 30; # When we do retry, how much time will we wait before trying again? $remainingAttempts = $maxRetries while ($remainingAttempts -gt 0) { $remainingAttempts-- Write-Log "Sending email to $($fixedTo -join ', ')" -Level Verbose try { Send-MailMessage @Params $remainingAttempts = 0 } catch { if ($remainingAttempts -gt 0) { Write-Log "Exception trying to send mail: $($_.Exception.Message). Will try again in $retryBackoffSeconds seconds." -Level Warning Start-Sleep -Seconds $retryBackoffSeconds } else { Write-Log "Exception trying to send mail: $($_.Exception.Message). Retry attempts exhausted. Unable to send email." -Level Error } } } } } function Write-InteractiveHost { <# .SYNOPSIS Forwards to Write-Host only if the host is interactive, else does nothing. .DESCRIPTION A proxy function around Write-Host that detects if the host is interactive before calling Write-Host. Use this instead of Write-Host to avoid failures in non-interactive hosts. The Git repo for this module can be found here: http://aka.ms/StoreBroker .EXAMPLE Write-InteractiveHost "Test" Write-InteractiveHost "Test" -NoNewline -f Yellow .NOTES Boilerplate is generated using these commands: # $Metadata = New-Object System.Management.Automation.CommandMetaData (Get-Command Write-Host) # [System.Management.Automation.ProxyCommand]::Create($Metadata) | Out-File temp #> [CmdletBinding( HelpUri='http://go.microsoft.com/fwlink/?LinkID=113426', RemotingCapability='None')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingWriteHost", "", Justification="This provides a wrapper around Write-Host. In general, we'd like to use Write-Information, but it's not supported on PS 4.0 which we need to support.")] param( [Parameter( Position=0, ValueFromPipeline, ValueFromRemainingArguments)] [System.Object] $Object, [switch] $NoNewline, [System.Object] $Separator, [System.ConsoleColor] $ForegroundColor, [System.ConsoleColor] $BackgroundColor ) # Determine if the host is interactive if ([Environment]::UserInteractive -and `  -like '-noni*') -and ` (Get-Host).Name -ne 'Default Host') { # Special handling for OutBuffer (generated for the proxy function) $outBuffer = $null if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) { $PSBoundParameters['OutBuffer'] = 1 } Write-Host @PSBoundParameters } } function Resolve-UnverifiedPath { <# .SYNOPSIS A wrapper around Resolve-Path that works for paths that exist as well as for paths that don't (Resolve-Path normally throws an exception if the path doesn't exist.) .DESCRIPTION A wrapper around Resolve-Path that works for paths that exist as well as for paths that don't (Resolve-Path normally throws an exception if the path doesn't exist.) The Git repo for this module can be found here: https://aka.ms/StoreBroker .EXAMPLE Resolve-UnverifiedPath -Path 'c:\windows\notepad.exe' Returns the string 'c:\windows\notepad.exe'. .EXAMPLE Resolve-UnverifiedPath -Path '..\notepad.exe' Returns the string 'c:\windows\notepad.exe', assuming that it's executed from within 'c:\windows\system32' or some other sub-directory. .EXAMPLE Resolve-UnverifiedPath -Path '..\foo.exe' Returns the string 'c:\windows\foo.exe', assuming that it's executed from within 'c:\windows\system32' or some other sub-directory, even though this file doesn't exist. .OUTPUTS [string] - The fully resolved path #> [CmdletBinding()] param( [Parameter( Position=0, ValueFromPipeline)] [string] $Path ) $resolvedPath = Resolve-Path -Path $Path -ErrorVariable resolvePathError -ErrorAction SilentlyContinue if ($null -eq $resolvedPath) { return $resolvePathError[0].TargetObject } else { return $resolvedPath.ProviderPath } } # SIG # Begin signature block # MIIa1AYJKoZIhvcNAQcCoIIaxTCCGsECAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUqwqxib8OWIRnDJwRmVOS48I0 # sqSgghWDMIIEwzCCA6ugAwIBAgITMwAAAMp9MhZ8fv0FAwAAAAAAyjANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTYwOTA3MTc1ODU1 # WhcNMTgwOTA3MTc1ODU1WjCBszELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjENMAsGA1UECxMETU9QUjEnMCUGA1UECxMebkNpcGhlciBEU0UgRVNO # OjcyOEQtQzQ1Ri1GOUVCMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT # ZXJ2aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj3CeDl2ll7S4 # 96ityzOt4bkPI1FucwjpTvklJZLOYljFyIGs/LLi6HyH+Czg8Xd/oDQYFzmJTWac # A0flGdvk8Yj5OLMEH4yPFFgQsZA5Wfnz/Cg5WYR2gmsFRUFELCyCbO58DvzOQQt1 # k/tsTJ5Ns5DfgCb5e31m95yiI44v23FVpKnTY9CUJbIr8j28O3biAhrvrVxI57GZ # nzkUM8GPQ03o0NGCY1UEpe7UjY22XL2Uq816r0jnKtErcNqIgglXIurJF9QFJrvw # uvMbRjeTBTCt5o12D4b7a7oFmQEDgg+koAY5TX+ZcLVksdgPNwbidprgEfPykXiG # ATSQlFCEXwIDAQABo4IBCTCCAQUwHQYDVR0OBBYEFGb30hxaE8ox6QInbJZnmt6n # G7LKMB8GA1UdIwQYMBaAFCM0+NlSRnAK7UD7dvuzK7DDNbMPMFQGA1UdHwRNMEsw # SaBHoEWGQ2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3Rz # L01pY3Jvc29mdFRpbWVTdGFtcFBDQS5jcmwwWAYIKwYBBQUHAQEETDBKMEgGCCsG # AQUFBzAChjxodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jv # c29mdFRpbWVTdGFtcFBDQS5jcnQwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJKoZI # hvcNAQEFBQADggEBAGyg/1zQebvX564G4LsdYjFr9ptnqO4KaD0lnYBECEjMqdBM # 4t+rNhN38qGgERoc+ns5QEGrrtcIW30dvMvtGaeQww5sFcAonUCOs3OHR05QII6R # XYbxtAMyniTUPwacJiiCSeA06tLg1bebsrIY569mRQHSOgqzaO52EzJlOtdLrGDk # Ot1/eu8E2zN9/xetZm16wLJVCJMb3MKosVFjFZ7OlClFTPk6rGyN9jfbKKDsDtNr # jfAiZGVhxrEqMiYkj4S4OyvJ2uhw/ap7dbotTCfZu1yO57SU8rE06K6j8zWB5L9u # DmtgcqXg3ckGvdmWVWBrcWgnmqNMYgX50XSzffQwggTtMIID1aADAgECAhMzAAAB # QJap7nBW/swHAAEAAAFAMA0GCSqGSIb3DQEBBQUAMHkxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xIzAhBgNVBAMTGk1pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBMB4XDTE2MDgxODIwMTcxN1oXDTE3MTEwMjIwMTcxN1owgYMxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xDTALBgNVBAsTBE1PUFIx # HjAcBgNVBAMTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIwDQYJKoZIhvcNAQEB # BQADggEPADCCAQoCggEBANtLi+kDal/IG10KBTnk1Q6S0MThi+ikDQUZWMA81ynd # ibdobkuffryavVSGOanxODUW5h2s+65r3Akw77ge32z4SppVl0jII4mzWSc0vZUx # R5wPzkA1Mjf+6fNPpBqks3m8gJs/JJjE0W/Vf+dDjeTc8tLmrmbtBDohlKZX3APb # LMYb/ys5qF2/Vf7dSd9UBZSrM9+kfTGmTb1WzxYxaD+Eaxxt8+7VMIruZRuetwgc # KX6TvfJ9QnY4ItR7fPS4uXGew5T0goY1gqZ0vQIz+lSGhaMlvqqJXuI5XyZBmBre # ueZGhXi7UTICR+zk+R+9BFF15hKbduuFlxQiCqET92ECAwEAAaOCAWEwggFdMBMG # A1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBSc5ehtgleuNyTe6l6pxF+QHc7Z # ezBSBgNVHREESzBJpEcwRTENMAsGA1UECxMETU9QUjE0MDIGA1UEBRMrMjI5ODAz # K2Y3ODViMWMwLTVkOWYtNDMxNi04ZDZhLTc0YWU2NDJkZGUxYzAfBgNVHSMEGDAW # gBTLEejK0rQWWAHJNy4zFha5TJoKHzBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8v # Y3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNDb2RTaWdQQ0Ff # MDgtMzEtMjAxMC5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRw # Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY0NvZFNpZ1BDQV8wOC0z # MS0yMDEwLmNydDANBgkqhkiG9w0BAQUFAAOCAQEAa+RW49cTHSBA+W3p3k7bXR7G # bCaj9+UJgAz/V+G01Nn5XEjhBn/CpFS4lnr1jcmDEwxxv/j8uy7MFXPzAGtOJar0 # xApylFKfd00pkygIMRbZ3250q8ToThWxmQVEThpJSSysee6/hU+EbkfvvtjSi0lp # DimD9aW9oxshraKlPpAgnPWfEj16WXVk79qjhYQyEgICamR3AaY5mLPuoihJbKwk # Mig+qItmLPsC2IMvI5KR91dl/6TV6VEIlPbW/cDVwCBF/UNJT3nuZBl/YE7ixMpT # Th/7WpENW80kg3xz6MlCdxJfMSbJsM5TimFU98KNcpnxxbYdfqqQhAQ6l3mtYDCC # BbwwggOkoAMCAQICCmEzJhoAAAAAADEwDQYJKoZIhvcNAQEFBQAwXzETMBEGCgmS # JomT8ixkARkWA2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UE # AxMkTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTEwMDgz # MTIyMTkzMloXDTIwMDgzMTIyMjkzMloweTELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEjMCEGA1UEAxMaTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ # Q0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCycllcGTBkvx2aYCAg # Qpl2U2w+G9ZvzMvx6mv+lxYQ4N86dIMaty+gMuz/3sJCTiPVcgDbNVcKicquIEn0 # 8GisTUuNpb15S3GbRwfa/SXfnXWIz6pzRH/XgdvzvfI2pMlcRdyvrT3gKGiXGqel # cnNW8ReU5P01lHKg1nZfHndFg4U4FtBzWwW6Z1KNpbJpL9oZC/6SdCnidi9U3RQw # WfjSjWL9y8lfRjFQuScT5EAwz3IpECgixzdOPaAyPZDNoTgGhVxOVoIoKgUyt0vX # T2Pn0i1i8UU956wIAPZGoZ7RW4wmU+h6qkryRs83PDietHdcpReejcsRj1Y8wawJ # XwPTAgMBAAGjggFeMIIBWjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTLEejK # 0rQWWAHJNy4zFha5TJoKHzALBgNVHQ8EBAMCAYYwEgYJKwYBBAGCNxUBBAUCAwEA # ATAjBgkrBgEEAYI3FQIEFgQU/dExTtMmipXhmGA7qDFvpjy82C0wGQYJKwYBBAGC # NxQCBAweCgBTAHUAYgBDAEEwHwYDVR0jBBgwFoAUDqyCYEBWJ5flJRP8KuEKU5VZ # 5KQwUAYDVR0fBEkwRzBFoEOgQYY/aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br # aS9jcmwvcHJvZHVjdHMvbWljcm9zb2Z0cm9vdGNlcnQuY3JsMFQGCCsGAQUFBwEB # BEgwRjBEBggrBgEFBQcwAoY4aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9j # ZXJ0cy9NaWNyb3NvZnRSb290Q2VydC5jcnQwDQYJKoZIhvcNAQEFBQADggIBAFk5 # Pn8mRq/rb0CxMrVq6w4vbqhJ9+tfde1MOy3XQ60L/svpLTGjI8x8UJiAIV2sPS9M # uqKoVpzjcLu4tPh5tUly9z7qQX/K4QwXaculnCAt+gtQxFbNLeNK0rxw56gNogOl # VuC4iktX8pVCnPHz7+7jhh80PLhWmvBTI4UqpIIck+KUBx3y4k74jKHK6BOlkU7I # G9KPcpUqcW2bGvgc8FPWZ8wi/1wdzaKMvSeyeWNWRKJRzfnpo1hW3ZsCRUQvX/Ta # rtSCMm78pJUT5Otp56miLL7IKxAOZY6Z2/Wi+hImCWU4lPF6H0q70eFW6NB4lhhc # yTUWX92THUmOLb6tNEQc7hAVGgBd3TVbIc6YxwnuhQ6MT20OE049fClInHLR82zK # wexwo1eSV32UjaAbSANa98+jZwp0pTbtLS8XyOZyNxL0b7E8Z4L5UrKNMxZlHg6K # 3RDeZPRvzkbU0xfpecQEtNP7LN8fip6sCvsTJ0Ct5PnhqX9GuwdgR2VgQE6wQuxO # 7bN2edgKNAltHIAxH+IOVN3lofvlRxCtZJj/UBYufL8FIXrilUEnacOTj5XJjdib # Ia4NXJzwoq6GaIMMai27dmsAHZat8hZ79haDJLmIz2qoRzEvmtzjcT3XAH5iR9HO # iMm4GPoOco3Boz2vAkBq/2mbluIQqBC0N1AI1sM9MIIGBzCCA++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/0xggS7MIIE # twIBATCBkDB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMw # IQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQQITMwAAAUCWqe5wVv7M # BwABAAABQDAJBgUrDgMCGgUAoIHUMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEE # MBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBQC # ISZ4RObExwKbG8j04oX3xNnXVjB0BgorBgEEAYI3AgEMMWYwZKAigCAARQBuAGcA # RgB1AG4AUwBpAG0AcABsAGUAUwBpAGcAbqE+gDxodHRwOi8vZWR3ZWIvc2l0ZXMv # SVNTRW5naW5lZXJpbmcvRW5nRnVuL1NpdGVQYWdlcy9Ib21lLmFzcHgwDQYJKoZI # hvcNAQEBBQAEggEAberA++IbjdofRSZcDuq4evPEJ6PCxGLAuzH0wnmL3B6Tyyfb # X+oOp3fQlfjV1QEhH6q424F8VZa9guy2H09xprOla9uJ4MYQel9tX+ZOZm10tti5 # EdhdpnaLdfQlGo44hxTXwgCPmnsFmO56aszEu/kQoU62q1nDWUrtmURaUQR3kGI0 # MKOsi9gYQuJZ2VLmufp32gnEc/qs16napw4GwRCsshdOxuuL+1/jNpxWX7TWqAWe # GXSIWDnOFp/BxZ1msql/UKaw4n0Fw7hnwjApYRk4odfzf3RHxhHPSjqkivXK4Iyq # wbm1Ke5pJsFAXqP4tUlBXiOwwcd4pQitQ+U/KaGCAigwggIkBgkqhkiG9w0BCQYx # ggIVMIICEQIBATCBjjB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv # bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0 # aW9uMSEwHwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0ECEzMAAADKfTIW # fH79BQMAAAAAAMowCQYFKw4DAhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0B # BwEwHAYJKoZIhvcNAQkFMQ8XDTE3MDUwMjIzMTUwMFowIwYJKoZIhvcNAQkEMRYE # FGM+mrOdsRzfY8Z4XTXbHWkzNOk+MA0GCSqGSIb3DQEBBQUABIIBAArCvXyi1ef9 # gVIqpTJGspp1AWcmHiEJFz3nHyDni4kgzOA6mQwA9fuDG/F6GkZk57YnE7kOv4DS # 8dFWiY8DMUIWU+2N7lOLZ4brv2pFbECutOScIOtKeh6KxYUv1X31FTlVys6cLGRe # xu1vvxeDPZXvKBQzNdfFsjnHV/mlGLu81sgTdNZ72t56eTLhE4MVJTfn1KmGwjUw # Bfm9PvfwLG7M5+7sie3khFhxiAEmgrvD+Eks2Gh4Lg9bKFuUtLrCIFn8qj5ZvvM2 # WFhWN5REy5oL4cGDxw1qJbE70VYBsyEUeRUllZP9Iqtm0O5Ql5orDmAGk3fSOG2i # pkgUJ7pijzc= # SIG # End signature block |