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.")] # Note, this doesn't currently work due to https://github.com/PowerShell/PSScriptAnalyzer/issues/698 [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseDeclaredVarsMoreThanAssignment", "", Justification="These are global variables and so are used elsewhere.")] param() # We only set their values if they don't already have values defined. # We use -ErrorAction Ignore 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. # SilentlyContinue would cause it to go into the global $Error array, Ignore prevents that as well. if (!(Get-Variable -Name SBLoggingEnabled -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBLoggingEnabled = $true } if (!(Get-Variable -Name SBLogPath -Scope Global -ValueOnly -ErrorAction Ignore)) { $documentsFolder = [System.Environment]::GetFolderPath('MyDocuments') if (-not [System.String]::IsNullOrEmpty($documentsFolder)) { $global:SBLogPath = Join-Path -Path $documentsFolder -ChildPath 'StoreBroker.log' } else { $global:SBLoggingEnabled = $false } } if (!(Get-Variable -Name SBShouldLogPid -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBShouldLogPid = $false } if (!(Get-Variable -Name SBNotifyDefaultDomain -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBNotifyDefaultDomain = $null } if (!(Get-Variable -Name SBNotifySmtpServer -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBNotifySmtpServer = $null } if (!(Get-Variable -Name SBNotifyDefaultFrom -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBNotifyDefaultFrom = $env:username } if (!(Get-Variable -Name SBNotifyCredential -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBNotifyCredential = [PSCredential]$null } if (!(Get-Variable -Name SBUseUTC -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBUseUTC = $false } if (!(Get-Variable -Name SBWebRequestTimeoutSec -Scope Global -ValueOnly -ErrorAction Ignore)) { $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 -Message "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 -Message "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 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(s) to be logged. Each element of the array will be written to a separate line. This parameter supports pipelining but there are no performance benefits to doing so. For more information, see the .NOTES for this cmdlet. .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 .PARAMETER Exception If present, the exception information will be logged after the messages provided. The actual string that is logged is obtained by passing this object to Out-String. .EXAMPLE Write-Log -Message "Everything worked." -Path C:\Debug.log Writes the message "Everything worked." 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 ("Everything worked.", "No cause for alarm.") -Path C:\Debug.log Writes the following message 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: Everything worked. No cause for alarm. .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. .EXAMPLE try { $null.Do() } catch { Write-Log -Message ("There was a problem.", "Here is the exception information:") -Exception $_ -Level Error } Logs the message: Write-Log : 2018-01-23 12:57:37 : dabelc : There was a problem. Here is the exception information: You cannot call a method on a null-valued expression. At line:1 char:7 + try { $null.Do() } catch { Write-Log -Message ("There was a problem." ... + ~~~~~~~~~~ + CategoryInfo : InvalidOperation: (:) [], RuntimeException + FullyQualifiedErrorId : InvokeMethodOnNull .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. Note that, although this function supports pipeline input to the -Message parameter, there is NO performance benefit to using the pipeline. This is because the pipeline input is simply accumulated and not acted upon until all input has been received. This behavior is intentional, in order for a statement like: "Multiple", "messages" | Write-Log -Exception $ex -Level Error to make sense. In this case, the cmdlet should accumulate the messages and, at the end, include the exception information. #> [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(ValueFromPipeline)] [AllowEmptyCollection()] [AllowEmptyString()] [AllowNull()] [string[]] $Message = @(), [ValidateSet('Error', 'Warning', 'Info', 'Verbose', 'Debug')] [string] $Level = 'Info', [ValidateRange(1, 30)] [Int16] $Indent = 0, [IO.FileInfo] $Path = "$global:SBLogPath", [System.Management.Automation.ErrorRecord] $Exception ) Begin { # Accumulate the list of Messages, whether by pipeline or parameter. $messages = @() } Process { foreach ($m in $Message) { $messages += $m } } End { if ($null -ne $Exception) { # If we have an exception, add it after the accumulated messages. $messages += Out-String -InputObject $Exception } elseif ($messages.Count -eq 0) { # If no exception and no messages, we should early return. return } # Finalize the string to be logged. $finalMessage = $messages -join [Environment]::NewLine # Build the console and log-specific messages. $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") } $consoleMessage = '{0}{1} : {2} : {3}' -f (" " * $Indent), $dateString, $env:username, $finalMessage if ($global:SBShouldLogPid) { $maxPidDigits = 10 # This is an estimate (see https://stackoverflow.com/questions/17868218/what-is-the-maximum-process-id-on-windows) $pidColumnLength = $maxPidDigits + "[]".Length $logFileMessage = "{0}{1} : {2, -$pidColumnLength} : {3} : {4} : {5}" -f (" " * $Indent), $dateString, "[$global:PID]", $env:username, $Level.ToUpper(), $finalMessage } else { $logFileMessage = '{0}{1} : {2} : {3} : {4}' -f (" " * $Indent), $dateString, $env:username, $Level.ToUpper(), $finalMessage } # Write the message to screen/log. # Note that the below logic could easily be moved to a separate helper function, but a concious # decision was made to leave it here. When this cmdlet is called with -Level Error, Write-Error # will generate a WriteErrorException with the origin being Write-Log. If this call is moved to # a helper function, the origin of the WriteErrorException will be the helper function, which # could confuse an end user. 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:" $output += Out-String -InputObject $_ 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 -Message "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 -Message "Sending email to $($fixedTo -join ', ')" -Level Verbose try { Send-MailMessage @Params $remainingAttempts = 0 } catch { if ($remainingAttempts -gt 0) { Write-Log -Message "Exception trying to send mail. Will try again in $retryBackoffSeconds seconds." -Exception $_ -Level Warning Start-Sleep -Seconds $retryBackoffSeconds } else { Write-Log -Message "Exception trying to send mail. Retry attempts exhausted. Unable to send email." -Exception $_ -Level Error } } } } } $script:alwaysRedactParametersForLogging = @( 'AccessToken' # Would be a security issue ) $script:alwaysExcludeParametersForLogging = @( 'NoStatus' ) function Write-InvocationLog { <# .SYNOPSIS Writes a log entry for the invoke command. .DESCRIPTION Writes a log entry for the invoke command. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER InvocationInfo The '$MyInvocation' object from the calling function. No need to explicitly provide this if you're trying to log the immediate function this is being called from. .PARAMETER RedactParameter An optional array of parameter names that should be logged, but their values redacted. .PARAMETER ExcludeParameter An optional array of parameter names that should simply not be logged. .EXAMPLE Write-InvocationLog -Invocation $MyInvocation .EXAMPLE Write-InvocationLog -Invocation $MyInvocation -ExcludeParameter @('Properties', 'Metrics') .NOTES The actual invocation line will not be _completely_ accurate as converted parameters will be in JSON format as opposed to PowerShell format. However, it should be sufficient enough for debugging purposes. ExcludeParamater will always take precedence over RedactParameter. #> [CmdletBinding(SupportsShouldProcess)] param( [Management.Automation.InvocationInfo] $Invocation = (Get-Variable -Name MyInvocation -Scope 1 -ValueOnly), [string[]] $RedactParameter, [string[]] $ExcludeParameter ) $jsonConversionDepth = 20 # Seems like it should be more than sufficient # Build up the invoked line, being sure to exclude and/or redact any values necessary $params = @() foreach ($param in $Invocation.BoundParameters.GetEnumerator()) { if ($param.Key -in ($script:alwaysExcludeParametersForLogging + $ExcludeParameter)) { continue } if ($param.Key -in ($script:alwaysRedactParametersForLogging + $RedactParameter)) { $params += "-$($param.Key) <redacted>" } else { if ($param.Value -is [switch]) { $params += "-$($param.Key):`$$($param.Value.ToBool().ToString().ToLower())" } else { $params += "-$($param.Key) $($param.Value | ConvertTo-Json -Depth $jsonConversionDepth -Compress)" } } } Write-Log -Message "[$($Invocation.MyCommand.Module.Version)] Executing: $($Invocation.MyCommand) $($params -join ' ')" -Level Verbose } 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 } } function Ensure-Directory { <# .SYNOPSIS A utility function for ensuring a given directory exists. .DESCRIPTION A utility function for ensuring a given directory exists. If the directory does not already exist, it will be created. .PARAMETER Path A full or relative path to the directory that should exist when the function exits. .NOTES Uses the Resolve-UnverifiedPath function to resolve relative paths. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseApprovedVerbs", "", Justification = "Unable to find a standard verb that satisfies describing the purpose of this internal helper method.")] param( [Parameter(Mandatory)] [string] $Path ) try { $Path = Resolve-UnverifiedPath -Path $Path if (-not (Test-Path -PathType Container -Path $Path)) { Write-Log -Message "Creating directory: [$Path]" -Level Verbose New-Item -ItemType Directory -Path $Path | Out-Null } } catch { Write-Log -Message "Could not ensure directory: [$Path]" -Level Error throw } } function Get-HttpWebResponseContent { <# .SYNOPSIS Returns the content that may be contained within an HttpWebResponse object. .DESCRIPTION Returns the content that may be contained within an HttpWebResponse object. This would commonly be used when trying to get the potential content returned within a failing WebResponse. Normally, when you call Invoke-WebRequest, it returns back a BasicHtmlWebResponseObject which directly contains a Content property, however if the web request fails, you get a WebException which contains a simpler WebResponse, which requires a bit more effort in order to acccess the raw response content. .PARAMETER WebResponse An HttpWebResponse object, typically the Response property on a WebException. .OUTPUTS System.String - The raw content that was included in a WebResponse; $null otherwise. #> [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory)] [System.Net.HttpWebResponse] $WebResponse ) $streamReader = $null try { $content = $null if (($null -ne $WebResponse) -and ($WebResponse.ContentLength -gt 0)) { $stream = $WebResponse.GetResponseStream() $encoding = [System.Text.Encoding]::UTF8 if (-not [String]::IsNullOrWhiteSpace($WebResponse.ContentEncoding)) { $encoding = [System.Text.Encoding]::GetEncoding($WebResponse.ContentEncoding) } $streamReader = New-Object -TypeName System.IO.StreamReader -ArgumentList ($stream, $encoding) $content = $streamReader.ReadToEnd() } return $content } finally { if ($null -ne $streamReader) { $streamReader.Close() } } } # SIG # Begin signature block # MIIjkgYJKoZIhvcNAQcCoIIjgzCCI38CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCA1kDFQJefJaK6x # fnbadxvforiRBeMXtYft1K4EqJp1W6CCDYEwggX/MIID56ADAgECAhMzAAABh3IX # chVZQMcJAAAAAAGHMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ3WhcNMjEwMzAzMTgzOTQ3WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOt8kLc7P3T7MKIhouYHewMFmnq8Ayu7FOhZCQabVwBp2VS4WyB2Qe4TQBT8aB # znANDEPjHKNdPT8Xz5cNali6XHefS8i/WXtF0vSsP8NEv6mBHuA2p1fw2wB/F0dH # sJ3GfZ5c0sPJjklsiYqPw59xJ54kM91IOgiO2OUzjNAljPibjCWfH7UzQ1TPHc4d # weils8GEIrbBRb7IWwiObL12jWT4Yh71NQgvJ9Fn6+UhD9x2uk3dLj84vwt1NuFQ # itKJxIV0fVsRNR3abQVOLqpDugbr0SzNL6o8xzOHL5OXiGGwg6ekiXA1/2XXY7yV # Fc39tledDtZjSjNbex1zzwSXAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhov4ZyO96axkJdMjpzu2zVXOJcsw # UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1 # ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU4Mzg1MB8GA1UdIwQYMBaAFEhu # ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w # Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAixmy # S6E6vprWD9KFNIB9G5zyMuIjZAOuUJ1EK/Vlg6Fb3ZHXjjUwATKIcXbFuFC6Wr4K # NrU4DY/sBVqmab5AC/je3bpUpjtxpEyqUqtPc30wEg/rO9vmKmqKoLPT37svc2NV # BmGNl+85qO4fV/w7Cx7J0Bbqk19KcRNdjt6eKoTnTPHBHlVHQIHZpMxacbFOAkJr # qAVkYZdz7ikNXTxV+GRb36tC4ByMNxE2DF7vFdvaiZP0CVZ5ByJ2gAhXMdK9+usx # zVk913qKde1OAuWdv+rndqkAIm8fUlRnr4saSCg7cIbUwCCf116wUJ7EuJDg0vHe # yhnCeHnBbyH3RZkHEi2ofmfgnFISJZDdMAeVZGVOh20Jp50XBzqokpPzeZ6zc1/g # yILNyiVgE+RPkjnUQshd1f1PMgn3tns2Cz7bJiVUaqEO3n9qRFgy5JuLae6UweGf # AeOo3dgLZxikKzYs3hDMaEtJq8IP71cX7QXe6lnMmXU/Hdfz2p897Zd+kU+vZvKI # 3cwLfuVQgK2RZ2z+Kc3K3dRPz2rXycK5XCuRZmvGab/WbrZiC7wJQapgBodltMI5 # GMdFrBg9IeF7/rP4EqVQXeKtevTlZXjpuNhhjuR+2DMt/dWufjXpiW91bo3aH6Ea # jOALXmoxgltCp1K7hrS6gmsvj94cLRf50QQ4U8Qwggd6MIIFYqADAgECAgphDpDS # AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0 # ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla # MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT # H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG # OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S # 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz # y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7 # 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u # M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33 # X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl # XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP # 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB # l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF # RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM # CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ # BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud # DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO # 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0 # LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y # Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p # Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y # Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB # FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw # cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA # XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY # 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj # 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd # d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ # Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf # wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ # aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j # NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B # xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96 # eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7 # r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I # RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVZzCCFWMCAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAYdyF3IVWUDHCQAAAAABhzAN # BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgVKjiVll6 # IP2MC1Fl/LNAQU0E2l7pVYlz5hRqo8LbiS0wQgYKKwYBBAGCNwIBDDE0MDKgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN # BgkqhkiG9w0BAQEFAASCAQBhRKhh7UKEsaLgrYgRD91dtjCCwXRWGb3l5M5tjcPi # AmIajw+qkJ32w8EegU+WWTIx4Mgs1nxP4oANNrmZobL9Dz7u6YJuqt46Mu92KjSv # Mb1siyJYmxKyciZ/536TzkATUcb7rRk8uPMsmBCHItvg0hp6CI55mpbN+/LicUui # xTxMfKrTGqf/pJYJu1ZUxKvTkx8cVnt0cRZlJlv6VqEaETkee04AvikqrVLhlh/+ # zaJ8EEpG2AyUIWhilCucmSaotafmBooKr0ZJgguWlboK1znANgWso2mEOQgZf6Cc # 6WYkAbrHZeqBr54BdzZsehIz8XwJ3KWE553iK6hp/vAooYIS8TCCEu0GCisGAQQB # gjcDAwExghLdMIIS2QYJKoZIhvcNAQcCoIISyjCCEsYCAQMxDzANBglghkgBZQME # AgEFADCCAVUGCyqGSIb3DQEJEAEEoIIBRASCAUAwggE8AgEBBgorBgEEAYRZCgMB # MDEwDQYJYIZIAWUDBAIBBQAEICApPZfwtozQ9nYWh/wu/ZGKTNkr2glcT3RjMtRz # fbPEAgZfu9MEbhUYEzIwMjAxMjAxMjAwNzExLjMyOVowBIACAfSggdSkgdEwgc4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1p # Y3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjo3ODgwLUUzOTAtODAxNDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCDkQwggT1MIID3aADAgECAhMzAAABKKAOgeE21U/CAAAA # AAEoMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTE5MTIxOTAxMTUwMFoXDTIxMDMxNzAxMTUwMFowgc4xCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVy # YXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo3ODgw # LUUzOTAtODAxNDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj # ZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ2Rsdb3VNuGPs2/Dgpc # 9gt77LG0JPkD4VWTlEJLkqznTJl+RoZfiOwN6iWfPu4k/kj8nwY7pvLs1OsBy494 # yusg4rHLwHNUJPtw1Tc54MOLgdcosA4Nxki73fDyqWwDtjOdk6H7kNczBPqADD6B # 98ot77/wSACBJIxm9qAUudquS5fczCF0++aWUavDu46U3cv6HEjIdV2ZdJTUKg4W # UIdTYMQXI082+qSs45WBZjcK98/tIfx8uq8q8ksWF9+zUjGTFiMaKHhn7cSCoEj7 # E1tVmW08ISpS678WFP2+A0OQwaWcJKNACK+J+La7Lz2bGupCidOGz5XDewc1lD9n # LPcCAwEAAaOCARswggEXMB0GA1UdDgQWBBSE4vKD8X61N5vUAcNOdH9QBMum8jAf # BgNVHSMEGDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBH # hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNU # aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF # BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0 # YVBDQV8yMDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsG # AQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IBAQCLX2ZHGIULgDk/iccHWUywjDyAsBHl # hkmtmBp4lldwL3dNo0bXZZHiSZB+c2KzvPqY64BlECjS/Pqur2m9UaT1N0BeUowR # HQT88wdzd94gYqKXmLDbVR8yeVgBkcP/JiVWbXdQzcz1ETHgWrh+uzA8BwUgAaHJ # w+nXYccIuDgPJM1UTeNl9R5Ovf+6zR2E5ZI4DrIqvS4jH4QsoMPTn27AjN7VZt4a # moRxMLEcQAS7vPT1JUUaRFpFHmkUYVln1YMsw///6968aRvy3cmClS44uxkkaILb # hh1h09ejZjHhrEn+k9McVkWiuY724jJ/57tylM7A/jzIWNj1F8VlhkyyMIIGcTCC # BFmgAwIBAgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJv # b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcN # MjUwNzAxMjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv # bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0 # aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIw # DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0 # VBDVpQoAgoX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEw # RA/xYIiEVEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQe # dGFnkV+BVLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKx # Xf13Hz3wV3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4G # kbaICDXoeByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEA # AaOCAeYwggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7 # fEYbxTNoWoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0g # AQH/BIGVMIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYB # BQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUA # bQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOh # IW+z66bM9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS # +7lTjMz0YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlK # kVIArzgPF/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon # /VWvL/625Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOi # PPp/fZZqkHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/ # fmNZJQ96LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCII # YdqwUB5vvfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0 # cs0d9LiFAR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7a # KLixqduWsqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQ # cdeh0sVV42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+ # NR4Iuto229Nfj950iEkSoYIC0jCCAjsCAQEwgfyhgdSkgdEwgc4xCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBP # cGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo3 # ODgwLUUzOTAtODAxNDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUAMT1LG/KAEj0XsiL9n7mxmX1afZuggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AONw3KcwIhgPMjAyMDEyMDExOTE1NTFaGA8yMDIwMTIwMjE5MTU1MVowdzA9Bgor # BgEEAYRZCgQBMS8wLTAKAgUA43DcpwIBADAKAgEAAgIhSAIB/zAHAgEAAgISVTAK # AgUA43IuJwIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAGjWBJ+P5lUNuAqw # FxaIPjyCmStjuau0fo12669MbiwTtJ6GvCNY/JFr7hwkrR1j93WlLDqpsjlsrCsT # RiqDj6uVl9hdoYRRFNoelvz29v50heCNY7H07EyOn8+/irlzcJsrVjYJMOgmDpIg # IePuc3ICUUzteO8POZyB4Mu6wbj5MYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAEooA6B4TbVT8IAAAAAASgwDQYJYIZIAWUD # BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B # CQQxIgQgIsKa4WZbYezjCzbCXAIR6EszLnDuxcgz9IjgCuQaCuswgfoGCyqGSIb3 # DQEJEAIvMYHqMIHnMIHkMIG9BCC8RWqLrwVSd+/cGxDfBqS4b1tPXhoPFrC615vV # 1ugU2jCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB # KKAOgeE21U/CAAAAAAEoMCIEINyDBLU6aoav/UGHDt0ohLsSLwiwi164yrA1rm+1 # VT8fMA0GCSqGSIb3DQEBCwUABIIBAHW46u/GB6feuYhIdpmpPkripi26Ey0C78pG # pn1YDu6CBXJ3u1roeTwa/ksE+Qx60uWU7wNhgOX+1SNche+NHNlknkO7QMjnMmBf # iDEKOl46Sto3ltuhe342WPQ0esaVwzGh5gfZhpDjdhhlvmrtV2G8DwjgqDRi+kaz # pYvaYQg5BrhJ5l8jLl6QqST2yiiHs1wlHCjxpP320ZJXFNbGUcc8mAUC0kZK1sSQ # bbZnOW1jXqmMlfYbufzJiz3IJe9itoC6b9etX6EXrlRid+pOKnmuWwH7bBkq1hgs # P/qijzM1MPlPylO3WuoOiQG/IyCLLaG+tz4NpDNSGFiKC71rkaI= # SIG # End signature block |