Microsoft.VisualStudio.DSC

1.0.26

Microsoft.VisualStudio.DSC.psm1

                                # Copyright (c) Microsoft Corporation. All rights reserved.

# Licensed under the MIT License.

#Requires -RunAsAdministrator

using namespace System.Collections.Generic

using namespace System.Diagnostics

[DSCResource()]

class VSComponents

{

    [DscProperty(Key)]

    [string]$productId

    [DscProperty(Key)]

    [string]$channelId

    [DscProperty()]

    [string[]]$components

    [DscProperty()]

    [string]$vsConfigFile

    [DscProperty()]

    [bool]$includeRecommended = $false

    [DscProperty()]

    [bool]$includeOptional = $false

    [DscProperty()]

    [bool]$allowUnsignedExtensions = $false

    [DscProperty(NotConfigurable)]

    [string[]]$installedComponents

    [VSComponents] Get()

    {

        $this.installedComponents = Get-VsComponents -ProductId $this.productId -ChannelId $this.channelId

        return @{

            productId = $this.productId

            channelId = $this.channelId

            components = $this.components

            vsConfigFile = $this.vsConfigFile

            includeRecommended = $this.includeRecommended

            includeOptional = $this.includeOptional

            allowUnsignedExtensions = $this.allowUnsignedExtensions

            installedComponents = $this.installedComponents

        }

    }

    [bool] Test()

    {

        if(-not $this.components -and -not $this.vsConfigFile)

        {

            throw "No components specified to be added. Specify either an Installation Configuration (VSConfig) file, individual required components, or both."

        }

        $this.Get()

        $requestedComponents = $this.components

        if($this.vsConfigFile)

        {

            if(-not (Test-Path $this.vsConfigFile))

            {

                throw "Provided Installation Configuration file does not exist at $($this.vsConfigFile)"

            }

            $vsConfigFileObj = Get-Content $this.vsConfigFile | Out-String | ConvertFrom-Json

            # If the provided VS Config file has extensions, automatically fail the test

            if($vsConfigFileObj.extensions.count -gt 0)

            {

                return $false

            }

            $requestedComponents += $vsConfigFileObj | Select-Object -ExpandProperty components

        }

        foreach ($component in $requestedComponents)

        {

            if($this.installedComponents -notcontains $component)

            {

                return $false

            }

        }  

        return $true

    }

    [void] Set()

    {

        if ($this.Test())

        {

            return

        }

        Add-VsComponents -ProductId $this.productId -ChannelId $this.channelId -VsConfigPath $this.vsConfigFile -Components $this.components -IncludeRecommended $this.includeRecommended -IncludeOptional $this.includeOptional -AllowUnsignedExtensions $this.allowUnsignedExtensions

    }

}

<#

.SYNOPSIS

    Returns a collection of components identifiers installed in the Visual Studio instance identified by the provided Product ID and Channel ID.

.PARAMETER ProductId

    The product identifier of the instance you are working with. EG: 'Microsoft.VisualStudio.Product.Community'

.PARAMETER ChannelId

    The channel identifier of the instance you are working with. EG: 'VisualStudio.17.Release'

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/command-line-parameter-examples#using---channelId

#>

function Get-VsComponents

{

    param

    (

        [Parameter(Mandatory)]

        [string]$ProductId,

        [Parameter(Mandatory)]

        [string]$ChannelId

    )

    $result = Invoke-VsWhere -Arguments "-products $ProductId -include packages -format json -all -prerelease" | ConvertFrom-Json | Where-Object { $_.channelId -eq $ChannelId }

    return $result.packages | Where-Object { $_.type -eq "Component" -or $_.type -eq "Workload" } | Select-Object -ExpandProperty id 

}

<#

.SYNOPSIS

    Adds components and workloads identified by the provided component list & Installation Configuration (VSConfig) file into the specified instance

.PARAMETER ProductId

    The product identifier of the instance you are working with. EG: 'Microsoft.VisualStudio.Product.Community'

.PARAMETER ChannelId

    The channel identifier of the instance you are working with. EG: 'VisualStudio.17.Release'

.PARAMETER Components

    Collection of component identifiers you wish to update the provided instance with.

.PARAMETER VsConfigPath

    Path to the Installation Configuration (VSConfig) file you wish to update the provided instance with.

.PARAMETER IncludeRecommended

    For the provided required components, also add recommended components into the specified instance

.PARAMETER IncludeOptional

    For the provided required components, also add optional components into the specified instance

.PARAMETER AllowUnsignedExtensions

    For the provided extensions, allow unsigned extensions to be installed into the specified instance

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/command-line-parameter-examples#using---channelId

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio#install-update-modify-repair-uninstall-and-export-commands-and-command-line-parameters

.LINK

    https://devblogs.microsoft.com/setup/configure-visual-studio-across-your-organization-with-vsconfig/

#>

function Add-VsComponents

{

    param

    (

        [Parameter(Mandatory)]

        [string]$ProductId,

        [Parameter(Mandatory)]

        [string]$ChannelId,

        [Parameter()]

        [string[]]$Components,

        [Parameter()]

        [string]$VsConfigPath,

        [Parameter()]

        [bool]$IncludeRecommended,

        [Parameter()]

        [bool]$IncludeOptional,

        [Parameter()]

        [bool]$AllowUnsignedExtensions

    )

    $installerArgs = "modify --productId $ProductId --channelId $ChannelId --quiet --norestart --activityId VisualStudioDSC-$((New-Guid).Guid)"

    if(-not $Components -and -not $VsConfigPath)

    {

        throw "No components specified to be added. Specify either an Installation Configuration (VSConfig) file, individual required components, or both."

    }

    if($VsConfigPath)

    {

        if(-not (Test-Path $VsConfigPath))

        {

            throw "Provided Installation Configuration file does not exist at $VsConfigPath"

        }

        $installerArgs += " --config `"$VsConfigPath`""

    }

    if($Components)

    {

        $installerArgs += " --add " + ($Components -join ' --add ');

    }

    if($IncludeRecommended)

    {

        $installerArgs += " --includeRecommended"

    }

    if($IncludeOptional)

    {

        $installerArgs += " --includeOptional"

    }

    if($AllowUnsignedExtensions)

    {

        $installerArgs += " --allowUnsignedExtensions"

    }

    Invoke-VsInstaller -Arguments $installerArgs

}

<#

.SYNOPSIS

    Builds a base path, if it exists, with the provided argument.

.DESCRIPTION

    Builds a base path with the provided argument.

    This is used to build a base path for process ids of setup.exe or vswhere.exe.

.PARAMETER Arguments

    Arguments to build a base path with

#>

function Build-BasePath

{

    param

    (

        [Parameter()]

        [string]$ExePath

    )

    $basePath = Join-Path -Path "${env:ProgramFiles(x86)}" -ChildPath "Microsoft Visual Studio"

    if($ExePath)

    {

        return Join-Path -Path $basePath -ChildPath $ExePath

    }

    return $basePath

}

<#

.SYNOPSIS

    Invokes Visual Studio Installer, if it exists, with the provided arguments.

.DESCRIPTION

    Invokes Visual Studio Installer with the provided arguments.

    If this script is not run as an administrator, without the installer present, or with the installer process running, this script will fail.

    The invocation is considered successful if return codes of 0 (success), 3010 (reboot required) or 862968 (reboot recommended) are returned.

.PARAMETER Arguments

    Arguments to pass onwards to Visual Studio Installer.

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio

#>

function Invoke-VsInstaller

{

    param

    (

        [Parameter(Mandatory)]

        [string]$Arguments

    )

    Assert-IsAdministrator

    Assert-VsInstallerPresent

    Assert-VsInstallerProcessNotRunning

    $installer = Start-Process -FilePath (Get-VsInstallerPath) -ArgumentList $Arguments -PassThru

    $installer.WaitForExit();

    $basePath = Build-BasePath

    # Set EnableRaisingEvents to true to access the Exit Code later

    $activeInstallerProcess = Get-Process Setup | Where-Object { $_.Path -like "$basePath*" } | ForEach-Object { $_.EnableRaisingEvents = $true }

    # See script block description for error code explanation

    $validErrorCodes = 0,3010,862968;

    if($activeInstallerProcess)

    {

        $processIds = $activeInstallerProcess | Select-Object -ExpandProperty Id

        Wait-Process -Id $processIds -Timeout 3600

        foreach($process in $activeInstallerProcess) 

        {

            if($process.ExitCode -NotIn $validErrorCodes)

            {

                throw "Visual Studio Installer failed after installer update with error code $($process.ExitCode) using arguments: $Arguments"

            }

        }

    }

    else

    {

        if($installer.ExitCode -NotIn $validErrorCodes)

        {

            throw "Visual Studio Installer failed with error code $($installer.ExitCode) using arguments: $Arguments"

        }

    }

}

<#

.SYNOPSIS

    Invokes Visual Studio Locator, if it exists, with the provided arguments.

.DESCRIPTION

    Invokes Visual Studio Locator (vswhere.exe) with the provided arguments.

    If this script is run without the locator present, it will fail.

.PARAMETER Arguments

    Arguments to pass onwards to Visual Studio Locator.

.LINK

    https://learn.microsoft.com/en-us/visualstudio/install/tools-for-managing-visual-studio-instances#using-vswhereexe

#>

function Invoke-VsWhere

{

    param

    (

        [Parameter(Mandatory)]

        [string]$Arguments

    )

    Assert-VsWherePresent

    return Invoke-Expression -Command "&'$(Get-VsWherePath)' $Arguments"

}

<#

.SYNOPSIS

    Throws an exception if not running elevated.

#>

function Assert-IsAdministrator

{

    if(-not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))

    {

        throw "This resource must be run as an Administrator."

    }

}

<#

.SYNOPSIS

    Returns the default path of Visual Studio Installer.

#>

function Get-VsInstallerPath

{

    return Build-BasePath -ExePath "Installer\setup.exe"

}

<#

.SYNOPSIS

    Returns the default path of Visual Studio Locator (vswhere.exe).

#>

function Get-VsWherePath

{

    return Build-BasePath -ExePath "Installer\vswhere.exe"

}

<#

.SYNOPSIS

    Throws an exception if Visual Studio Installer is not present in the default location.

#>

function Assert-VsInstallerPresent

{

    if(-not (Test-Path (Get-VsInstallerPath)))

    {

        throw "Visual Studio Installer not found."

    }

}

<#

.SYNOPSIS

    Throws an exception if Visual Studio Locator (vswhere.exe) is not present in the default location.

#>

function Assert-VsWherePresent

{

    if(-not (Test-Path (Get-VsWherePath)))

    {

        throw "Visual Studio Locator not found."

    }

}

<#

.SYNOPSIS

    Throws an exception if Visual Studio Installer is currently running.

#>

function Assert-VsInstallerProcessNotRunning

{

    if(Get-Process | Where-Object { $_.Path -eq (Get-VsInstallerPath) })

    {

        throw "Visual Studio Installer is running. Close the installer and try again."

    }

}

# SIG # Begin signature block

# MIIoLAYJKoZIhvcNAQcCoIIoHTCCKBkCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDE8cduH5MWj8/i

# EO/TNZQykIdWumuwh8V9Y0P8irSXDKCCDXYwggX0MIID3KADAgECAhMzAAADrzBA

# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA

# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG

# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN

# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL

# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB

# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd

# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ

# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY

# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp

# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn

# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT

# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG

# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O

# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk

# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx

# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt

# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGgwwghoIAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEINgJdwR8OEKwnPZ7Zh5g/Z3L

# uvJk5XGjivnsLNWOPboqMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAPpx9W2agnRcZ2YW0Vjpt11TM9sM6Q3+DPaiE1185JDlhvHrUtznxZPGb

# +4ifzR+2/as5JcxhP1Bw2agFSHjbuDZ9wsKJjRf/Tp1HV49RHKQE7moRxOvP8X8J

# FSd4BwGRhLyERow67aG2b/8EHEDXNA11UmuB+CrQ84kp3HW9NgFPbEKNLv27hWXB

# 53r29Qi7sCZdNmyUqfCqIJhTekkhg2vUiUoSLkTs1reUedkOKZ5i4ufXbicI3Th4

# 3sUWFX53XHfkAGShNCr+CNIRybPdsa4Eu/5Nl1J7JThYtd3IHCwIXZy3Dgpy8vwe

# MCNU1qvHjOTmFlHHZEH80K4zKXd/haGCF5YwgheSBgorBgEEAYI3AwMBMYIXgjCC

# F34GCSqGSIb3DQEHAqCCF28wghdrAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsq

# hkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCBodpvnwNwj4wo14bRjHz01kCv9VY5wrr1Hcmk0o1ga/wIGZuMQH+o7

# GBIyMDI0MDkyNzIyNDAxNy44OFowBIACAfSggdGkgc4wgcsxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVy

# aWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozNzAzLTA1

# RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCC

# Ee0wggcgMIIFCKADAgECAhMzAAAB6pokctVZP2FjAAEAAAHqMA0GCSqGSIb3DQEB

# CwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV

# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTIzMTIwNjE4NDUz

# MFoXDTI1MDMwNTE4NDUzMFowgcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMx

# JzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozNzAzLTA1RTAtRDk0NzElMCMGA1UE

# AxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEB

# BQADggIPADCCAgoCggIBALULX/FIPyAH1fsu52ijatZvaSypoXrlC0mRtCmaxzob

# huDkw6/pY/+4nhc4m8pf9zW3R6PihYGp0YPpVuNdfhPQp/KVO6WvMq2DGfFmHurW

# 4PQPL/DkbQMkM9vqjFCvPq8xXZnfL1nGN9moGcN+oaif/hUMedmF1qzbay9ILkYf

# LCxDYn3Qwzsvh5xjxOcsjzmRddNURJvT23Eva0cxisH4ocLLTx2zfpqfshw4Z9Ga

# EdsWg9rmib1galUpLzF5PsQDBbtZtcv+Wjmn0pFEiMCWwEEcPVN0YG5ysYLdNBdJ

# On2zsOOS+80W5RrQEqzPpSIIvEkZBJmF3aI4lMR8nV/FiTadjpIIqxX5Wa1XlqI/

# Nj+xagVjnjb7POsA+vh6Wu+v24HpyL8pyL/8Q4RFkRRME9cwT+Jr63yOtPbLe6DX

# kxIJW6E6w2ua5kXBpEKtEQPTLPhX3CUxMYcglbnmI0zcc9UknX285K+sI/2WwRwT

# BZkhDUULI86eQzV+zvzzR1qEBrlSY+oyTlYQrHMM9WnTzVflFDocZVTPpl2BDSNx

# Pn0Qb4IoM9EPqbHyi/MilL+v/AQc8q3mQ6FiuPJAddz0ocpNZ9ekBWPVLKq3lfie

# v4yl65u/438+NAQ+vSJgkONLMmuoguEGzmnK1vq/JHwdRUyn6YADiteM7Dja+Qd9

# AgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUK4FFJaJR5ukXQFTUxMhyiwVuWV4wHwYD

# VR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZO

# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBc

# BggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0

# cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYD

# VR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAOBgNVHQ8BAf8EBAMC

# B4AwDQYJKoZIhvcNAQELBQADggIBACiDrVZeP37+fFVtfcbfsqC/Kg0Ce67bDceh

# ZmPcfRgJ5Ddv0pJlOFVOFbiIVwesqeEUwFtclfi5AjneQ5ZJpYJpXfELOelG3dzj

# +BKfd287/UY/cwmSkl+CjnoKBL3Ms6I/fWR+alR0+p6RlviK8xHoug9vkc2WrRZs

# GnMVu2xOM2tPJ+qpyoDBzqv30N/ZRBOoNrS/PCkDwLGICDYqVs/IzAE49yv2ElPy

# walf9mEsOHXV1lxtQDNcejVEmitJJ+1Vr2EtafPEbMQZp89TAuagROKE4YuohCUK

# m+v3geJqTQarTBjqV25RCOT+XFngTMDD9wYx6TwndB2I1Ly726NiHUHs0uvq3ciC

# V9JwNXdt1VZ63WK1NSgpVEsiK9EPABPt1EfXcKrfaPYkbkFi79eK1ETxx3NomYNU

# HNiGU+X1Be8L7qpHwjo0g3/33XhtOr9LiDoUXh/V2LFTETiqV9Q8yLEavQW3j9LQ

# /h/CaGz5YdGfrY8HiPfMIeLEokKxGf0hHcTEFApB0yLlq6KoHrFAEANR/4XuFIpl

# 9sDywVIWt4tKqG+P6pRAXzg1zG5rGlslZWmw7XwgvhBu3jkLP9AxrsSYwY2ftrww

# ze5NA6VDLS7pz+OrXXWLUmoyNrJNx5Bk0wEwzkQxzkOvmbdPhsOP1ZM0uA/xIV7c

# SpNpZUw5MIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAAAAAAFTANBgkqhkiG

# 9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO

# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEy

# MDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw

# MTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB

# AOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2AX9sSuDivbk+F2Az

# /1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpSg0S3po5GawcU88V2

# 9YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2rrPY2vjUmZNqYO7oa

# ezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k45GPsjksUZzpcGkN

# yjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSueik3rMvrg0XnRm7K

# MtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09/SDPc31BmkZ1zcRf

# NN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR6L8FA6PRc6ZNN3SU

# HDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxCaC4Q6oRRRuLRvWoY

# WmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaDIV1fMHSRlJTYuVD5

# C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMURHXLvjflSxIUXk8A8

# FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMBAAGjggHdMIIB2TAS

# BgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQqp1L+ZMSavoKRPEY1

# Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXAYDVR0gBFUw

# UzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0cDovL3d3dy5taWNy

# b3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRtMBMGA1UdJQQMMAoG

# CCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIB

# hjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fO

# mhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9w

# a2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggr

# BgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNv

# bS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MA0GCSqGSIb3

# DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2Pk5HZHixBpOXPTEz

# tTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03dmLq2HnjYNi6cqYJW

# AAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1TkeFN1JFe53Z/zjj3G

# 82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kpicO8F7BUhUKz/Aye

# ixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKpW99Jo3QMvOyRgNI9

# 5ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrYUP4KWN1APMdUbZ1j

# dEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QBjloZkWsNn6Qo3GcZ

# KCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkBRH58oWFsc/4Ku+xB

# Zj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0ViY1w/ue10CgaiQuP

# Ntq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq0Z4+7X6gMTN9vMvp

# e784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1VM1izoXBm8qGCA1Aw

# ggI4AgEBMIH5oYHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw

# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAInb

# HtxB+OlGyQnxQYhy04KSYSSPoIGDMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAg

# UENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDqoVOVMCIYDzIwMjQwOTI3MTU1MzU3

# WhgPMjAyNDA5MjgxNTUzNTdaMHcwPQYKKwYBBAGEWQoEATEvMC0wCgIFAOqhU5UC

# AQAwCgIBAAICGaMCAf8wBwIBAAICE7YwCgIFAOqipRUCAQAwNgYKKwYBBAGEWQoE

# AjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkq

# hkiG9w0BAQsFAAOCAQEANqm9t0Ld/0Bi56c9hxS4z/doDZiKZF8AKXO4G2fXB6qh

# 1DoiXmnB34xYpZyDd8AAA35KL5cECal9guNjrUcF4e7cJctJcOshCRtpQQrcjQBM

# mQzBCcGiVqO8qHwkWhv+q556GQOCs+NZiy1ULOcjO3Uvk30AI2mso+1ak2iMBUfW

# Py5zconjkccS3efgVgos93S0oiNMkHqw5GSZVLydUt4ChESZAkTMll8UqvTZF2ne

# j1qwPa8GwUlrOnpd7kMtHELJ2CfPvkTjGW2x09lSztFDU5IQw2hT20D2Z60YExTZ

# +qqC/sh3uaVN/s5iPp5QROE92N6MrsRF6rcZboFMETGCBA0wggQJAgEBMIGTMHwx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB6pokctVZP2FjAAEAAAHq

# MA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQw

# LwYJKoZIhvcNAQkEMSIEIDwls3ogfbYpMBhgx2HIlqoNMIQdHvErXkQcDF0LVS/7

# MIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgKY+h1eNkNHiLCDSW0sA1cGHk

# bW4qooi+ryyMp6S4ZngwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMAITMwAAAeqaJHLVWT9hYwABAAAB6jAiBCDdHcrPDn5ox9D+suL1WRTtlWdz

# 9lt33qs9dZ+xyjBtvjANBgkqhkiG9w0BAQsFAASCAgCAYQq6O0NLz99Yn58/qQ48

# M0tH12uRvEjHeBgGFqjoenwBeu9Z8FdGDRB4bMKF9a5Qb9equqyV3Z7sSQT8mzXs

# TIZwDhl7tEXoBe7w7e+OuJ+pNZ7nf+4hqyaNJ3M1CqlTWpqJiCIgxrsrxR0aK4Kk

# SYVF4gYGEA6FXWAsfkPNvf+s7kN4XBcFmbMG4BRxAyabM8pS5ONRKiNdzCscAMqh

# p/A7NgOnbGwf8yeh/EN8ZkiqF0D6nwCad/n9J9mM0NCf5a+bv679I73pSM1G8nvm

# 7WESy5GO45RarkOQF68Ts1ngrt2EHXHQL0Is2Dtu7V0AFQvDPHcU2rN/SDKPoweH

# TMynEo+SmgUFWkHX/1sm7lhXqLiVFdgyZ9w9qhZ92cnAPenHn8j0W8IcRSZTSj7D

# S0FTHNCtWYpXYE9RLusiXSJaODTsiPEAXRhUHcA3q7b5h6gyf17k+w0lMTD2zxcX

# t6TbzlRi2BYhQvQLccuhKLZrV6GL0LQc2AsH0PZGUuCa0+fW0boKryqXGkLPGaWy

# FsZG1LuGVDM0180YWiv9YX5vNWui4ITu4gRzfkU7tZdAICaPpxtg1aqLe4bbjPny

# svwDTk2oGuOMT6102wDbDah6RRxyNwJFemE/0kIU2VRvXrd2BISb+YMpiAivj5GN

# mMBAuWulAJfTssdn/LgEQg==

# SIG # End signature block