Lability

0.10.0

Src/LabImage.ps1

                                function Get-LabImage {

<#

    .SYNOPSIS

        Gets master/parent disk image.

    .DESCRIPTION

        The Get-LabImage cmdlet returns current master/parent disk image properties.

    .PARAMETER Id

        Specifies the media Id of the image to return. If this parameter is not specified, all images are returned.

    .PARAMETER ConfigurationData

        Specifies a PowerShell DSC configuration data hashtable or a path to an existing PowerShell DSC .psd1

        configuration document that contains the required media definition.

    .EXAMPLE

        Get-LabImage

        Returns all current lab images on the host.

    .EXAMPLE

        Get-LabImage -Id 2012R2_x64_Standard_EN_Eval

        Returns the '2012R2_x64_Standard_EN_Eval' lab image properties, if available.

#>

    [CmdletBinding()]

    [OutputType([System.Management.Automation.PSCustomObject])]

    param (

        [Parameter(ValueFromPipeline,ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Id,

        ## Lab DSC configuration data

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData

    )

    process {

        $hostDefaults = GetConfigurationData -Configuration Host;

        $parentVhdPath = ResolvePathEx -Path $hostDefaults.ParentVhdPath;

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

            ## We have an Id. so resolve that

            try {

                $labMedia = ResolveLabMedia @PSBoundParameters;

            }

            catch {

                $labMedia = $null;

            }

        }

        else {

            ## Otherwise return all media

            $labMedia = Get-LabMedia;

        }

        foreach ($media in $labMedia) {

            $differencingVhdPath = '{0}.vhdx' -f $media.Id;

            if ($media.MediaType -eq 'VHD') {

                $differencingVhdPath = $media.Filename;

            }

            $imagePath = Join-Path -Path $parentVhdPath -ChildPath $differencingVhdPath;

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

                $imageFileInfo = Get-Item -Path $imagePath;

                $diskImage = Get-DiskImage -ImagePath $imageFileInfo.FullName;

                $labImage = [PSCustomObject] @{

                    Id = $media.Id;

                    Attached = $diskImage.Attached;

                    ImagePath = $diskImage.ImagePath;

                    LogicalSectorSize = $diskImage.LogicalSectorSize;

                    BlockSize = $diskImage.BlockSize;

                    FileSize = $diskImage.FileSize;

                    Size = $diskImage.Size;

                    Generation = ($imagePath.Split('.')[-1]).ToUpper();

                }

                Write-Output -InputObject $labImage;

            }

        } #end foreach media

    } #end process

} #end function Get-LabImage

function Test-LabImage {

<#

    .SYNOPSIS

        Tests whether a master/parent lab image is present.

    .DESCRIPTION

        The Test-LabImage cmdlet returns whether a specified disk image is present.

    .PARAMETER Id

        Specifies the media Id of the image to test.

    .PARAMETER ConfigurationData

        Specifies a PowerShell DSC configuration data hashtable or a path to an existing PowerShell DSC .psd1

        configuration document that contains the required media definition.

    .EXAMPLE

        Test-LabImage -Id 2012R2_x64_Standard_EN_Eval

        Tests whether the '-Id 2012R2_x64_Standard_EN_Eval' lab image is present.

    .LINK

        Get-LabImage

#>

    [CmdletBinding()]

    [OutputType([System.Boolean])]

    param (

        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Id,

        ## Lab DSC configuration data

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData

    )

    process {

        if (Get-LabImage @PSBoundParameters) {

            return $true;

        }

        else {

            return $false;

        }

    } #end process

} #end function Test-LabImage

function New-LabImage {

<#

    .SYNOPSIS

        Creates a new master/parent lab image.

    .DESCRIPTION

        The New-LabImage cmdlet starts the creation of a lab VHD(X) master image from the specified media Id.

        Lability will automatically create lab images as required. If there is a need to manally recreate an image,

        then the New-LabImage cmdlet can be used.

    .PARAMETER Id

        Specifies the media Id of the image to create.

    .PARAMETER ConfigurationData

        Specifies a PowerShell DSC configuration data hashtable or a path to an existing PowerShell DSC .psd1

        configuration document that contains the required media definition.

    .PARAMETER Force

        Specifies that any existing image should be overwritten.

    .EXAMPLE

        New-LabImage -Id 2012R2_x64_Standard_EN_Eval

        Creates the VHD(X) image from the '2012R2_x64_Standard_EN_Eval' media Id.

    .EXAMPLE

        New-LabImage -Id 2012R2_x64_Standard_EN_Eval -Force

        Creates the VHD(X) image from the '2012R2_x64_Standard_EN_Eval' media Id, overwriting an existing image with the same name.

    .LINK

        Get-LabMedia

        Get-LabImage

#>

    [CmdletBinding(SupportsShouldProcess)]

    [OutputType([System.IO.FileInfo])]

    param (

        ## Lab media Id

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Id,

        ## Lab DSC configuration data

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Force the re(creation) of the master/parent image

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force

    )

    process {

        ## Download media if required..

        [ref] $null = $PSBoundParameters.Remove('Force');

        [ref] $null = $PSBoundParameters.Remove('WhatIf');

        [ref] $null = $PSBoundParameters.Remove('Confirm');

        if ((Test-LabImage @PSBoundParameters) -and $Force) {

            $image = Get-LabImage @PSBoundParameters;

            WriteVerbose ($localized.RemovingDiskImage -f $image.ImagePath);

            [ref] $null = Remove-Item -Path $image.ImagePath -Force -ErrorAction Stop;

        }

        elseif (Test-LabImage @PSBoundParameters) {

            throw ($localized.ImageAlreadyExistsError -f $Id);

        }

        $media = ResolveLabMedia @PSBoundParameters;

        $mediaFileInfo = InvokeLabMediaImageDownload -Media $media;

        $hostDefaults = GetConfigurationData -Configuration Host;

        if ($media.MediaType -eq 'VHD') {

            WriteVerbose ($localized.ImportingExistingDiskImage -f $media.Description);

            $imageName = $media.Filename;

            $imagePath = Join-Path -Path $hostDefaults.ParentVhdPath -ChildPath $imageName;

        } #end if VHD

        else {

            WriteVerbose ($localized.CreatingDiskImage -f $media.Description);

            $imageName = '{0}.vhdx' -f $Id;

            $imagePath = Join-Path -Path $hostDefaults.ParentVhdPath -ChildPath $imageName;

            $imageCreationFailed = $false;

            try {

                ## Create VHDX

                if ($media.CustomData.PartitionStyle) {

                    ## Custom partition style has been defined so use that

                    $partitionStyle = $media.CustomData.PartitionStyle;

                }

                elseif ($media.Architecture -eq 'x86') {

                    ## Otherwise default to MBR for x86 media

                    $partitionStyle = 'MBR';

                }

                else {

                    $partitionStyle = 'GPT';

                }

                ## Create disk image and refresh PSDrives

                $image = NewDiskImage -Path $imagePath -PartitionStyle $partitionStyle -Passthru -Force -ErrorAction Stop;

                [ref] $null = Get-PSDrive;

                ## Apply WIM (ExpandWindowsImage) and add specified features

                $expandWindowsImageParams = @{

                    Vhd = $image;

                    MediaPath = $mediaFileInfo.FullName;

                    PartitionStyle = $partitionStyle;

                }

                ## Determine whether we're using the WIM image index or image name. This permits

                ## specifying an integer image index in a media's 'ImageName' property.

                [System.Int32] $wimImageIndex = $null;

                if ([System.Int32]::TryParse($media.ImageName, [ref] $wimImageIndex)) {

                    $expandWindowsImageParams['WimImageIndex'] = $wimImageIndex;

                }

                else {

                    $expandWindowsImageParams['WimImageName'] = $media.ImageName;

                }

                if ($media.CustomData.SourcePath) {

                    $expandWindowsImageParams['SourcePath'] = $media.CustomData.SourcePath;

                }

                if ($media.CustomData.WimPath) {

                    $expandWindowsImageParams['WimPath'] = $media.CustomData.WimPath;

                }

                if ($media.CustomData.WindowsOptionalFeature) {

                    $expandWindowsImageParams['WindowsOptionalFeature'] = $media.CustomData.WindowsOptionalFeature;

                }

                if ($media.CustomData.PackagePath) {

                    $expandWindowsImageParams['PackagePath'] = $media.CustomData.PackagePath;

                }

                if ($media.CustomData.Package) {

                    $expandWindowsImageParams['Package'] = $media.CustomData.Package;

                }

                ExpandWindowsImage @expandWindowsImageParams;

                ## Apply hotfixes (AddDiskImageHotfix)

                AddDiskImageHotfix -Id $Id -Vhd $image -PartitionStyle $partitionStyle;

                ## Configure boot volume (SetDiskImageBootVolume)

                SetDiskImageBootVolume -Vhd $image -PartitionStyle $partitionStyle;

            }

            catch {

                ## Have to ensure VHDX is dismounted before we can delete!

                $imageCreationFailed = $true;

                Write-Error -Message $_;

            }

            finally {

                ## Dismount VHDX

                Dismount-VHD -Path $imagePath;

            }

            if ($imageCreationFailed -eq $true) {

                WriteWarning ($localized.RemovingIncompleteImageWarning -f $imagePath);

                Remove-Item -Path $imagePath -Force;

            }

        } #end if ISO/WIM

        return (Get-Item -Path $imagePath -ErrorAction Ignore);

    } #end process

} #end function New-LabImage

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUFMF6z/IpvuLl/iw0EtkHgXeh

# VNugghLqMIID7jCCA1egAwIBAgIQfpPr+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

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUq7WXXLiHwm03cx567BTiSN5mJq4wDQYJKoZI

# hvcNAQEBBQAEggEAqIfEhY4ONWopS0c/Z7nhP9PEI0Qpwdf/kIhZH/R0YdLRYfYC

# EgKNpZyNYGIs2+Ne/n4/Adz1iF+JV7egfimBl9MpzrNhx0lJRLl+4ohEyegLHegn

# e/aAf6nYuD0lsyfVMLh4ShCRqjVPX4a+UiiN262Hy3OVKdV69y4mzP5s9Wp1RxSv

# JWXU1v4bRUm3fteMoea3Px5X1N5nC8uhkuPv+oH/QINORAwvFC9Y8pS0HYkR5pAC

# qdkaCsEoVbHygcN121SvaWx74oUFLNGe4mFXeX9SAgxOEaEjP75AL9kD+eT2QTXh

# YokkpwcdTAxrARsiIYHg+o2hkQcYXVJQzCcKZKGCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNjA5MDYxNjA3

# MDFaMCMGCSqGSIb3DQEJBDEWBBQJVY2yIySoYzYWJbN+Ci/vx0/iNDANBgkqhkiG

# 9w0BAQEFAASCAQB/8IgGzKQh/PWIS4kg92lWqWOzj8+9JKUIwLMSqZC98q8N+iMX

# 1BcqKKCmL6CnSMe9PIwDLbxW6p2dF79gYREQyVT/CJGKhCHWn6lVjkAlI0U4oIQz

# QHelqP5sRlpeEKcCqnuEb+l5JXpQz+MZ6H8FCgM7jVek2GYSJ0wDZLsAcLf4GrKa

# EbqLSwpSNqJiuP65VziRG/tWFGpFPiygUYz1UpjZYNdi7qh8giIWNsIIYA7wZ+fh

# FL50LrpjsssHwbQZ74ZfG+QRzOFvb5vVHwfJFPAaAvdWVgePdMCUX948eecEl2rA

# ruMIBmF4w+68XeQl7EvwQUnNkfR+DG832z8p

# SIG # End signature block