Lability

0.11.0

Src/LabVMDiskFile.ps1

                                function SetLabVMDiskModule {

<#

    .SYNOPSIS

        Downloads (if required) PowerShell/DSC modules and expands

        them to the destination path specified.

#>

    [CmdletBinding()]

    param (

        ## Lability PowerShell modules/DSC resource hashtable

        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

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

        ## The target VHDX modules path

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $DestinationPath,

        ## Force a download of the module(s) even if they already exist in the cache.

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force,

        ## Removes existing target module directory (if present)

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Clean

    )

    process {

        ## Invokes the module download if not cached, and returns the source

        [ref] $null = InvokeModuleCacheDownload -Module $Module -Force:$Force

        ## Expand the modules into the VHDX file

        [ref] $null = ExpandModuleCache -Module $Module -DestinationPath $DestinationPath -Clean:$Clean;

    } #end process

} #end function SetLabVMDiskModule

function SetLabVMDiskFileResource {

<#

    .SYNOPSIS

        Copies a node's defined resources to VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Lab VM/Node name

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $NodeName,

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        $hostDefaults = Get-ConfigurationData -Configuration Host;

        $resourceDestinationPath = '{0}:\{1}' -f $vhdDriveLetter, $hostDefaults.ResourceShareName;

        $expandLabResourceParams = @{

            ConfigurationData = $ConfigurationData;

            Name = $NodeName;

            DestinationPath = $resourceDestinationPath;

        }

        WriteVerbose -Message ($localized.AddingVMResource -f 'VM');

        ExpandLabResource @expandLabResourceParams;

    } #end process

} #end function SetLabVMDiskFileResource

function SetLabVMDiskFileModule {

<#

    .SYNOPSIS

        Copies a node's PowerShell and DSC resource modules to a VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Lab VM/Node name

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $NodeName,

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        ## Resolve the localized %ProgramFiles% directory

        $programFilesPath = '{0}\WindowsPowershell\Modules' -f (Resolve-ProgramFilesFolder -Drive $VhdDriveLetter).FullName

        ## Add the DSC resource modules

        $resolveLabModuleParams =@{

            ConfigurationData = $ConfigurationData;

            NodeName = $NodeName;

            ModuleType = 'DscResource';

        }

        $setLabVMDiskDscModuleParams = @{

            Module = Resolve-LabModule @resolveLabModuleParams;

            DestinationPath = $programFilesPath;

        }

        if ($null -ne $setLabVMDiskDscModuleParams['Module']) {

            WriteVerbose -Message ($localized.AddingDSCResourceModules -f $programFilesPath);

            SetLabVMDiskModule @setLabVMDiskDscModuleParams;

        }

        ## Add the PowerShell resource modules

        $resolveLabModuleParams =@{

            ConfigurationData = $ConfigurationData;

            NodeName = $NodeName;

            ModuleType = 'Module';

        }

        $setLabVMDiskPowerShellModuleParams = @{

            Module = Resolve-LabModule @resolveLabModuleParams;

            DestinationPath = $programFilesPath;

        }

        if ($null -ne $setLabVMDiskPowerShellModuleParams['Module']) {

            WriteVerbose -Message ($localized.AddingPowerShellModules -f $programFilesPath);

            SetLabVMDiskModule @setLabVMDiskPowerShellModuleParams;

        }

    } #end process

} #end function SetLabVMDiskFileModule

function SetLabVMDiskFileUnattendXml {

<#

    .SYNOPSIS

        Copies a node's unattent.xml to a VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Lab VM/Node name

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $NodeName,

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Local administrator password of the VM

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [System.Management.Automation.PSCredential]

        [System.Management.Automation.CredentialAttribute()]

        $Credential,

        ## Media-defined product key

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.String] $ProductKey,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        $node = Resolve-NodePropertyValue -NodeName $NodeName -ConfigurationData $ConfigurationData -ErrorAction Stop;

        ## Create Unattend.xml

        $newUnattendXmlParams = @{

            ComputerName = $node.NodeName;

            Credential = $Credential;

            InputLocale = $node.InputLocale;

            SystemLocale = $node.SystemLocale;

            UserLocale = $node.UserLocale;

            UILanguage = 'en-US';

            Timezone = $node.Timezone;

            RegisteredOwner = $node.RegisteredOwner;

            RegisteredOrganization = $node.RegisteredOrganization;

        }

        WriteVerbose -Message $localized.SettingAdministratorPassword;

        ## Node defined Product Key takes preference over key defined in the media definition

        if ($node.CustomData.ProductKey) {

            $newUnattendXmlParams['ProductKey'] = $node.CustomData.ProductKey;

        }

        elseif ($PSBoundParameters.ContainsKey('ProductKey')) {

            $newUnattendXmlParams['ProductKey'] = $ProductKey;

        }

        ## TODO: We probably need to be localise the \Windows\ (%ProgramFiles% has been done) directory?

        $unattendXmlPath = '{0}:\Windows\System32\Sysprep\Unattend.xml' -f $VhdDriveLetter;

        WriteVerbose -Message ($localized.AddingUnattendXmlFile -f $unattendXmlPath);

        [ref] $null = SetUnattendXml @newUnattendXmlParams -Path $unattendXmlPath;

    } #end process

} #end function SetLabVMDiskFileUnattendXml

function SetLabVMDiskFileBootstrap {

<#

    .SYNOPSIS

        Copies a the Lability bootstrap file to a VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Custom bootstrap script

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $CustomBootstrap,

        ## CoreCLR

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $CoreCLR,

        ## Custom/replacement shell

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.String] $DefaultShell,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        $bootStrapPath = '{0}:\BootStrap' -f $VhdDriveLetter;

        WriteVerbose -Message ($localized.AddingBootStrapFile -f $bootStrapPath);

        $setBootStrapParams = @{

            Path = $bootStrapPath;

            CoreCLR = $CoreCLR;

        }

        if ($CustomBootStrap) {

            $setBootStrapParams['CustomBootStrap'] = $CustomBootStrap;

        }

        if ($PSBoundParameters.ContainsKey('DefaultShell')) {

            WriteVerbose -Message ($localized.SettingCustomShell -f $DefaultShell);

            $setBootStrapParams['DefaultShell'] = $DefaultShell;

        }

        SetBootStrap @setBootStrapParams;

        $setupCompleteCmdPath = '{0}:\Windows\Setup\Scripts' -f $vhdDriveLetter;

        WriteVerbose -Message ($localized.AddingSetupCompleteCmdFile -f $setupCompleteCmdPath);

        SetSetupCompleteCmd -Path $setupCompleteCmdPath -CoreCLR:$CoreCLR;

    } #end process

} #end function SetLabVMDiskFileBootstrap

function SetLabVMDiskFileMof {

<#

    .SYNOPSIS

        Copies a node's mof files to a VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Lab VM/Node name

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $NodeName,

        ## Lab VM/Node DSC .mof and .meta.mof configuration files

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [System.String] $Path,

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        $bootStrapPath = '{0}:\BootStrap' -f $VhdDriveLetter;

        $mofPath = Join-Path -Path $Path -ChildPath ('{0}.mof' -f $NodeName);

        if (-not (Test-Path -Path $mofPath)) {

            WriteWarning -Message ($localized.CannotLocateMofFileError -f $mofPath);

        }

        else {

            $destinationMofPath = Join-Path -Path $bootStrapPath -ChildPath 'localhost.mof';

            WriteVerbose -Message ($localized.AddingDscConfiguration -f $destinationMofPath);

            Copy-Item -Path $mofPath -Destination $destinationMofPath -Force -ErrorAction Stop -Confirm:$false;

        }

        $metaMofPath = Join-Path -Path $Path -ChildPath ('{0}.meta.mof' -f $NodeName);

        if (Test-Path -Path $metaMofPath -PathType Leaf) {

            $destinationMetaMofPath = Join-Path -Path $bootStrapPath -ChildPath 'localhost.meta.mof';

            WriteVerbose -Message ($localized.AddingDscConfiguration -f $destinationMetaMofPath);

            Copy-Item -Path $metaMofPath -Destination $destinationMetaMofPath -Force -Confirm:$false;

        }

    } #end process

} #end function SetLabVMDiskFileMof

function SetLabVMDiskFileCertificate {

<#

    .SYNOPSIS

        Copies a node's certificate(s) to a VHD(X) file.

#>

    [CmdletBinding()]

    param (

        ## Lab VM/Node name

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $NodeName,

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Mounted VHD path

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $VhdDriveLetter,

        ## Catch all to enable splatting @PSBoundParameters

        [Parameter(ValueFromRemainingArguments)]

        $RemainingArguments

    )

    process {

        $node = Resolve-NodePropertyValue -NodeName $NodeName -ConfigurationData $ConfigurationData -ErrorAction Stop;

        $bootStrapPath = '{0}:\BootStrap' -f $VhdDriveLetter;

        if (-not [System.String]::IsNullOrWhitespace($node.ClientCertificatePath)) {

            [ref] $null = New-Item -Path $bootStrapPath -ItemType File -Name 'LabClient.pfx' -Force;

            $destinationCertificatePath = Join-Path -Path $bootStrapPath -ChildPath 'LabClient.pfx';

            $expandedClientCertificatePath = [System.Environment]::ExpandEnvironmentVariables($node.ClientCertificatePath);

            WriteVerbose -Message ($localized.AddingCertificate -f 'Client', $destinationCertificatePath);

            Copy-Item -Path $expandedClientCertificatePath -Destination $destinationCertificatePath -Force -Confirm:$false;

        }

        if (-not [System.String]::IsNullOrWhitespace($node.RootCertificatePath)) {

            [ref] $null = New-Item -Path $bootStrapPath -ItemType File -Name 'LabRoot.cer' -Force;

            $destinationCertificatePath = Join-Path -Path $bootStrapPath -ChildPath 'LabRoot.cer';

            $expandedRootCertificatePath = [System.Environment]::ExpandEnvironmentVariables($node.RootCertificatePath);

            WriteVerbose -Message ($localized.AddingCertificate -f 'Root', $destinationCertificatePath);

            Copy-Item -Path $expandedRootCertificatePath -Destination $destinationCertificatePath -Force -Confirm:$false;

        }

    } #end process

} #end functionSetLabVMDiskFileCertificate

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUI2ht/ykbVXtskrtxrbdjgQGF

# g3KgghLqMIID7jCCA1egAwIBAgIQfpPr+3zGTlnqS5p31Ab8OzANBgkqhkiG9w0B

# AQUFADCBizELMAkGA1UEBhMCWkExFTATBgNVBAgTDFdlc3Rlcm4gQ2FwZTEUMBIG

# A1UEBxMLRHVyYmFudmlsbGUxDzANBgNVBAoTBlRoYXd0ZTEdMBsGA1UECxMUVGhh

# d3RlIENlcnRpZmljYXRpb24xHzAdBgNVBAMTFlRoYXd0ZSBUaW1lc3RhbXBpbmcg

# Q0EwHhcNMTIxMjIxMDAwMDAwWhcNMjAxMjMwMjM1OTU5WjBeMQswCQYDVQQGEwJV

# UzEdMBsGA1UEChMUU3ltYW50ZWMgQ29ycG9yYXRpb24xMDAuBgNVBAMTJ1N5bWFu

# dGVjIFRpbWUgU3RhbXBpbmcgU2VydmljZXMgQ0EgLSBHMjCCASIwDQYJKoZIhvcN

# AQEBBQADggEPADCCAQoCggEBALGss0lUS5ccEgrYJXmRIlcqb9y4JsRDc2vCvy5Q

# WvsUwnaOQwElQ7Sh4kX06Ld7w3TMIte0lAAC903tv7S3RCRrzV9FO9FEzkMScxeC

# i2m0K8uZHqxyGyZNcR+xMd37UWECU6aq9UksBXhFpS+JzueZ5/6M4lc/PcaS3Er4

# ezPkeQr78HWIQZz/xQNRmarXbJ+TaYdlKYOFwmAUxMjJOxTawIHwHw103pIiq8r3

# +3R8J+b3Sht/p8OeLa6K6qbmqicWfWH3mHERvOJQoUvlXfrlDqcsn6plINPYlujI

# fKVOSET/GeJEB5IL12iEgF1qeGRFzWBGflTBE3zFefHJwXECAwEAAaOB+jCB9zAd

# BgNVHQ4EFgQUX5r1blzMzHSa1N197z/b7EyALt0wMgYIKwYBBQUHAQEEJjAkMCIG

# CCsGAQUFBzABhhZodHRwOi8vb2NzcC50aGF3dGUuY29tMBIGA1UdEwEB/wQIMAYB

# Af8CAQAwPwYDVR0fBDgwNjA0oDKgMIYuaHR0cDovL2NybC50aGF3dGUuY29tL1Ro

# YXd0ZVRpbWVzdGFtcGluZ0NBLmNybDATBgNVHSUEDDAKBggrBgEFBQcDCDAOBgNV

# HQ8BAf8EBAMCAQYwKAYDVR0RBCEwH6QdMBsxGTAXBgNVBAMTEFRpbWVTdGFtcC0y

# MDQ4LTEwDQYJKoZIhvcNAQEFBQADgYEAAwmbj3nvf1kwqu9otfrjCR27T4IGXTdf

# plKfFo3qHJIJRG71betYfDDo+WmNI3MLEm9Hqa45EfgqsZuwGsOO61mWAK3ODE2y

# 0DGmCFwqevzieh1XTKhlGOl5QGIllm7HxzdqgyEIjkHq3dlXPx13SYcqFgZepjhq

# IhKjURmDfrYwggSjMIIDi6ADAgECAhAOz/Q4yP6/NW4E2GqYGxpQMA0GCSqGSIb3

# DQEBBQUAMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBDb3Jwb3Jh

# dGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2aWNlcyBD

# QSAtIEcyMB4XDTEyMTAxODAwMDAwMFoXDTIwMTIyOTIzNTk1OVowYjELMAkGA1UE

# BhMCVVMxHTAbBgNVBAoTFFN5bWFudGVjIENvcnBvcmF0aW9uMTQwMgYDVQQDEytT

# eW1hbnRlYyBUaW1lIFN0YW1waW5nIFNlcnZpY2VzIFNpZ25lciAtIEc0MIIBIjAN

# BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAomMLOUS4uyOnREm7Dv+h8GEKU5Ow

# mNutLA9KxW7/hjxTVQ8VzgQ/K/2plpbZvmF5C1vJTIZ25eBDSyKV7sIrQ8Gf2Gi0

# jkBP7oU4uRHFI/JkWPAVMm9OV6GuiKQC1yoezUvh3WPVF4kyW7BemVqonShQDhfu

# ltthO0VRHc8SVguSR/yrrvZmPUescHLnkudfzRC5xINklBm9JYDh6NIipdC6Anqh

# d5NbZcPuF3S8QYYq3AhMjJKMkS2ed0QfaNaodHfbDlsyi1aLM73ZY8hJnTrFxeoz

# C9Lxoxv0i77Zs1eLO94Ep3oisiSuLsdwxb5OgyYI+wu9qU+ZCOEQKHKqzQIDAQAB

# o4IBVzCCAVMwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwcwYIKwYBBQUHAQEEZzBlMCoGCCsGAQUFBzABhh5odHRw

# Oi8vdHMtb2NzcC53cy5zeW1hbnRlYy5jb20wNwYIKwYBBQUHMAKGK2h0dHA6Ly90

# cy1haWEud3Muc3ltYW50ZWMuY29tL3Rzcy1jYS1nMi5jZXIwPAYDVR0fBDUwMzAx

# oC+gLYYraHR0cDovL3RzLWNybC53cy5zeW1hbnRlYy5jb20vdHNzLWNhLWcyLmNy

# bDAoBgNVHREEITAfpB0wGzEZMBcGA1UEAxMQVGltZVN0YW1wLTIwNDgtMjAdBgNV

# HQ4EFgQURsZpow5KFB7VTNpSYxc/Xja8DeYwHwYDVR0jBBgwFoAUX5r1blzMzHSa

# 1N197z/b7EyALt0wDQYJKoZIhvcNAQEFBQADggEBAHg7tJEqAEzwj2IwN3ijhCcH

# bxiy3iXcoNSUA6qGTiWfmkADHN3O43nLIWgG2rYytG2/9CwmYzPkSWRtDebDZw73

# BaQ1bHyJFsbpst+y6d0gxnEPzZV03LZc3r03H0N45ni1zSgEIKOq8UvEiCmRDoDR

# EfzdXHZuT14ORUZBbg2w6jiasTraCXEQ/Bx5tIB7rGn0/Zy2DBYr8X9bCT2bW+IW

# yhOBbQAuOA2oKY8s4bL0WqkBrxWcLC9JG9siu8P+eJRRw4axgohd8D20UaF5Mysu

# e7ncIAkTcetqGVvP6KUwVyyJST+5z3/Jvz4iaGNTmr1pdKzFHTx/kuDDvBzYBHUw

# ggUZMIIEAaADAgECAhADViTO4HBjoJNSwH9//cwJMA0GCSqGSIb3DQEBCwUAMHIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJ

# RCBDb2RlIFNpZ25pbmcgQ0EwHhcNMTUwNTE5MDAwMDAwWhcNMTcwODIzMTIwMDAw

# WjBgMQswCQYDVQQGEwJHQjEPMA0GA1UEBxMGT3hmb3JkMR8wHQYDVQQKExZWaXJ0

# dWFsIEVuZ2luZSBMaW1pdGVkMR8wHQYDVQQDExZWaXJ0dWFsIEVuZ2luZSBMaW1p

# dGVkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqLQmabdimcQtYPTQ

# 9RSjv3ThEmFTRJt/MzseYYtZpBTcR6BnSfj8RfkC4aGZvspFgH0cGP/SNJh1w67b

# iX9oT5NFL9sUJHUsVdyPBA1LhpWcF09PP28mGGKO3oQHI4hTLD8etiIlF9qFantd

# 1Pmo0jdqT4uErSmx0m4kYGUUTa5ZPAK0UZSuAiNX6iNIL+rj/BPbI3nuPJzzx438

# oHYkZGRtsx11+pLA6hIKyUzRuIDoI7JQ0nZ0MkCziVyc6xGfS54JVLaVCEteTKPz

# Gc4yyvCqp6Tfe9gs8UuxJiEMdH5fvllTU4aoXbm+W8tonkE7i/19rv8S1A2VPiVV

# xNLbpwIDAQABo4IBuzCCAbcwHwYDVR0jBBgwFoAUWsS5eyoKo6XqcQPAYPkt9mV1

# DlgwHQYDVR0OBBYEFP2RNOWYipdNCSRVb5jIcyRp9tUDMA4GA1UdDwEB/wQEAwIH

# gDATBgNVHSUEDDAKBggrBgEFBQcDAzB3BgNVHR8EcDBuMDWgM6Axhi9odHRwOi8v

# Y3JsMy5kaWdpY2VydC5jb20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDA1oDOgMYYv

# aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmww

# QgYDVR0gBDswOTA3BglghkgBhv1sAwEwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93

# d3cuZGlnaWNlcnQuY29tL0NQUzCBhAYIKwYBBQUHAQEEeDB2MCQGCCsGAQUFBzAB

# hhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wTgYIKwYBBQUHMAKGQmh0dHA6Ly9j

# YWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURDb2RlU2ln

# bmluZ0NBLmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IBAQCclXHR

# DhDyJr81eiD0x+AL04ryDwdKT+PooKYgOxc7EhRn59ogxNO7jApQPSVo0I11Zfm6

# zQ6K6RPWhxDenflf2vMx7a0tIZlpHhq2F8praAMykK7THA9F3AUxIb/lWHGZCock

# yD/GQvJek3LSC5NjkwQbnubWYF/XZTDzX/mJGU2DcG1OGameffR1V3xODHcUE/K3

# PWy1bzixwbQCQA96GKNCWow4/mEW31cupHHSo+XVxmjTAoC93yllE9f4Kdv6F29H

# bRk0Go8Yn8WjWeLE/htxW/8ruIj0KnWkG+YwmZD+nTegYU6RvAV9HbJJYUEIfhVy

# 3DeK5OlY9ima2sdtMIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkq

# hkiG9w0BAQsFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5j

# MRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBB

# c3N1cmVkIElEIFJvb3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAw

# WjByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQL

# ExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3Vy

# ZWQgSUQgQ29kZSBTaWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB

# CgKCAQEA+NOzHH8OEa9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6

# kkPApfmJ1DcZ17aq8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQj

# ZhJUM1B0sSgmuyRpwsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5w

# MWYzcT6scKKrzn/pfMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp

# 6moKq4TzrGdOtcT3jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH

# 5DiLanMg0A9kczyen6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgw

# BgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYI

# KwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6

# Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmww

# OqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJ

# RFJvb3RDQS5jcmwwTwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUH

# AgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYD

# VR0OBBYEFFrEuXsqCqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuC

# MS1Ri6enIZ3zbcgPMA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2

# qB1dHC06GsTvMGHXfgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4Q

# pO4/cY5jDhNLrddfRHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEp

# KBo6cSgCPC6Ro8AlEeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/Dm

# ZAwlCEIysjaKJAL+L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9

# CBoYs4GbT8aTEAb8B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHv

# MYIENzCCBDMCAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0

# IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNl

# cnQgU0hBMiBBc3N1cmVkIElEIENvZGUgU2lnbmluZyBDQQIQA1YkzuBwY6CTUsB/

# f/3MCTAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkq

# hkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGC

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUYPRQDBLr0Jdqgfd6/4vD4q584jEwDQYJKoZI

# hvcNAQEBBQAEggEAOKfvts/s5IkDqTJuoxlSWIzut75nw8jlso3ybk6ChgOHp3VS

# k1GfkIpwgbLBiRWzSylhDDZvqOo8auoq2ovGQ88aC+550C3lXdtB5J0FHSEIDCl8

# J7SMbQnqgmqnXR6n1vvoEDXNycpYzgfpXqW2EOewwqXv3HKMGs55Iv8Lt/+32eqb

# kZU1J9WrAeWl7ffHBlSMod0h8gGdijKS5W4OWlKI8eqAxnTxwAHKCsyMOqE8k+8p

# cvHyH+hg7BzWpMChvTI0sXTvP4f74gZ/c1mveUSHRn4Gq/8zGZ8eTqHfzAwGbSqa

# RsgrL5DrFLJNM2PKD3ZxLUPklo4IiSgQGEm3QaGCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNzA1MDExNDE3

# NTRaMCMGCSqGSIb3DQEJBDEWBBTNNSSaKAX/j8ZX2G8WD9ffojGKIzANBgkqhkiG

# 9w0BAQEFAASCAQCT8lJRN7oDLGKluZn/OeREGrA8CwxO5JIHycm0fFtFIifie+zo

# awk+2Qkjqsv7oX3GSZmRwijYXH/cXfDesFnTLSOXo0keMkTFL6Kyna5aq77HSo8F

# sj38/yPmEZXmdisXONvLMhRXI7DrW3joIUTHS7otMVGVJEndgJ/EB8sogm/0fr9I

# IF1dfs/or6bwtdC5conrOJLZzi2fCCVu+EnHyDtmVebb5VhgEpPlA4XEg24DTQ08

# Vf9m3FjSwf09yYARjOlIBDcSpHIhu1h8sUyBnE9nQXPdXWGWc3+TD/iEvyr7pkfR

# 3Mp4lrConVLPoIcG/Bgot9JW7A5Ke9oNYAUA

# SIG # End signature block