AppVentiX

2024.927.2100

public/Copy-AppVentiXPublishingTask.ps1

                                <#

    .SYNOPSIS

        Copies AppVentiX publishing tasks to a new machine group.

    .DESCRIPTION

        The Copy-AppVentiXPublishingTask function copies AppVentiX publishing tasks to a new machine group. It allows you to specify the publishing tasks to copy based on their ID or machine group friendly name. The function retrieves the publishing tasks and machine groups from the AppVentiX module and performs the copy operation.

    .PARAMETER Id

        Specifies the ID of the publishing task to copy.

        This parameter is mandatory when using the 'ID' parameter set.

    .PARAMETER MachineGroupFriendlyname

        Specifies the friendly name of the machine group to copy publishing tasks from.

        This parameter is mandatory when using the 'MachineGroupFriendlyname' parameter set.

    .PARAMETER NewMachineGroupFriendlyname

        Specifies the friendly name of the new machine group to copy publishing tasks to.

        This parameter is mandatory.

    .PARAMETER NewGroup

        Specifies the new group for the publishing tasks. This parameter is optional. If not specified, the group of the original publishing tasks will be used.

    .PARAMETER EnablePublishSeamless

        Enables seamless publishing for the copied publishing tasks. Default is disabled.

        This parameter is optional.

    .EXAMPLE

        Copy-AppVentiXPublishingTask -Id "12345678-1234-1234-1234-1234567890AB" -NewMachineGroupFriendlyname "NewMachineGroup"

        This will copy the publishing task with ID '12345678-1234-1234-1234-1234567890AB' to the machine group with friendly name 'NewMachineGroup'.

    .EXAMPLE

        Copy-AppVentiXPublishingTask -MachineGroupFriendlyname "OldMachineGroup" -NewMachineGroupFriendlyname "NewMachineGroup" -NewGroup "domain.local\NewGroup"

        This will copy all publishing tasks from the machine group with friendly name 'OldMachineGroup' to the machine group with friendly name 'NewMachineGroup' and set the new group to 'domain.local\NewGroup'.

    .EXAMPLE

        Copy-AppVentiXPublishingTask -MachineGroupFriendlyname "OldMachineGroup" -NewMachineGroupFriendlyname "NewMachineGroup"

        This will copy all publishing tasks from the machine group with friendly name 'OldMachineGroup' to the machine group with friendly name 'NewMachineGroup'.

    .EXAMPLE

        Get-AppVentiXPublishingTask -MachineGroupFriendlyName "OldMachineGroup" | Copy-AppVentiXPublishingTask -NewMachineGroupFriendlyname "NewMachineGroup"

        This will copy all publishing tasks from the machine group with friendly name 'OldMachineGroup' to the machine group with friendly name 'NewMachineGroup'.

    .NOTES

        Function : Copy-AppVentiXPublishingTask

        Author   : John Billekens Consultancy

        Copyright: Copyright (c) AppVentiX

        Version  : 1.5

        Requires : Valid AppVentiX license

#>

function Copy-AppVentiXPublishingTask {

    [CmdletBinding(DefaultParameterSetName = 'ID')]

    param (

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

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

        [ValidateScript({

                if ( [guid]::TryParse("$_", $([ref][guid]::Empty)) ) {

                    $true

                } else {

                    Throw [System.Management.Automation.ValidationMetadataException] "The ID '${_}' is not a valid GUID."

                }

            })]

        [ValidateNotNullOrEmpty()]

        [String]$Id,

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

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

        [ValidateNotNullOrEmpty()]

        [String]$MachineGroupFriendlyname,

        [Parameter(ParameterSetName = 'ID', Mandatory)]

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlyname', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [ValidateNotNullOrEmpty()]

        [String]$NewMachineGroupFriendlyname,

        [Parameter(ParameterSetName = 'ID')]

        [Parameter(ParameterSetName = 'IDAzure')]

        [String]$NewGroup,

        [Parameter(ParameterSetName = 'ID')]

        [Parameter(ParameterSetName = 'MachineGroupFriendlyname')]

        [Switch]$DontPublishSeamless,

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [String]$SubscriptionId,

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [String]$ResourceGroupName,

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [Alias('ApplicationGroup')]

        [String]$ApplicationGroupName,

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [Alias('HostPool')]

        [String]$HostPoolName,

        [Parameter(ParameterSetName = 'IDAzure', Mandatory)]

        [Parameter(ParameterSetName = 'MachineGroupFriendlynameAzure', Mandatory)]

        [String]$AssignmentName,

        [Parameter(DontShow, ParameterSetName = 'ID')]

        [Parameter(DontShow, ParameterSetName = 'IDAzure')]

        [Parameter(DontShow, ParameterSetName = 'MachineGroupFriendlyname')]

        [Parameter(DontShow, ParameterSetName = 'MachineGroupFriendlynameAzure')]

        [ValidateNotNullOrEmpty()]

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

    )

    Begin {

        if (Test-AppVentiXIsLicensed -ConfigShare $ConfigShare) {

            $publishingTasksFullname = Join-Path -Path $ConfigShare -ChildPath $Script:AppVentiX.PublishingTasksFilename

            if (-Not (Test-Path -Path $publishingTasksFullname)) {

                Write-Error "Publishing tasks file not found at '$publishingTasksFullname'" -ErrorAction Stop

            }

            $publishingTasks = @(Get-AppVentiXPublishingTask -UserPublishingTasks)

            Write-Verbose "Retrieved $($publishingTasks.Count) publishing task(s)"

            $machineGroups = @(Get-AppVentiXMachineGroup)

            Write-Verbose "Retrieved $($machineGroups.Count) machine group(s)"

        } else {

            Write-Warning 'AppVentiX is not licensed!'

            return

        }

    }

    Process {

        Write-Verbose "Processing the publishing task(s) based on the $($PSCmdlet.ParameterSetName)"

        if ($PSCmdlet.ParameterSetName -in 'ID','IDAzure') {

            Write-Verbose "Copying a single publishing task."

            $selectedPublishingTasks = @($publishingTasks | Where-Object { $_.Id -eq $Id })

        } elseif ($PSCmdlet.ParameterSetName -in 'MachineGroupFriendlyname','MachineGroupFriendlynameAzure') {

            Write-Verbose "Copying publishing task(s) from machine group with friendly name '$MachineGroupFriendlyname' to machine group with friendly name '$NewMachineGroupFriendlyname'"

            $selectedPublishingTasks = @($publishingTasks | Where-Object { $_.MachineGroupFriendlyname -eq $MachineGroupFriendlyname })

        }

        if ($selectedPublishingTasks.Count -eq 0) {

            Write-Error "No publishing task(s) found"

            return

        }

        if (-Not ($newMachineGroup = $machineGroups | Where-Object { $_.FriendlyName -like "$NewMachineGroupFriendlyname" } )) {

            Write-Error "No machine group found with friendly name '$NewMachineGroupFriendlyname'"

            return

        }

        Write-Verbose "Copying $($selectedPublishingTasks.Count) publishing task(s)"

        foreach ($task in $selectedPublishingTasks) {

            Write-Verbose "Retrieving the publishing tasks"

            [xml]$publishingTasksXml = Get-Content -Path $publishingTasksFullname

            $currentMachineGroup = $machineGroups | Where-Object { $_.FriendlyName -like $task.MachineGroupFriendlyname }

            $publishingTask = $publishingTasksXml.SelectSingleNode("//Task[Id='$($task.Id)']")

            if ($publishingTask.ToString() -like "Task") {

                Write-Verbose "Copying publishing task with ID '$($task.Id)'"

                $newPublishingTask = $publishingTask.Clone()

                $newPublishingTask.Id = [System.Guid]::NewGuid().ToString()

                $newPublishingTask.MachineGroupFriendlyname = "$($newMachineGroup.FriendlyName)"

                $newPublishingTask.MachineGroup = "$($newMachineGroup.GroupName)"

                if ($publishingTask.Seamless.Count -gt 0 -and (-Not $DontPublishSeamless.ToBool()) -And $publishingTask.PublishSeamless -like $true) {

                    Write-Verbose "Publishing the copied publishing task seamless"

                    Write-Verbose "Removing existing seamless applications"

                    $null = $newPublishingTask.RemoveChild($newPublishingTask.Seamless)

                    Write-Verbose "Adding seamless applications"

                    $SeamlessApps = @()

                    ForEach ($app in $publishingTask.Seamless.SeamlessApplication) {

                        $seamlessApp = [PSCustomObject]@{

                            Order        = $app.SeamlessApplicationNumber

                            Executable   = $app.SeamlessApplicationExecutable

                            Argument     = $app.SeamlessApplicationArgument

                            IconPath     = $app.SeamlessApplicationIconPath

                            FriendlyName = $app.SeamlessApplicationFriendlyName

                            RunVirtual   = $app.SeamlessApplicationRunVirtual

                            Description  = $app.SeamlessApplicationFriendlyName

                        }

                        $SeamlessApps += $seamlessApp

                        Write-Verbose "Added application for processing $($seamlessApp | Format-List | Out-String)"

                    }

                    if ($null -ne $publishingTask.Seamless.SeamlessWVDapplicationgroup) {

                        $publishingParameters = @{

                            Id                   = $newPublishingTask.Id

                            SubscriptionId       = $SubscriptionId

                            ResourceGroupName    = $ResourceGroupName

                            ApplicationGroupName = $ApplicationGroupName

                            HostPoolName         = $HostPoolName

                            AssignmentName       = $AssignmentName

                            SeamlessApps         = @($SeamlessApps)

                            ConfigShare          = $ConfigShare

                        }

                    }

                } else {

                    Write-Verbose "Seamless publishing is disabled"

                    $newPublishingTask.PublishSeamless = "False"

                }

                $basePath = $publishingTask.Path

                ForEach ($share in $currentMachineGroup.GroupContentshares.ContentShare) {

                    $basePath = ($basePath -ireplace [regex]::Escape($share.Path), $null).TrimStart('\')

                }

                $newPath = $null

                ForEach ($share in $newMachineGroup.GroupContentshares.ContentShare) {

                    if (Test-Path -Path "$(Join-Path -Path $share.Path -ChildPath $basePath)" -ErrorAction SilentlyContinue ) {

                        $newPath = Join-Path -Path $share.Path -ChildPath $basePath

                        Write-Verbose "Found '$basePath'"

                    } else {

                        Write-Verbose "Not found '$basePath'"

                    }

                    Write-Verbose "In content share '$($share.Path)'"

                }

                if ([String]::IsNullOrEmpty($newPath)) {

                    $fileName = [System.IO.Path]::GetFileName($basePath)

                    Write-Warning "'$fileName' not found in any content share of machine group '$($newMachineGroup.FriendlyName)'"

                    Write-Warning "Skipping publishing task with ID '$($task.Id)'"

                    continue

                } else {

                    Write-Verbose "Configuring new path"

                    $newPublishingTask.Path = "$newPath"

                }

                if (-Not [String]::IsNullOrEmpty($NewGroup)) {

                    Write-Verbose "Setting the new group for the publishing task"

                    $domainName, $groupName = $publishingTask.Group.Split('\')

                    if ($NewGroup.Split('\').Count -eq 1) {

                        $groupName = $NewGroup

                    } else {

                        $domainName, $groupName = $newTask.Group.Split('\')

                    }

                    $adGroup = '{0}\{1}' -f $domainName, $NewGroup

                    $newPublishingTask.Group = $adGroup

                    $groupSID = Get-GroupSID -GroupName $adGroup

                    if ($newPublishingTask | Get-Member -Name ADGroupSID -ErrorAction SilentlyContinue) {

                        $newPublishingTask.ADGroupSID = "$groupSID"

                    } else {

                        $null = $($newPublishingTask.AppendChild($publishingTasksXml.CreateElement("ADGroupSID"))).AppendChild($publishingTasksXml.CreateTextNode($groupSID))

                    }

                    Write-Verbose "New group set to '$NewGroup'"

                    Write-Verbose "New group SID set to '$groupSID'"

                }

                Write-Verbose "Adding the copied publishing task"

                $null = $publishingTask.ParentNode.AppendChild($newPublishingTask)

                Write-Verbose "Saving the updated publishing tasks"

                $publishingTasksXml.Save($publishingTasksFullname)

                if ($newPublishingTask.PublishSeamless -like $true) {

                    Write-Verbose "Enabling seamless publishing for the copied publishing task"

                    Enable-AppVentiXSeamlessPublishing @publishingParameters

                }

            } else {

                Write-Error "No publishing task found with ID '$($task.Id)'"

            }

        }

        Clear-Variable -Name publishingTasksXml, selectedPublishingTasks -ErrorAction SilentlyContinue -Force

    }

    End {

        Clear-Variable -Name publishingTasks, machineGroups, publishingTasksFullname -ErrorAction SilentlyContinue -Force

    }

}

# SIG # Begin signature block

# MIIndQYJKoZIhvcNAQcCoIInZjCCJ2ICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCyEJiCliFZVmR/

# kkjmz/QtJltGDDk60+eTJigd2g1uLaCCICkwggXJMIIEsaADAgECAhAbtY8lKt8j

# AEkoya49fu0nMA0GCSqGSIb3DQEBDAUAMH4xCzAJBgNVBAYTAlBMMSIwIAYDVQQK

# ExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2Vy

# dGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBUcnVzdGVkIE5l

# dHdvcmsgQ0EwHhcNMjEwNTMxMDY0MzA2WhcNMjkwOTE3MDY0MzA2WjCBgDELMAkG

# A1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMuQS4xJzAl

# BgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIGA1UEAxMb

# Q2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMIICIjANBgkqhkiG9w0BAQEFAAOC

# Ag8AMIICCgKCAgEAvfl4+ObVgAxknYYblmRnPyI6HnUBfe/7XGeMycxca6mR5rlC

# 5SBLm9qbe7mZXdmbgEvXhEArJ9PoujC7Pgkap0mV7ytAJMKXx6fumyXvqAoAl4Va

# qp3cKcniNQfrcE1K1sGzVrihQTib0fsxf4/gX+GxPw+OFklg1waNGPmqJhCrKtPQ

# 0WeNG0a+RzDVLnLRxWPa52N5RH5LYySJhi40PylMUosqp8DikSiJucBb+R3Z5yet

# /5oCl8HGUJKbAiy9qbk0WQq/hEr/3/6zn+vZnuCYI+yma3cWKtvMrTscpIfcRnNe

# GWJoRVfkkIJCu0LW8GHgwaM9ZqNd9BjuiMmNF0UpmTJ1AjHuKSbIawLmtWJFfzcV

# WiNoidQ+3k4nsPBADLxNF8tNorMe0AZa3faTz1d1mfX6hhpneLO/lv403L3nUlbl

# s+V1e9dBkQXcXWnjlQ1DufyDljmVe2yAWk8TcsbXfSl6RLpSpCrVQUYJIP4ioLZb

# MI28iQzV13D4h1L92u+sUS4Hs07+0AnacO+Y+lbmbdu1V0vc5SwlFcieLnhO+Nqc

# noYsylfzGuXIkosagpZ6w7xQEmnYDlpGizrrJvojybawgb5CAKT41v4wLsfSRvbl

# jnX98sy50IdbzAYQYLuDNbdeZ95H7JlI8aShFf6tjGKOOVVPORa5sWOd/7cCAwEA

# AaOCAT4wggE6MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFLahVDkCw6A/joq8

# +tT4HKbROg79MB8GA1UdIwQYMBaAFAh2zcsH/yT2xc3tu5C84oQ3RnX3MA4GA1Ud

# DwEB/wQEAwIBBjAvBgNVHR8EKDAmMCSgIqAghh5odHRwOi8vY3JsLmNlcnR1bS5w

# bC9jdG5jYS5jcmwwawYIKwYBBQUHAQEEXzBdMCgGCCsGAQUFBzABhhxodHRwOi8v

# c3ViY2Eub2NzcC1jZXJ0dW0uY29tMDEGCCsGAQUFBzAChiVodHRwOi8vcmVwb3Np

# dG9yeS5jZXJ0dW0ucGwvY3RuY2EuY2VyMDkGA1UdIAQyMDAwLgYEVR0gADAmMCQG

# CCsGAQUFBwIBFhhodHRwOi8vd3d3LmNlcnR1bS5wbC9DUFMwDQYJKoZIhvcNAQEM

# BQADggEBAFHCoVgWIhCL/IYx1MIy01z4S6Ivaj5N+KsIHu3V6PrnCA3st8YeDrJ1

# BXqxC/rXdGoABh+kzqrya33YEcARCNQOTWHFOqj6seHjmOriY/1B9ZN9DbxdkjuR

# mmW60F9MvkyNaAMQFtXx0ASKhTP5N+dbLiZpQjy6zbzUeulNndrnQ/tjUoCFBMQl

# lVXwfqefAcVbKPjgzoZwpic7Ofs4LphTZSJ1Ldf23SIikZbr3WjtP6MZl9M7JYjs

# NhI9qX7OAo0FmpKnJ25FspxihjcNpDOO16hO0EoXQ0zF8ads0h5YbBRRfopUofbv

# n3l6XYGaFpAP4bvxSgD5+d2+7arszgowggZFMIIELaADAgECAhAIMk+dt9qRb2Pk

# 8qM8Xl1RMA0GCSqGSIb3DQEBCwUAMFYxCzAJBgNVBAYTAlBMMSEwHwYDVQQKExhB

# c3NlY28gRGF0YSBTeXN0ZW1zIFMuQS4xJDAiBgNVBAMTG0NlcnR1bSBDb2RlIFNp

# Z25pbmcgMjAyMSBDQTAeFw0yNDA0MDQxNDA0MjRaFw0yNzA0MDQxNDA0MjNaMGsx

# CzAJBgNVBAYTAk5MMRIwEAYDVQQHDAlTY2hpam5kZWwxIzAhBgNVBAoMGkpvaG4g

# QmlsbGVrZW5zIENvbnN1bHRhbmN5MSMwIQYDVQQDDBpKb2huIEJpbGxla2VucyBD

# b25zdWx0YW5jeTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAMslntDb

# SQwHZXwFhmibivbnd0Qfn6sqe/6fos3pKzKxEsR907RkDMet2x6RRg3eJkiIr3TF

# PwqBooyXXgK3zxxpyhGOcuIqyM9J28DVf4kUyZHsjGO/8HFjrr3K1hABNUszP0o7

# H3o6J31eqV1UmCXYhQlNoW9FOmRC1amlquBmh7w4EKYEytqdmdOBavAD5Xq4vLPx

# NP6kyA+B2YTtk/xM27TghtbwFGKnu9Vwnm7dFcpLxans4ONt2OxDQOMA5NwgcUv/

# YTpjhq9qoz6ivG55NRJGNvUXsM3w2o7dR6Xh4MuEGrTSrOWGg2A5EcLH1XqQtkF5

# cZnAPM8W/9HUp8ggornWnFVQ9/6Mga+ermy5wy5XrmQpN+x3u6tit7xlHk1Hc+4X

# Y4a4ie3BPXG2PhJhmZAn4ebNSBwNHh8z7WTT9X9OFERepGSytZVeEP7hgyptSLcu

# hpwWeR4QdBb7dV++4p3PsAUQVHFpwkSbrRTv4EiJ0Lcz9P1HPGFoHiFAQQIDAQAB

# o4IBeDCCAXQwDAYDVR0TAQH/BAIwADA9BgNVHR8ENjA0MDKgMKAuhixodHRwOi8v

# Y2NzY2EyMDIxLmNybC5jZXJ0dW0ucGwvY2NzY2EyMDIxLmNybDBzBggrBgEFBQcB

# AQRnMGUwLAYIKwYBBQUHMAGGIGh0dHA6Ly9jY3NjYTIwMjEub2NzcC1jZXJ0dW0u

# Y29tMDUGCCsGAQUFBzAChilodHRwOi8vcmVwb3NpdG9yeS5jZXJ0dW0ucGwvY2Nz

# Y2EyMDIxLmNlcjAfBgNVHSMEGDAWgBTddF1MANt7n6B0yrFu9zzAMsBwzTAdBgNV

# HQ4EFgQUO6KtBpOBgmrlANVAnyiQC6W6lJwwSwYDVR0gBEQwQjAIBgZngQwBBAEw

# NgYLKoRoAYb2dwIFAQQwJzAlBggrBgEFBQcCARYZaHR0cHM6Ly93d3cuY2VydHVt

# LnBsL0NQUzATBgNVHSUEDDAKBggrBgEFBQcDAzAOBgNVHQ8BAf8EBAMCB4AwDQYJ

# KoZIhvcNAQELBQADggIBAEQsN8wgPMdWVkwHPPTN+jKpdns5AKVFjcn00psf2NGV

# VgWWNQBIQc9lEuTBWb54IK6Ga3hxQRZfnPNo5HGl73YLmFgdFQrFzZ1lnaMdIcyh

# 8LTWv6+XNWfoyCM9wCp4zMIDPOs8LKSMQqA/wRgqiACWnOS4a6fyd5GUIAm4Cuap

# tpFYr90l4Dn/wAdXOdY32UhgzmSuxpUbhD8gVJUaBNVmQaRqeU8y49MxiVrUKJXd

# e1BCrtR9awXbqembc7Nqvmi60tYKlD27hlpKtj6eGPjkht0hHEsgzU0Fxw7ZJghY

# G2wXfpF2ziN893ak9Mi/1dmCNmorGOnybKYfT6ff6YTCDDNkod4egcMZdOSv+/Qv

# +HAeIgEvrxE9QsGlzTwbRtbm6gwYYcVBs/SsVUdBn/TSB35MMxRhHE5iC3aUTkDb

# ceo/XP3uFhVL4g2JZHpFfCSu2TQrrzRn2sn07jfMvzeHArCOJgBW1gPqR3WrJ4hU

# xL06Rbg1gs9tU5HGGz9KNQMfQFQ70Wz7UIhezGcFcRfkIfSkMmQYYpsc7rfzj+z0

# ThfDVzzJr2dMOFsMlfj1T6l22GBq9XQx0A4lcc5Fl9pRxbOuHHWFqIBD/BCEhwni

# OCySzqENd2N+oz8znKooSISStnkNaYXt6xblJF2dx9Dn89FK7d1IquNxOwt0tI5d

# MIIGlTCCBH2gAwIBAgIQCcXM+LtmfXE3qsFZgAbLMTANBgkqhkiG9w0BAQwFADBW

# MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEu

# MSQwIgYDVQQDExtDZXJ0dW0gVGltZXN0YW1waW5nIDIwMjEgQ0EwHhcNMjMxMTAy

# MDgzMjIzWhcNMzQxMDMwMDgzMjIzWjBQMQswCQYDVQQGEwJQTDEhMB8GA1UECgwY

# QXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMR4wHAYDVQQDDBVDZXJ0dW0gVGltZXN0

# YW1wIDIwMjMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC5Frrqxud9

# kjaqgkAo85Iyt6ecN343OWPztNOFkORvsc6ukhucOOQQ+szxH0jsi3ARjBwG1b9o

# QwnDx1COOkOpwm2HzY2zxtJe2X2qC+H8DMt4+nUNAYFuMEMjReq5ptDTI3JidDEb

# gcxKdr2azfCwmJ3FpqGpKr1LbtCD2Y7iLrwZOxODkdVYKEyJL0UPJ2A18JgNR54+

# CZ0/pVfCfbOEZag65oyU3A33ZY88h5mhzn9WIPF/qLR5qt9HKe9u8Y+uMgz8MKQa

# gH/ajWG/uYcqeQK28AS3Eh5AcSwl4xFfwHGaFwExxBWSXLZRGUbn9aFdirSZKKde

# 20p1COlmZkxImJY+bxQYSgw5nEM0jPg6rePD+0IQQc4APK6dSHAOQS3QvBJrfzTW

# lCQokGtOvxcNIs5cOvaANmTcGcLgkH0eHgMBpLFlcyzE0QkY8Heh+xltZFEiAvK5

# gbn8CHs8oo9o0/JjLqdWYLrW4HnES43/NC1/sOaCVmtslTaFoW/WRRbtJaRrK/03

# jFjrN921dCntRRinB/Ew3MQ1kxPN604WCMeLvAOpT3F5KbBXoPDrMoW9OGTYnYqv

# 88A6hTbVFRs+Ei8UJjk4IlfOknHWduimRKQ4LYDY1GDSA33YUZ/c3Pootanc2iWP

# Navjy/ieDYIdH8XVbRfWqchnDpTE+0NFcwIDAQABo4IBYzCCAV8wDAYDVR0TAQH/

# BAIwADAdBgNVHQ4EFgQUx2k8Lua941lH/xkSwdk06EHP448wHwYDVR0jBBgwFoAU

# vlQCL79AbHNDzqwJJU6eQ0Qa7uAwDgYDVR0PAQH/BAQDAgeAMBYGA1UdJQEB/wQM

# MAoGCCsGAQUFBwMIMDMGA1UdHwQsMCowKKAmoCSGImh0dHA6Ly9jcmwuY2VydHVt

# LnBsL2N0c2NhMjAyMS5jcmwwbwYIKwYBBQUHAQEEYzBhMCgGCCsGAQUFBzABhhxo

# dHRwOi8vc3ViY2Eub2NzcC1jZXJ0dW0uY29tMDUGCCsGAQUFBzAChilodHRwOi8v

# cmVwb3NpdG9yeS5jZXJ0dW0ucGwvY3RzY2EyMDIxLmNlcjBBBgNVHSAEOjA4MDYG

# CyqEaAGG9ncCBQELMCcwJQYIKwYBBQUHAgEWGWh0dHBzOi8vd3d3LmNlcnR1bS5w

# bC9DUFMwDQYJKoZIhvcNAQEMBQADggIBAHjd7rE6Q+b32Ws4vTJeC0HcGDi7mfQU

# nbaJ9nFFOQpizPX+YIpHuK89TPkOdDF7lOEmTZzVQpw0kwpIZDuB8lSM0Gw9KloO

# vXIsGjF/KgTNxYM5aViQNMtoIiF6W9ysmubDHF7lExSToPd1r+N0zYGXlE1uEX4o

# 988K/Z7kwgE/GC649S1OEZ5IGSGmirtcruLX/xhjIDA5S/cVfz0We/ElHamHs+Uf

# W3/IxTigvvq4JCbdZHg9DsjkW+UgGGAVtkxB7qinmWJamvdwpgujAwOT1ym/giPT

# W5C8/MnkL18ZgVQ38sqKqFdqUS+ZIVeXKfV58HaWtV2Lip1Y0luL7Mswb856jz7z

# XINk79H4XfbWOryf7AtWBjrus28jmHWK3gXNhj2StVcOI48Dc6CFfXDMo/c/E/ab

# 217kTYhiht2rCWeGS5THQ3bZVx+lUPLaDe3kVXjYvxMYQKWu04QX6+vURFSeL3WV

# rUSO6nEnZu7X2EYci5MUmmUdEEiAVZO/03yLlNWUNGX72/949vU+5ZN9r9EGdp7X

# 3W7mLL1Tx4gLmHnrB97O+e9RYK6370MC52siufu11p3n8OG5s2zJw2J6LpD+HLby

# CgfRId9Q5UKgsj0A1QuoBut8FI6YdaH3sR1ponEv6GsNYrTyBtSR77csUWLUCyVb

# osF3+ae0+SofMIIGuTCCBKGgAwIBAgIRAJmjgAomVTtlq9xuhKaz6jkwDQYJKoZI

# hvcNAQEMBQAwgYAxCzAJBgNVBAYTAlBMMSIwIAYDVQQKExlVbml6ZXRvIFRlY2hu

# b2xvZ2llcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRo

# b3JpdHkxJDAiBgNVBAMTG0NlcnR1bSBUcnVzdGVkIE5ldHdvcmsgQ0EgMjAeFw0y

# MTA1MTkwNTMyMThaFw0zNjA1MTgwNTMyMThaMFYxCzAJBgNVBAYTAlBMMSEwHwYD

# VQQKExhBc3NlY28gRGF0YSBTeXN0ZW1zIFMuQS4xJDAiBgNVBAMTG0NlcnR1bSBD

# b2RlIFNpZ25pbmcgMjAyMSBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC

# ggIBAJ0jzwQwIzvBRiznM3M+Y116dbq+XE26vest+L7k5n5TeJkgH4Cyk74IL9uP

# 61olRsxsU/WBAElTMNQI/HsE0uCJ3VPLO1UufnY0qDHG7yCnJOvoSNbIbMpT+Cci

# 75scCx7UsKK1fcJo4TXetu4du2vEXa09Tx/bndCBfp47zJNsamzUyD7J1rcNxOw5

# g6FJg0ImIv7nCeNn3B6gZG28WAwe0mDqLrvU49chyKIc7gvCjan3GH+2eP4mYJAS

# flBTQ3HOs6JGdriSMVoD1lzBJobtYDF4L/GhlLEXWgrVQ9m0pW37KuwYqpY42grp

# /kSYE4BUQrbLgBMNKRvfhQPskDfZ/5GbTCyvlqPN+0OEDmYGKlVkOMenDO/xtMrM

# INRJS5SY+jWCi8PRHAVxO0xdx8m2bWL4/ZQ1dp0/JhUpHEpABMc3eKax8GI1F03m

# SJVV6o/nmmKqDE6TK34eTAgDiBuZJzeEPyR7rq30yOVw2DvetlmWssewAhX+cnSa

# aBKMEj9O2GgYkPJ16Q5Da1APYO6n/6wpCm1qUOW6Ln1J6tVImDyAB5Xs3+Jriasa

# iJ7P5KpXeiVV/HIsW3ej85A6cGaOEpQA2gotiUqZSkoQUjQ9+hPxDVb/Lqz0tMjp

# 6RuLSKARsVQgETwoNQZ8jCeKwSQHDkpwFndfCceZ/OfCUqjxAgMBAAGjggFVMIIB

# UTAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTddF1MANt7n6B0yrFu9zzAMsBw

# zTAfBgNVHSMEGDAWgBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC

# AQYwEwYDVR0lBAwwCgYIKwYBBQUHAwMwMAYDVR0fBCkwJzAloCOgIYYfaHR0cDov

# L2NybC5jZXJ0dW0ucGwvY3RuY2EyLmNybDBsBggrBgEFBQcBAQRgMF4wKAYIKwYB

# BQUHMAGGHGh0dHA6Ly9zdWJjYS5vY3NwLWNlcnR1bS5jb20wMgYIKwYBBQUHMAKG

# Jmh0dHA6Ly9yZXBvc2l0b3J5LmNlcnR1bS5wbC9jdG5jYTIuY2VyMDkGA1UdIAQy

# MDAwLgYEVR0gADAmMCQGCCsGAQUFBwIBFhhodHRwOi8vd3d3LmNlcnR1bS5wbC9D

# UFMwDQYJKoZIhvcNAQEMBQADggIBAHWIWA/lj1AomlOfEOxD/PQ7bcmahmJ9l0Q4

# SZC+j/v09CD2csX8Yl7pmJQETIMEcy0VErSZePdC/eAvSxhd7488x/Cat4ke+AUZ

# ZDtfCd8yHZgikGuS8mePCHyAiU2VSXgoQ1MrkMuqxg8S1FALDtHqnizYS1bIMOv8

# znyJjZQESp9RT+6NH024/IqTRsRwSLrYkbFq4VjNn/KV3Xd8dpmyQiirZdrONoPS

# lCRxCIi54vQcqKiFLpeBm5S0IoDtLoIe21kSw5tAnWPazS6sgN2oXvFpcVVpMcq0

# C4x/CLSNe0XckmmGsl9z4UUguAJtf+5gE8GVsEg/ge3jHGTYaZ/MyfujE8hOmKBA

# UkVa7NMxRSB1EdPFpNIpEn/pSHuSL+kWN/2xQBJaDFPr1AX0qLgkXmcEi6PFnaw5

# T17UdIInA58rTu3mefNuzUtse4AgYmxEmJDodf8NbVcU6VdjWtz0e58WFZT7tST6

# EWQmx/OoHPelE77lojq7lpsjhDCzhhp4kfsfszxf9g2hoCtltXhCX6NqsqwTT7xe

# 8LgMkH4hVy8L1h2pqGLT2aNCx7h/F95/QvsTeGGjY7dssMzq/rSshFQKLZ8lPb8h

# FTmiGDJNyHga5hZ59IGynk08mHhBFM/0MLeBzlAQq1utNjQprztZ5vv/NJy8ua9A

# GbwkMWkOMIIGuTCCBKGgAwIBAgIRAOf/acc7Nc5LkSbYdHxopYcwDQYJKoZIhvcN

# AQEMBQAwgYAxCzAJBgNVBAYTAlBMMSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xv

# Z2llcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3Jp

# dHkxJDAiBgNVBAMTG0NlcnR1bSBUcnVzdGVkIE5ldHdvcmsgQ0EgMjAeFw0yMTA1

# MTkwNTMyMDdaFw0zNjA1MTgwNTMyMDdaMFYxCzAJBgNVBAYTAlBMMSEwHwYDVQQK

# ExhBc3NlY28gRGF0YSBTeXN0ZW1zIFMuQS4xJDAiBgNVBAMTG0NlcnR1bSBUaW1l

# c3RhbXBpbmcgMjAyMSBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB

# AOkSHwQ17bldesWmlUG+imV/TnfRbSV102aO2/hhKH9/t4NAoVoipzu0ePujH67y

# 8iwlmWuhqRR4xLeLdPxolEL55CzgUXQaq+Qzr5Zk7ySbNl/GZloFiYwuzwWS2AVg

# LPLCZd5DV8QTF+V57Y6lsdWTrrl5dEeMfsxhkjM2eOXabwfLy6UH2ZHzAv9bS/Sm

# Mo1PobSx+vHWST7c4aiwVRvvJY2dWRYpTipLEu/XqQnqhUngFJtnjExqTokt4Hyz

# Osr2/AYOm8YOcoJQxgvc26+LAfXHiBkbQkBdTfHak4DP3UlYolICZHL+XSzSXlsR

# gqiWD4MypWGU4A13xiHmaRBZowS8FET+QAbMiqBaHDM3Y6wohW07yZ/mw9ZKu/Km

# VIAEBhrXesxifPB+DTyeWNkeCGq4IlgJr/Ecr1px6/1QPtj66yvXl3uauzPPGEXU

# k6vUym6nZyE1IGXI45uGVI7XqvCt99WuD9LNop9Kd1LmzBGGvxucOo0lj1M3IRi8

# FimAX3krunSDguC5HgD75nWcUgdZVjm/R81VmaDPEP25Wj+C1reicY5CPckLGBjH

# QqsJe7jJz1CJXBMUtZs10cVKMEK3n/xD2ku5GFWhx0K6eFwe50xLUIZD9GfT7s/5

# /MyBZ1Ep8Q6H+GMuudDwF0mJitk3G8g6EzZprfMQMc3DAgMBAAGjggFVMIIBUTAP

# BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBS+VAIvv0Bsc0POrAklTp5DRBru4DAf

# BgNVHSMEGDAWgBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMCAQYw

# EwYDVR0lBAwwCgYIKwYBBQUHAwgwMAYDVR0fBCkwJzAloCOgIYYfaHR0cDovL2Ny

# bC5jZXJ0dW0ucGwvY3RuY2EyLmNybDBsBggrBgEFBQcBAQRgMF4wKAYIKwYBBQUH

# MAGGHGh0dHA6Ly9zdWJjYS5vY3NwLWNlcnR1bS5jb20wMgYIKwYBBQUHMAKGJmh0

# dHA6Ly9yZXBvc2l0b3J5LmNlcnR1bS5wbC9jdG5jYTIuY2VyMDkGA1UdIAQyMDAw

# LgYEVR0gADAmMCQGCCsGAQUFBwIBFhhodHRwOi8vd3d3LmNlcnR1bS5wbC9DUFMw

# DQYJKoZIhvcNAQEMBQADggIBALiTWXfJTBX9lAcIoKd6oCzwQZOfARQkt0OmiQ39

# 0yEqMrStHmpfycggfPGlBHdMDDYhHDVTGyvY+WIbdsIWpJ1BNRt9pOrpXe8HMR5s

# Ou71AWOqUqfEIXaHWOEs0UWmVs8mJb4lKclOHV8oSoR0p3GCX2tVO+XF8Qnt7E6f

# bkwZt3/AY/C5KYzFElU7TCeqBLuSagmM0X3Op56EVIMM/xlWRaDgRna0hLQze5mY

# HJGv7UuTCOO3wC1bzeZWdlPJOw5v4U1/AljsNLgWZaGRFuBwdF62t6hOKs86v+jP

# IMqFPwxNJN/ou22DqzpP+7TyYNbDocrThlEN9D2xvvtBXyYqA7jhYY/fW9edUqhZ

# UmkUGM++Mvz9lyT/nBdfaKqM5otK0U5H8hCSL4SGfjOVyBWbbZlUIE8X6XycDBRR

# KEK0q5JTsaZksoKabFAyRKJYgtObwS1UPoDGcmGirwSeGMQTJSh+WR5EXZaEWJVA

# 6ZZPBlGvjgjFYaQ0kLq1OitbmuXZmX7Z70ks9h/elK0A8wOg8oiNVd3o1bb59ms1

# QF4OjZ45rkWfsGuz8ctB9/leCuKzkx5Rt1WAOsXy7E7pws+9k+jrePrZKw2DnmlN

# aT19QgX2I+hFtvhC6uOhj/CgjVEA4q1i1OJzpoAmre7zdEg+kZcFIkrDHgokA5mc

# IMK1MYIGojCCBp4CAQEwajBWMQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNv

# IERhdGEgU3lzdGVtcyBTLkEuMSQwIgYDVQQDExtDZXJ0dW0gQ29kZSBTaWduaW5n

# IDIwMjEgQ0ECEAgyT5232pFvY+TyozxeXVEwDQYJYIZIAWUDBAIBBQCggYQwGAYK

# KwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg

# qPGN8QSbam1yAM3q/q/QZ6FTMB3O0Tj+77ylwnN8fUIwDQYJKoZIhvcNAQEBBQAE

# ggGAWrIt4nOkCQyEm1ZB2tx2UK3DjrCMMb5mfsMsM3FlO+FspYZNjuyq65LskO4G

# /ZtOnyMikq1lQa/sZIpKLhTeRpOsHqhw0DkXmI5QjROo0QqTnCISl8xNogP/vir2

# uBfqv+CmEcN+YFwcfoyzgL7cqfuyi7BItIr9IE9fZmk0Z/dmd1MHQY7qq1OGwtfY

# iUPnA7dfqmz+QhXf1juzGYvoI1Itu7A4HsPqEvZc67AB2q7y+WOA68NPEbDShdZt

# wK/2058YAY2TpJdzxzadkknlrp1xtkizPiW1OleRSnPI55v/B05V9ewspboQdJHw

# rRRsikrsYWntrM1v162dI6mVmLaF9nih565Vy2fWadm519B7IY5o0LjbdxGhiZvH

# o7rYmOOtu+wHLYhxCz/qx1M3Ai0VWgevmmMT/mm1VUG8e4J71L9q1MhjOAFH2mvJ

# GZrozombrSXZYza53AufKE9mfMhM8rlxlC8Lau0S6bG3fAjDmdSmqDvXiiDaCUrw

# Qxx1oYIEAjCCA/4GCSqGSIb3DQEJBjGCA+8wggPrAgEBMGowVjELMAkGA1UEBhMC

# UEwxITAfBgNVBAoTGEFzc2VjbyBEYXRhIFN5c3RlbXMgUy5BLjEkMCIGA1UEAxMb

# Q2VydHVtIFRpbWVzdGFtcGluZyAyMDIxIENBAhAJxcz4u2Z9cTeqwVmABssxMA0G

# CWCGSAFlAwQCAgUAoIIBVjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwHAYJ

# KoZIhvcNAQkFMQ8XDTI0MDkyNzE5MDcxMVowNwYLKoZIhvcNAQkQAi8xKDAmMCQw

# IgQg6pVLsdBAtDFASNhln49hXYh0LMzgZ5LgVgJNSwA60xwwPwYJKoZIhvcNAQkE

# MTIEMIDDv3YG6pFnwdoin0nKXW9gLfnnWqPFOaDDmjDgsWrQ2QzNk9NPAEVMfqE7

# eYmriDCBnwYLKoZIhvcNAQkQAgwxgY8wgYwwgYkwgYYEFA9PuFUe/9j23n9nJrQ8

# E9Bqped3MG4wWqRYMFYxCzAJBgNVBAYTAlBMMSEwHwYDVQQKExhBc3NlY28gRGF0

# YSBTeXN0ZW1zIFMuQS4xJDAiBgNVBAMTG0NlcnR1bSBUaW1lc3RhbXBpbmcgMjAy

# MSBDQQIQCcXM+LtmfXE3qsFZgAbLMTANBgkqhkiG9w0BAQEFAASCAgA9r8w2et9A

# g87W6pn3t33QERSos+gYoDn/hdE5n7xV/msfOAO3YPSEg3RD6FQ4hFDNvTyDCINp

# AnEUjAxjcRBl1Tv96+7yA4mcbBHjJKOCNCYPuT05fkhnGhWoBBU/Gm47So8KPLYi

# Xgz/trEBK4AB9xzm5JbnAa2GRrq3SeLFgxAUcVE8DuJJVGiClF4cHPq6KTYaCe3E

# 2UO1WAFrJV8mG64ze487E5f0/6E3GtIr5BjqKmBJuAogxXlRyoAngrFHG5FMQXTZ

# 4zDUv/+fKSwbxRNaFjZ6feJZ1VUCJAVaSZSOOaGDalBGpSd+Fahdb0NieKpel4Hj

# 0iA9NPzLEjj1fjm2TwlD/JmAKOM66U+n2kPLjCwfOPPRhOzG7s/OUKF3qq0PrfLy

# pVBEsc5AhnThOK0m942KUdtFPAY6WTHMuaO90aW1FG5zO9cC8OeP3AsWc0P2XsNx

# PK8Rz3YkrrF2GMAWyNRfQ1sVQdMX4vgLseu5FHjdTGEUhVcKkXSOADv64Z/DaCct

# 9dOqliJg5cPQgZRuZImzhfSce62TwzL2VOHb8syqzcjjNRqjbKn6sj7hxslefJjr

# loyhlXrj+Vdh6DhAY0pTED1Kf9B6mWz7JIvrOhYXtztCjcL8EHgU5yy13j3g5MTz

# yBu2vPrtQiZVNAIkqHV/9YfjhQBXsJNwLw==

# SIG # End signature block