Az.Tools.Installer

0.2.1

Az.Tools.Installer.psm1

                                # ----------------------------------------------------------------------------------

#

# Copyright Microsoft Corporation

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

# http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.internal

# See the License for the specific language governing permissions and

# limitations under the License.

# ----------------------------------------------------------------------------------

using namespace System

using namespace System.Collections.Generic

using namespace System.IO

using namespace System.IO.Compression

using namespace System.Linq

using namespace System.Management.Automation

using namespace System.Net

using namespace System.Net.Http

using namespace System.Threading

using namespace System.Threading.Tasks

Microsoft.PowerShell.Core\Set-StrictMode -Version 3

$script:AzTempRepoName = 'AzTempRepo'

$script:FixProgressBarId = 1

$script:ParallelDownloaderClassCode = @"

using System;

using System.Collections.Generic;

using System.IO;

using System.Linq;

using System.Net.Http;

using System.Text.RegularExpressions;

using System.Threading;

using System.Threading.Tasks;

public class ParallelDownloader

{

    private readonly HttpClientHandler httpClientHandler = new HttpClientHandler();

    private readonly HttpClient client = null;

    private readonly string urlRepository = null;

    private readonly CancellationTokenSource CancellationTokenSource = new CancellationTokenSource();

    private readonly IList<Task> tasks;

    private readonly IList<string> modules;

    private string lastModuleName = null;

    private string lastModuleVersion = null;

    public string LastModuleName

    {

        get

        {

            return lastModuleName;

        }

    }

    public string LastModuleVersion

    {

        get

        {

            return lastModuleVersion;

        }

    }

    public ParallelDownloader(string url)

    {

        client = new HttpClient(httpClientHandler);

        this.urlRepository = url;

        tasks = new List<Task>();

        modules = new List<string>();

    }

    public ParallelDownloader()

    {

        client = new HttpClient(httpClientHandler);

        tasks = new List<Task>();

        modules = new List<string>();

    }

    private async Task DownloadToFile(string uri, string filePath)

    {

        using (var httpResponseMessage = await client.GetAsync(uri, CancellationTokenSource.Token))

        using (var stream = await httpResponseMessage.EnsureSuccessStatusCode().Content.ReadAsStreamAsync())

        using (var fileStream = new FileStream(filePath, FileMode.Create))

        {

            await stream.CopyToAsync(fileStream, 81920, CancellationTokenSource.Token);

        }

    }

    private void Copy(string src, string dest)

    {

        File.Copy(src, dest);

    }

    bool ParseFile(string fileName, out string moduleName, out Version moduleVersion, out Boolean preview)

    {

        try

        {

            Regex pattern = new Regex(@"(?<moduleName>[a-zA-Z.]+)\.(?<moduleVersion>[0-9.]+(\-preview)?)\.nupkg");

            Match matches = pattern.Match(fileName);

            if (matches.Groups["moduleName"].Success && matches.Groups["moduleVersion"].Success)

            {

                moduleName = matches.Groups["moduleName"].Value;

                var versionString = matches.Groups["moduleVersion"].Value;

                if (versionString.Contains('-'))

                {

                    var parts = versionString.Split('-');

                    moduleVersion = Version.Parse(parts[0]);

                    preview = string.Compare(parts[1], "preview", true) == 0;

                }

                else

                {

                    moduleVersion = Version.Parse(versionString);

                    preview = false;

                }

                return true;

            }

        }

        catch

        {

        }

        moduleName = null;

        moduleVersion = null;

        preview = false;

        return false;

    }

    public string Download(string sourceUri, string targetPath)

    {

        try

        {

            Uri uri = new Uri(sourceUri);

            var fileName = Path.GetFileName(uri.AbsoluteUri);

            string module = null;

            Version version = null;

            Boolean preview = false;

            if (!ParseFile(fileName, out module, out version, out preview))

            {

                throw new ArgumentException(string.Format("{0} is not a valid Az module nuget package name for installation.", fileName));

            }

            var nupkgFile = preview ? "{0}.{1}-preview.nupkg": "{0}.{1}.nupkg";

            nupkgFile = Path.Combine(targetPath, String.Format(nupkgFile, module, version));

            if (uri.IsFile)

            {

                Copy(uri.AbsolutePath, nupkgFile);

            }

            else if(String.Compare(uri.Scheme, "http", true) == 0 || String.Compare(uri.Scheme, "https", true) == 0)

            {

                Task task = DownloadToFile(uri.AbsoluteUri, nupkgFile);

                tasks.Add(task);

                modules.Add(module);

            }

            else

            {

                throw new ArgumentException(string.Format("{0} scheme is not supported.", sourceUri));

            }

            lastModuleName = module;

            lastModuleVersion = string.Format(preview ? "{0}-preview" : "{0}", version);

            return nupkgFile;

        }

        catch (UriFormatException)

        {

            throw new ArgumentException(string.Format("{0} is not a valid uri.", sourceUri));

        }

    }

    public string Download(string module, Version version, string path, Boolean preview = false)

    {

        var nupkgFile = preview ? "{0}.{1}-preview.nupkg" : "{0}.{1}.nupkg";

        nupkgFile = Path.Combine(path, String.Format(nupkgFile, module, version));

        Task task = DownloadToFile(String.Format("{0}/package/{1}/{2}", urlRepository, module, version), nupkgFile);

        tasks.Add(task);

        modules.Add(module);

        lastModuleName = module;

        lastModuleVersion = string.Format(preview ? "{0}-preview" : "{0}", version);

        return nupkgFile;

    }

    public void WaitForAllTasks()

    {

        while (tasks.Count() > 0)

        {

            int taskIndex = Task.WaitAny(tasks.ToArray());

            var task = tasks[taskIndex];

            tasks.Remove(task);

            modules.Remove(modules[taskIndex]);

            if (!task.IsCompleted)

            {

                throw new Exception(String.Format("Error downloading {0} {1}", modules[taskIndex], task.Exception));

            }

        }

    }

    public void Dispose()

    {

        if (tasks.Count() > 0)

        {

            CancellationTokenSource.Cancel();

            try

            {

                Task.WaitAll(tasks.ToArray());

            }

            catch

            {

            }

        }

        if (client != null)

        {

            client.Dispose();

        }

        if (httpClientHandler != null)

        {

            httpClientHandler.Dispose();

        }

    }

}

"@

Add-Type -AssemblyName System.Net.Http -ErrorAction Stop

Add-Type $script:ParallelDownloaderClassCode -ReferencedAssemblies System.Net.Http,System.Threading.Tasks,System.Linq,System.Collections,System.Runtime.Extensions,System.Text.RegularExpressions,System.IO.FileSystem

$getModule = Get-Module -Name "PowerShellGet"

if ($null -ne $getModule -and $getModule.Version -lt [System.Version]"2.1.3") {

    Write-Error "This module requires PowerShellGet version 2.1.3. An earlier version of PowerShellGet is imported in the current PowerShell session. Please open a new session before importing this module." -ErrorAction Stop

}

elseif ($null -eq $getModule -or $getModule.Version -ge [System.Version]"3.0") {

    try {

        Import-Module PowerShellGet -MinimumVersion 2.1.3 -MaximumVersion 3.0 -Scope Global -Force -ErrorAction Stop

    }

    catch {

        Write-Error "This module requires PowerShellGet version no earlier than 2.1.3 and no later than 3.0. Please install the required PowerShellGet firstly."

    }

}

function Get-AllAzModule {

    param (

        [Parameter()]

        [Switch]

        ${PrereleaseOnly}

    )

    process {

        $allmodules = Microsoft.PowerShell.Core\Get-Module -ListAvailable -Name Az*, Az `

         | Where-Object {$_.Name -match "Az(\.[a-zA-Z0-9]+)?$"} `

         | Where-Object {

            !$PrereleaseOnly -or ($_.PrivateData -and $_.PrivateData.ContainsKey('PSData') -and $_.PrivateData.PSData.ContainsKey('PreRelease') -and $_.PrivateData.PSData.Prerelease -eq 'preview') -or ($_.Version -lt [Version] "1.0")

        }

        $allmodules

    }

}

function Normalize-ModuleName {

    param (

        [Parameter()]

        [string[]]

        ${Name}

    )

    process {

        $normalName = $Name | ForEach-Object {

            if ($_) {

                if ($_ -notlike "Az.*") {

                    "Az.$_"

                }

                else {

                    $_

                }

            }

        } | Sort-Object -Unique

        if ($normalName -and $normalName -notmatch "Az(\.[a-zA-Z0-9.]+)?$") {

            $normalName = $null

            Throw "The Name parameter must only contain Az modules."

        }

        if ($normalName -eq 'Az.Az') {

            $normalName = $normalName | Where-Object { $_ -ne 'Az.Az'}

            Write-Warning "Az.Tools.Installer cannot be used to install Az. Will discard Az in the Name parameter."

        }

        $normalName

    }

}

function Get-AzModuleFromRemote {

    [OutputType([PSCustomObject[]])]

    param (

        [Parameter()]

        [string[]]

        ${Name},

        [Parameter()]

        [string]

        ${Repository},

        [Parameter()]

        [Switch]

        ${AllowPrerelease},

        [Parameter()]

        [Version]

        ${RequiredVersion},

        [Parameter()]

        [Switch]

        ${UseExactAccountVersion},

        [Parameter(Mandatory)]

        [ValidateNotNullOrEmpty()]

        [string]

        ${Invoker}

    )

    process {

        $azModule = "Az"

        if ($AllowPrerelease) {

            if ($RequiredVersion -and $RequiredVersion -lt [Version] "6.0") {

                Throw "[$Invoker] Prerelease version cannot be lower than 6.0. Please install GA modules only or specify Az version above 6.0."

            }

            else {

                $azModule = "AzPreview"

            }

        }

        $findModuleParams = @{

            Name =  $azModule

            RequiredVersion = $RequiredVersion

            ErrorAction = 'Stop'

        }

        if ($Repository) {

            $findModuleParams.Add('Repository', $Repository);

        }

        $modules = [Array] (PowerShellGet\Find-Module @findModuleParams)

        if ($modules.Count -gt 1) {

            Throw "[$Invoker] You have multiple modules matched 'Az' in the registered reposistory $($modules.Repository). Please specify a single -Repository."

        }

        $Repository = $modules.Repository

        $accountVersion = 0

        if (!$UseExactAccountVersion) {

            $findModuleParams = @{

                Name = 'Az.Accounts'

                Repository = $Repository

            }

            $module = PowerShellGet\Find-Module @findModuleParams

            $accountVersion = [Version] $module.Version

        }

        $modulesWithVersion = @()

        $containValidModule = if ($Name) {$Name -Contains 'Az.Accounts'} else {$false}

        $module = $null

        foreach ($module in $modules.Dependencies) {

            if ($module.Name -eq 'Az.Accounts') {

                if ($UseExactAccountVersion) {

                    $version = $accountVersion

                    if ($module.Keys -Contains 'MinimumVersion') {

                        $version = $module.MinimumVersion

                    }

                    elseif ($module.Keys -Contains 'RequiredVersion') {

                        $version = $module.RequiredVersion

                    }

                    $modulesWithVersion += [PSCustomObject]@{Name = $module.Name; Version = $version; Repository = $Repository}

                }

                else {

                    $modulesWithVersion += [PSCustomObject]@{Name = $module.Name; Version = $accountVersion; Repository = $Repository}

                }

            }

            elseif (!$Name -or $Name -Contains $module.Name)

            {

                if ($module.RequiredVersion) {

                    $modulesWithVersion += [PSCustomObject]@{Name = $module.Name; Version = $module.RequiredVersion; Repository = $Repository}

                    $containValidModule = $true

                }

            }

        }

        if (!$containValidModule) {

            $modulesWithVersion = $modulesWithVersion | Where-Object {$_.Name -ne "Az.Accounts"}

        }

        $count = if ($modulesWithVersion) {$modulesWithVersion.Count} else {0}

        Write-Debug "[$Invoker] $count module(s) are found."

        $modulesWithVersion

    }

}

class ModuleInfo

{

    [string] $Name = $null

    [Version[]] $Version = @()

}

function Remove-AzureRM {

    process {

        try {

            $azureModuleNames = (Get-InstalledModule -Name Azure* -ErrorAction Stop).Name | Where-Object {$_ -match "Azure(\.[a-zA-Z0-9]+)?" -or $_ -match "AzureRM(\.[a-zA-Z0-9]+)?"}

            foreach ($moduleName in $azureModuleNames) {

                PowerShellGet\Uninstall-Module -Name $moduleName -AllVersion -AllowPrerelease -ErrorAction Continue

            }

        }

        catch {

            Write-Warning $_

        }

    }

}

function Get-RepositoryUrl {

    param (

        [Parameter()]

        [string]

        ${Repository}

    )

    process {

        $url = (Get-PSRepository -Name $repository).SourceLocation

        $url

    }

}

$exportedFunctions = @( Get-ChildItem -Path $PSScriptRoot/exports/*.ps1 -Recurse -ErrorAction SilentlyContinue )

$internalFunctions = @( Get-ChildItem -Path $PSScriptRoot/internal/*.ps1 -ErrorAction SilentlyContinue )

$allFunctions = $internalFunctions + $exportedFunctions

foreach ($function in $allFunctions) {

    try {

        . $function.Fullname

    }

    catch {

        Write-Error "Failed to import function $($function.fullname): $_"

    }

}

Export-ModuleMember -Function $exportedFunctions.Basename

$commandsWithRepositoryParameter = @(

    "Install-AzModule",

    "Update-AzModule"

)

Add-RepositoryArgumentCompleter -Cmdlets $commandsWithRepositoryParameter -ParameterName "Repository"

# SIG # Begin signature block

# MIInygYJKoZIhvcNAQcCoIInuzCCJ7cCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBmgg3sgy1HLyqR

# Mgu+nn5Zg94eACo26htrJODnFD1X3aCCDYEwggX/MIID56ADAgECAhMzAAACzI61

# lqa90clOAAAAAALMMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjIwNTEyMjA0NjAxWhcNMjMwNTExMjA0NjAxWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCiTbHs68bADvNud97NzcdP0zh0mRr4VpDv68KobjQFybVAuVgiINf9aG2zQtWK

# No6+2X2Ix65KGcBXuZyEi0oBUAAGnIe5O5q/Y0Ij0WwDyMWaVad2Te4r1Eic3HWH

# UfiiNjF0ETHKg3qa7DCyUqwsR9q5SaXuHlYCwM+m59Nl3jKnYnKLLfzhl13wImV9

# DF8N76ANkRyK6BYoc9I6hHF2MCTQYWbQ4fXgzKhgzj4zeabWgfu+ZJCiFLkogvc0

# RVb0x3DtyxMbl/3e45Eu+sn/x6EVwbJZVvtQYcmdGF1yAYht+JnNmWwAxL8MgHMz

# xEcoY1Q1JtstiY3+u3ulGMvhAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUiLhHjTKWzIqVIp+sM2rOHH11rfQw

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDcwNTI5MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAeA8D

# sOAHS53MTIHYu8bbXrO6yQtRD6JfyMWeXaLu3Nc8PDnFc1efYq/F3MGx/aiwNbcs

# J2MU7BKNWTP5JQVBA2GNIeR3mScXqnOsv1XqXPvZeISDVWLaBQzceItdIwgo6B13

# vxlkkSYMvB0Dr3Yw7/W9U4Wk5K/RDOnIGvmKqKi3AwyxlV1mpefy729FKaWT7edB

# d3I4+hldMY8sdfDPjWRtJzjMjXZs41OUOwtHccPazjjC7KndzvZHx/0VWL8n0NT/

# 404vftnXKifMZkS4p2sB3oK+6kCcsyWsgS/3eYGw1Fe4MOnin1RhgrW1rHPODJTG

# AUOmW4wc3Q6KKr2zve7sMDZe9tfylonPwhk971rX8qGw6LkrGFv31IJeJSe/aUbG

# dUDPkbrABbVvPElgoj5eP3REqx5jdfkQw7tOdWkhn0jDUh2uQen9Atj3RkJyHuR0

# GUsJVMWFJdkIO/gFwzoOGlHNsmxvpANV86/1qgb1oZXdrURpzJp53MsDaBY/pxOc

# J0Cvg6uWs3kQWgKk5aBzvsX95BzdItHTpVMtVPW4q41XEvbFmUP1n6oL5rdNdrTM

# j/HXMRk1KCksax1Vxo3qv+13cCsZAaQNaIAvt5LvkshZkDZIP//0Hnq7NnWeYR3z

# 4oFiw9N2n3bb9baQWuWPswG0Dq9YT9kb+Cs4qIIwggd6MIIFYqADAgECAgphDpDS

# 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/BvW1taslScxMNelDNMYIZnzCCGZsCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAsyOtZamvdHJTgAAAAACzDAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgPTtETB9v

# 9iE6HXw7TgXOFUTSHTzWECjEJiTZq4WJulkwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQAS6oGf1jypDtMqYrK7TXrxyMj/ldiSoZGPwMnSJC71

# KWLC1068EO5qgVnrte1QLKHmzHU2UsCdnVOcRwvnsHkKgG+9erA48pqFKL82OaHq

# MUeC+8LQ6j/DK58rCaqbDFf2dToQ1uVPD2L/Lq9rEcmDZOMzMTcn2OHzIBEfNpP4

# qcKBhN/5DnMYw5S8uNRsgPA+L/zncCz6aAFe81uIlRz/jvg2uJdIfnrq1yPkquvJ

# YnegevmqjSagYy2fnjHVF2Lvn8b91sRyaT89zqomt8GWVhDWMK6KgtvVGYxFry71

# ynXBvjmBcc/RLhANhzu4SCcd4F6bihmdlL4XWg9GtzaWoYIXKTCCFyUGCisGAQQB

# gjcDAwExghcVMIIXEQYJKoZIhvcNAQcCoIIXAjCCFv4CAQMxDzANBglghkgBZQME

# AgEFADCCAVkGCyqGSIb3DQEJEAEEoIIBSASCAUQwggFAAgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIJBNiU4E+wGhJ7qyk/SDGtygJ12Og4c5eJqJAYy3

# 7RzFAgZjovLR2HcYEzIwMjMwMTA2MDYwNzQxLjE0OVowBIACAfSggdikgdUwgdIx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1p

# Y3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhh

# bGVzIFRTUyBFU046MkFENC00QjkyLUZBMDExJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2WgghF4MIIHJzCCBQ+gAwIBAgITMwAAAbHKkEPuC/AD

# qwABAAABsTANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMDAeFw0yMjA5MjAyMDIxNTlaFw0yMzEyMTQyMDIxNTlaMIHSMQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQg

# SXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1Mg

# RVNOOjJBRDQtNEI5Mi1GQTAxMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFt

# cCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAhqKrPtXs

# G8fsg4w8R4MzZTAKkzwvEBQ94ntS+72rRGIMF0GCyEL9IOt7f9gkGoamfbtrtdY4

# y+KIFR8w19/nU3EoWhJfrYamrfpgtFmTaE3XCKCsI7rnrPmlVOMmndDyN1gAlfeu

# 4l5rdxx9ODECBPdS/+w/jDT7JkBhrYllqVXcwGAgWLdXAoUDgKVByv5XhKkbOrPx

# 9qppuZjKm4nflmfwb/bTWkA3aMMQ67tBoMLSsbIN3BJNWZdwczjoQVXo3YXr2fB+

# PYNmHviCcDUMHs0Vxmf7i/WSpBafsDMEn6WY7G8qtRGVX+7X0zDVg/7NVDLMqfn/

# iv++5hJGP+2Fmv4WZkBS1MBpwvOi4EQ25pIG45jWTffR4ynyed1I1SxSOP+efuBx

# 0WrN1A250lv5fGZHCL0vCMDT/w+U6wpNnxfDoQRY9Ut82iNK5alkxNozPP/DNI+n

# knTaSliaR2XnSXDIZEs7lfuJYg0qahfJJ1CZF2IYxOS9FK1crEigSb8QnEJoj6Th

# Lf4FYpYLTsRXlPdQbvBsVvgt++BttooznwfK0DKMOc718SLS+unwkVO0aF23CEQS

# Stoy0ZW34K+cbRmUfia+k9E+4luoTnT17oKqYfDNO5Rk8UwVa8mfh8+/R3fZaz2O

# /ZhiYT/RZHV9Quz5PHGlaCfXPQ8A6zFJlE8CAwEAAaOCAUkwggFFMB0GA1UdDgQW

# BBT0m2eR7w2thIr18WehUTSmvQ45kzAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJl

# pxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx

# MCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3Rh

# bXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQM

# MAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEA

# 2Oc3kmql5VKEitAhoBCc1U6/VwMSYKQPqhC59f00Y5fbwnD+B2Qa0wnJqADSVVu6

# bBCVrks+EGbkuMhRb/lpiHNKVnuXF4PKTDnvCnYCqgwAmbttdxe0m38fJpGU3fmE

# CEFX4OYacEhFwTkLZtIUVjdqwPnQpRII+YqX/Q0Vp096g2puPllSdrxUB8xIOx3F

# 7LGOzyv/1WmrLyWAhUGpGte0W3qfX4YWkn7YCM+yl887tj5j+jO/l1MRi6bl4MsN

# 0PW2FCYeRbyzQEENsg5Pd351Z08ROR/nR8z+cAuQwR29ijaDKIms5IbRr1nZL/qZ

# skFSuCuSA+nYeMuTJxHg2HCXrt6ECFbEkYoPaBGTzxPYopcuJEcChhNlWkduCRgu

# ykEsmz0LvtmS7Fe68g4Zoh3sQkIE5VEwnKC3HwVemhK7eNYR1q7RYExfGFUDMQdO

# 7tQpbcPD4oaBbtFGWGu3nz1IryWs9K88zo8+eoQV/o9SxNU7Rs6TMqcLdM6C6Lgm

# GVaWKKC0S2DVKU8zFx0y5z25h1ZJ7X/Zhaav1mtXVG6+lJIq8ktJgOU5/pomumdf

# tgosxGjIp3NORy9fDUll+KQl4YmN9GzZxPYkhuI0QYriLmytBtUK+AK91hURVldV

# bUjP8sksr1dsiQwyOYQIkSxrTuhp0pw7h5329jphgEYwggdxMIIFWaADAgECAhMz

# AAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9v

# dCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0z

# MDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjAN

# BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP9

# 7pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMM

# tY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gm

# U3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130

# /o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP

# 3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7

# vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+A

# utuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz

# 1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6

# EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/Zc

# UlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZy

# acaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJ

# KwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVd

# AF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8G

# CCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3Mv

# UmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQC

# BAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYD

# VR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZF

# aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9v

# Q2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcw

# AoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJB

# dXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cB

# MSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7

# bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/

# SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2

# EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2Fz

# Lixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0

# /fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9

# swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJ

# Xk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+

# pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW

# 4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N

# 7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIC1DCCAj0CAQEwggEAoYHYpIHVMIHSMQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNy

# b3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxl

# cyBUU1MgRVNOOjJBRDQtNEI5Mi1GQTAxMSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQDtZLG+pANsDu/LLr1OfTA/

# kEbHK6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqG

# SIb3DQEBBQUAAgUA52HgUjAiGA8yMDIzMDEwNjA3NDgzNFoYDzIwMjMwMTA3MDc0

# ODM0WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDnYeBSAgEAMAcCAQACAhksMAcC

# AQACAhFoMAoCBQDnYzHSAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkK

# AwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEFBQADgYEAm2u+

# PrfTNgaqoDC/9MwmWgSpruS154DPWFop8nlPI9+/PWLmWcJJVci/f78OMtLZfB4z

# 8z/SyGgnE4rhiiW+fY5vpyuEQ0knvWG9cP1+chzG6drGKJ7HNWbUhYwVF1i7EDO6

# IOIIQvYYOxD6L9or2ATK9Y7fY1w04mOC9ZTIZcgxggQNMIIECQIBATCBkzB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAbHKkEPuC/ADqwABAAABsTAN

# BglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8G

# CSqGSIb3DQEJBDEiBCANbgSjjbFbKQXPLXmK+WHAAxUTSBKjTwaPYae9SaD57DCB

# +gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIIPtDYsUW9+p4OjL2Cm7fm3p1h6u

# sM7RwxOU4iibNM9sMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTACEzMAAAGxypBD7gvwA6sAAQAAAbEwIgQgp8xQBlV11uZEsvY44l87OadosD8e

# io62tN0+UQKp0OMwDQYJKoZIhvcNAQELBQAEggIAOHjpYyVy0xBEcon0tBp+jhz+

# WiiSgcadTVbfUJvnBZ7dvwQMGcrZ/v9maKa0cRH70egLHvcV7sOMEwHp7KPLb8d/

# eKp17nxUknRhYotjnx3Ge3AFRa9umhEiOqQg3WtxmQwT6WlpJdstTnd9HwcO0SZ6

# yzKGXFB7w33Ys7mIxh7BdoLFGQyOoJ/jxPKCewNmoTtqAO87KPyurmF60+xnRjI4

# 7EWYySKmzA/VcLFjz/nt4m/TjmJoZTsLnjjzG6s9VBZegDT8GWFcRnEFW2+nJ5w/

# ZxWpUI6WLG21h3ZwvrNh9sKq6n4fzoKigq8b9nz+5/1MA2weMpsUm2CEkEjTM67w

# v6+JAMTnIfMXtn3OQ1VxtbwcLQ1rQAps/2SuD9AkytPkBu4NriBAYW1tEe6tB3oM

# qMMXk8HsNZSFIrpQJB7G1AWJL8cfMB74kFeO1C7cA0zszoNpIXtGPqexQBoBwF2J

# +/1IrLztu4hSJPR4mMevq4yRN3bmDgE9TU+Zv03CBSaZeK8TUnIpI6bhTExHXvcl

# JZFxGZLGoVn18nDP0T1SmURWFlUqReurqcrBQAD3/yoWiIc8zWPsFlRP5Dc8AdNE

# WnZF3sEha38tjZwSjmLTdLzkJlYbnTKwls/oEIkyqVq9VJA1btQb3hg3jpx9wFqp

# zqw2GaOt7CLntzgQuuk=

# SIG # End signature block