Az.Functions

1.0.1

custom/Update-AzFunctionApp.ps1

                                
function Update-AzFunctionApp {

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

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

    [CmdletBinding(DefaultParameterSetName='ByName', SupportsShouldProcess=$true)]

    param(

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

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

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${SubscriptionId},

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

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${ResourceGroupName},

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

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${Name},

        [Parameter(ParameterSetName='ByObjectInput', Mandatory=$true, ValueFromPipeline=$true)]

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Models.Api20190801.ISite]

        [ValidateNotNull()]

        ${InputObject},

        [Parameter(HelpMessage='The name of the service plan.')]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${PlanName},

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

        [ValidateNotNullOrEmpty()]

        [System.String]

        [Alias("AppInsightsName")]

        ${ApplicationInsightsName},

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

        [ValidateNotNullOrEmpty()]

        [System.String]

        [System.String]

        [Alias("AppInsightsKey")]

        ${ApplicationInsightsKey},

        [Parameter(HelpMessage='Resource tags.')]

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

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Runtime.Info(PossibleTypes=([Microsoft.Azure.PowerShell.Cmdlets.Functions.Models.Api20190801.IResourceTags]))]

        [System.Collections.Hashtable]

        [ValidateNotNull()]

        ${Tag},

        [Parameter(HelpMessage="Specifies the type of identity used for the function app.

            The type 'None' will remove any identities from the function app. The acceptable values for this parameter are:

            - SystemAssigned

            - UserAssigned

            - None

            ")]

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

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

        [Microsoft.Azure.PowerShell.Cmdlets.Functions.Support.ManagedServiceIdentityType]

        ${IdentityType},

        [Parameter(HelpMessage="Specifies the list of user identities associated with the function app.

            The user identity references will be ARM resource ids in the form:

            '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'")]

        [ValidateNotNullOrEmpty()]

        [System.String]

        ${IdentityID},

        [Parameter(HelpMessage='Starts the operation and returns immediately, before the operation is completed. In order to determine if the operation has successfully been completed, use some other mechanism.')]

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

        [System.Management.Automation.SwitchParameter]

        ${NoWait},

        [Parameter(HelpMessage='Runs the cmdlet as a background job.')]

        [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 {

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

        $paramsToRemove = @(

            "PlanName",

            "ApplicationInsightsName",

            "ApplicationInsightsKey"

            "IdentityType",

            "IdentityID",

            "Tag"

        )

        foreach ($paramName in $paramsToRemove)

        {

            if ($PSBoundParameters.ContainsKey($paramName))

            {

                $PSBoundParameters.Remove($paramName)  | Out-Null

            }

        }

        $params = GetParameterKeyValues -PSBoundParametersDictionary $PSBoundParameters `

                                        -ParameterList @("SubscriptionId", "HttpPipelineAppend", "HttpPipelinePrepend")

        $existingFunctionApp = $null

        if ($PsCmdlet.ParameterSetName -eq "ByObjectInput")

        {

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

            {

                $PSBoundParameters.Remove("InputObject")  | Out-Null

            }

            $Name = $InputObject.Name

            $PSBoundParameters.Add("Name", $Name)  | Out-Null

            $PSBoundParameters.Add("ResourceGroupName", $InputObject.ResourceGroupName)  | Out-Null

            $PSBoundParameters.Add("SubscriptionId", $InputObject.SubscriptionId)  | Out-Null

            $existingFunctionApp = $InputObject                

        }

        else

        {

            $existingFunctionApp = GetFunctionAppByName -Name $Name -ResourceGroupName $ResourceGroupName @params

        }

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

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

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

        # Identity information

        if ($IdentityType)

        {

            $functionAppDef.IdentityType = $IdentityType

            if ($IdentityType -eq "UserAssigned")

            {

                # Set UserAssigned managed identity

                if (-not $IdentityID)

                {

                    $errorMessage = "IdentityID is required for UserAssigned identity"

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

                    ThrowTerminatingError -ErrorId "IdentityIDIsRequiredForUserAssignedIdentity" `

                                            -ErrorMessage $errorMessage `

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

                                            -Exception $exception

                }

                $identityUserAssignedIdentity = NewIdentityUserAssignedIdentity -IdentityID $IdentityID

                $functionAppDef.IdentityUserAssignedIdentity = $identityUserAssignedIdentity

            }

        }

        elseif ($existingFunctionApp.IdentityType)

        {

            if ($existingFunctionApp.IdentityType -eq "UserAssigned")

            {

                $functionAppDef.IdentityType = "UserAssigned"

                if ($existingFunctionApp.IdentityUserAssignedIdentity -and $existingFunctionApp.IdentityUserAssignedIdentity.Count -gt 0)

                {

                    $identityUserAssignedIdentity = NewIdentityUserAssignedIdentity -IdentityID $existingFunctionApp.IdentityUserAssignedIdentity.Keys

                    $functionAppDef.IdentityUserAssignedIdentity = $identityUserAssignedIdentity

                }

            }

            elseif ($existingFunctionApp.IdentityType -eq "SystemAssigned")

            {

                $functionAppDef.IdentityType = "SystemAssigned"

            }

            else

            {

                $errorMessage = "Unknown IdentityType '$($existingFunctionApp.IdentityType)'"

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

                ThrowTerminatingError -ErrorId "UnknownIdentityType" `

                                        -ErrorMessage $errorMessage `

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

                                        -Exception $exception

            }

        }

        # Update function app hosting plan

        if ($PlanName)

        {

            # Validate that the new plan is exists

            $newFunctionAppPlan = GetServicePlan $PlanName @params

            # Get the current plan in which the app is being hosted

            $currentFunctionAppPlan = GetFunctionAppServicePlanInfo $existingFunctionApp.ServerFarmId @params

            ValidatePlanSwitchCompatibility -CurrentServicePlan $currentFunctionAppPlan -NewServicePlan $newFunctionAppPlan

            $functionAppDef.ServerFarmId = $newFunctionAppPlan.Id

            $functionAppDef.Location = $newFunctionAppPlan.Location

            $functionAppDef.Reserved = $newFunctionAppPlan.Reserved

        }

        else

        {

            # Copy the existing function app plan settings

            $functionAppDef.ServerFarmId = $existingFunctionApp.ServerFarmId

            $functionAppDef.Location = $existingFunctionApp.Location

            $functionAppDef.Reserved = $existingFunctionApp.Reserved                

        }

        # Set Application Insights

        $currentApplicationSettings = $existingFunctionApp.ApplicationSettings

        if ($ApplicationInsightsKey)

        {

            $currentApplicationSettings['APPINSIGHTS_INSTRUMENTATIONKEY'] = $ApplicationInsightsKey

        }

        elseif ($ApplicationInsightsName)

        {

            $params = GetParameterKeyValues -PSBoundParametersDictionary $PSBoundParameters `

                                            -ParameterList @("SubscriptionId", "HttpPipelineAppend", "HttpPipelinePrepend")

            $appInsightsProject = GetApplicationInsightsProject -Name $ApplicationInsightsName @params

            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

            }

            $currentApplicationSettings['APPINSIGHTS_INSTRUMENTATIONKEY'] = $appInsightsProject.InstrumentationKey

        }

        # Set app settings

        foreach ($appSettingName in $currentApplicationSettings.Keys)

        {

            $appSettingValue = $currentApplicationSettings[$appSettingName]

            $appSettings.Add((NewAppSetting -Name $appSettingName -Value $appSettingValue))

        }

        # Set Tag

        if ($Tag -and ($Tag.Count -gt 0))

        {

            $resourceTag = NewResourceTag -Tag $Tag

            $functionAppDef.Tag = $resourceTag

        }

        elseif ($existingFunctionApp.Tag.AdditionalProperties -and ($existingFunctionApp.Tag.AdditionalProperties.Count -gt 0))

        {

            $functionAppDef.Tag = $existingFunctionApp.Tag

        }

        # Set siteConfig properties: AlwaysOn, LinuxFxVersion, JavaVersion, PowerShellVersion

        $siteCofig.AlwaysOn = $existingFunctionApp.SiteConfig.AlwaysOn

        $siteCofig.LinuxFxVersion = $existingFunctionApp.SiteConfig.LinuxFxVersion            

        $siteCofig.JavaVersion = $existingFunctionApp.SiteConfig.JavaVersion

        $siteCofig.PowerShellVersion = $existingFunctionApp.SiteConfig.PowerShellVersion

        # Set the function app Kind

        $functionAppDef.Kind = $existingFunctionApp.Kind

        # Set app settings and site configuration

        $siteCofig.AppSetting = $appSettings

        $functionAppDef.Config = $siteCofig

        $PSBoundParameters.Add("SiteEnvelope", $functionAppDef)  | Out-Null

        if ($PsCmdlet.ShouldProcess($Name, "Updating function app"))

        {

            # Save the ErrorActionPreference

            $currentErrorActionPreference = $ErrorActionPreference

            $ErrorActionPreference = 'Stop'

            try

            {

                Az.Functions.internal\Set-AzFunctionApp @PSBoundParameters

            }

            catch

            {

                $errorMessage = GetErrorMessage -Response $_

                if ($errorMessage)

                {

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

                    ThrowTerminatingError -ErrorId "FailedToUdpateFunctionApp" `

                                            -ErrorMessage $errorMessage `

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

                                            -Exception $exception

                }

                throw $_

            }

            finally

            {

                # Reset the ErrorActionPreference

                $ErrorActionPreference = $currentErrorActionPreference

            }

        }

    }

}

# SIG # Begin signature block

# MIIjlgYJKoZIhvcNAQcCoIIjhzCCI4MCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB/ZNdgBlctBzTx

# kfdnocnbdnZOFvxehL6I2iVXthkWqKCCDYUwggYDMIID66ADAgECAhMzAAABiK9S

# 1rmSbej5AAAAAAGIMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ4WhcNMjEwMzAzMTgzOTQ4WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCSCNryE+Cewy2m4t/a74wZ7C9YTwv1PyC4BvM/kSWPNs8n0RTe+FvYfU+E9uf0

# t7nYlAzHjK+plif2BhD+NgdhIUQ8sVwWO39tjvQRHjP2//vSvIfmmkRoML1Ihnjs

# 9kQiZQzYRDYYRp9xSQYmRwQjk5hl8/U7RgOiQDitVHaU7BT1MI92lfZRuIIDDYBd

# vXtbclYJMVOwqZtv0O9zQCret6R+fRSGaDNfEEpcILL+D7RV3M4uaJE4Ta6KAOdv

# V+MVaJp1YXFTZPKtpjHO6d9pHQPZiG7NdC6QbnRGmsa48uNQrb6AfmLKDI1Lp31W

# MogTaX5tZf+CZT9PSuvjOCLNAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUj9RJL9zNrPcL10RZdMQIXZN7MG8w

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ1ODM4NjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# ACnXo8hjp7FeT+H6iQlV3CcGnkSbFvIpKYafgzYCFo3UHY1VHYJVb5jHEO8oG26Q

# qBELmak6MTI+ra3WKMTGhE1sEIlowTcp4IAs8a5wpCh6Vf4Z/bAtIppP3p3gXk2X

# 8UXTc+WxjQYsDkFiSzo/OBa5hkdW1g4EpO43l9mjToBdqEPtIXsZ7Hi1/6y4gK0P

# mMiwG8LMpSn0n/oSHGjrUNBgHJPxgs63Slf58QGBznuXiRaXmfTUDdrvhRocdxIM

# i8nXQwWACMiQzJSRzBP5S2wUq7nMAqjaTbeXhJqD2SFVHdUYlKruvtPSwbnqSRWT

# GI8s4FEXt+TL3w5JnwVZmZkUFoioQDMMjFyaKurdJ6pnzbr1h6QW0R97fWc8xEIz

# LIOiU2rjwWAtlQqFO8KNiykjYGyEf5LyAJKAO+rJd9fsYR+VBauIEQoYmjnUbTXM

# SY2Lf5KMluWlDOGVh8q6XjmBccpaT+8tCfxpaVYPi1ncnwTwaPQvVq8RjWDRB7Pa

# 8ruHgj2HJFi69+hcq7mWx5nTUtzzFa7RSZfE5a1a5AuBmGNRr7f8cNfa01+tiWjV

# Kk1a+gJUBSP0sIxecFbVSXTZ7bqeal45XSDIisZBkWb+83TbXdTGMDSUFKTAdtC+

# r35GfsN8QVy59Hb5ZYzAXczhgRmk7NyE6jD0Ym5TKiW5MIIHejCCBWKgAwIBAgIK

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

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAGIr1LWuZJt6PkAAAAA

# AYgwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIGYB

# B9QSAIUHnRxLqMCpoCcdZmhJLz+jvfCBgPWvT/LEMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEASCoPLv4QfRj7ryehcg6XSvKkRAjadiGdquQA

# Gb9nimF9sxh/WbSm1CrpAb1jVqmYDF4Z6GpbE+gyhPxRQzrMfFvQS5UKxCSRJQnR

# OxswV1kvFZ4KZWZELg83bmbpAsF01BcrIsLpZ7BGiB1ysPl+Ve8+7/9mBsckCzN0

# IjTtS3eUB16RlpTKrRN/NMaQB8maUThkRVRU9nueLnz0Kg4RVWm8Hmqfn2FOTT+c

# /MiuSauMBtTogILF14Y3G/FAB5GfKppwZr39Kr1rAzL+DeB518RLfp1es3rGAoqj

# wdChISOt7QlubH9FhwBbdPtYfzNqbwMVKBnZlFSPslttX38pRKGCEvEwghLtBgor

# BgEEAYI3AwMBMYIS3TCCEtkGCSqGSIb3DQEHAqCCEsowghLGAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFVBgsqhkiG9w0BCRABBKCCAUQEggFAMIIBPAIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCARkJY9eqWcIif0FOdvDXkiMkfoNtegVQE+

# 7MU/ohewGwIGXtVJutbqGBMyMDIwMDYxNzE1MjAzOC44MTZaMASAAgH0oIHUpIHR

# MIHOMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQL

# EyBNaWNyb3NvZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhh

# bGVzIFRTUyBFU046QjI5QS1FMzdELTY4RUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2Wggg5EMIIE9TCCA92gAwIBAgITMwAAATDYOFZkjDVG

# pAAAAAABMDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMDAeFw0xOTEyMTkwMTE1MDZaFw0yMTAzMTcwMTE1MDZaMIHOMQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3NvZnQg

# T3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046

# QjI5QS1FMzdELTY4RUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl

# cnZpY2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCxtfaXhKop/kFn

# gK6NmYPbqTUTTC5YHsCBcFAM66FX8R12RHJ4BJmFSvInpNAnNeCSM0iS2naOBFp9

# 8BUCRp7vQxZD7tAQaNqEVVZqxuDcJoINxT1zGg6jkpS7EsCqKOWjoaRTHtnV17BD

# ue/k3/H2EkrVnLFFy7j0bohQmC2k8jDsaJhOTs8gon8xhk5E9t8RClixXDS2UNfo

# 9kL4hFdjJwV0wCB2bQrd12VPfwcV6/lfQqBn4P9rBgsMIvVLhHdKB6YS+nD3JPU3

# fn11Ml7nKUAoryJCGVcUougngQZldYbghLmUOMtZDPZeqPofczHSiE+Y4stOmHJV

# I+Ajs3ONAgMBAAGjggEbMIIBFzAdBgNVHQ4EFgQUwY4pJ9R5Si5fb6kiuqViE822

# IzYwHwYDVR0jBBgwFoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljVGltU3RhUENBXzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNU

# aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAK

# BggrBgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAQEANkxPxt22AW2EjMGy2sRRLhin

# 1bjXvG57ri8L1WU7myOjDwpF9qI8HHe3Utd7xzADTzuiJIer2cpm1JUEKlll10W8

# TAFBoE+ZM9dvwtTJAbR1Sza1lqxIO2EsgQfXwNlKzZIGpmwUI+UVWsTAgwUoJfkj

# uz1oWyCyKwuqnen97pzUF5zJKS4QlwiHN0I3G/CP/bEJYTvtzeMdmRjkzzjyhLN4

# 2zleTPEVHNndsmzGQuYBfc0XEu21cCYs5kD1kII8wg71Cy7s0oASqeL7b4XPwAYn

# pcIzwa9HoP4T4+xwZtJ+FURzzVqs5MxQgLn4QuKsZLpE6F2bfva5wSaGfCQSDDCC

# BnEwggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcwMTIxMzY1

# NVoXDTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs/BOX9fp/

# aZRrdFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUdzgkTjnxh

# MFmxMEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAyWGBG8lhH

# hjKEHnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJyGiGKr0tk

# iVBisV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqxqPJ6Kgox

# 8NpOBpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4WnAEFTyJN

# AgMBAAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU1WM6XIox

# kPNDe3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0P

# BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9

# lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQu

# Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3Js

# MFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3Nv

# ZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwgaAG

# A1UdIAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIBFjFodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQuaHRtMEAG

# CCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8AUwB0AGEA

# dABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG4Jg/gXED

# PZ2joSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m87WtUVwgr

# UYJEEvu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/8jd9Wj8c

# 8pl5SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kpvLb9BOFw

# nzJKJ/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlKcWOdeyFt

# w5yjojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsiOCC1JeVk

# 7Pf0v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw4TtxCd9d

# dJgiCGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcunCaw5u+zG

# y9iCtHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1wC9UJyH3

# yKxO2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvHIa9Zta7c

# RDyXUHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2gUDXa7wkn

# HNWzfjUeCLraNtvTX4/edIhJEqGCAtIwggI7AgEBMIH8oYHUpIHRMIHOMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3Nv

# ZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBF

# U046QjI5QS1FMzdELTY4RUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAAxpZWpY9F5UFd4LqREthbhptdJmoIGD

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEF

# BQACBQDilDccMCIYDzIwMjAwNjE3MTAzMDUyWhgPMjAyMDA2MTgxMDMwNTJaMHcw

# PQYKKwYBBAGEWQoEATEvMC0wCgIFAOKUNxwCAQAwCgIBAAICB74CAf8wBwIBAAIC

# EfEwCgIFAOKViJwCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAK

# MAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQC2dlGEZ18l

# dYQwHufCB/OZVvY2Jzs2FqLIocM4NEodNPypCOmGxaEtNV1gfBvRtmsnIux9Dpwn

# 7JxnwdiMDhSAetzdOjHG0qPRKD9fIQfT9qIQFFVM35doNVGnpuxrBg1T98OvenIh

# t9ZqFGPBksO82qyux+pb5IzaXrd9ZdkHpDGCAw0wggMJAgEBMIGTMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABMNg4VmSMNUakAAAAAAEwMA0GCWCG

# SAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZI

# hvcNAQkEMSIEIGMsxy4XZ/95Jbpzegu6FxH/ye+PTfD1VOM7OikF+qChMIH6Bgsq

# hkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgq1DzJsW0UHduprWOYScvQUc3TrLx3Goy

# cA4rxowVQ40wgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT

# MwAAATDYOFZkjDVGpAAAAAABMDAiBCByQe5w/gbSN0VkHBLs09aX/L5IIt65+g1T

# 8Ab9cq7bZDANBgkqhkiG9w0BAQsFAASCAQCJLkZORAPS9mnddTSXN+XMqsrdPumO

# RlweeBcWXKW1Uq6tY4s5Tzhsef1AqJgiSaVw0aQfUtrt7B3rYIR06yRxM2mIU/7F

# RtJu+LcwSrl8vaE1BalOV0st2OOqYwtydn73yXdyH2Xn5h90RNYhu3AFyPG9iixp

# hkmnMphjXm5ICyDpDk7YBJ4xyGeqBXTvC5m7FAfsmB1ZRvKK4IebYiGorF+Zpn1+

# lH8NfSbVWIGjSoDhpBXOtqpeRsC4v3Aupcmob2irTOp/4PHyp3K1bP96ZhhhjVa1

# tvk64N8yHeHidMDQj/C3cwvcNHeSMzroXzFvAfzIjISR4TXUfPjmZseK

# SIG # End signature block