AppVentiX

2026.623.1130

public/New-AppVentiXRegistryUserSetting.ps1

                                <#

.SYNOPSIS

    Creates an AppVentiX UserSetting XML file for a Group Policy configuration.

.DESCRIPTION

    Builds and saves an AppVentiX UserSetting XML file that defines a Group Policy configuration,

    including configured policies, elements, and registry entries. Supports two input modes:

    - AppVentiXParams mode (AppVentiXParamsFile / AppVentiXParamsContent): accepts pre-structured

      policy data from Get-IvantiWCPolicy -ExportFor AppVentiX, which includes policy metadata,

      element values, and registry entries ready for direct use.

    - Legacy RegistryEntries mode (AdmxFile / AdmxContent): accepts a flat array of hashtables

      describing individual registry entries; the function looks up matching ADMX policy definitions

      to build the policy structure.

    The ADMX and ADML files are saved alongside the XML if they do not already exist at the target path.

.PARAMETER FriendlyName

    Display name for the AppVentiX UserSetting.

.PARAMETER Description

    Optional description for the UserSetting.

.PARAMETER ExecutionOrder

    Execution order for the UserSetting. Defaults to 0.

.PARAMETER ProcessAtLogin

    Whether the policy is applied at login. Defaults to $true.

.PARAMETER ProcessAtRefresh

    Whether the policy is applied at refresh. Defaults to $true.

.PARAMETER ProcessAtReconnectAndUnlock

    Whether the policy is applied at reconnect and unlock. Defaults to $false.

.PARAMETER MachineGroupFriendlyName

    One or more machine group friendly names to apply the setting to. Defaults to 'All Machine Groups'.

.PARAMETER RegistryEntries

    Array of hashtables describing registry entries. Each entry must contain: RootKey, KeyPath

    Optional keys: ValueName, ValueData, ValueType, Action, DeleteKey.

.NOTES

    Function  : New-AppVentiXRegistryUserSetting

    Author    : John Billekens

    Copyright : (c) John Billekens Consultancy & AppVentiX

    Version   : 2026.312.2000

#>

function New-AppVentiXRegistryUserSetting {

    [CmdletBinding()]

    [Alias("New-AppVentiXRegistry")]

    param (

        [Parameter(Mandatory = $true, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [string]$FriendlyName,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [string]$Description,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [int]$ExecutionOrder = 0,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [bool]$ProcessAtLogin = $true,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [bool]$ProcessAtRefresh = $true,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [bool]$ProcessAtReconnectAndUnlock = $false,

        [Parameter(Mandatory = $false, ParameterSetName = "RegistryEntries")]

        [Parameter(Mandatory = $false, ParameterSetName = "InputObject")]

        [string[]]$MachineGroupFriendlyName = @("All Machine Groups"),

        [Parameter(Mandatory = $true, ParameterSetName = "RegistryEntries")]

        [hashtable[]]$RegistryEntries = @(),

        [Parameter(Mandatory = $true, ParameterSetName = "InputObject")]

        [PSCustomObject]$InputObject,

        [Parameter(DontShow)]

        [ValidateNotNullOrEmpty()]

        [string]$ConfigShare = $Script:AppVentix.ConfigShare

    )

    #region functions

    function New-RegistryUserSettingXml {

        <#

    .SYNOPSIS

        Builds and returns the UserSetting XML document object.

    .NOTES

        Function  : New-RegistryUserSettingXml

        Author    : John Billekens

        Copyright : Copyright (c) John Billekens Consultancy

        Version   : 2026.0227.1200

    #>

        [CmdletBinding()]

        param ()

        $XmlDoc = New-Object System.Xml.XmlDocument

        # Root element

        $Root = $XmlDoc.CreateElement("UserSetting")

        [void]$XmlDoc.AppendChild($Root)

        # Helper: append a simple text element

        function Add-TextElement {

            param (

                [System.Xml.XmlElement]$Parent,

                [string]$Name,

                [string]$Text

            )

            $Element = $XmlDoc.CreateElement($Name)

            $Element.InnerText = $Text

            [void]$Parent.AppendChild($Element)

            return $Element

        }

        # Basic metadata

        [void](Add-TextElement -Parent $Root -Name "Id" -Text $SettingId)

        [void](Add-TextElement -Parent $Root -Name "FriendlyName" -Text $FriendlyName)

        [void](Add-TextElement -Parent $Root -Name "Description" -Text $Description)

        [void](Add-TextElement -Parent $Root -Name "Type" -Text $Type)

        [void](Add-TextElement -Parent $Root -Name "ExecutionOrder" -Text $ExecutionOrder)

        [void](Add-TextElement -Parent $Root -Name "CreatedDate" -Text $CreatedDate)

        [void](Add-TextElement -Parent $Root -Name "LastModifiedDate" -Text $LastModifiedDate)

        [void](Add-TextElement -Parent $Root -Name "ProcessAtLogin" -Text (ConvertTo-BooleanString -Value $ProcessAtLogin))

        [void](Add-TextElement -Parent $Root -Name "ProcessAtRefresh" -Text (ConvertTo-BooleanString -Value $ProcessAtRefresh))

        [void](Add-TextElement -Parent $Root -Name "ProcessAtReconnectAndUnlock" -Text (ConvertTo-BooleanString -Value $ProcessAtReconnectAndUnlock))

        $MachineGroupsElement = $XmlDoc.CreateElement("MachineGroups")

        foreach ($Group in $MachineGroups) {

            [void](Add-TextElement -Parent $MachineGroupsElement -Name "MachineGroup" -Text $Group)

        }

        [void]$Root.AppendChild($MachineGroupsElement)

        $MachineGroupFriendlyNamesElement = $XmlDoc.CreateElement("MachineGroupFriendlyNames")

        foreach ($GroupFriendlyName in $MachineGroupFriendlyNames) {

            [void](Add-TextElement -Parent $MachineGroupFriendlyNamesElement -Name "FriendlyName" -Text $GroupFriendlyName)

        }

        [void]$Root.AppendChild($MachineGroupFriendlyNamesElement)

        $RegistryEntriesElement = $XmlDoc.CreateElement("RegistryEntries")

        foreach ($EntryData in $NewRegistryEntries) {

            $RegistryEntryElement = $XmlDoc.CreateElement("RegistryEntry")

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "RootKey" -Text $EntryData.RootKey)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "KeyPath" -Text $EntryData.KeyPath)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "ValueName" -Text $EntryData.ValueName)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "ValueData" -Text $EntryData.ValueData)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "ValueType" -Text $EntryData.ValueType)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "Action" -Text $EntryData.Action)

            [void](Add-TextElement -Parent $RegistryEntryElement -Name "DeleteKey" -Text (ConvertTo-BooleanString -Value ([bool]$EntryData.DeleteKey)))

            [void]$RegistryEntriesElement.AppendChild($RegistryEntryElement)

        }

        [void]$Root.AppendChild($RegistryEntriesElement)

        return $XmlDoc

    }

    #endregion functions

    if (Test-AppVentiXIsLicensed -ConfigShare $ConfigShare) {

        # region Basics

        $SettingId = [guid]::NewGuid().ToString()

        $Type = "RegistrySettings"

        # endregion Basics

        $userSettingsPath = Join-Path -Path $ConfigShare -ChildPath $Script:AppVentix.UserSettingsPath

        #Process the inputObject if provided

        if ($PSBoundParameters.ContainsKey("InputObject")) {

            Write-Verbose "Processing InputObject parameter..."

            if (-not [string]::IsNullOrEmpty($InputObject.FriendlyName)) {

                $FriendlyName = $InputObject.FriendlyName

            }

            if (-not [string]::IsNullOrEmpty($InputObject.Description)) {

                $Description = $InputObject.Description

            }

            $FriendlyName = $InputObject.FriendlyName

            $Description = $InputObject.Description

            $RegistryEntries = @($InputObject.RegistryEntries | ConvertTo-HashTable)

        }

        # Only first MachineGroup is used

        if ($MachineGroupFriendlyName.Count -gt 0) {

            if ($MachineGroup -notcontains "All Machine Groups" -and $MachineGroup -notcontains "All" -and $MachineGroup.Count -gt 0) {

                $AvailableGroups = Get-AppVentiXMachineGroup

                $MachineGroups = @()

                $MachineGroupFriendlyNames = @()

                foreach ($Group in $MachineGroupFriendlyName) {

                    $selectedGroup = $AvailableGroups | Where-Object { $_.FriendlyName -ieq $Group }

                    if ($selectedGroup) {

                        $MachineGroups += $selectedGroup.GroupName.ToString()

                        $MachineGroupFriendlyNames += $selectedGroup.FriendlyName.ToString()

                    }

                }

            } else {

                $MachineGroups = @("All")

                $MachineGroupFriendlyNames = @("All Machine Groups")

            }

        } else {

            $MachineGroups = @("All")

            $MachineGroupFriendlyNames = @("All Machine Groups")

        }

        #region --- Build $NewRegistryEntries ---

        #Check That the $RegistryEntries parameter is an array of hashtables with the required keys

        $NewRegistryEntries = @()

        foreach ($entry in $RegistryEntries) {

            if (-not ($entry.ContainsKey("RootKey") -and $entry.ContainsKey("KeyPath"))) {

                Write-Error "Each registry entry must be a hashtable containing at least the keys: RootKey, KeyPath"

                return

            }

            $NewRegistryEntry = [ordered]@{

                RootKey   = "$($entry.RootKey)"

                KeyPath   = "$($entry.KeyPath)"

                ValueName = "$($entry.ValueName)"

                ValueData = "$($entry.ValueData)"

                ValueType = "$($entry.ValueType)"

                Action    = "$($entry.Action)"

                DeleteKey = $($entry.DeleteKey)

            }

            if ([string]::IsNullOrEmpty($NewRegistryEntry.Action)) {

                $NewRegistryEntry.Action = "Set"

            }

            if ([string]::IsNullOrEmpty($NewRegistryEntry.DeleteKey)) {

                $NewRegistryEntry.DeleteKey = $false

            }

            #check and normalize the rootkey values

            Write-Verbose "Checking RootKey value: $($NewRegistryEntry.RootKey)"

            switch -CaseSensitive ($NewRegistryEntry.RootKey) {

                "HKLM" { $NewRegistryEntry.RootKey = "HKEY_LOCAL_MACHINE" }

                "HKCU" { $NewRegistryEntry.RootKey = "HKEY_CURRENT_USER" }

                "Machine" { $NewRegistryEntry.RootKey = "HKEY_LOCAL_MACHINE" }

                "User" { $NewRegistryEntry.RootKey = "HKEY_CURRENT_USER" }

                "HKEY_LOCAL_MACHINE" { }

                "HKEY_CURRENT_USER" { }

                default {

                    Write-Error "Invalid RootKey value: $($NewRegistryEntry.RootKey). Valid values are: HKEY_LOCAL_MACHINE (alias: HKLM, Machine), HKEY_CURRENT_USER (alias: HKCU, User)"

                    return

                }

            }

            $NewRegistryEntry.RootKey = $NewRegistryEntry.RootKey.ToUpper()

            if ($NewRegistryEntry.RootKey -notin @("HKEY_LOCAL_MACHINE", "HKEY_CURRENT_USER")) {

                Write-Error "Invalid RootKey value: $($NewRegistryEntry.RootKey). Valid values are: HKEY_LOCAL_MACHINE (alias: HKLM, Machine), HKEY_CURRENT_USER (alias: HKCU, User)"

                return

            }

            Write-Verbose "Continuing with normalized RootKey: $($NewRegistryEntry.RootKey)"

            Write-Verbose "Checking ValueType value: $($NewRegistryEntry.ValueType)"

            switch ($NewRegistryEntry.ValueType) {

                "String" { $NewRegistryEntry.ValueType = "REG_SZ" }

                "DWord" { $NewRegistryEntry.ValueType = "REG_DWORD" }

                "Binary" { $NewRegistryEntry.ValueType = "REG_BINARY" }

                "MultiString" { $NewRegistryEntry.ValueType = "REG_MULTI_SZ" }

                "ExpandString" { $NewRegistryEntry.ValueType = "REG_EXPAND_SZ" }

            }

            $NewRegistryEntry.ValueType = $NewRegistryEntry.ValueType.ToUpper()

            if ([string]::IsNullOrEmpty($NewRegistryEntry.ValueType)) {

                $NewRegistryEntry.ValueType = "REG_SZ"

                Write-Verbose "ValueType not specified. Defaulting to REG_SZ."

            }

            if ($NewRegistryEntry.ValueType -notin @("REG_SZ", "REG_DWORD", "REG_BINARY", "REG_MULTI_SZ", "REG_EXPAND_SZ")) {

                Write-Error "Invalid ValueType: $($NewRegistryEntry.ValueType). Valid values are: REG_SZ (alias: String), REG_DWORD (alias: DWord), REG_BINARY (alias: Binary), REG_MULTI_SZ (alias: MultiString), REG_EXPAND_SZ (alias: ExpandString)"

                return

            }

            Write-Verbose "Continuing with normalized ValueType: $($NewRegistryEntry.ValueType)"

            Write-Verbose "Checking DeleteKey value: $($NewRegistryEntry.DeleteKey)"

            $deleteKey = $false

            switch ($($NewRegistryEntry.DeleteKey)) {

                "True" { $deleteKey = $true }

                "False" { $deleteKey = $false }

                "1" { $deleteKey = $true }

                "0" { $deleteKey = $false }

                $true { $deleteKey = $true }

                $false { $deleteKey = $false }

                default {

                    Write-Error "Invalid DeleteKey value: $($NewRegistryEntry.DeleteKey). Valid values are: True (alias: 1), False (alias: 0)"

                    return

                }

            }

            $NewRegistryEntry.DeleteKey = $deleteKey

            if ($NewRegistryEntry.Action -ieq "Remove" -and [string]::IsNullOrEmpty($NewRegistryEntry.ValueName)) {

                $NewRegistryEntry.DeleteKey = $true

                Write-Verbose "Action is Remove and ValueName is empty. Setting DeleteKey to True."

            }

            Write-Verbose "Continuing with normalized DeleteKey: $($NewRegistryEntry.DeleteKey)"

            $NewRegistryEntries += $NewRegistryEntry

        }

        #endregion --- Build $NewRegistryEntries ---

        $policyFilename = "$($Type)-$($SettingId).xml"

        $policyFullname = Join-Path -Path $userSettingsPath -ChildPath $policyFilename

        $CreatedDate = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss")

        $LastModifiedDate = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss")

        #region --- Main ---

        if ([string]::IsNullOrEmpty($FriendlyName)) {

            Write-Error "FriendlyName is required. Please provide a value for the FriendlyName parameter or include it in the InputObject."

            return

        }

        try {

            Write-Verbose "Building UserSetting XML..."

            $XmlDocument = New-RegistryUserSettingXml

            $XmlWriterSettings = New-Object System.Xml.XmlWriterSettings

            $XmlWriterSettings.Indent = $true

            $XmlWriterSettings.IndentChars = "  "

            $XmlWriterSettings.Encoding = [System.Text.Encoding]::UTF8

            $XmlWriterSettings.OmitXmlDeclaration = $true

            Write-Verbose "Saving UserSetting XML to $policyFullname"

            $XmlWriter = [System.Xml.XmlWriter]::Create($policyFullname, $XmlWriterSettings)

            $XmlDocument.Save($XmlWriter)

            Write-AppVentiXLogEntry -Feature UserSettings -Action $($MyInvocation.MyCommand.Name) -Details "New Registry User Setting '$FriendlyName' added with $($NewRegistryEntries.Count) setting(s)."

            $XmlWriter.Close()

            Write-Output ( [PSCustomObject]@{

                    Id           = $SettingId

                    FriendlyName = $FriendlyName

                    FileName     = $policyFilename

                }

            )

        } catch {

            Write-Error "Failed to generate XML: $($_.Exception.Message)"

        }

    } else {

        Write-Warning 'AppVentiX is not licensed!'

    }

}

# SIG # Begin signature block

# MIImdwYJKoZIhvcNAQcCoIImaDCCJmQCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCVgiJJsBcj4H00

# Cjwp1UYpY+wGqB+I2cg/HO9bjNNhAKCCIAowggYUMIID/KADAgECAhB6I67aU2mW

# D5HIPlz0x+M/MA0GCSqGSIb3DQEBDAUAMFcxCzAJBgNVBAYTAkdCMRgwFgYDVQQK

# Ew9TZWN0aWdvIExpbWl0ZWQxLjAsBgNVBAMTJVNlY3RpZ28gUHVibGljIFRpbWUg

# U3RhbXBpbmcgUm9vdCBSNDYwHhcNMjEwMzIyMDAwMDAwWhcNMzYwMzIxMjM1OTU5

# WjBVMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSwwKgYD

# VQQDEyNTZWN0aWdvIFB1YmxpYyBUaW1lIFN0YW1waW5nIENBIFIzNjCCAaIwDQYJ

# KoZIhvcNAQEBBQADggGPADCCAYoCggGBAM2Y2ENBq26CK+z2M34mNOSJjNPvIhKA

# VD7vJq+MDoGD46IiM+b83+3ecLvBhStSVjeYXIjfa3ajoW3cS3ElcJzkyZlBnwDE

# JuHlzpbN4kMH2qRBVrjrGJgSlzzUqcGQBaCxpectRGhhnOSwcjPMI3G0hedv2eNm

# GiUbD12OeORN0ADzdpsQ4dDi6M4YhoGE9cbY11XxM2AVZn0GiOUC9+XE0wI7CQKf

# OUfigLDn7i/WeyxZ43XLj5GVo7LDBExSLnh+va8WxTlA+uBvq1KO8RSHUQLgzb1g

# bL9Ihgzxmkdp2ZWNuLc+XyEmJNbD2OIIq/fWlwBp6KNL19zpHsODLIsgZ+WZ1AzC

# s1HEK6VWrxmnKyJJg2Lv23DlEdZlQSGdF+z+Gyn9/CRezKe7WNyxRf4e4bwUtrYE

# 2F5Q+05yDD68clwnweckKtxRaF0VzN/w76kOLIaFVhf5sMM/caEZLtOYqYadtn03

# 4ykSFaZuIBU9uCSrKRKTPJhWvXk4CllgrwIDAQABo4IBXDCCAVgwHwYDVR0jBBgw

# FoAU9ndq3T/9ARP/FqFsggIv0Ao9FCUwHQYDVR0OBBYEFF9Y7UwxeqJhQo1SgLqz

# YZcZojKbMA4GA1UdDwEB/wQEAwIBhjASBgNVHRMBAf8ECDAGAQH/AgEAMBMGA1Ud

# JQQMMAoGCCsGAQUFBwMIMBEGA1UdIAQKMAgwBgYEVR0gADBMBgNVHR8ERTBDMEGg

# P6A9hjtodHRwOi8vY3JsLnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNUaW1lU3Rh

# bXBpbmdSb290UjQ2LmNybDB8BggrBgEFBQcBAQRwMG4wRwYIKwYBBQUHMAKGO2h0

# dHA6Ly9jcnQuc2VjdGlnby5jb20vU2VjdGlnb1B1YmxpY1RpbWVTdGFtcGluZ1Jv

# b3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdvLmNvbTAN

# BgkqhkiG9w0BAQwFAAOCAgEAEtd7IK0ONVgMnoEdJVj9TC1ndK/HYiYh9lVUacah

# RoZ2W2hfiEOyQExnHk1jkvpIJzAMxmEc6ZvIyHI5UkPCbXKspioYMdbOnBWQUn73

# 3qMooBfIghpR/klUqNxx6/fDXqY0hSU1OSkkSivt51UlmJElUICZYBodzD3M/SFj

# eCP59anwxs6hwj1mfvzG+b1coYGnqsSz2wSKr+nDO+Db8qNcTbJZRAiSazr7KyUJ

# Go1c+MScGfG5QHV+bps8BX5Oyv9Ct36Y4Il6ajTqV2ifikkVtB3RNBUgwu/mSiSU

# ice/Jp/q8BMk/gN8+0rNIE+QqU63JoVMCMPY2752LmESsRVVoypJVt8/N3qQ1c6F

# ibbcRabo3azZkcIdWGVSAdoLgAIxEKBeNh9AQO1gQrnh1TA8ldXuJzPSuALOz1Uj

# b0PCyNVkWk7hkhVHfcvBfI8NtgWQupiaAeNHe0pWSGH2opXZYKYG4Lbukg7HpNi/

# KqJhue2Keak6qH9A8CeEOB7Eob0Zf+fU+CCQaL0cJqlmnx9HCDxF+3BLbUufrV64

# EbTI40zqegPZdA+sXCmbcZy6okx/SjwsusWRItFA3DE8MORZeFb6BmzBtqKJ7l93

# 9bbKBy2jvxcJI98Va95Q5JnlKor3m0E7xpMeYRriWklUPsetMSf2NvUQa/E5vVye

# fQIwggZFMIIELaADAgECAhAIMk+dt9qRb2Pk8qM8Xl1RMA0GCSqGSIb3DQEBCwUA

# MFYxCzAJBgNVBAYTAlBMMSEwHwYDVQQKExhBc3NlY28gRGF0YSBTeXN0ZW1zIFMu

# QS4xJDAiBgNVBAMTG0NlcnR1bSBDb2RlIFNpZ25pbmcgMjAyMSBDQTAeFw0yNDA0

# MDQxNDA0MjRaFw0yNzA0MDQxNDA0MjNaMGsxCzAJBgNVBAYTAk5MMRIwEAYDVQQH

# DAlTY2hpam5kZWwxIzAhBgNVBAoMGkpvaG4gQmlsbGVrZW5zIENvbnN1bHRhbmN5

# MSMwIQYDVQQDDBpKb2huIEJpbGxla2VucyBDb25zdWx0YW5jeTCCAaIwDQYJKoZI

# hvcNAQEBBQADggGPADCCAYoCggGBAMslntDbSQwHZXwFhmibivbnd0Qfn6sqe/6f

# os3pKzKxEsR907RkDMet2x6RRg3eJkiIr3TFPwqBooyXXgK3zxxpyhGOcuIqyM9J

# 28DVf4kUyZHsjGO/8HFjrr3K1hABNUszP0o7H3o6J31eqV1UmCXYhQlNoW9FOmRC

# 1amlquBmh7w4EKYEytqdmdOBavAD5Xq4vLPxNP6kyA+B2YTtk/xM27TghtbwFGKn

# u9Vwnm7dFcpLxans4ONt2OxDQOMA5NwgcUv/YTpjhq9qoz6ivG55NRJGNvUXsM3w

# 2o7dR6Xh4MuEGrTSrOWGg2A5EcLH1XqQtkF5cZnAPM8W/9HUp8ggornWnFVQ9/6M

# ga+ermy5wy5XrmQpN+x3u6tit7xlHk1Hc+4XY4a4ie3BPXG2PhJhmZAn4ebNSBwN

# Hh8z7WTT9X9OFERepGSytZVeEP7hgyptSLcuhpwWeR4QdBb7dV++4p3PsAUQVHFp

# wkSbrRTv4EiJ0Lcz9P1HPGFoHiFAQQIDAQABo4IBeDCCAXQwDAYDVR0TAQH/BAIw

# ADA9BgNVHR8ENjA0MDKgMKAuhixodHRwOi8vY2NzY2EyMDIxLmNybC5jZXJ0dW0u

# cGwvY2NzY2EyMDIxLmNybDBzBggrBgEFBQcBAQRnMGUwLAYIKwYBBQUHMAGGIGh0

# dHA6Ly9jY3NjYTIwMjEub2NzcC1jZXJ0dW0uY29tMDUGCCsGAQUFBzAChilodHRw

# Oi8vcmVwb3NpdG9yeS5jZXJ0dW0ucGwvY2NzY2EyMDIxLmNlcjAfBgNVHSMEGDAW

# gBTddF1MANt7n6B0yrFu9zzAMsBwzTAdBgNVHQ4EFgQUO6KtBpOBgmrlANVAnyiQ

# C6W6lJwwSwYDVR0gBEQwQjAIBgZngQwBBAEwNgYLKoRoAYb2dwIFAQQwJzAlBggr

# BgEFBQcCARYZaHR0cHM6Ly93d3cuY2VydHVtLnBsL0NQUzATBgNVHSUEDDAKBggr

# BgEFBQcDAzAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAEQsN8wg

# PMdWVkwHPPTN+jKpdns5AKVFjcn00psf2NGVVgWWNQBIQc9lEuTBWb54IK6Ga3hx

# QRZfnPNo5HGl73YLmFgdFQrFzZ1lnaMdIcyh8LTWv6+XNWfoyCM9wCp4zMIDPOs8

# LKSMQqA/wRgqiACWnOS4a6fyd5GUIAm4CuaptpFYr90l4Dn/wAdXOdY32UhgzmSu

# xpUbhD8gVJUaBNVmQaRqeU8y49MxiVrUKJXde1BCrtR9awXbqembc7Nqvmi60tYK

# lD27hlpKtj6eGPjkht0hHEsgzU0Fxw7ZJghYG2wXfpF2ziN893ak9Mi/1dmCNmor

# GOnybKYfT6ff6YTCDDNkod4egcMZdOSv+/Qv+HAeIgEvrxE9QsGlzTwbRtbm6gwY

# YcVBs/SsVUdBn/TSB35MMxRhHE5iC3aUTkDbceo/XP3uFhVL4g2JZHpFfCSu2TQr

# rzRn2sn07jfMvzeHArCOJgBW1gPqR3WrJ4hUxL06Rbg1gs9tU5HGGz9KNQMfQFQ7

# 0Wz7UIhezGcFcRfkIfSkMmQYYpsc7rfzj+z0ThfDVzzJr2dMOFsMlfj1T6l22GBq

# 9XQx0A4lcc5Fl9pRxbOuHHWFqIBD/BCEhwniOCySzqENd2N+oz8znKooSISStnkN

# aYXt6xblJF2dx9Dn89FK7d1IquNxOwt0tI5dMIIGYjCCBMqgAwIBAgIRAKQpO24e

# 3denNAiHrXpOtyQwDQYJKoZIhvcNAQEMBQAwVTELMAkGA1UEBhMCR0IxGDAWBgNV

# BAoTD1NlY3RpZ28gTGltaXRlZDEsMCoGA1UEAxMjU2VjdGlnbyBQdWJsaWMgVGlt

# ZSBTdGFtcGluZyBDQSBSMzYwHhcNMjUwMzI3MDAwMDAwWhcNMzYwMzIxMjM1OTU5

# WjByMQswCQYDVQQGEwJHQjEXMBUGA1UECBMOV2VzdCBZb3Jrc2hpcmUxGDAWBgNV

# BAoTD1NlY3RpZ28gTGltaXRlZDEwMC4GA1UEAxMnU2VjdGlnbyBQdWJsaWMgVGlt

# ZSBTdGFtcGluZyBTaWduZXIgUjM2MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEA04SV9G6kU3jyPRBLeBIHPNyUgVNnYayfsGOyYEXrn3+SkDYTLs1crcw/

# ol2swE1TzB2aR/5JIjKNf75QBha2Ddj+4NEPKDxHEd4dEn7RTWMcTIfm492TW22I

# 8LfH+A7Ehz0/safc6BbsNBzjHTt7FngNfhfJoYOrkugSaT8F0IzUh6VUwoHdYDpi

# ln9dh0n0m545d5A5tJD92iFAIbKHQWGbCQNYplqpAFasHBn77OqW37P9BhOASdmj

# p3IijYiFdcA0WQIe60vzvrk0HG+iVcwVZjz+t5OcXGTcxqOAzk1frDNZ1aw8nFhG

# EvG0ktJQknnJZE3D40GofV7O8WzgaAnZmoUn4PCpvH36vD4XaAF2CjiPsJWiY/j2

# xLsJuqx3JtuI4akH0MmGzlBUylhXvdNVXcjAuIEcEQKtOBR9lU4wXQpISrbOT8ux

# +96GzBq8TdbhoFcmYaOBZKlwPP7pOp5Mzx/UMhyBA93PQhiCdPfIVOCINsUY4U23

# p4KJ3F1HqP3H6Slw3lHACnLilGETXRg5X/Fp8G8qlG5Y+M49ZEGUp2bneRLZoyHT

# yynHvFISpefhBCV0KdRZHPcuSL5OAGWnBjAlRtHvsMBrI3AAA0Tu1oGvPa/4yeei

# Ayu+9y3SLC98gDVbySnXnkujjhIh+oaatsk/oyf5R2vcxHahajMCAwEAAaOCAY4w

# ggGKMB8GA1UdIwQYMBaAFF9Y7UwxeqJhQo1SgLqzYZcZojKbMB0GA1UdDgQWBBSI

# YYyhKjdkgShgoZsx0Iz9LALOTzAOBgNVHQ8BAf8EBAMCBsAwDAYDVR0TAQH/BAIw

# ADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDBKBgNVHSAEQzBBMDUGDCsGAQQBsjEB

# AgEDCDAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28uY29tL0NQUzAIBgZn

# gQwBBAIwSgYDVR0fBEMwQTA/oD2gO4Y5aHR0cDovL2NybC5zZWN0aWdvLmNvbS9T

# ZWN0aWdvUHVibGljVGltZVN0YW1waW5nQ0FSMzYuY3JsMHoGCCsGAQUFBwEBBG4w

# bDBFBggrBgEFBQcwAoY5aHR0cDovL2NydC5zZWN0aWdvLmNvbS9TZWN0aWdvUHVi

# bGljVGltZVN0YW1waW5nQ0FSMzYuY3J0MCMGCCsGAQUFBzABhhdodHRwOi8vb2Nz

# cC5zZWN0aWdvLmNvbTANBgkqhkiG9w0BAQwFAAOCAYEAAoE+pIZyUSH5ZakuPVKK

# 4eWbzEsTRJOEjbIu6r7vmzXXLpJx4FyGmcqnFZoa1dzx3JrUCrdG5b//LfAxOGy9

# Ph9JtrYChJaVHrusDh9NgYwiGDOhyyJ2zRy3+kdqhwtUlLCdNjFjakTSE+hkC9F5

# ty1uxOoQ2ZkfI5WM4WXA3ZHcNHB4V42zi7Jk3ktEnkSdViVxM6rduXW0jmmiu71Z

# pBFZDh7Kdens+PQXPgMqvzodgQJEkxaION5XRCoBxAwWwiMm2thPDuZTzWp/gUFz

# i7izCmEt4pE3Kf0MOt3ccgwn4Kl2FIcQaV55nkjv1gODcHcD9+ZVjYZoyKTVWb4V

# qMQy/j8Q3aaYd/jOQ66Fhk3NWbg2tYl5jhQCuIsE55Vg4N0DUbEWvXJxtxQQaVR5

# xzhEI+BjJKzh3TQ026JxHhr2fuJ0mV68AluFr9qshgwS5SpN5FFtaSEnAwqZv3IS

# +mlG50rK7W3qXbWwi4hmpylUfygtYLEdLQukNEX1jiOKMIIGgjCCBGqgAwIBAgIQ

# NsKwvXwbOuejs902y8l1aDANBgkqhkiG9w0BAQwFADCBiDELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYD

# VQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBS

# U0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMjEwMzIyMDAwMDAwWhcNMzgw

# MTE4MjM1OTU5WjBXMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1p

# dGVkMS4wLAYDVQQDEyVTZWN0aWdvIFB1YmxpYyBUaW1lIFN0YW1waW5nIFJvb3Qg

# UjQ2MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAiJ3YuUVnnR3d6Lkm

# gZpUVMB8SQWbzFoVD9mUEES0QUCBdxSZqdTkdizICFNeINCSJS+lV1ipnW5ihkQy

# C0cRLWXUJzodqpnMRs46npiJPHrfLBOifjfhpdXJ2aHHsPHggGsCi7uE0awqKggE

# /LkYw3sqaBia67h/3awoqNvGqiFRJ+OTWYmUCO2GAXsePHi+/JUNAax3kpqstbl3

# vcTdOGhtKShvZIvjwulRH87rbukNyHGWX5tNK/WABKf+Gnoi4cmisS7oSimgHUI0

# Wn/4elNd40BFdSZ1EwpuddZ+Wr7+Dfo0lcHflm/FDDrOJ3rWqauUP8hsokDoI7D/

# yUVI9DAE/WK3Jl3C4LKwIpn1mNzMyptRwsXKrop06m7NUNHdlTDEMovXAIDGAvYy

# nPt5lutv8lZeI5w3MOlCybAZDpK3Dy1MKo+6aEtE9vtiTMzz/o2dYfdP0KWZwZIX

# bYsTIlg1YIetCpi5s14qiXOpRsKqFKqav9R1R5vj3NgevsAsvxsAnI8Oa5s2oy25

# qhsoBIGo/zi6GpxFj+mOdh35Xn91y72J4RGOJEoqzEIbW3q0b2iPuWLA911cRxgY

# 5SJYubvjay3nSMbBPPFsyl6mY4/WYucmyS9lo3l7jk27MAe145GWxK4O3m3gEFEI

# kv7kRmefDR7Oe2T1HxAnICQvr9sCAwEAAaOCARYwggESMB8GA1UdIwQYMBaAFFN5

# v1qqK0rPVIDh2JvAnfKyA2bLMB0GA1UdDgQWBBT2d2rdP/0BE/8WoWyCAi/QCj0U

# JTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zATBgNVHSUEDDAKBggr

# BgEFBQcDCDARBgNVHSAECjAIMAYGBFUdIAAwUAYDVR0fBEkwRzBFoEOgQYY/aHR0

# cDovL2NybC51c2VydHJ1c3QuY29tL1VTRVJUcnVzdFJTQUNlcnRpZmljYXRpb25B

# dXRob3JpdHkuY3JsMDUGCCsGAQUFBwEBBCkwJzAlBggrBgEFBQcwAYYZaHR0cDov

# L29jc3AudXNlcnRydXN0LmNvbTANBgkqhkiG9w0BAQwFAAOCAgEADr5lQe1oRLjl

# ocXUEYfktzsljOt+2sgXke3Y8UPEooU5y39rAARaAdAxUeiX1ktLJ3+lgxtoLQhn

# 5cFb3GF2SSZRX8ptQ6IvuD3wz/LNHKpQ5nX8hjsDLRhsyeIiJsms9yAWnvdYOdEM

# q1W61KE9JlBkB20XBee6JaXx4UBErc+YuoSb1SxVf7nkNtUjPfcxuFtrQdRMRi/f

# InV/AobE8Gw/8yBMQKKaHt5eia8ybT8Y/Ffa6HAJyz9gvEOcF1VWXG8OMeM7Vy7B

# s6mSIkYeYtddU1ux1dQLbEGur18ut97wgGwDiGinCwKPyFO7ApcmVJOtlw9FVJxw

# /mL1TbyBns4zOgkaXFnnfzg4qbSvnrwyj1NiurMp4pmAWjR+Pb/SIduPnmFzbSN/

# G8reZCL4fvGlvPFk4Uab/JVCSmj59+/mB2Gn6G/UYOy8k60mKcmaAZsEVkhOFuoj

# 4we8CYyaR9vd9PGZKSinaZIkvVjbH/3nlLb0a7SBIkiRzfPfS9T+JesylbHa1LtR

# V9U/7m0q7Ma2CQ/t392ioOssXW7oKLdOmMBl14suVFBmbzrt5V5cQPnwtd3UOTpS

# 9oCG+ZZheiIvPgkDmA8FzPsnfXW5qHELB43ET7HHFHeRPRYrMBKjkb8/IN7Po0d0

# hQoF4TeMM+zYAJzoKQnVKOLg8pZVPT8wgga5MIIEoaADAgECAhEAmaOACiZVO2Wr

# 3G6EprPqOTANBgkqhkiG9w0BAQwFADCBgDELMAkGA1UEBhMCUEwxIjAgBgNVBAoT

# GVVuaXpldG8gVGVjaG5vbG9naWVzIFMuQS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0

# aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIGA1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0

# d29yayBDQSAyMB4XDTIxMDUxOTA1MzIxOFoXDTM2MDUxODA1MzIxOFowVjELMAkG

# A1UEBhMCUEwxITAfBgNVBAoTGEFzc2VjbyBEYXRhIFN5c3RlbXMgUy5BLjEkMCIG

# A1UEAxMbQ2VydHVtIENvZGUgU2lnbmluZyAyMDIxIENBMIICIjANBgkqhkiG9w0B

# AQEFAAOCAg8AMIICCgKCAgEAnSPPBDAjO8FGLOczcz5jXXp1ur5cTbq96y34vuTm

# flN4mSAfgLKTvggv24/rWiVGzGxT9YEASVMw1Aj8ewTS4IndU8s7VS5+djSoMcbv

# IKck6+hI1shsylP4JyLvmxwLHtSworV9wmjhNd627h27a8RdrT1PH9ud0IF+njvM

# k2xqbNTIPsnWtw3E7DmDoUmDQiYi/ucJ42fcHqBkbbxYDB7SYOouu9Tj1yHIohzu

# C8KNqfcYf7Z4/iZgkBJ+UFNDcc6zokZ2uJIxWgPWXMEmhu1gMXgv8aGUsRdaCtVD

# 2bSlbfsq7BiqljjaCun+RJgTgFRCtsuAEw0pG9+FA+yQN9n/kZtMLK+Wo837Q4QO

# ZgYqVWQ4x6cM7/G0yswg1ElLlJj6NYKLw9EcBXE7TF3HybZtYvj9lDV2nT8mFSkc

# SkAExzd4prHwYjUXTeZIlVXqj+eaYqoMTpMrfh5MCAOIG5knN4Q/JHuurfTI5XDY

# O962WZayx7ACFf5ydJpoEowSP07YaBiQ8nXpDkNrUA9g7qf/rCkKbWpQ5boufUnq

# 1UiYPIAHlezf4muJqxqIns/kqld6JVX8cixbd6PzkDpwZo4SlADaCi2JSplKShBS

# ND36E/ENVv8urPS0yOnpG4tIoBGxVCARPCg1BnyMJ4rBJAcOSnAWd18Jx5n858JS

# qPECAwEAAaOCAVUwggFRMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFN10XUwA

# 23ufoHTKsW73PMAywHDNMB8GA1UdIwQYMBaAFLahVDkCw6A/joq8+tT4HKbROg79

# MA4GA1UdDwEB/wQEAwIBBjATBgNVHSUEDDAKBggrBgEFBQcDAzAwBgNVHR8EKTAn

# MCWgI6Ahhh9odHRwOi8vY3JsLmNlcnR1bS5wbC9jdG5jYTIuY3JsMGwGCCsGAQUF

# BwEBBGAwXjAoBggrBgEFBQcwAYYcaHR0cDovL3N1YmNhLm9jc3AtY2VydHVtLmNv

# bTAyBggrBgEFBQcwAoYmaHR0cDovL3JlcG9zaXRvcnkuY2VydHVtLnBsL2N0bmNh

# Mi5jZXIwOQYDVR0gBDIwMDAuBgRVHSAAMCYwJAYIKwYBBQUHAgEWGGh0dHA6Ly93

# d3cuY2VydHVtLnBsL0NQUzANBgkqhkiG9w0BAQwFAAOCAgEAdYhYD+WPUCiaU58Q

# 7EP89DttyZqGYn2XRDhJkL6P+/T0IPZyxfxiXumYlARMgwRzLRUStJl490L94C9L

# GF3vjzzH8Jq3iR74BRlkO18J3zIdmCKQa5LyZ48IfICJTZVJeChDUyuQy6rGDxLU

# UAsO0eqeLNhLVsgw6/zOfImNlARKn1FP7o0fTbj8ipNGxHBIutiRsWrhWM2f8pXd

# d3x2mbJCKKtl2s42g9KUJHEIiLni9ByoqIUul4GblLQigO0ugh7bWRLDm0CdY9rN

# LqyA3ahe8WlxVWkxyrQLjH8ItI17RdySaYayX3PhRSC4Am1/7mATwZWwSD+B7eMc

# ZNhpn8zJ+6MTyE6YoEBSRVrs0zFFIHUR08Wk0ikSf+lIe5Iv6RY3/bFAEloMU+vU

# BfSouCReZwSLo8WdrDlPXtR0gicDnytO7eZ5827NS2x7gCBibESYkOh1/w1tVxTp

# V2Na3PR7nxYVlPu1JPoRZCbH86gc96UTvuWiOruWmyOEMLOGGniR+x+zPF/2DaGg

# K2W1eEJfo2qyrBNPvF7wuAyQfiFXLwvWHamoYtPZo0LHuH8X3n9C+xN4YaNjt2yw

# zOr+tKyEVAotnyU9vyEVOaIYMk3IeBrmFnn0gbKeTTyYeEEUz/Qwt4HOUBCrW602

# NCmvO1nm+/80nLy5r0AZvCQxaQ4xggXDMIIFvwIBATBqMFYxCzAJBgNVBAYTAlBM

# MSEwHwYDVQQKExhBc3NlY28gRGF0YSBTeXN0ZW1zIFMuQS4xJDAiBgNVBAMTG0Nl

# cnR1bSBDb2RlIFNpZ25pbmcgMjAyMSBDQQIQCDJPnbfakW9j5PKjPF5dUTANBglg

# hkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3

# DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEV

# MC8GCSqGSIb3DQEJBDEiBCA6MyNzA6Ndw9ABHW+zmVY0rSVdt71Vby1KXVNaERMe

# tDANBgkqhkiG9w0BAQEFAASCAYB5Az638Doojq/3PsR9LKSNK9zemjuI0PAuZa+N

# XB6IUODQaSytVyszsJl6pQW8BjZVI0vDZYQwbspePQp0w59JseFCQgUnYNZpikws

# sqGd4lCIsxN7PxNx5EhiJC10Vn4y0o13HHwX+4rJSt9Ehd3ObjDji0hTVZxd8SO4

# sMML0WVRjZCd8IRLPuKFVHTDvPe0Zo5NfJlOg6qebpbm8mKdUtgl5dAef6pbGA9g

# pJDqARTc5xTBER1IvYd/QwuNpwtjlaJLFWoF/Phpa8ly937bxeU44Ud9eFgXsV4B

# dFbBShLjbXLsi1MJlzo9RH8INfW4GD8woC0qs7nDgkIWFoDmjLCHnalqUERphDut

# jUtvI6+YNGARml7Jfl6+Rhba1VCtT8MiSkQhm4CP8FyZsVdcZME+FPz+TF0nVuPj

# lC5ULzTancrQ9/QErwa+xdX0IyNxQs67FAMPmbxyNR2z6oQswO1QX86W/0cv4Oj4

# 2FuLWPP2/WrXt/cwmMrMEKqfNRWhggMjMIIDHwYJKoZIhvcNAQkGMYIDEDCCAwwC

# AQEwajBVMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSww

# KgYDVQQDEyNTZWN0aWdvIFB1YmxpYyBUaW1lIFN0YW1waW5nIENBIFIzNgIRAKQp

# O24e3denNAiHrXpOtyQwDQYJYIZIAWUDBAICBQCgeTAYBgkqhkiG9w0BCQMxCwYJ

# KoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yNjA2MTYxODMzMzRaMD8GCSqGSIb3

# DQEJBDEyBDB3CpX0a8XHeVzIPs6WngwOORaD+msN0O0aWLPuXQrPYGVeZyBIfV30

# oNjkdW3R6LcwDQYJKoZIhvcNAQEBBQAEggIAJ/+2DpzVZWuS6AhSEeIbgzbPEU6L

# nn577fXu2ENtCJikmrJiWnIF+LybqhXcCKY++4+rG6L6rsoDbaL4YRTZ3Lrgu5Zk

# yB1UJMWx3aq3Qq8KhLlOm4kYa49dGot/L7ZWJO++xgV1uA/aQb1BoQLAjIGqnwQJ

# qTFwnnMTGSj/OaYuVRbll2xg8ltLR1URKZlOr3fqItUFzr0Uu2zPj2gzdubtGVYW

# SvvdlM+5uMbMN16YHIA9UBkwIk5cuF2nKDEvwb3ic6WQCr7aaZvmTclH8Lcq5kI1

# HgGyjPum1pkS3LSxSD/0Rd3Yw/2YC/4DEZfhbjXDIldpzVj0udI7MJtbmgkeGNDE

# sYfFH77DR7xcGinFP6X5wMS2zsASWhDlcgH4/ZLIAAi9p5XBsgWEk6A4Qrdt7ZLQ

# 86yaSCQN4wjx9RoU8DZ91mCTloJNPzqj+nws8i2d238VF/7KWJbKUP05RepWChkU

# ZSPgtJTj4OyK4RrNVgBIT25MToP/ODzDTFS01NL52dL4+4qOwgQ//6gTHT7dQ1Rl

# VKqSCzKscGk6s1Quz/5BxJ356Tr/qjyivC1/NgTytVixjt3fEDzVKaWLIFt8KkMe

# TLssCTpF131y7jaYSy9ryRwyHBn7cAy+dB/uqhDujMye0bBfmnS5S+Z2EkBDOhRl

# /vXEgovxXbO2pA4=

# SIG # End signature block