Lability

0.9.9

Src/LabConfiguration.ps1

                                function Test-LabConfiguration {

<#

    .SYNOPSIS

        Tests the configuration of all VMs in a lab.

    .DESCRIPTION

        The Test-LabConfiguration determines whether all nodes defined in a PowerShell DSC configuration document

        are configured correctly and returns the results.

        WANRING: Only the virtual machine configuration is checked, not in the internal VM configuration. For example,

        the virtual machine's memory configuraiton, virtual switch configuration and processor count are tested. The

        VM's operating system configuration is not checked.

    .PARAMETER ConfigurationData

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

        configuration document used to create the virtual machines. Each node defined in the AllNodes array is

        tested.

    .LINK

        about_ConfigurationData

        Start-LabConfiguration

#>

    [CmdletBinding()]

    param (

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData

    )

    process {

        WriteVerbose $localized.StartedLabConfigurationTest;

        $currentNodeCount = 0;

        $nodes = $ConfigurationData.AllNodes | Where-Object { $_.NodeName -ne '*' };

        foreach ($node in $nodes) {

            $currentNodeCount++;

            $nodeProperties = ResolveLabVMProperties -NodeName $node.NodeName -ConfigurationData $ConfigurationData;

            [System.Int16] $percentComplete = (($currentNodeCount / $nodes.Count) * 100) - 1;

            $activity = $localized.ConfiguringNode -f $nodeProperties.NodeDisplayName;

            Write-Progress -Id 42 -Activity $activity -PercentComplete $percentComplete;

            $nodeResult = [PSCustomObject] @{

                Name = $nodeProperties.NodeName;

                IsConfigured = Test-LabVM -Name $node.NodeName -ConfigurationData $ConfigurationData;

                DisplayName = $nodeProperties.NodeDisplayName;

            }

            Write-Output -InputObject $nodeResult;

        }

        WriteVerbose $localized.FinishedLabConfigurationTest;

    } #end process

} #end function Test-LabConfiguration

function TestLabConfigurationMof {

<#

    .SYNOPSIS

        Checks for node MOF and meta MOF configuration files.

#>

    [CmdletBinding()]

    param (

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Lab vm/node name

        [Parameter(ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Name,

        ## Path to .MOF files created from the DSC configuration

        [Parameter(ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Path = (GetLabHostDSCConfigurationPath),

        ## Ignores missing MOF file

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $SkipMofCheck

    )

    process {

        $Path = Resolve-Path -Path $Path -ErrorAction Stop;

        $node = $ConfigurationData.AllNodes | Where-Object { $_.NodeName -eq $Name };

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

        WriteVerbose ($localized.CheckingForNodeFile -f $mofPath);

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

            if ($SkipMofCheck) {

                WriteWarning ($localized.CannotLocateMofFileError -f $mofPath)

            }

            else {

                throw ($localized.CannotLocateMofFileError -f $mofPath);

            }

        }

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

        WriteVerbose ($localized.CheckingForNodeFile -f $metaMofPath);

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

            WriteWarning ($localized.CannotLocateLCMFileWarning -f $metaMofPath);

        }

    } #end process

} #end function TestLabConfigurationMof

function Start-LabConfiguration {

<#

    .SYNOPSIS

        Invokes the deployment and configuration of a VM for each node defined in a PowerShell DSC configuration

        document.

    .DESCRIPTION

        The Start-LabConfiguration initiates the configuration of all nodes defined in a PowerShell DSC configuration

        document. The AllNodes array is enumerated and a virtual machine is created per node, using the NodeName

        property.

        If any existing virtual machine exists with the same name as the NodeName declaration of the AllNodes array,

        the cmdlet will throw an error. If this behaviour is not desired, you can forcibly remove the existing VM

        with the -Force parameter. NOTE: THE VIRTUAL MACHINE'S EXISTING DATA WILL BE LOST.

        The virtual machines' local administrator password must be specified when creating the lab VMs. The local

        administrator password can be specified as a [PSCredential] or a [SecureString] type. If a [PSCredential] is

        used then the username is not used.

        It is possible to override the module's virtual machine default settings by specifying the required property

        on the node hashtable in the PowerShell DSC configuration document. Default settings include the Operating

        System image to use, the amount of memory assigned to the virtual machine and/or the virtual switch to

        connect the virtual machine to. If the settings are not overridden, the module's defaults are used. Use the

        Get-LabVMDefault cmdlet to view the module's default values.

        Each virtual machine created by the Start-LabConfiguration cmdlet, has its PowerShell DSC configuraion (.mof)

        file injected into the VHD file as it is created. This configuration is then applied during the first boot

        process to ensure the virtual machine is configured as required. If the path to the VM's .mof files is not

        specified, the module's default Configuration directory is used. Use the Get-LabHostDefault cmdlet to view

        the module's default Configuration directory path.

        The virtual machine .mof files must be created before creating the lab. If any .mof files are missing, the

        Start-LabConfiguration cmdlet will generate an error. You can choose to ignore this error by specifying

        the -SkipMofCheck parameter. If you skip the .mof file check - and no .mof file is found - no configuration

        will be applied to the virtual machine's Operating System settings.

        When deploying a lab, the module will create a default baseline snapshot of all virtual machines. This

        snapshot can be used to revert all VMs back to their default configuration. If this snapshot is not

        required, it can be surpressed with the -NoSnapshot parameter.

    .NOTES

        The same local administrator password is used for all virtual machines created in the same lab configuration.

    .PARAMETER ConfigurationData

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

        configuration document used to create the virtual machines. One virtual machine is created per node defined

        in the AllNodes array.

    .PARAMETER Credential

        Specifies the local administrator password of all virtual machines in the lab configuration. The same

        password is used for all virtual machines in the same lab configuration. The username is not used.

    .PARAMETER Password

        Specifies the local administrator password of all virtual machines in the lab configuration. The same

        password is used for all virtual machines in the same lab configuration.

    .PARAMETER Path

        Specifies the directory path containing the individual PowerShell DSC .mof files. If not specified, the

        module's default location is used.

    .PARAMETER NoSnapshot

        Specifies that no default snapshot will be taken when creating the virtual machine.

        NOTE: If no default snapshot is not created, the lab cannot be restored to its initial configuration

        with the Reset-Lab cmdlet.

    .PARAMETER SkipMofCheck

        Specifies that the module will configure a virtual machines that do not have a corresponding .mof file

        located in the -Path specfified. By default, if any .mof file cannot be located then the cmdlet will

        generate an error.

        NOTE: If no .mof file is found and the -SkipMofCheck parameter is specified, no configuration will be

        applied to the virtual machine's Operating System configuration.

    .PARAMETER IgnorePendingReboot

        The host's configuration is checked before invoking a lab configuration, including checking for pending

        reboots. The -IgnorePendingReboot specifies that a pending reboot should be ignored and the lab

        configuration applied.

    .PARAMETER Force

        Specifies that any existing virtual machine with a matching name, will be removed and recreated. By

        default, if a virtual machine already exists with the same name, the cmdlet will generate an error.

        NOTE: If the -Force parameter is specified - and a virtual machine with the same name already exists -

        ALL EXISTING DATA WITHIN THE VM WILL BE LOST.

    .LINK

        about_ConfigurationData

        about_Bootstrap

        Get-LabHostDefault

        Set-LabHostDefault

        Get-LabVMDefault

        Set-LabVMDefault

        Reset-Lab

#>

    [CmdletBinding(DefaultParameterSetName = 'PSCredential')]

    param (

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Local administrator password of the VM. The username is NOT used.

        [Parameter(ParameterSetName = 'PSCredential', ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.Management.Automation.PSCredential]

        [System.Management.Automation.CredentialAttribute()]

        $Credential = (& $credentialCheckScriptBlock),

        ## Local administrator password of the VM.

        [Parameter(Mandatory, ParameterSetName = 'Password', ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.Security.SecureString] $Password,

        ## Path to .MOF files created from the DSC configuration

        [Parameter(ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Path = (GetLabHostDSCConfigurationPath),

        ## Skip creating baseline snapshots

        [Parameter(ValueFromPipelineByPropertyName)]

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

        ## Forces a reconfiguration/redeployment of all nodes.

        [Parameter(ValueFromPipelineByPropertyName)]

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

        ## Ignores missing MOF file

        [Parameter(ValueFromPipelineByPropertyName)]

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

        ## Skips pending reboot check

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $IgnorePendingReboot

    )

    begin {

        ## If we have only a secure string, create a PSCredential

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

            $Credential = New-Object -TypeName 'System.Management.Automation.PSCredential' -ArgumentList 'LocalAdministrator', $Password;

        }

        if (-not $Credential) { throw ($localized.CannotProcessCommandError -f 'Credential'); }

        elseif ($Credential.Password.Length -eq 0) { throw ($localized.CannotBindArgumentError -f 'Password'); }

        if (-not (Test-LabHostConfiguration -IgnorePendingReboot:$IgnorePendingReboot) -and (-not $Force)) {

            throw $localized.HostConfigurationTestError;

        }

    }

    process {

        WriteVerbose $localized.StartedLabConfiguration;

        $nodes = $ConfigurationData.AllNodes | Where-Object { $_.NodeName -ne '*' };

        $Path = ResolvePathEx -Path $Path;

        foreach ($node in $nodes) {

            $testLabConfigurationMofParams = @{

                ConfigurationData = $ConfigurationData;

                Name = $node.NodeName;

                Path = $Path;

            }

            TestLabConfigurationMof @testLabConfigurationMofParams -SkipMofCheck:$SkipMofCheck;

        } #end foreach node

        $currentNodeCount = 0;

        foreach ($node in (Test-LabConfiguration -ConfigurationData $ConfigurationData)) {

            $currentNodeCount++;

            [System.Int16] $percentComplete = (($currentNodeCount / $nodes.Count) * 100) - 1;

            $activity = $localized.ConfiguringNode -f $node.Name;

            Write-Progress -Id 42 -Activity $activity -PercentComplete $percentComplete;

            if ($node.IsConfigured -and $Force) {

                WriteVerbose ($localized.NodeForcedConfiguration -f $node.Name);

                NewLabVM -Name $node.Name -ConfigurationData $ConfigurationData -Path $Path -NoSnapshot:$NoSnapshot -Credential $Credential;

            }

            elseif ($node.IsConfigured) {

                WriteVerbose ($localized.NodeAlreadyConfigured -f $node.Name);

            }

            else {

                WriteVerbose ($localized.NodeMissingOrMisconfigured -f $node.Name);

                NewLabVM -Name $node.Name -ConfigurationData $ConfigurationData -Path $Path -NoSnapshot:$NoSnapshot -Credential $Credential;

            }

        }

        Write-Progress -Id 42 -Activity $activity -Completed;

        WriteVerbose $localized.FinishedLabConfiguration;

    } #end process

} #end function Start-LabConfiguration

function Remove-LabConfiguration {

<#

    .SYNOPSIS

        Removes all VMs and associated snapshots of all nodes defined in a PowerShell DSC configuration document.

    .DESCRIPTION

        The Remove-LabConfiguration removes all virtual machines that have a corresponding NodeName defined in the

        AllNode array of the PowerShell DSC configuration document.

        WARNING: ALL EXISTING VIRTUAL MACHINE DATA WILL BE LOST WHEN VIRTUAL MACHINES ARE REMOVED.

        By default, associated virtual machine switches are not removed as they may be used by other virtual

        machines or lab configurations. If you wish to remove any virtual switche defined in the PowerShell DSC

        configuration document, specify the -RemoveSwitch parameter.

    .PARAMETER ConfigurationData

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

        configuration document used to remove existing virtual machines. One virtual machine is removed per node

        defined in the AllNodes array.

    .PARAMETER RemoveSwitch

        Specifies that any connected virtual switch should also be removed when the virtual machine is removed.

    .LINK

        about_ConfigurationData

        Start-LabConfiguration

#>

    [CmdletBinding()]

    param (

        ## Lab DSC configuration data

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.Collections.Hashtable]

        [Microsoft.PowerShell.DesiredStateConfiguration.ArgumentToConfigurationDataTransformationAttribute()]

        $ConfigurationData,

        ## Include removal of virtual switch(es). By default virtual switches are not removed.

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $RemoveSwitch

    )

    process {

        WriteVerbose $localized.StartedLabConfiguration;

        $nodes = $ConfigurationData.AllNodes | Where-Object { $_.NodeName -ne '*' };

        $currentNodeCount = 0;

        foreach ($node in $nodes) {

            $currentNodeCount++;

            $nodeProperties = ResolveLabVMProperties -NodeName $node.NodeName -ConfigurationData $ConfigurationData;

            [System.Int16] $percentComplete = (($currentNodeCount / $nodes.Count) * 100) - 1;

            $activity = $localized.ConfiguringNode -f $nodeProperties.NodeDisplayName;

            Write-Progress -Id 42 -Activity $activity -PercentComplete $percentComplete;

            ##TODO: Should this not ensure that VMs are powered off?

            RemoveLabVM -Name $node.NodeName -ConfigurationData $ConfigurationData -RemoveSwitch:$RemoveSwitch;

        }

        Write-Progress -Id 42 -Activity $activity -Completed;

        WriteVerbose $localized.FinishedLabConfiguration;

    } #end process

} #end function Remove-LabConfiguration

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUMIJSoMhllLvRCdXC6Bd7MjBt

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

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUwGi0wjAc5Q6GzErNdCbxhiQIJ1IwDQYJKoZI

# hvcNAQEBBQAEggEAZFcFd0HSs1XgqiOjwAbFnkIJZEk5q4vGJskrZlc+LDfJBPqZ

# xmCp5FtcemyFw+ODrlz/tV1RWP4X2NpPPrH49v76DAfyOO7T6Vl9nG7mbQCm/TRf

# OlbD92AFTwx1TfM41BYCAcycu2mRApl3uLEQwCUx+8KYwvvndJYM4z3Cldspxx3l

# zjyiys5sDVROxoZ169lgyLbI43lbSNmEAcYS+jhOOEMKQ/bTi0Wh2hO3yWDolPUb

# RNH78MiI3QyqZrkc7DYa32qtwQyUFo7ySy5BxjISYzffHlHvV3v7gfc/0IALF0po

# JgdmRPdgTUZx9wHz9FfLRq3VGjTGOezHEKOJG6GCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNjA0MTMxMzMz

# MjFaMCMGCSqGSIb3DQEJBDEWBBSIyKXwesD8sXGiRTWLB3Mp7BNUcTANBgkqhkiG

# 9w0BAQEFAASCAQBT7AJ+H4TTTs8ITCe82NcYM7RSI3anG0qpH/ByMbUt5mflb6gP

# JBDrGa3CkdJW4YV85CxxglT4AM9bxEG/n2pxRaO66l7g8CCAYOuX0mITiYN/kI/n

# vfM2YGoMIzHTgqaS9VGX9QzTnWjUK3DDTNIYe6m0wIgCGP1WxaSdomggqRSLD0ym

# 7gTCbMkgkDe9TdMrq8j/w4wsMo09G6HXsi7CGp/hDrCAwkwuwkf9NjiJ66JP9rwl

# 68rvzEAZ0kc2MJcj0sI/hWVOanrtNBQ3RJ2faM0aBKMu252a2x0W/HIDabcpqi4+

# 67i5+c9tpsmFvo1I1FUTv1KTF6cjB1/8f0Ev

# SIG # End signature block