Lability

0.10.2

Lib/WindowsImage.ps1

                                function ExpandWindowsImage {

<#

    .SYNOPSIS

        Writes a .wim image to a mounted VHD/(X) file.

#>

    [CmdletBinding(DefaultParameterSetName = 'Index')]

    param (

        ## File path to WIM file or ISO file containing the WIM image

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $MediaPath,

        ## WIM image index to apply

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

        [System.Int32] $WimImageIndex,

        ## WIM image name to apply

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

        [ValidateNotNullOrEmpty()]

        [System.String] $WimImageName,

        ## Mounted VHD(X) Operating System disk image

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNull()]

        [System.Object] $Vhd, # Microsoft.Vhd.PowerShell.VirtualHardDisk

        ## Disk image partition scheme

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateSet('MBR','GPT')]

        [System.String] $PartitionStyle,

        ## Optional Windows features to add to the image after expansion (ISO only)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNull()]

        [System.String[]] $WindowsOptionalFeature,

        ## Optional Windows features source path

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $SourcePath = '\sources\sxs',

        ## Relative source WIM file path (only used for ISOs)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $WimPath = '\sources\install.wim',

        ## Optional Windows packages to add to the image after expansion (primarily used for Nano Server)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNull()]

        [System.String[]] $Package,

        ## Relative packages (.cab) file path (primarily used for Nano Server)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $PackagePath = '\packages',

        ## Package localization directory/extension (primarily used for Nano Server)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $PackageLocale = 'en-US'

    )

    process {

        ## Assume the media path is a literal path to a WIM file

        $windowsImagePath = $MediaPath;

        $mediaFileInfo = Get-Item -Path $MediaPath;

        if ($mediaFileInfo.Extension -eq '.ISO') {

            ## Mount ISO

            WriteVerbose ($localized.MountingDiskImage -f $MediaPath);

            $iso = Mount-DiskImage -ImagePath $MediaPath -StorageType ISO -Access ReadOnly -PassThru -Verbose:$false;

            $iso = Get-DiskImage -ImagePath $iso.ImagePath;

            $isoDriveLetter = $iso | Get-Volume | Select-Object -ExpandProperty DriveLetter;

            ## Update the media path to point to the mounted ISO

            $windowsImagePath = '{0}:{1}' -f $isoDriveLetter, $WimPath;

        }

        if ($PSCmdlet.ParameterSetName -eq 'Name') {

            ## Locate the image index

            $WimImageIndex = GetWindowsImageIndex -ImagePath $windowsImagePath -ImageName $WimImageName;

        }

        if ($PartitionStyle -eq 'MBR') {

            $partitionType = 'IFS';

        }

        elseif ($PartitionStyle -eq 'GPT') {

            $partitionType = 'Basic';

        }

        $vhdDriveLetter = GetDiskImageDriveLetter -DiskImage $Vhd -PartitionType $partitionType;

        $logName = '{0}.log' -f [System.IO.Path]::GetFileNameWithoutExtension($Vhd.Path);

        $logPath = Join-Path -Path $env:TEMP -ChildPath $logName;

        WriteVerbose ($localized.ApplyingWindowsImage -f $WimImageIndex, $Vhd.Path);

        $expandWindowsImage = @{

            ImagePath = $windowsImagePath;

            ApplyPath = '{0}:\' -f $vhdDriveLetter;

            LogPath = $logPath;

            Index = $WimImageIndex;

        }

        $dismOutput = Expand-WindowsImage @expandWindowsImage -Verbose:$false;

        [ref] $null = Get-PSDrive;

        ## Add additional packages (.cab) files

        if ($Package) {

            ## Default to relative package folder path

            $addWindowsPackageParams = @{

                PackagePath = '{0}:{1}' -f $isoDriveLetter, $PackagePath;

                DestinationPath = '{0}:\' -f $vhdDriveLetter;

                LogPath = $logPath;

                Package = $Package;

                PackageLocale = $PackageLocale;

            }

            if (-not $PackagePath.StartsWith('\')) {

                ## Use the specified/literal path

                $addWindowsPackageParams['PackagePath'] = $PackagePath;

            }

            $dismOutput = AddWindowsPackage @addWindowsPackageParams;

        } #end if Package

        ## Add additional features if required

        if ($WindowsOptionalFeature) {

            ## Default to ISO relative source folder path

            $addWindowsOptionalFeatureParams = @{

                ImagePath = '{0}:{1}' -f $isoDriveLetter, $SourcePath;

                DestinationPath = '{0}:\' -f $vhdDriveLetter;

                LogPath = $logPath;

                WindowsOptionalFeature = $WindowsOptionalFeature;

            }

            if ($mediaFileInfo.Extension -eq '.WIM') {

                ## The Windows optional feature source path for .WIM files is a literal path

                $addWindowsOptionalFeatureParams['ImagePath'] = $SourcePath;

            }

            $dismOutput = AddWindowsOptionalFeature @addWindowsOptionalFeatureParams;

        } #end if WindowsOptionalFeature

        if ($mediaFileInfo.Extension -eq '.ISO') {

            ## Dismount ISO

            WriteVerbose ($localized.DismountingDiskImage -f $MediaPath);

            Dismount-DiskImage -ImagePath $MediaPath;

        }

    } #end process

} #end function ExpandWindowsImage

function AddWindowsOptionalFeature {

<#

    .SYMOPSIS

        Enables Windows optional features to an image.

#>

    [CmdletBinding()]

    param (

        ## Source package file path

        [Parameter(Mandatory, ValueFromPipeline)]

        [ValidateNotNullOrEmpty()]

        [System.String] $ImagePath,

        ## Mounted VHD(X) Operating System disk drive

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        ## Windows packages to add to the image after expansion

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNull()]

        [System.String[]] $WindowsOptionalFeature,

        ## DISM log path

        [Parameter()]

        [ValidateNotNullOrEmpty()]

        [System.String] $LogPath = $DestinationPath

    )

    process {

        WriteVerbose ($localized.AddingWindowsFeature -f ($WindowsOptionalFeature -join ','), $DestinationPath);

        $enableWindowsOptionalFeatureParams = @{

            Source = $ImagePath;

            Path = $DestinationPath;

            LogPath = $LogPath;

            FeatureName = $WindowsOptionalFeature;

            LimitAccess = $true;

            All = $true;

            Verbose = $false;

        }

        $dismOutput = Microsoft.Dism.Powershell\Enable-WindowsOptionalFeature @enableWindowsOptionalFeatureParams;

    } #end process

} #end function AddDiskImageOptionalFeature

function AddWindowsPackage {

<#

    .SYNOPSIS

        Adds a Windows package to an image.

#>

    [CmdletBinding()]

    param (

        ## Windows packages (.cab) files to add to the image after expansion

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNull()]

        [System.String[]] $Package,

        ## Path to the .cab files

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $PackagePath,

        ## Mounted VHD(X) Operating System disk drive

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        ## Package localization directory/extension (primarily used for Nano Server)

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $PackageLocale = 'en-US',

        ## DISM log path

        [Parameter()]

        [ValidateNotNullOrEmpty()]

        [System.String] $LogPath = $DestinationPath

    )

    process {

        foreach ($packageName in $Package) {

            WriteVerbose ($localized.AddingWindowsPackage -f $packagename, $DestinationPath);

            $packageFilename = '{0}.cab' -f $packageName;

            $packageFilePath = Join-Path -Path $PackagePath -ChildPath $packageFilename;

            AddDiskImagePackage -Name $packageName -Path $packageFilePath -DestinationPath $DestinationPath;

            ## Check for language-specific package (Change from Server 2016 TP releases and Server 2016 Nano RTM)

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

                $localizedPackageName = '{0}_{1}' -f $packageName, $packageLocale;

                $localizedPackageFilename = '{0}.cab' -f $localizedPackageName;

                $localizedPackageDirectoryPath = Join-Path -Path $PackagePath -ChildPath $PackageLocale;

                $localizedPackagePath = Join-Path -Path $localizedPackageDirectoryPath -ChildPath $localizedPackageFilename;

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

                    WriteVerbose ($localized.AddingLocalizedWindowsPackage -f $localizedPackageName, $DestinationPath);

                    $addDiskImagePackageParams = @{

                        Name = $localizedPackageName;

                        Path = $localizedPackagePath;

                        DestinationPath = $DestinationPath;

                    }

                    AddDiskImagePackage @addDiskImagePackageParams;

                }

            }

        } #end foreach package

    } #end process

} #end function AddWindowsPackage

function GetWindowsImageIndex {

<#

    .SYNOPSIS

        Locates the specified WIM image index by its name, i.e. SERVERSTANDARD or SERVERDATACENTERSTANDARD

    .OUTPUTS

        The WIM image index.

#>

    [CmdletBinding()]

    [OutputType([System.Int32])]

    param (

        # WIM image path

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

        [System.String] $ImagePath,

        # Windows image name

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

        [System.String] $ImageName

    )

    process {

        WriteVerbose ($localized.LocatingWimImageIndex -f $ImageName);

        Get-WindowsImage -ImagePath $ImagePath -Verbose:$false |

            Where-Object ImageName -eq $ImageName |

                Select-Object -ExpandProperty ImageIndex;

    } #end process

} #end function GetWindowsImageIndex

function GetWindowsImageName {

<#

    .SYNOPSIS

        Locates the specified WIM image name by its index.

#>

    [CmdletBinding()]

    [OutputType([System.String])]

    param (

        # WIM image path

        [Parameter(Mandatory, ValueFromPipeline)]

        [ValidateNotNullOrEmpty()]

        [System.String] $ImagePath,

        # Windows image index

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.Int32] $ImageIndex

    )

    process {

        WriteVerbose ($localized.LocatingWimImageName -f $ImageIndex);

        Get-WindowsImage -ImagePath $ImagePath -Verbose:$false |

            Where-Object ImageIndex -eq $ImageIndex |

                Select-Object -ExpandProperty ImageName;

    } #end process

} #end function GetWindowsImageName

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUibQxhj4ceiUtw3wIuM6kLpV+

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

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUwB3MnDM03FpAOQtJB4x++bg3t7wwDQYJKoZI

# hvcNAQEBBQAEggEAkRmUOYRypGwriuCp2OmHA2J+KnHn25HIQujeFYMO7XZ6vkr7

# hD0KOE5KIA4k5/TvKjVsY798UbSuwyShxot7UwVDSbPGnvvAJ1SM4yvs7shA4OQv

# L8Fiwf7hh3msG1soT1QzmO67NSffvV/YhMMB9O21JiGWVSZf8of9UxL9TtLxzKoy

# mjiUyaAf9dDSak5CWBm1/Ey7q4l3eJgoc+nLZ+zigwvOU3pcqPqoqWGDDmJh4VR5

# sFT+UjKR3ebng5xKiBNXkoGAb7nmFMjb3bdKFIpAtEUUya9AUKfmVHdyskDvfCZg

# AlAal99nSqGp4HizWPuf95z8wyw1/Vid81EZTqGCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNzAyMDcwOTIw

# NDNaMCMGCSqGSIb3DQEJBDEWBBSwiiJc4DYnMLfPON1CRFb797xXFTANBgkqhkiG

# 9w0BAQEFAASCAQAK/mnsBPSqW1APKocuP2wPdEhPc+uKNxfdVS87Ue8xz80xjQkw

# R/L4hnEomzhAWvl93v/HFhbl4t/ElKWw974LQyVQeWuAEtjTDfkj0wj8hCzJt4us

# cQveXWs0nWZw1pgVEzsfBv3nvM3mZYgR0kLl0uDDciW5xqYdvtfhPuQ5t95lXQWI

# 59ybciigJnSHZR1uzcsZb7YvdVNwoyGTifJmNmbthmHb+h2+yPGlfYihVnAjOE5i

# gAMDBO8mE54PZIvX+kFTW26qcDlCXRho2OJeFZ8dncPfE2JBN/EncrUgvow6TKb5

# Kna1oi4tP9AgzJCKKKTzkkErrruUu/1EofH0

# SIG # End signature block