Azs.Syndication.Admin

0.1.140

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-AzureRmResource -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-AzureRmResourceAction -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

# MIIjigYJKoZIhvcNAQcCoIIjezCCI3cCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAN1ljDYO3ptmKJ

# nhtaM8v9NH48R8pFMg0qurS2tKnDgqCCDYUwggYDMIID66ADAgECAhMzAAABUptA

# n1BWmXWIAAAAAAFSMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMTkwNTAyMjEzNzQ2WhcNMjAwNTAyMjEzNzQ2WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCxp4nT9qfu9O10iJyewYXHlN+WEh79Noor9nhM6enUNbCbhX9vS+8c/3eIVazS

# YnVBTqLzW7xWN1bCcItDbsEzKEE2BswSun7J9xCaLwcGHKFr+qWUlz7hh9RcmjYS

# kOGNybOfrgj3sm0DStoK8ljwEyUVeRfMHx9E/7Ca/OEq2cXBT3L0fVnlEkfal310

# EFCLDo2BrE35NGRjG+/nnZiqKqEh5lWNk33JV8/I0fIcUKrLEmUGrv0CgC7w2cjm

# bBhBIJ+0KzSnSWingXol/3iUdBBy4QQNH767kYGunJeY08RjHMIgjJCdAoEM+2mX

# v1phaV7j+M3dNzZ/cdsz3oDfAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU3f8Aw1sW72WcJ2bo/QSYGzVrRYcw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ1NDEzNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AJTwROaHvogXgixWjyjvLfiRgqI2QK8GoG23eqAgNjX7V/WdUWBbs0aIC3k49cd0

# zdq+JJImixcX6UOTpz2LZPFSh23l0/Mo35wG7JXUxgO0U+5drbQht5xoMl1n7/TQ

# 4iKcmAYSAPxTq5lFnoV2+fAeljVA7O43szjs7LR09D0wFHwzZco/iE8Hlakl23ZT

# 7FnB5AfU2hwfv87y3q3a5qFiugSykILpK0/vqnlEVB0KAdQVzYULQ/U4eFEjnis3

# Js9UrAvtIhIs26445Rj3UP6U4GgOjgQonlRA+mDlsh78wFSGbASIvK+fkONUhvj8

# B8ZHNn4TFfnct+a0ZueY4f6aRPxr8beNSUKn7QW/FQmn422bE7KfnqWncsH7vbNh

# G929prVHPsaa7J22i9wyHj7m0oATXJ+YjfyoEAtd5/NyIYaE4Uu0j1EhuYUo5VaJ

# JnMaTER0qX8+/YZRWrFN/heps41XNVjiAawpbAa0fUa3R9RNBjPiBnM0gvNPorM4

# dsV2VJ8GluIQOrJlOvuCrOYDGirGnadOmQ21wPBoGFCWpK56PxzliKsy5NNmAXcE

# x7Qb9vUjY1WlYtrdwOXTpxN4slzIht69BaZlLIjLVWwqIfuNrhHKNDM9K+v7vgrI

# bf7l5/665g0gjQCDCN6Q5sxuttTAEKtJeS/pkpI+DbZ/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCFVswghVXAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAFSm0CfUFaZdYgAAAAA

# AVIwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIJ6w

# k9hJYao39SvyurUBf2Mpv1NYMSVxCSy7SPZP8gjTMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAHpJkMHJCaQfoI2TNsqGrQKWahEAIcRDJ8Jfq

# LnLHAkL7ipbwZRoqAPBzLDLf9bRy+SXBDPgIt7NhbeB96Rd3GksLm4X9pYunwGp7

# PbS7RMz/C37gCocQy/splTmjhJLiqD4Mg78zHvDUOnwcia3d2xYvDqsF1eeMXEp6

# meSFNu3h0SY5lw8t53a/yG0pPnnsS/8L4AArAMkDkKgSu//0HKpOQffX8vwdAoPV

# fuiqBAjqbeogwJfxfCsqfoJRt03qrN+eLR/ejJgpu4U0A72SP3xD/vpYekA/l2fU

# VND5zH21wmW9hqvLxMypXMPRHT5o3+BkIh42AxhulTqd6m20RqGCEuUwghLhBgor

# BgEEAYI3AwMBMYIS0TCCEs0GCSqGSIb3DQEHAqCCEr4wghK6AgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCDsFgz7ZPICsdOCzgAZQQwkX5QnyskKjwi0

# EAVc7nOkggIGXioH4jORGBMyMDIwMDIxNDIxNTY1Ni4zNzlaMASAAgH0oIHQpIHN

# MIHKMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMg

# VFNTIEVTTjpBRTJDLUUzMkItMUFGQzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgU2VydmljZaCCDjwwggTxMIID2aADAgECAhMzAAABFpMi6r+7LU3mAAAA

# AAEWMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MB4XDTE5MTExMzIxNDAzNFoXDTIxMDIxMTIxNDAzNFowgcoxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVy

# aWNhIE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkFFMkMtRTMy

# Qi0xQUZDMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIB

# IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0Pgb8/296ie/Lj2rWq+MIlMZ

# wkSUwZsIKd472tyeVOyNcKgqSCT4zQvz2kd+VD7lYWN3V0USL5oipdp+xp7wH7CA

# HC7zNU21PjdHWPOi2okIlPyTikrQBowo+MOV9Xgd3WqMnJSKEank7QmSHgJimJ2q

# /ZRR5+0Z5uZRejJHkQcJmTB8Gq/wg2E/gjuRl/iGa4fGJu0cHSUiX78m5FEyaac1

# XnkqafSqYR8qb7sn3ZVt/ltbiGUJr874oi2bZduUtCMR0QiWWfBMExcLV4A6ermC

# 98cbbvi/pQb1p1l7vXT2NReD+xkFqzKn0cA3Vi9cc5LjDhY91L18RuHIgU3qHQID

# AQABo4IBGzCCARcwHQYDVR0OBBYEFOW/Xiu4F+gXzUflH3k0/lfIIVULMB8GA1Ud

# IwQYMBaAFNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJoEeGRWh0

# dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1RpbVN0

# YVBDQV8yMDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKG

# Pmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGltU3RhUENB

# XzIwMTAtMDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUH

# AwgwDQYJKoZIhvcNAQELBQADggEBADaDatfaqaPbAy/pSdK8e8XdzN6v9979NSWL

# UsNHoNBFpyr1FTGcvwf0SKIfe0ygt8s8plkAYxMUftUmOnO+OnGXUgTOreXIw4zt

# sepotreHcL094+bn7OUGLPMa56GQii3WUgiGPP0gfNXhXcqSdd9HmXjMhKfRn0jO

# KREJTPqPHLXSxcA1SVTrg8JDtkD+yWVzuuAkSopTGxtJp5PcrYUrMb7nW1coIe7t

# sQiSPp6xFVzKfXFUJ9VzAChucE+8pqXLpV/xU3p/1vf0DgLZMpI22mwAgbe/E6wg

# yDSKyHXI4UsiIlSYASv+IlKOtcXzrXV0IRQUdRyIC1ZiWWL/YggwggZxMIIEWaAD

# AgECAgphCYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBD

# ZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVaFw0yNTA3

# MDEyMTQ2NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIBIjANBgkq

# hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mUa3RUENWl

# CgCChfvtfGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZsTBED/Fg

# iIRUQwzXTbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4YyhB50YWeR

# X4FUsc+TTJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQYrFd/Xcf

# PfBXday9ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDaTgaRtogI

# Neh4HLDpmc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQIDAQABo4IB

# 5jCCAeIwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDzQ3t8RhvF

# M2hahW1VMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAP

# BgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjE

# MFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kv

# Y3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEF

# BQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9w

# a2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNVHSABAf8E

# gZUwgZIwgY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDovL3d3dy5t

# aWNyb3NvZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggrBgEFBQcC

# AjA0HjIgHQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQAZQBtAGUA

# bgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2do6Ehb7Pr

# psz1Mb7PBeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GCRBL7uVOM

# zPRgEop2zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZeUqRUgCv

# OA8X9S95gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8ySif9Va8v

# /rbljjO7Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOco6I8+n99

# lmqQeKZt0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz39L9+Y1kl

# D3ouOVd2onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSYIghh2rBQ

# Hm+98eEA3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvYgrRyzR30

# uIUBHoD7G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98isTtoouLGp

# 25ayp0Kiyc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8l1Bx16HS

# xVXjad5XwdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzVs341Hgi6

# 2jbb01+P3nSISRKhggLOMIICNwIBATCB+KGB0KSBzTCByjELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp

# Y2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046QUUyQy1FMzJC

# LTFBRkMxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoB

# ATAHBgUrDgMCGgMVAIdNW9zyT6CLG1qCDNc++szs3ZZDoIGDMIGApH4wfDELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDh8Yb/MCIY

# DzIwMjAwMjE1MDQ1MjE1WhgPMjAyMDAyMTYwNDUyMTVaMHcwPQYKKwYBBAGEWQoE

# ATEvMC0wCgIFAOHxhv8CAQAwCgIBAAICIlICAf8wBwIBAAICEeYwCgIFAOHy2H8C

# AQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEK

# MAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQBVHsmOuAYqv5IOnDeSm7YGzkCf

# 42cvcXoFgrN9Q9SiTGwsmUgnIwx7jkUUb7j3i2en8JxZB9qi+euMZnMzap0WJsSv

# kg+V0Ya/1EKE4wCezAbCv+mcpST6viTM+s57p27B0i5OuWx5ztMi3AuRjHL10pVN

# l0fC1FAofs6vY4oimDGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAABFpMi6r+7LU3mAAAAAAEWMA0GCWCGSAFlAwQCAQUAoIIB

# SjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIAKc

# vHzawZEh77OWAVaCynAX9cBfeOEnm9CG1WuPtNXBMIH6BgsqhkiG9w0BCRACLzGB

# 6jCB5zCB5DCBvQQggyKU9qRgKQiXXCmbITbdtLENhYxqIMhBaM+iXtLBkMowgZgw

# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAARaTIuq/uy1N

# 5gAAAAABFjAiBCCUOKmruuCKm7Gw9fWc/8HtG0dQZBcjB+Ive+v0VLJwzTANBgkq

# hkiG9w0BAQsFAASCAQBIcseTI/K0QGcoreh9dHfca36ZhCPYvuP91NkLiFoZEJ26

# qeCKfLtPW0+D/Op0XQLikSr10BDTayMRuqjqMJ2zv8x3vtqo/MV2yibca2UlvT0T

# LWz8uiZh9MKlz9v6R1XR5UT2q7W2Ig4o+bMmG7SB8Epf5EgzTfsgn8Zu65iPdsIP

# ezqIu7QVNwwExs9/Vx83DEmd4IjgvXluKaRcWg6ijtREU3vPiIHVGv0mbfzghTQm

# 8E6yWHBfhyemboRrwJ8Yf6wTnXLyam620qLP9wZO7D6el5btuFQJr/w/AkyN9Ei4

# pjjz9e9BCbGeKgM6otmk8mq6w28hKc2UJLHrHeb7

# SIG # End signature block