Azs.Syndication.Admin

0.1.157

Export.psm1

                                #-----------------------------------------------------------------------

# Copyright (c) Microsoft Corporation. All rights reserved.

#-----------------------------------------------------------------------

# .EXTERNALHELP Export.psm1-Help.xml

function Export-AzsMarketplaceItem {

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]

        [string[]] $ProductId,

        [Parameter(Mandatory = $true)]

        [string] $RepositoryDir,

        [Parameter(Mandatory = $false)]

        [string] $JournalDir,

        [Parameter(Mandatory = $false)]

        [switch] $IgnoreDependencies,

        [Parameter(Mandatory = $false)]

        [switch] $AcceptLegalTerms,

        [Parameter(Mandatory = $false)]

        [ValidateSet('Resolve', 'Download', 'Cleanup')]

        [string] $From = 'Resolve',

        [Parameter(Mandatory = $false)]

        [ValidateSet('Resolve', 'Download', 'Cleanup')]

        [string] $UpTo = 'Cleanup',

        [Parameter(Mandatory = $false)]

        [ValidateRange(5, 60)]

        [int] $SleepInterval = 60

    )

    begin {

        $productQueue = [System.Collections.Queue]::new()

    }

    process {

        $ProductId | ForEach-Object { $productQueue.Enqueue($_) }

    }

    end {

        function Resolve-AllProducts {

            param ()

            function Resolve-ProductDetails {

                param (

                    [ValidateNotNullOrEmpty()]

                    [string] $ProductId

                )

                $productName = $ProductId.Split('/')[-1]

                Start-Activity "Resolve-ProductDetails, productName: $ProductName"

                try

                {

                    $productDetailsDir = "$RepositoryDir\$productName"

                    $productDetailsFileName = "$productDetailsDir\productDetails.json"

                    if (Test-Path -Path $productDetailsFileName) {

                        Write-Verbose "Retriving product details from cache: $ProductName" -Verbose

                        $productDetails = Get-Content -Path $productDetailsFileName -Raw | ConvertFrom-Json

                        if (-not (Test-IsStale -ProductDetails $productDetails)) {

                            return $productDetails

                        }

                        Write-Verbose "Product details is stale: $ProductName" -Verbose

                    }

                    Write-Verbose "Retriving details from the Cloud: $ProductName" -Verbose

                    $productDetails = Get-ProductDetails -ProductName $productName -ProductId $ProductId

                    if ($productDetails.Properties.legalTerms -and -not $AcceptLegalTerms.ToBool()) {

                        Display-LegalTerms -ProductDetails $productDetails

                    }

                    New-Item -Path $productDetailsDir -ItemType Directory -Force | Out-Null

                    $productDetails | ConvertTo-Json -Depth 99 | Set-Content -LiteralPath $productDetailsFileName -Encoding UTF8

                    return $productDetails

                }

                finally {

                    Stop-Activity

                }

            }

            function Test-IsStale {

                param (

                    [ValidateNotNull()]

                    [psobject] $ProductDetails

                )

                $timestamp = [datetime]::ParseExact($ProductDetails.Timestamp, 'o', [System.Globalization.CultureInfo]::InvariantCulture, [System.Globalization.DateTimeStyles]::AdjustToUniversal)

                if ([datetime]::UtcNow - $timestamp -gt [timespan]::FromDays(1)) {

                    return $true

                }

                return $false

            }

            function Get-ProductDetails {

                param (

                    [ValidateNotNullOrEmpty()]

                    [string] $ProductName,

                    [ValidateNotNullOrEmpty()]

                    [string] $ProductId

                )

                $productDetails = [psobject]::new()

                $productDetails | Add-Member -MemberType NoteProperty -Name 'ProductName' -Value $ProductName

                $productDetails | Add-Member -MemberType NoteProperty -Name 'Timestamp' -Value ([datetime]::UtcNow.ToString('o'))

                $resourceDefinition = Get-AzResource -ResourceId $ProductId -ApiVersion 2016-01-01

                $productDetails | Add-Member -MemberType NoteProperty -Name 'ResourceId' -Value $resourceDefinition.ResourceId

                $productDetails | Add-Member -MemberType NoteProperty -Name 'Properties' -Value $resourceDefinition.Properties

                $details = Invoke-AzResourceAction -ResourceId $ProductId -Action listDetails -ApiVersion 2016-01-01 -Force

                $productDetails | Add-Member -MemberType NoteProperty -Name 'Details' -Value $details

                $artifacts = Get-ProductArtifacts -ProductDetails $productDetails

                $productDetails | Add-Member -MemberType NoteProperty -Name 'Artifacts' -Value $artifacts

                return $productDetails

            }

            function Get-ProductArtifacts {

                param (

                    [ValidateNotNull()]

                    [psobject] $ProductDetails

                )

                $artifacts = @()

                if ($ProductDetails.Properties.iconUris.hero) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Properties.iconUris.hero -Type Icon -RelativeDir 'icons\hero'

                }

                if ($ProductDetails.Properties.iconUris.large) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Properties.iconUris.large -Type Icon -RelativeDir 'icons\large'

                }

                if ($ProductDetails.Properties.iconUris.medium) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Properties.iconUris.medium -Type Icon -RelativeDir 'icons\medium'

                }

                if ($ProductDetails.Properties.iconUris.small) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Properties.iconUris.small -Type Icon -RelativeDir 'icons\small'

                }

                if ($ProductDetails.Properties.iconUris.wide) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Properties.iconUris.wide -Type Icon -RelativeDir 'icons\wide'

                }

                if ($ProductDetails.Properties.galleryItemIdentity) {

                    $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Details.galleryPackageBlobSasUri -Type GalleryPackage -RelativeDir 'galleryPackage'

                }

                $productKind = $ProductDetails.Properties.productKind

                switch ($productKind) {

                    { $_ -eq 'VirtualMachine'} {

                        $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Details.properties.osDiskImage.sourceBlobSasUri -Type VMDiskImage -RelativeDir 'osDiskImage'

                        foreach ($dataDiskImage in $ProductDetails.Details.properties.dataDiskImages) {

                            $artifacts += New-ArtifactDescriptor -SourceUri $dataDiskImage.sourceBlobSasUri -Type VMDiskImage -RelativeDir "dataDiskImages\$($dataDiskImage.lun)"

                        }

                        break

                    }

                    { $_ -eq 'VirtualMachineExtension' } {

                        $artifacts += New-ArtifactDescriptor -SourceUri $ProductDetails.Details.properties.sourceBlob.uri -Type VMExtensionPackage -RelativeDir 'extension'

                        break

                    }

                    { $_ -eq 'ResourceProvider' -or $_ -eq 'Solution'} {

                        foreach ($fileContainer in $ProductDetails.Details.properties.fileContainers) {

                            $artifacts += New-ArtifactDescriptor -SourceUri $fileContainer.sourceUri -Type FileContainer -RelativeDir ([System.IO.Path]::Combine('fileContainers', $fileContainer.id))

                        }

                        break

                    }

                    default {

                        throw "Product kind '$productKind' is invalid or not supported."

                    }

                }

                return $artifacts

            }

            function New-ArtifactDescriptor {

                param (

                    [ValidateNotNullOrEmpty()]

                    [string] $SourceUri,

                    [ValidateSet('Icon', 'GalleryPackage', 'VMDiskImage', 'VMExtensionPackage', 'FileContainer')]

                    [string] $Type,

                    [ValidateNotNullOrEmpty()]

                    [string] $RelativeDir

                )

                $fileName = [System.IO.Path]::GetFileName([uri]::new($SourceUri, [System.UriKind]::Absolute).AbsolutePath)

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

                    throw "Unable to resolve file name, sourceUri: '$SourceUri'."

                }

                $artifact = [psobject]::new()

                $artifact | Add-Member -MemberType NoteProperty -Name SourceUri -Value $SourceUri

                $artifact | Add-Member -MemberType NoteProperty -Name Type -Value $Type

                $artifact | Add-Member -MemberType NoteProperty -Name RelativeFileName -Value ([System.IO.Path]::Combine($RelativeDir, $fileName))

                return $artifact

            }

            function New-DependentProductId {

                param (

                    [ValidateNotNullOrEmpty()]

                    [string] $OriginalProductId,

                    [ValidateNotNullOrEmpty()]

                    [string] $DependentProductName

                )

                $segments = $OriginalProductId.Split('/')

                $segments[-1] = $DependentProductName

                return $segments -join '/'

            }

            function Display-LegalTerms {

                param (

                    [ValidateNotNull()]

                    [psobject] $ProductDetails

                )

                Write-Host "------- Legal Terms: $($productDetails.Properties.displayName)" -ForegroundColor DarkYellow

                Write-Host $productDetails.Properties.legalTerms -ForegroundColor DarkYellow

                Write-Host '-------' -ForegroundColor DarkYellow

                while ($true) {

                    $result = Read-Host -Prompt 'Accept Legal Terms (Y/N)?'

                    if ($result -eq 'Y') {

                        break

                    }

                    if ($result -eq 'N') {

                        throw 'You must accept Legal Terms to download this software.'

                    }

                }

            }

            #-----------------------------------------------------------------------

            Start-Activity 'Resolve-AllProducts'

            $processedIds = @{}

            $productNames = @()

            while ($productQueue.Count -gt 0) {

                $productId = $productQueue.Dequeue()

                if ($processedIds.ContainsKey($productId)) {

                    continue

                }

                $productDetails = Resolve-ProductDetails -ProductId $productId

                $processedIds.Add($productId, $true)

                $productNames += $productDetails.ProductName

                if (-not $IgnoreDependencies.ToBool()) {

                    if ($productDetails.Details.properties.dependentProducts) {

                        foreach ($dependentProductName in $productDetails.Details.properties.dependentProducts) {

                            $productQueue.Enqueue((New-DependentProductId -OriginalProductId $productId -DependentProductName $dependentProductName))

                        }

                    }

                }

            }

            @{

                productNames = $productNames

            } | ConvertTo-Json -Depth 99 | Set-Content -LiteralPath "$JournalDir\.download-info.json" -Encoding UTF8

            Stop-Activity

        }

        #-----------------------------------------------------------------------

        function Download-AllProducts {

            param ()

            Start-Activity 'Download-AllProducts'

            while ($true) {

                & "$PSScriptRoot\SyndicationClient.exe" download $RepositoryDir $JournalDir

                if ($LASTEXITCODE -eq 0) {

                    break

                }

                Write-Verbose "Sleep for $SleepInterval seconds" -Verbose

                Start-Sleep -Seconds $SleepInterval

            }

            Stop-Activity

        }

        #-----------------------------------------------------------------------

        function Invoke-Cleanup {

            param ()

            Start-Activity 'Invoke-Cleanup'

            if (Test-Path $JournalDir) {

                Remove-Item $JournalDir -Recurse -Force

            }

            Stop-Activity

        }

        #-----------------------------------------------------------------------

        $Steps = @{

            Resolve = 0

            Download = 1

            Cleanup = 2

        }

        $FromValue = $Steps[$From]

        $UpToValue = $Steps[$UpTo]

        $RepositoryDir = $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($RepositoryDir)

        New-Item -Path $RepositoryDir -ItemType Directory -Force | Out-Null

        if (-not $JournalDir) {

            $JournalDir = [System.IO.Path]::Combine([System.IO.Path]::GetTempPath(), [guid]::NewGuid().ToString())

        }

        else {

            $JournalDir = $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($JournalDir)

        }

        New-Item -Path $JournalDir -ItemType Directory -Force | Out-Null

        Start-Activity 'Export'

        Write-Verbose "RepositoryDir: $RepositoryDir" -Verbose

        Write-Verbose "JournalDir: $JournalDir" -Verbose

        if ($FromValue -le $Steps.Resolve -and $UpToValue -ge $Steps.Resolve) {

            Resolve-AllProducts

        }

        if ($FromValue -le $Steps.Download -and $UpToValue -ge $Steps.Download) {

            Download-AllProducts

        }

        if ($FromValue -le $Steps.Cleanup -and $UpToValue -ge $Steps.Cleanup) {

            Invoke-Cleanup

        }

        Stop-Activity

    }

}

#-----------------------------------------------------------------------

$ErrorActionPreference = 'Stop'

$InformationPreference = 'Continue'

Import-Module "$PSScriptRoot\Activities.psm1" -Force -ErrorAction Stop

Export-ModuleMember -Function @('Export-AzsMarketplaceItem')

# SIG # Begin signature block

# MIIjhgYJKoZIhvcNAQcCoIIjdzCCI3MCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDKno9r1SLGQu+w

# HD6eYtOJ2QUKDzWf0ZwDJDeYgj78OKCCDYEwggX/MIID56ADAgECAhMzAAAB32vw

# LpKnSrTQAAAAAAHfMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAxMjE1MjEzMTQ1WhcNMjExMjAyMjEzMTQ1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQC2uxlZEACjqfHkuFyoCwfL25ofI9DZWKt4wEj3JBQ48GPt1UsDv834CcoUUPMn

# s/6CtPoaQ4Thy/kbOOg/zJAnrJeiMQqRe2Lsdb/NSI2gXXX9lad1/yPUDOXo4GNw

# PjXq1JZi+HZV91bUr6ZjzePj1g+bepsqd/HC1XScj0fT3aAxLRykJSzExEBmU9eS

# yuOwUuq+CriudQtWGMdJU650v/KmzfM46Y6lo/MCnnpvz3zEL7PMdUdwqj/nYhGG

# 3UVILxX7tAdMbz7LN+6WOIpT1A41rwaoOVnv+8Ua94HwhjZmu1S73yeV7RZZNxoh

# EegJi9YYssXa7UZUUkCCA+KnAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUOPbML8IdkNGtCfMmVPtvI6VZ8+Mw

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDYzMDA5MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAnnqH

# tDyYUFaVAkvAK0eqq6nhoL95SZQu3RnpZ7tdQ89QR3++7A+4hrr7V4xxmkB5BObS

# 0YK+MALE02atjwWgPdpYQ68WdLGroJZHkbZdgERG+7tETFl3aKF4KpoSaGOskZXp

# TPnCaMo2PXoAMVMGpsQEQswimZq3IQ3nRQfBlJ0PoMMcN/+Pks8ZTL1BoPYsJpok

# t6cql59q6CypZYIwgyJ892HpttybHKg1ZtQLUlSXccRMlugPgEcNZJagPEgPYni4

# b11snjRAgf0dyQ0zI9aLXqTxWUU5pCIFiPT0b2wsxzRqCtyGqpkGM8P9GazO8eao

# mVItCYBcJSByBx/pS0cSYwBBHAZxJODUqxSXoSGDvmTfqUJXntnWkL4okok1FiCD

# Z4jpyXOQunb6egIXvkgQ7jb2uO26Ow0m8RwleDvhOMrnHsupiOPbozKroSa6paFt

# VSh89abUSooR8QdZciemmoFhcWkEwFg4spzvYNP4nIs193261WyTaRMZoceGun7G

# CT2Rl653uUj+F+g94c63AhzSq4khdL4HlFIP2ePv29smfUnHtGq6yYFDLnT0q/Y+

# Di3jwloF8EWkkHRtSuXlFUbTmwr/lDDgbpZiKhLS7CBTDj32I0L5i532+uHczw82

# oZDmYmYmIUSMbZOgS65h797rj5JJ6OkeEUJoAVwwggd6MIIFYqADAgECAgphDpDS

# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla

# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT

# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG

# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S

# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz

# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7

# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u

# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33

# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl

# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP

# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB

# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF

# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM

# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ

# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud

# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO

# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0

# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw

# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA

# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY

# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj

# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd

# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ

# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf

# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ

# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j

# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B

# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96

# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7

# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I

# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVWzCCFVcCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAd9r8C6Sp0q00AAAAAAB3zAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgie98HYQu

# SKubLbJlB8yJFmDOYbhZIrfAQ4mkS+UE5uIwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQCx+jCNhpRZigbek12LGf8cC4VD4aPoUc6r26LDqw5b

# 2gKQEvPl5YSNRuHdF8ciQXEvDIp+dlJcVi/FaztBz6OCwhnxyCyiqZ0CPP3G4fA6

# jLV8ef2ulnvj/10QbP9XOHfGEAXBLdrk0RHYgf2CyuQrzyT532/ml6nOhlNS0wLw

# appiElEclVE2JxQEqqtXSxwSzUFCLgJRKXevg+3Iu8w6Orrnpg2l1esS1nTkalfd

# ykWo6eBqIViS73nNdzXifYr6vQp16VNucdFxuB3v1Gzq9b7OjZBcj4nVHi2KhnPV

# jGyTDadzYrA4MRWqGVijUkC9StUSsjr8GQadB3xziviKoYIS5TCCEuEGCisGAQQB

# gjcDAwExghLRMIISzQYJKoZIhvcNAQcCoIISvjCCEroCAQMxDzANBglghkgBZQME

# AgEFADCCAVEGCyqGSIb3DQEJEAEEoIIBQASCATwwggE4AgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIEeS5QBGLGnk0crsuvdx5Y2FpkKpdSeEfNMBI9CB

# o/dlAgZgicexMUUYEzIwMjEwNTA0MTgwMDMxLjkxNFowBIACAfSggdCkgc0wgcox

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p

# Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1Mg

# RVNOOjhBODItRTM0Ri05RERBMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFt

# cCBTZXJ2aWNloIIOPDCCBPEwggPZoAMCAQICEzMAAAFLT7KmSNXkwlEAAAAAAUsw

# DQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcN

# MjAxMTEyMTgyNTU5WhcNMjIwMjExMTgyNTU5WjCByjELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2Eg

# T3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046OEE4Mi1FMzRGLTlE

# REExJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggEiMA0G

# CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQChNnpQx3YuJr/ivobPoLtpQ9egUFl8

# THdWZ6SAKIJdtP3L24D3/d63ommmjZjCyrQm+j/1tHDAwjQGuOwYvn79ecPCQfAB

# 91JnEp/wP4BMF2SXyMf8k9R84RthIdfGHPXTWqzpCCfNWolVEcUVm8Ad/r1LrikR

# O+4KKo6slDQJKsgKApfBU/9J7Rudvhw1rEQw0Nk1BRGWjrIp7/uWoUIfR4rcl6U1

# utOiYIonC87PPpAJQXGRsDdKnVFF4NpWvMiyeuksn5t/Otwz82sGlne/HNQpmMzi

# gR8cZ8eXEDJJNIZxov9WAHHj28gUE29D8ivAT706ihxvTv50ZY8W51uxAgMBAAGj

# ggEbMIIBFzAdBgNVHQ4EFgQUUqpqftASlue6K3LePlTTn01K68YwHwYDVR0jBBgw

# FoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDov

# L2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljVGltU3RhUENB

# XzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNUaW1TdGFQQ0FfMjAx

# MC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDCDAN

# BgkqhkiG9w0BAQsFAAOCAQEAFtq51Zc/O1AfJK4tEB2Nr8bGEVD5qQ8l8gXIQMrM

# ZYtddHH+cGiqgF/4GmvmPfl5FAYh+gf/8Yd3q4/iD2+K4LtJbs/3v6mpyBl1mQ4v

# usK65dAypWmiT1W3FiXjsmCIkjSDDsKLFBYH5yGFnNFOEMgL+O7u4osH42f80nc2

# WdnZV6+OvW035XPV6ZttUBfFWHdIbUkdOG1O2n4yJm10OfacItZ08fzgMMqE+f/S

# TgVWNCHbR2EYqTWayrGP69jMwtVD9BGGTWti1XjpvE6yKdO8H9nuRi3L+C6jYntf

# aEmBTbnTFEV+kRx1CNcpSb9os86CAUehZU1aRzQ6CQ/pjzCCBnEwggRZoAMCAQIC

# CmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRp

# ZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcwMTIxMzY1NVoXDTI1MDcwMTIx

# NDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggEiMA0GCSqGSIb3

# DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs/BOX9fp/aZRrdFQQ1aUKAIKF

# ++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUdzgkTjnxhMFmxMEQP8WCIhFRD

# DNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAyWGBG8lhHhjKEHnRhZ5FfgVSx

# z5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJyGiGKr0tkiVBisV39dx898Fd1

# rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqxqPJ6Kgox8NpOBpG2iAg16Hgc

# sOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4WnAEFTyJNAgMBAAGjggHmMIIB

# 4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU1WM6XIoxkPNDe3xGG8UzaFqF

# bVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1Ud

# EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYD

# VR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwv

# cHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEB

# BE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9j

# ZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwgaAGA1UdIAEB/wSBlTCB

# kjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIBFjFodHRwOi8vd3d3Lm1pY3Jv

# c29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQuaHRtMEAGCCsGAQUFBwICMDQe

# MiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8AUwB0AGEAdABlAG0AZQBuAHQA

# LiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG4Jg/gXEDPZ2joSFvs+umzPUx

# vs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m87WtUVwgrUYJEEvu5U4zM9GAS

# inbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/8jd9Wj8c8pl5SpFSAK84Dxf1

# L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kpvLb9BOFwnzJKJ/1Vry/+tuWO

# M7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlKcWOdeyFtw5yjojz6f32WapB4

# pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsiOCC1JeVk7Pf0v35jWSUPei45

# V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw4TtxCd9ddJgiCGHasFAeb73x

# 4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcunCaw5u+zGy9iCtHLNHfS4hQEe

# gPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1wC9UJyH3yKxO2ii4sanblrKn

# QqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvHIa9Zta7cRDyXUHHXodLFVeNp

# 3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2gUDXa7wknHNWzfjUeCLraNtvT

# X4/edIhJEqGCAs4wggI3AgEBMIH4oYHQpIHNMIHKMQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBP

# cGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4QTgyLUUzNEYtOURE

# QTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcG

# BSsOAwIaAxUAkToz97fseHxNOUSQ5O/bBVSF+e6ggYMwgYCkfjB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIFAOQ7hj0wIhgPMjAy

# MTA1MDQxNjM3MTdaGA8yMDIxMDUwNTE2MzcxN1owdzA9BgorBgEEAYRZCgQBMS8w

# LTAKAgUA5DuGPQIBADAKAgEAAgIl/gIB/zAHAgEAAgISbDAKAgUA5DzXvQIBADA2

# BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIB

# AAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAAJcQxl/bqfNdGrQLkBmZ2CQExzvjpZc

# OhFve7nQp9T4p0bxPPqXX2yByXiLumERefTBExrMZQzWt3SdPQ00cmuKljjC20HC

# Ce7xH2fz07HJIAGxvekHTrcwON4AyCXWb+3Qxt2ihKsOAtqoosp1gMNcg+rZPvEG

# r83BlSYJgBXPMYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB

# IDIwMTACEzMAAAFLT7KmSNXkwlEAAAAAAUswDQYJYIZIAWUDBAIBBQCgggFKMBoG

# CSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgKQziGtub

# qH/KRceq9lkqHG23+BeY/Xu8JxLVj2VBYi8wgfoGCyqGSIb3DQEJEAIvMYHqMIHn

# MIHkMIG9BCBr9u6EInnsZYEts/Fj/rIFv0YZW1ynhXKOP2hVPUU5IzCBmDCBgKR+

# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT

# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABS0+ypkjV5MJRAAAA

# AAFLMCIEIEv2wCyp0mHzOSvtB8r9YFHfE5pTfHVJvVWzgxGRqvwoMA0GCSqGSIb3

# DQEBCwUABIIBAAUK8DI1w98Uz0eNTL9sBuOFeqRb7pP5qFSMo71mdDVYho9nTBUD

# Y5MxX6jU+cOWyUAuFVijhXNAlc0FvP55Xw1lKLar3UGcI3yidPvugMkuiUjtmlL5

# nJvJjSIi5hFGm3rt51aB3v9YJ9cSzGgOuTuuuwMpxxEPrWT3kgyB8ckMqEeDU5h6

# AVDDNpzlaoZPcXhg5MSOeSfcHiPr2grpN2jsGDX9NHv2PCExqbWU4KCslQm8jokG

# klykKSPUDPkcZgOpOGn7sC9uj1qh3qzXJKGvcULz3FTMaVvRimgtsr7d/6WRPUnQ

# zUchl2DMXbQaYzx3HC+CI7w1tjerwrkDmq4=

# SIG # End signature block