Lability

0.21.0

Src/Public/Register-LabMedia.ps1

                                function Register-LabMedia {

<#

    .SYNOPSIS

        Registers a custom media entry.

    .DESCRIPTION

        The Register-LabMedia cmdlet allows adding custom media to the host's configuration. This circumvents the requirement of having to define custom media entries in the DSC configuration document (.psd1).

        You can use the Register-LabMedia cmdlet to override the default media entries, e.g. you have the media hosted internally or you wish to replace the built-in media with your own implementation.

        To override a built-in media entry, specify the same media Id with the -Force switch.

    .PARAMETER Legacy

        Specifies registering a legacy Windows 10 media as custom media.

    .EXAMPLE

        Register-LabMedia -Legacy WIN10_x64_Enterprise_1809_EN_Eval

        Reregisters the deprecated Windows 10 Enterprise x64 English evaluation media.

    .LINK

        Get-LabMedia

        Unregister-LabMedia

#>

    [CmdletBinding(DefaultParameterSetName = 'ID')]

    [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseSingularNouns','')]

    param

    (

        ## Specifies the media Id to register. You can override the built-in media if required.

        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [System.String] $Id,

        ## Specifies the media's type.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateSet('VHD','ISO','WIM','NULL')]

        [System.String] $MediaType,

        ## Specifies the source Uri (http/https/file) of the media.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [System.Uri] $Uri,

        ## Specifies the architecture of the media.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateSet('x64','x86')]

        [System.String] $Architecture,

        ## Specifies a description of the media.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNullOrEmpty()]

        [System.String] $Description,

        ## Specifies the image name containing the target WIM image. You can specify integer values.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNullOrEmpty()]

        [System.String] $ImageName,

        ## Specifies the local filename of the locally cached resource file.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNullOrEmpty()]

        [System.String] $Filename,

        ## Specifies the MD5 checksum of the resource file.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNullOrEmpty()]

        [System.String] $Checksum,

        ## Specifies custom data for the media.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNull()]

        [System.Collections.Hashtable] $CustomData,

        ## Specifies additional Windows hotfixes to install post deployment.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateNotNull()]

        [System.Collections.Hashtable[]] $Hotfixes,

        ## Specifies the media type. Linux VHD(X)s do not inject resources.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [ValidateSet('Windows','Linux')]

        [System.String] $OperatingSystem = 'Windows',

        ## Specifies the media alias (Id).

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'ID')]

        [System.String] $Alias,

        ## Registers media via a JSON file hosted externally.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'FromUri')]

        [System.String] $FromUri,

        ## Registers media using a custom Id.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'FromUri')]

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'Legacy')]

        [System.String] $CustomId,

        ## Specifies that an exiting media entry should be overwritten.

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force

    )

    DynamicParam

    {

        ## Adds a dynamic -Legacy parameter that returns the available legacy Windows 10 media Ids

        $parameterAttribute = New-Object -TypeName 'System.Management.Automation.ParameterAttribute'

        $parameterAttribute.ParameterSetName = 'Legacy'

        $parameterAttribute.Mandatory = $true

        $attributeCollection = New-Object -TypeName 'System.Collections.ObjectModel.Collection[System.Attribute]'

        $attributeCollection.Add($parameterAttribute)

        $mediaIds = (Get-LabMedia -Legacy).Id

        $validateSetAttribute = New-Object -TypeName 'System.Management.Automation.ValidateSetAttribute' -ArgumentList $mediaIds

        $attributeCollection.Add($validateSetAttribute)

        $runtimeParameter = New-Object -TypeName 'System.Management.Automation.RuntimeDefinedParameter' -ArgumentList @('Legacy', [System.String], $attributeCollection)

        $runtimeParameterDictionary = New-Object -TypeName 'System.Management.Automation.RuntimeDefinedParameterDictionary'

        $runtimeParameterDictionary.Add('Legacy', $runtimeParameter)

        return $runtimeParameterDictionary

    }

    process

    {

        switch ($PSCmdlet.ParameterSetName)

        {

            Legacy {

                ## Download the json content and convert into a hashtable

                $legacyMedia = Get-LabMedia -Id $PSBoundParameters.Legacy -Legacy | Convert-PSObjectToHashtable

                if ($PSBoundParameters.ContainsKey('CustomId'))

                {

                    $legacyMedia['Id'] = $CustomId

                }

                ## Recursively call Register-LabMedia and splat the properties

                return (Register-LabMedia @legacyMedia -Force:$Force)

            }

            FromUri {

                ## Download the json content and convert into a hashtable

                $customMedia = Invoke-RestMethod -Uri $FromUri | Convert-PSObjectToHashtable

                if ($PSBoundParameters.ContainsKey('CustomId'))

                {

                    $customMedia['Id'] = $CustomId

                }

                ## Recursively call Register-LabMedia and splat the properties

                return (Register-LabMedia @customMedia -Force:$Force)

            }

            default {

                ## Validate Linux VM media type is VHD or NULL

                if (($OperatingSystem -eq 'Linux') -and ($MediaType -notin 'VHD','NULL'))

                {

                    throw ($localized.InvalidOSMediaTypeError -f $MediaType, $OperatingSystem)

                }

                ## Validate ImageName when media type is ISO/WIM

                if (($MediaType -eq 'ISO') -or ($MediaType -eq 'WIM'))

                {

                    if (-not $PSBoundParameters.ContainsKey('ImageName'))

                    {

                        throw ($localized.ImageNameRequiredError -f '-ImageName')

                    }

                }

                ## Resolve the media Id to see if it's already been used

                try

                {

                    $media = Resolve-LabMedia -Id $Id -ErrorAction SilentlyContinue

                }

                catch

                {

                    Write-Debug -Message ($localized.CannotLocateMediaError -f $Id)

                }

                if ($media -and (-not $Force))

                {

                    throw ($localized.MediaAlreadyRegisteredError -f $Id, '-Force')

                }

                if ($PSBoundParameters.ContainsKey('Alias'))

                {

                    ## Check to see whether the alias is already registered

                    $existingMediaIds = Get-LabMediaId

                    if ($existingMediaIds.Contains($Alias))

                    {

                        throw ($localized.MediaAliasAlreadyRegisteredError -f $Alias)

                    }

                }

                ## Get the custom media list (not the built in media)

                $existingCustomMedia = @(Get-ConfigurationData -Configuration CustomMedia)

                if (-not $existingCustomMedia)

                {

                    $existingCustomMedia = @()

                }

                $customMedia = [PSCustomObject] @{

                    Id              = $Id

                    Alias           = $Alias

                    Filename        = $Filename

                    Description     = $Description

                    Architecture    = $Architecture

                    ImageName       = $ImageName

                    MediaType       = $MediaType

                    OperatingSystem = $OperatingSystem

                    Uri             = $Uri

                    Checksum        = $Checksum

                    CustomData      = $CustomData

                    Hotfixes        = $Hotfixes

                }

                $hasExistingMediaEntry = $false

                for ($i = 0; $i -lt $existingCustomMedia.Count; $i++)

                {

                    if ($existingCustomMedia[$i].Id -eq $Id)

                    {

                        Write-Verbose -Message ($localized.OverwritingCustomMediaEntry -f $Id)

                        $hasExistingMediaEntry = $true

                        $existingCustomMedia[$i] = $customMedia

                    }

                }

                if (-not $hasExistingMediaEntry)

                {

                    ## Add it to the array

                    Write-Verbose -Message ($localized.AddingCustomMediaEntry -f $Id)

                    $existingCustomMedia += $customMedia

                }

                Write-Verbose -Message ($localized.SavingConfiguration -f $Id)

                Set-ConfigurationData -Configuration CustomMedia -InputObject @($existingCustomMedia)

                return $customMedia

            } #end default

        } #end switch

    } #end process

} #end function

# SIG # Begin signature block

# MIIdMgYJKoZIhvcNAQcCoIIdIzCCHR8CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUfK9yJhYw27ok9nPjX8Q3M2ZZ

# FVigghfKMIIE/jCCA+agAwIBAgIQDUJK4L46iP9gQCHOFADw3TANBgkqhkiG9w0B

# AQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFz

# c3VyZWQgSUQgVGltZXN0YW1waW5nIENBMB4XDTIxMDEwMTAwMDAwMFoXDTMxMDEw

# NjAwMDAwMFowSDELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMu

# MSAwHgYDVQQDExdEaWdpQ2VydCBUaW1lc3RhbXAgMjAyMTCCASIwDQYJKoZIhvcN

# AQEBBQADggEPADCCAQoCggEBAMLmYYRnxYr1DQikRcpja1HXOhFCvQp1dU2UtAxQ

# tSYQ/h3Ib5FrDJbnGlxI70Tlv5thzRWRYlq4/2cLnGP9NmqB+in43Stwhd4CGPN4

# bbx9+cdtCT2+anaH6Yq9+IRdHnbJ5MZ2djpT0dHTWjaPxqPhLxs6t2HWc+xObTOK

# fF1FLUuxUOZBOjdWhtyTI433UCXoZObd048vV7WHIOsOjizVI9r0TXhG4wODMSlK

# XAwxikqMiMX3MFr5FK8VX2xDSQn9JiNT9o1j6BqrW7EdMMKbaYK02/xWVLwfoYer

# vnpbCiAvSwnJlaeNsvrWY4tOpXIc7p96AXP4Gdb+DUmEvQECAwEAAaOCAbgwggG0

# MA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsG

# AQUFBwMIMEEGA1UdIAQ6MDgwNgYJYIZIAYb9bAcBMCkwJwYIKwYBBQUHAgEWG2h0

# dHA6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAfBgNVHSMEGDAWgBT0tuEgHf4prtLk

# YaWyoiWyyBc1bjAdBgNVHQ4EFgQUNkSGjqS6sGa+vCgtHUQ23eNqerwwcQYDVR0f

# BGowaDAyoDCgLoYsaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJl

# ZC10cy5jcmwwMqAwoC6GLGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFz

# c3VyZWQtdHMuY3JsMIGFBggrBgEFBQcBAQR5MHcwJAYIKwYBBQUHMAGGGGh0dHA6

# Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBPBggrBgEFBQcwAoZDaHR0cDovL2NhY2VydHMu

# ZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3VyZWRJRFRpbWVzdGFtcGluZ0NB

# LmNydDANBgkqhkiG9w0BAQsFAAOCAQEASBzctemaI7znGucgDo5nRv1CclF0CiNH

# o6uS0iXEcFm+FKDlJ4GlTRQVGQd58NEEw4bZO73+RAJmTe1ppA/2uHDPYuj1UUp4

# eTZ6J7fz51Kfk6ftQ55757TdQSKJ+4eiRgNO/PT+t2R3Y18jUmmDgvoaU+2QzI2h

# F3MN9PNlOXBL85zWenvaDLw9MtAby/Vh/HUIAHa8gQ74wOFcz8QRcucbZEnYIpp1

# FUL1LTI4gdr0YKK6tFL7XOBhJCVPst/JKahzQ1HavWPWH1ub9y4bTxMd90oNcX6X

# t/Q/hOvB46NJofrOp79Wz7pZdmGJX36ntI5nePk2mOHLKNpbh6aKLzCCBTEwggQZ

# oAMCAQICEAqhJdbWMht+QeQF2jaXwhUwDQYJKoZIhvcNAQELBQAwZTELMAkGA1UE

# BhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2lj

# ZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4X

# DTE2MDEwNzEyMDAwMFoXDTMxMDEwNzEyMDAwMFowcjELMAkGA1UEBhMCVVMxFTAT

# BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEx

# MC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFtcGluZyBD

# QTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL3QMu5LzY9/3am6gpnF

# OVQoV7YjSsQOB0UzURB90Pl9TWh+57ag9I2ziOSXv2MhkJi/E7xX08PhfgjWahQA

# OPcuHjvuzKb2Mln+X2U/4Jvr40ZHBhpVfgsnfsCi9aDg3iI/Dv9+lfvzo7oiPhis

# EeTwmQNtO4V8CdPuXciaC1TjqAlxa+DPIhAPdc9xck4Krd9AOly3UeGheRTGTSQj

# MF287DxgaqwvB8z98OpH2YhQXv1mblZhJymJhFHmgudGUP2UKiyn5HU+upgPhH+f

# MRTWrdXyZMt7HgXQhBlyF/EXBu89zdZN7wZC/aJTKk+FHcQdPK/P2qwQ9d2srOlW

# /5MCAwEAAaOCAc4wggHKMB0GA1UdDgQWBBT0tuEgHf4prtLkYaWyoiWyyBc1bjAf

# BgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzASBgNVHRMBAf8ECDAGAQH/

# AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB5BggrBgEF

# BQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBD

# BggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0

# QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHoweDA6oDigNoY0aHR0cDovL2Ny

# bDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDA6oDig

# NoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9v

# dENBLmNybDBQBgNVHSAESTBHMDgGCmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYc

# aHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzALBglghkgBhv1sBwEwDQYJKoZI

# hvcNAQELBQADggEBAHGVEulRh1Zpze/d2nyqY3qzeM8GN0CE70uEv8rPAwL9xafD

# DiBCLK938ysfDCFaKrcFNB1qrpn4J6JmvwmqYN92pDqTD/iy0dh8GWLoXoIlHsS6

# HHssIeLWWywUNUMEaLLbdQLgcseY1jxk5R9IEBhfiThhTWJGJIdjjJFSLK8pieV4

# H9YLFKWA1xJHcLN11ZOFk362kmf7U2GJqPVrlsD0WGkNfMgBsbkodbeZY4UijGHK

# eZR+WfyMD+NvtQEmtmyl7odRIeRYYJu6DC0rbaLEfrvEJStHAgh8Sa4TtuF8QkIo

# xhhWz0E0tmZdtnR79VYzIi8iNrJLokqV2PWmjlIwggawMIIEmKADAgECAhAIrUCy

# YNKcTJ9ezam9k67ZMA0GCSqGSIb3DQEBDAUAMGIxCzAJBgNVBAYTAlVTMRUwEwYD

# VQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAf

# BgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBHNDAeFw0yMTA0MjkwMDAwMDBa

# Fw0zNjA0MjgyMzU5NTlaMGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2Vy

# dCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25p

# bmcgUlNBNDA5NiBTSEEzODQgMjAyMSBDQTEwggIiMA0GCSqGSIb3DQEBAQUAA4IC

# DwAwggIKAoICAQDVtC9C0CiteLdd1TlZG7GIQvUzjOs9gZdwxbvEhSYwn6SOaNhc

# 9es0JAfhS0/TeEP0F9ce2vnS1WcaUk8OoVf8iJnBkcyBAz5NcCRks43iCH00fUyA

# VxJrQ5qZ8sU7H/Lvy0daE6ZMswEgJfMQ04uy+wjwiuCdCcBlp/qYgEk1hz1RGeiQ

# IXhFLqGfLOEYwhrMxe6TSXBCMo/7xuoc82VokaJNTIIRSFJo3hC9FFdd6BgTZcV/

# sk+FLEikVoQ11vkunKoAFdE3/hoGlMJ8yOobMubKwvSnowMOdKWvObarYBLj6Na5

# 9zHh3K3kGKDYwSNHR7OhD26jq22YBoMbt2pnLdK9RBqSEIGPsDsJ18ebMlrC/2pg

# VItJwZPt4bRc4G/rJvmM1bL5OBDm6s6R9b7T+2+TYTRcvJNFKIM2KmYoX7Bzzosm

# JQayg9Rc9hUZTO1i4F4z8ujo7AqnsAMrkbI2eb73rQgedaZlzLvjSFDzd5Ea/ttQ

# okbIYViY9XwCFjyDKK05huzUtw1T0PhH5nUwjewwk3YUpltLXXRhTT8SkXbev1jL

# chApQfDVxW0mdmgRQRNYmtwmKwH0iU1Z23jPgUo+QEdfyYFQc4UQIyFZYIpkVMHM

# IRroOBl8ZhzNeDhFMJlP/2NPTLuqDQhTQXxYPUez+rbsjDIJAsxsPAxWEQIDAQAB

# o4IBWTCCAVUwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQUaDfg67Y7+F8R

# hvv+YXsIiGX0TkIwHwYDVR0jBBgwFoAU7NfjgtJxXWRM3y5nP+e6mK4cD08wDgYD

# VR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUFBwMDMHcGCCsGAQUFBwEBBGsw

# aTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEEGCCsGAQUF

# BzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVk

# Um9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJodHRwOi8vY3JsMy5kaWdpY2Vy

# dC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNybDAcBgNVHSAEFTATMAcGBWeB

# DAEDMAgGBmeBDAEEATANBgkqhkiG9w0BAQwFAAOCAgEAOiNEPY0Idu6PvDqZ01bg

# Ahql+Eg08yy25nRm95RysQDKr2wwJxMSnpBEn0v9nqN8JtU3vDpdSG2V1T9J9Ce7

# FoFFUP2cvbaF4HZ+N3HLIvdaqpDP9ZNq4+sg0dVQeYiaiorBtr2hSBh+3NiAGhEZ

# GM1hmYFW9snjdufE5BtfQ/g+lP92OT2e1JnPSt0o618moZVYSNUa/tcnP/2Q0XaG

# 3RywYFzzDaju4ImhvTnhOE7abrs2nfvlIVNaw8rpavGiPttDuDPITzgUkpn13c5U

# bdldAhQfQDN8A+KVssIhdXNSy0bYxDQcoqVLjc1vdjcshT8azibpGL6QB7BDf5WI

# IIJw8MzK7/0pNVwfiThV9zeKiwmhywvpMRr/LhlcOXHhvpynCgbWJme3kuZOX956

# rEnPLqR0kq3bPKSchh/jwVYbKyP/j7XqiHtwa+aguv06P0WmxOgWkVKLQcBIhEuW

# TatEQOON8BUozu3xGFYHKi8QxAwIZDwzj64ojDzLj4gLDb879M4ee47vtevLt/B3

# E+bnKD+sEq6lLyJsQfmCXBVmzGwOysWGw/YmMwwHS6DTBwJqakAwSEs0qFEgu60b

# hQjiWQ1tygVQK+pKHJ6l/aCnHwZ05/LWUpD9r4VIIflXO7ScA+2GRfS0YW6/aOIm

# YIbqyK+p/pQd52MbOoZWeE4wggbbMIIEw6ADAgECAhAEyswKPFRr9qgYCxGuzc8m

# MA0GCSqGSIb3DQEBCwUAMGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2Vy

# dCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBDb2RlIFNpZ25p

# bmcgUlNBNDA5NiBTSEEzODQgMjAyMSBDQTEwHhcNMjExMDE5MDAwMDAwWhcNMjMx

# MTA0MjM1OTU5WjBgMQswCQYDVQQGEwJHQjEPMA0GA1UEBxMGTG9uZG9uMR8wHQYD

# VQQKExZWaXJ0dWFsIEVuZ2luZSBMaW1pdGVkMR8wHQYDVQQDExZWaXJ0dWFsIEVu

# Z2luZSBMaW1pdGVkMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAtbm3

# o57mQYxu0idSifhlyZaDVO0Zu0BnGTFZOtZLibBotgpKp7Be3k9WDyIbOiUHVaFY

# 7DG8aL8krpArj+3KJR49U5pLXcevNUQFLL18pi9lZ+e2w+dcBAfuJ30J760VtPDw

# AA7nmAff3f9o+tEB1ZnIeXzlPRyMz7YZS43sDeAft8p8jFzmM0jRtt9SXNxKcC0g

# nX6Cx0vw4AkxmMtreX/Igvj5VVq4M81E84CefWsU/IpqIL24xpxl3OOwZ53wzn+r

# PA3T9bj0PUyI/6VvONUIRD/EfODxurVdSDduLHsRag4+Q3xFvZm/WNqsr2qGv7LH

# T3uKPsjuPBo1Mz9fM/AfPwdEfM3xJ+Y1rBqUxnDhwYS97Fw3LM63lTKl3bN4TOFE

# JX8YPgC02J4vzYSIP0fwBBPyd7MtbiXzFvSoXnl0EQmjH+k4fjOCwn1tgWnI77NE

# T05Jd06F3Od52In9qIJ5Bhu4zlMFEQgE7JONOI4/Hl/dBzfNkyItMMRcNiPJAgMB

# AAGjggIGMIICAjAfBgNVHSMEGDAWgBRoN+Drtjv4XxGG+/5hewiIZfROQjAdBgNV

# HQ4EFgQUEr+p1bWwrT+zl6+TXhHWz9ewYuAwDgYDVR0PAQH/BAQDAgeAMBMGA1Ud

# JQQMMAoGCCsGAQUFBwMDMIG1BgNVHR8Ega0wgaowU6BRoE+GTWh0dHA6Ly9jcmwz

# LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNBNDA5

# NlNIQTM4NDIwMjFDQTEuY3JsMFOgUaBPhk1odHRwOi8vY3JsNC5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQyMDIx

# Q0ExLmNybDA+BgNVHSAENzA1MDMGBmeBDAEEATApMCcGCCsGAQUFBwIBFhtodHRw

# Oi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwgZQGCCsGAQUFBwEBBIGHMIGEMCQGCCsG

# AQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNENvZGVT

# aWduaW5nUlNBNDA5NlNIQTM4NDIwMjFDQTEuY3J0MAwGA1UdEwEB/wQCMAAwDQYJ

# KoZIhvcNAQELBQADggIBAB35Ee2voPHjrdDlB80kocW2ZrVcKO5/POchPOvxL1ev

# XPdoaexNDCwXzM/6GXa4U1VhV+GqbeQ+JCZFXWbiycxqXEfi5fxj2sRzdF3CDoot

# FiqxK1eqz2W82KR5FX45LTsQMrg6O8kA2nb2eBxk6TWYUtS+3jtdS/nwDp/B/A+o

# l0CaD51hlzq9QY0NNkwsbZ+fKmIxinqEFF6ntaOmQNWS0EOtNQBYdlf0pNThBuPx

# ENsDtWRS56pg3qfl3+khteed8sFoyY/9g1Sofbc7DAQiYtTikmekA+s5WkHY1ewi

# SF/NcXSNNMNgbuAsizoMQ9NkJ/vMhs89+hNUe6Tlk9bFffOP9oh5z6Df/XHJslhN

# Y3DxWYQQxtqzZpAk/4GCJ8L9qdeEDvtulPp3p6VqNBxQPu98C46pfXgCX0vIieVy

# 3RZOhHD2JCytWNFWXJFvoo03akcyTumiq2+mew6ALwXKKtFeoDHfnzDkVsZRPqY4

# 9gECVKifY7Z7Usuf3SBOB6txOlzK15eMR2EIRsBSCPVZCevU9z51DP/GLZ6/kCDG

# 6hcu6isenIWAxWw1wiGv6HJpca73ummRYoUeKtNV8hg7ItlPimtrjjoT+0ciE8Oh

# uv5GDBqK0GE4ikCIUZyFg74ppkHV4q+YghXvubkwMSV7ymFRKhgcGQLlDXP+OaVQ

# MYIE0jCCBM4CAQEwfTBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQs

# IEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgQ29kZSBTaWduaW5n

# IFJTQTQwOTYgU0hBMzg0IDIwMjEgQ0ExAhAEyswKPFRr9qgYCxGuzc8mMAkGBSsO

# AwIaBQCgeDAYBgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEM

# BgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqG

# SIb3DQEJBDEWBBR7cM/ucuiPmDVPkrCBoDoyvIeekDANBgkqhkiG9w0BAQEFAASC

# AYCegzVkTwshSt23K0oVPPb0Zo4sqCM/qTneYnJLBvSau3hzjiw5PK15wZRkcQQn

# sGPyEluUaClI45n4TiJR+EwiDvaSmijK/hiPw1PNy5G88ggmNv6eV5NfvapwdylI

# Fwd4rR2djlBnRAqXx4jbIQvaT5SIH9Mh5F9YqOGTJ8v1Y6BZ2riEN6r/kQJBHRyT

# YaDfpe9yLHbi+eNoo1Mxs5TvyCbAJpK8EPY2cxxqFWjeScgEwecmH3QHfjFiK5NY

# J5My0dOfkHgrQjYRErk48jldkyomp//2udQmgEAZUK9MYm8iW1hdMWRdgpnOoCxh

# 9oHwLneYZZDIsbAiHY699Ij8gBmsIPpshwDvVlIVA4lAjwnCKe7ZzPfFevv1hROq

# yqrwXZG1FBeLsiL5WfXoHEHrrI2GOnSlKMk+lMhaF5s6ZkHiOdS9xz28o3sNHRnk

# 67mA/qgL2ha8p+IL9WjG5D5Z4ap6EbQdtTC6CfG7ktTqU0b3lV2xp67lovIvtJim

# krehggIwMIICLAYJKoZIhvcNAQkGMYICHTCCAhkCAQEwgYYwcjELMAkGA1UEBhMC

# VVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0

# LmNvbTExMC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIFRpbWVzdGFt

# cGluZyBDQQIQDUJK4L46iP9gQCHOFADw3TANBglghkgBZQMEAgEFAKBpMBgGCSqG

# SIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIyMDEwNjEwMDgw

# MFowLwYJKoZIhvcNAQkEMSIEIDBYRh8afoQ4UkiMIOZK7UpHno+A6JiDC1IdhGuJ

# I0buMA0GCSqGSIb3DQEBAQUABIIBAGlvqgTk3vWa/PF/jr33RDuMLcciVAT+iz6M

# CTcjqWhI0Osp+eP/uWcpl1pSecFChJ0Hr/u7lmH47fsnNotFBPAqdjDf5oNKVUSa

# dg3IqaEYsQSx60IhkzHn6ogFWNNQC2ASycNr9QG7aM8Gg5YJ1qSQUwmnAJlAADqR

# 36U/TS2jv7yxzKyT7g9zDwtPCaPbTyX+RQ1+vlW71Wtjdi11qBKSOEZ1uvJ9/cKX

# /eaqrirX9eOM8Ct+LPPUSj8jUNvHBFeVc8rm5WgTD/Gqqgy0AW/5hOkfEVDf4hOi

# yECxJsiJPH89fdelZQ5Ly3k9sepOZuXyKZV4snKHVac5APU1NSs=

# SIG # End signature block