Az.Functions

0.0.1-preview

custom/New-AzFunctionApp.ps1

                                
function New-AzFunctionApp {

    [OutputType([Microsoft.Azure.PowerShell.Cmdlets.Functions.Models.Api20180201.ISite])]

    [Microsoft.Azure.PowerShell.Cmdlets.Functions.Description('Creates a function app.')]

    [CmdletBinding(SupportsShouldProcess=$true, DefaultParametersetname="ByAppServicePlan")]

    param(        

        [Parameter(ParameterSetName="Consumption", HelpMessage='The Azure subscription ID.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Runtime.DefaultInfo(Script='(Get-AzContext).Subscription.Id')]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${SubscriptionId},

        [Parameter(Mandatory=$true, ParameterSetName="Consumption", HelpMessage='The name of the resource group.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${ResourceGroupName},

        [Parameter(Mandatory=$true, ParameterSetName="Consumption", HelpMessage='The name of the function app.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${Name},

        [Parameter(Mandatory=$true, ParameterSetName="Consumption", HelpMessage='The name of the storage account.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${StorageAccountName},        

        [Parameter(ParameterSetName="Consumption", HelpMessage='Name of the existing App Insights project to be added to the function app.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        [Alias("AppInsightsName")]

        ${ApplicationInsightsName},

        [Parameter(ParameterSetName="Consumption", HelpMessage='Instrumentation key of App Insights to be added.')]

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        [Alias("AppInsightsKey")]

        ${ApplicationInsightsKey},

        [Parameter(Mandatory=$true, ParameterSetName="Consumption", HelpMessage='The location for the consumption plan.')]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${Location},

        [Parameter(Mandatory=$true, ParameterSetName="ByAppServicePlan", HelpMessage='The name of the service plan.')]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${PlanName},

        [Parameter(Mandatory=$true, ParameterSetName="ByAppServicePlan", HelpMessage='The OS to host the function app.')]

        [Parameter(ParameterSetName="Consumption")]

        [ArgumentCompleter([Microsoft.Azure.PowerShell.Cmdlets.Functions.Support.WorkerType])]

        [ValidateNotNullOrEmpty()]

        [System.String]

        # OS type (Linux or Windows)

        ${OSType},

        [Parameter(Mandatory=$true, ParameterSetName="ByAppServicePlan", HelpMessage='The function runtime.')]

        [Parameter(ParameterSetName="Consumption")]

        [ArgumentCompleter([Microsoft.Azure.PowerShell.Cmdlets.Functions.Support.RuntimeType])]

        [ValidateNotNullOrEmpty()]

        [System.String]

        # Runtime type (DotNet, Node, Java, PowerShell or Python

        ${Runtime},

        [Parameter(ParameterSetName="ByAppServicePlan", HelpMessage='Disable creating application insights resource during the function app creation. No logs will be available.')]

        [Parameter(ParameterSetName="Consumption")]

        [System.Management.Automation.SwitchParameter]

        [Alias("DisableAppInsights")]

        ${DisableApplicationInsights},

        [Parameter(ParameterSetName="ByAppServicePlan")]

        [Parameter(ParameterSetName="Consumption", HelpMessage='Returns true when the command succeeds.')]

        [System.Management.Automation.SwitchParameter]

        ${PassThru},

        <#

        [Parameter()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        ${NoWait},

        [Parameter()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        ${AsJob},

        #>

        [Alias('AzureRMContext', 'AzureCredential')]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Azure')]

        [System.Management.Automation.PSObject]

        ${DefaultProfile},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        # Wait for .NET debugger to attach

        ${Break},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Runtime.SendAsyncStep[]]

        # SendAsync Pipeline Steps to be appended to the front of the pipeline

        ${HttpPipelineAppend},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Runtime.SendAsyncStep[]]

        # SendAsync Pipeline Steps to be prepended to the front of the pipeline

        ${HttpPipelinePrepend},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Uri]

        # The URI for the proxy server to use

        ${Proxy},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Management.Automation.PSCredential]

        # Credentials for a proxy server to use for the remote call

        ${ProxyCredential},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        # Use the default credentials for the proxy

        ${ProxyUseDefaultCredentials}

)

    process {

        if ($PSBoundParameters.ContainsKey("AsJob"))

        {

            $null = $PSBoundParameters.Remove("AsJob")

            $modulePath = Join-Path $PSScriptRoot "../Az.Functions.psd1"

            Start-Job -ScriptBlock {

                param($arg, $modulePath)

                Import-Module $modulePath

                Az.Functions\New-AzFunctionApp @arg

            } -ArgumentList $PSBoundParameters, $modulePath

        }

        else 

        {

            # Remove bound parameters from the dictionary that cannot be process by the intenal cmdlets.

            $paramsToRemove = @(

                "StorageAccountName",

                "ApplicationInsightsName",

                "ApplicationInsightsKey",

                "Location",

                "PlanName",

                "OSType",

                "Runtime",

                "DisableApplicationInsights"

            )

            foreach ($paramName in $paramsToRemove)

            {

                if ($PSBoundParameters.ContainsKey($paramName))

                {

                    $null = $PSBoundParameters.Remove($paramName)

                }

            }

            ValidateFunctionName -Name $Name

            $appSettings = New-Object -TypeName System.Collections.Generic.List[System.Object]

            $siteCofig = New-Object -TypeName Microsoft.Azure.PowerShell.Cmdlets.Functions.Models.Api20180201.SiteConfig

            $functionAppDef = New-Object -TypeName Microsoft.Azure.PowerShell.Cmdlets.Functions.Models.Api20180201.Site

            $servicePlan = $null

            $OSIsLinux = $OSType -eq "Linux"

            $consumptionPlan = $PsCmdlet.ParameterSetName -eq "Consumption"

            if ($consumptionPlan)

            {

                ValidateConsumptionPlanLocation -Location $Location

                $functionAppDef.Location = $Location

            }

            else 

            {

                # App with SKU based plan

                $servicePlan = GetServicePlan $PlanName

                if (-not $servicePlan)

                {

                    $errorMessage = "Service plan '$PlanName' does not exist."

                    $exception = [System.InvalidOperationException]::New($errorMessage)

                    ThrowTerminatingError -ErrorId "ServicePlanDoesNotExist" `

                                        -ErrorMessage $errorMessage `

                                        -ErrorCategory ([System.Management.Automation.ErrorCategory]::InvalidOperation) `

                                        -Exception $exception

                }

                if ($null -ne $servicePlan.Location)

                {

                    $Location = $servicePlan.Location

                }

                if ($null -ne $servicePlan.Reserved)

                {

                    $OSIsLinux = $servicePlan.Reserved

                }

                $functionAppDef.ServerFarmId = $servicePlan.Id

                $functionAppDef.Location = $Location

            }

            # Validate runtime

            ValidateRuntime -Runtime $Runtime -OSIsLinux:$OSIsLinux

            $runtimeName = GetRuntimeName -Runtime $Runtime

            $runtimeVersion = GetRuntimeVersion -Runtime $Runtime

            $runtimeWorker = $runtimeName.ToLower()

            $appSettings.Add((NewAppSetting -Name 'FUNCTIONS_WORKER_RUNTIME' -Value "$runtimeWorker"))

            if ($OSIsLinux)

            {

                # Linux function app            

                $functionAppDef.Kind = 'functionapp,linux'

                $functionAppDef.Reserved = $true

                if (-not $consumptionPlan)

                {

                    $appSettings.Add((NewAppSetting -Name 'WEBSITES_ENABLE_APP_SERVICE_STORAGE' -Value 'true'))

                }

                $siteCofig.LinuxFxVersion = GetLinuxFxVersion -RuntimeName $runtimeName -RuntimeVersion $runtimeVersion -IsConsumption:$consumptionPlan

            }

            else 

            {

                # Windows function app

                $functionAppDef.Kind = 'functionapp'

            }

            # Validate storage account and get connection string

            $connectionStrings = GetConnectionString -StorageAccountName $StorageAccountName

            # Set the default Host version.

            $appSettings.Add((NewAppSetting -Name 'FUNCTIONS_EXTENSION_VERSION' -Value $DefaultHostRuntimeVersion))

            $appSettings.Add((NewAppSetting -Name 'AzureWebJobsStorage' -Value $connectionStrings))

            $appSettings.Add((NewAppSetting -Name 'AzureWebJobsDashboard' -Value $connectionStrings))

            # Set default Node version

            $defaultNodeVersion = GetFunctionAppDefaultNodeVersion -Runtime $runtimeName -RuntimeVersion $runtimeVersion

            $appSettings.Add((NewAppSetting -Name 'WEBSITE_NODE_DEFAULT_VERSION' -Value $defaultNodeVersion))

            # If plan is not consumption or elastic premium, set always on

            $planIsElasticPremium = $servicePlan.SkuTier -eq 'ElasticPremium'

            if ((-not $consumptionPlan) -and $planIsElasticPremium)

            {

                $siteCofig.AlwaysOn = $true

            }

            # If plan is elastic premium or windows consumption, we need these app settings

            $IsWindowsConsumption = $consumptionPlan -and (-not $OSIsLinux)

            if ($planIsElasticPremium -or $IsWindowsConsumption)

            {

                $appSettings.Add((NewAppSetting -Name 'WEBSITE_CONTENTAZUREFILECONNECTIONSTRING' -Value $connectionStrings))

                $appSettings.Add((NewAppSetting -Name 'WEBSITE_CONTENTSHARE' -Value $Name.ToLower()))

            }

            if (-not $DisableAppInsights)

            {

                if ($ApplicationInsightsKey)

                {

                    $appSettings.Add((NewAppSetting -Name 'APPINSIGHTS_INSTRUMENTATIONKEY' -Value $ApplicationInsightsKey))

                }

                elseif ($ApplicationInsightsName)

                {

                    $appInsightsProject = GetApplicationInsightsProject -Name $ApplicationInsightsName

                    if (-not $appInsightsProject)

                    {

                        $errorMessage = "Failed to get application insights key for project name '$ApplicationInsightsName'. Please make sure the project exist."

                        $exception = [System.InvalidOperationException]::New($errorMessage)

                        ThrowTerminatingError -ErrorId "ApplicationInsightsProjectNotFound" `

                                            -ErrorMessage $errorMessage `

                                            -ErrorCategory ([System.Management.Automation.ErrorCategory]::InvalidOperation) `

                                            -Exception $exception

                    }

                    $appSettings.Add((NewAppSetting -Name 'APPINSIGHTS_INSTRUMENTATIONKEY' -Value $appInsightsProject.InstrumentationKey))

                }

                else

                {

                    # Create a new ApplicationInsights

                    try 

                    {

                        $newAppInsightsProject = Az.Functions.internal\New-AzAppInsights -ResourceGroupName $resourceGroupName `

                                                                                        -ResourceName $Name  `

                                                                                        -Location $functionAppDef.Location `

                                                                                        -Kind web `

                                                                                        -RequestSource "AzurePowerShell" `

                                                                                        -ErrorAction Stop

                        if ($newAppInsightsProject)

                        {

                            $appSettings.Add((NewAppSetting -Name 'APPINSIGHTS_INSTRUMENTATIONKEY' -Value $newAppInsightsProject.InstrumentationKey))

                        }                    

                    }

                    catch

                    {

                        $warningMessage = 'Unable to create the Application Insights for the Function App. Please use the Azure Portal to manually create and configure the Application Insights, if needed.'

                        Write-Warning $warningMessage

                    }

                }

            }       

            # Set app settings and site configuration

            $siteCofig.AppSetting = $appSettings

            $functionAppDef.Config = $siteCofig

            $null = $PSBoundParameters.Add("SiteEnvelope", $functionAppDef)

            # Run the command with -NoWait

            if ($PSBoundParameters.ContainsKey("NoWait"))

            {

                $null = $PSBoundParameters.Remove("NoWait")

                Az.Functions.internal\New-AzFunctionApp @PSBoundParameters

            }

            else

            {

                # Create function app without AsJob and NoWait params

                $null = $PSBoundParameters.Add("ErrorAction", "Stop")

                try

                {

                    $createdFunctionApp = Az.Functions.internal\New-AzFunctionApp @PSBoundParameters

                    if ($createdFunctionApp)

                    {

                        $createdFunctionApp.OSType = $OSType

                        $createdFunctionApp.HostVersion = "$DefaultHostRuntimeVersion"

                        if ($runtimeName)

                        {

                            $createdFunctionApp.RuntimeName = $RuntimeToFormattedName[$runtimeName]

                        }

                        if ($PlanName)

                        {

                            $createdFunctionApp.AppServicePlan = $PlanName

                        }

                        if ($consumptionPlan)

                        {

                            $warningMessage = "Your Linux function app '$Name', that uses a consumption plan has been successfully created but is not active until content is published using Azure Portal or the Functions Core Tools."

                            Write-Warning $warningMessage

                        }

                        $createdFunctionApp

                    }

                }

                catch

                {

                    $errorMessage = GetErrorMessage -Response $_

                    if ($errorMessage)

                    {

                    $exception = [System.InvalidOperationException]::New($errorMessage)            

                        ThrowTerminatingError -ErrorId "FailedToCreateFunctionApp" `

                                            -ErrorMessage $errorMessage `

                                            -ErrorCategory ([System.Management.Automation.ErrorCategory]::InvalidOperation) `

                                            -Exception $exception

                    }

                    throw $_

                }

            } 

        }        

    }

}

# SIG # Begin signature block

# MIIkcwYJKoZIhvcNAQcCoIIkZDCCJGACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBr3DpmlGwQRjtA

# 6bHR/DhvFXJT0IUv750pJ+KAhjFheKCCDYEwggX/MIID56ADAgECAhMzAAABUZ6N

# j0Bxow5BAAAAAAFRMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMTkwNTAyMjEzNzQ2WhcNMjAwNTAyMjEzNzQ2WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCVWsaGaUcdNB7xVcNmdfZiVBhYFGcn8KMqxgNIvOZWNH9JYQLuhHhmJ5RWISy1

# oey3zTuxqLbkHAdmbeU8NFMo49Pv71MgIS9IG/EtqwOH7upan+lIq6NOcw5fO6Os

# +12R0Q28MzGn+3y7F2mKDnopVu0sEufy453gxz16M8bAw4+QXuv7+fR9WzRJ2CpU

# 62wQKYiFQMfew6Vh5fuPoXloN3k6+Qlz7zgcT4YRmxzx7jMVpP/uvK6sZcBxQ3Wg

# B/WkyXHgxaY19IAzLq2QiPiX2YryiR5EsYBq35BP7U15DlZtpSs2wIYTkkDBxhPJ

# IDJgowZu5GyhHdqrst3OjkSRAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUV4Iarkq57esagu6FUBb270Zijc8w

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU0MTM1MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAWg+A

# rS4Anq7KrogslIQnoMHSXUPr/RqOIhJX+32ObuY3MFvdlRElbSsSJxrRy/OCCZdS

# se+f2AqQ+F/2aYwBDmUQbeMB8n0pYLZnOPifqe78RBH2fVZsvXxyfizbHubWWoUf

# NW/FJlZlLXwJmF3BoL8E2p09K3hagwz/otcKtQ1+Q4+DaOYXWleqJrJUsnHs9UiL

# crVF0leL/Q1V5bshob2OTlZq0qzSdrMDLWdhyrUOxnZ+ojZ7UdTY4VnCuogbZ9Zs

# 9syJbg7ZUS9SVgYkowRsWv5jV4lbqTD+tG4FzhOwcRQwdb6A8zp2Nnd+s7VdCuYF

# sGgI41ucD8oxVfcAMjF9YX5N2s4mltkqnUe3/htVrnxKKDAwSYliaux2L7gKw+bD

# 1kEZ/5ozLRnJ3jjDkomTrPctokY/KaZ1qub0NUnmOKH+3xUK/plWJK8BOQYuU7gK

# YH7Yy9WSKNlP7pKj6i417+3Na/frInjnBkKRCJ/eYTvBH+s5guezpfQWtU4bNo/j

# 8Qw2vpTQ9w7flhH78Rmwd319+YTmhv7TcxDbWlyteaj4RK2wk3pY1oSz2JPE5PNu

# Nmd9Gmf6oePZgy7Ii9JLLq8SnULV7b+IP0UXRY9q+GdRjM2AEX6msZvvPCIoG0aY

# HQu9wZsKEK2jqvWi8/xdeeeSI9FN6K1w4oVQM4Mwggd6MIIFYqADAgECAgphDpDS

# 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/BvW1taslScxMNelDNMYIWSDCCFkQCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAVGejY9AcaMOQQAAAAABUTAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgJPsRihlh

# 5lHR6Y4QEGmdirqGb9xjtgncL/ivtPau9wkwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQCUnX0RzvzQrxQDTN5YLK29isK+QJrjTBPQgbeFUzUN

# dBAFUIo2gy0k0xS85NyKw2frx/1RAcMElRIVTSCxoR/NgTSoaf0cUvhUBHJgeycZ

# MIQMFGjDGzMcoEXsdSUsq0VNIHns7Sc9x78dZ+WMboWkCLwcuoJ4drAgY430dp6l

# N12DELbY6iQfv0Ig2GMWbZBPlttIGd8NwwgMUbkUXMT1823hsWLBxBkWHyJsxiJE

# oFmKDIwnmZe1LeB8aaacdf3TLXhQDl2qKcHRXhxQWgf57BEz9uHFpk2G+XLRGuSi

# +svuB3DLNGVjvAgqrUCazPjyqwyxqQghovwd6TXm3e+LoYIT0jCCE84GCisGAQQB

# gjcDAwExghO+MIITugYJKoZIhvcNAQcCoIITqzCCE6cCAQMxDzANBglghkgBZQME

# AgEFADCCAVgGCyqGSIb3DQEJEAEEoIIBRwSCAUMwggE/AgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIJEvgL+I8uX6BAtB4V03cFmLASJI0sNh202d7kll

# +qMPAgZdsHpfjWAYEzIwMTkxMTA3MTcxOTA4LjIwM1owBwIBAYACAfSggdSkgdEw

# gc4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsT

# IE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFs

# ZXMgVFNTIEVTTjo5OEZELUM2MUUtRTY0MTElMCMGA1UEAxMcTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgU2VydmljZaCCDyIwggT1MIID3aADAgECAhMzAAAA++CUDxRBhNvF

# AAAAAAD7MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy

# MDEwMB4XDTE5MDkwNjIwNDEwNloXDTIwMTIwNDIwNDEwNlowgc4xCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBP

# cGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo5

# OEZELUM2MUUtRTY0MTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKAhY+5J8HXlmAVU

# +70WH7Tm4GcoAWQzzKyzLYgQjL+mViTGe5p0zbwF49ZJcdXgwQkDM/uA2j8xj0or

# y2Uh5CefDW/AUHz9R2qkIe5AbjbjLADgCKg6U3SAlWfz8NoKNE8xu2Uy/8zpLDcV

# c0jw4B36Kq6Yjm8xXcsyxjObbaVzIicl23bsuJgkkCD1sathSBFrwDVEYQHk8R1Y

# wgFE8NB/ngp+4P02rAmuNpcc1wBOyvTyEbS8l1mirMFhT9VbDftN6s1zd0Mlp+Hr

# p5U0NGPwS+mEHilvjabY67LBK3BZLYgmUcitV46XontBCBv9K+5oPtpRrdbPVu2g

# e2THNecCAwEAAaOCARswggEXMB0GA1UdDgQWBBSQPADvO9LEi5oW6lyRMkqJD6tN

# jDAfBgNVHSMEGDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEug

# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N

# aWNUaW1TdGFQQ0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG

# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Rp

# bVN0YVBDQV8yMDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoG

# CCsGAQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IBAQBD2sGnRfoXWNGCeqAhw+SMyp8z

# SS7zFkOoGnH8IQtXLY2wMezdaD3O8NVB2+1J4jfygw7XiBkFQt40i+85x8ig+oUn

# Zl1F+f3l6TKbCLIeAlpvfRT2USLHO+4PIUX9wYViqOF7FXlP2DJC/1ga/bGhF5mc

# KxlcPo4BWk8cuO3BCjXabNCs5oHbNHVfxUI9xVKYUBN3GNDl+72j50bE11Jg8ZgV

# wI2Syw1j7UiC7ZHYzZ7GCNyuH3z9qGIXWgr6Nb/il5pPfsOWRI1bQbL0/oc/Q4TP

# 9tqhvCi57T+59NYz+33KAGx0SghLBcg6grUKyI6cgNf+fOUb/FQR+8Ph2SAyMIIG

# cTCCBFmgAwIBAgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0

# IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1

# WhcNMjUwNzAxMjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCC

# ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9p

# lGt0VBDVpQoAgoX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEw

# WbEwRA/xYIiEVEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeG

# MoQedGFnkV+BVLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJ

# UGKxXf13Hz3wV3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw

# 2k4GkbaICDXoeByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0C

# AwEAAaOCAeYwggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ

# 80N7fEYbxTNoWoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8E

# BAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2U

# kFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5j

# b20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmww

# WgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYD

# VR0gAQH/BIGVMIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYI

# KwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0

# AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9

# naOhIW+z66bM9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtR

# gkQS+7lTjMz0YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzy

# mXlKkVIArzgPF/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCf

# Mkon/VWvL/625Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3D

# nKOiPPp/fZZqkHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs

# 9/S/fmNZJQ96LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110

# mCIIYdqwUB5vvfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL

# 2IK0cs0d9LiFAR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffI

# rE7aKLixqduWsqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxE

# PJdQcdeh0sVV42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc

# 1bN+NR4Iuto229Nfj950iEkSoYIDsDCCApgCAQEwgf6hgdSkgdEwgc4xCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29m

# dCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVT

# Tjo5OEZELUM2MUUtRTY0MTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg

# U2VydmljZaIlCgEBMAkGBSsOAwIaBQADFQAV9O+PCUZ4KHTCMuuXBK/6zr9CMaCB

# 3jCB26SB2DCB1TELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO

# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEp

# MCcGA1UECxMgTWljcm9zb2Z0IE9wZXJhdGlvbnMgUHVlcnRvIFJpY28xJzAlBgNV

# BAsTHm5DaXBoZXIgTlRTIEVTTjo0REU5LTBDNUUtM0UwOTErMCkGA1UEAxMiTWlj

# cm9zb2Z0IFRpbWUgU291cmNlIE1hc3RlciBDbG9jazANBgkqhkiG9w0BAQUFAAIF

# AOFuIoQwIhgPMjAxOTExMDcxMjU2MzZaGA8yMDE5MTEwODEyNTYzNlowdzA9Bgor

# BgEEAYRZCgQBMS8wLTAKAgUA4W4ihAIBADAKAgEAAgIBsgIB/zAHAgEAAgIZWzAK

# AgUA4W90BAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMBoAowCAIB

# AAIDFuNgoQowCAIBAAIDB6EgMA0GCSqGSIb3DQEBBQUAA4IBAQCATpyVaR6IHn8v

# HCR3TSit0EkRGmUmCS165pKHFf3m6xfas4PikRWfelkwWKxbG2ul1bzcFEWzACcO

# EYoQOIrNZ1/jYgwyGUHtwbgRA3FNcuy2FR69Wgs9WpT8WihTmVBcIf6CvP9rsnB9

# TVdqDiRrqnf+TooNotCi4m1M3yV10AncOP9SOxGMme8W1AvxtlmYeqQ4iB0hNAPE

# +1/yZ82jz9KtdI4xCPgn0jpezDpIC1Vg3NImgQZIcAXK1qjZbEgmaJetKY8cwR9q

# 5O8DxnVzA+7tqN5xrBqNO+NPkXVFXVvQYl1ZTRwOmbzGJFYpAxrd6eMxE7lbodnG

# khA1fKOWMYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTACEzMAAAD74JQPFEGE28UAAAAAAPswDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG

# SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgsxblOLpEZQdP

# dXGKHauyiBv56bk7tMLceI00lF0RiN4wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk

# MIG9BCBu8fQjDOJ6yHyR/w+/uqCScFrrBeJLrXDO9BpMK7r+3TCBmDCBgKR+MHwx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAA++CUDxRBhNvFAAAAAAD7

# MCIEIFo9Ai2jY+bdvPPMYUA6/SDvKqnDXXJUpA/Sjz78Fx/DMA0GCSqGSIb3DQEB

# CwUABIIBAJRdThm1uOZmiGfsokAKxR0PAhzGJpBqSehzGzZP5pcq1jOKyNzNjTUW

# hYKeyGw60/K7CeBQ2pgYlbW0rnUNKsnDDbFE75rPA+oxWqPOR+6ODtg31IkOEkSj

# sxI7HG4mlrl8qFAvxTeGFXku9sgXyFQPkdaZ3LeO5OV6PepEWj4ZGM7YgbA+Raxj

# XAGgI7cMkIOrwD7M80+5B9AktuBF1PeOVygasaTPZT9F1ZNlvBJR19ssQ3MQ/UrX

# U/J5fXDdC/Ze8qgnraqj8r7Sz2XugMtQX5+lI2HC9No6+dYOvq6DHmB8UfX+RqhK

# XKC8d6iOOcJcyUhPEh+Q1Jc7+gre6iM=

# SIG # End signature block