Az.PolicyInsights

2.0.0

PolicyInsights.Autorest/custom/Helpers.ps1

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

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

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

# http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code

# is regenerated.

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

using namespace System.Management.Automation.Language

# split scope into usable parts

function ParseScope {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param($scope)

    # validate args

    if (!$scope) {

        throw 'ParseScope(scope) argument error: scope must be provided.'

    }

    # Remove leading slash if there, conflicts with generated code

    $scope = $scope.TrimStart('/')

    $scopeType = ''

    $subId = ''

    $mgName = ''

    $rgName = ''

    $resource = ''

    $resNamespace = ''

    $resType = ''

    $resName = ''

    # check for likeness and extract useful values

    if (($scope -like 'providers/Microsoft.Management/managementGroups/*') -or ($scope -like 'Microsoft.Management/managementGroups/*') -or ($scope -like 'managementGroups/*')) {

        $scopeType = 'mgname'

        $mgName = ($scope -split 'managementGroups/')[1]

    }

    elseif ($scope -like 'subscriptions/*/resourceGroups/*/*') {

        $scopeType = 'resource'

        $temp = ($scope -split 'subscriptions/')[1]

        $temp = ($temp -split '/resourceGroups/')

        $subId = $temp[0]

        $temp = ($temp[1] -split '/providers/')

        $rgName = $temp[0]

        $temp = $temp[1] -split '/'

        if ($temp.Length -gt 2) {

            $resNamespace = $temp[0]

            $resType = $temp[1..($temp.Length-2)] -join '/'

            $resName = $temp[$temp.Length-1]

        }

        $resource = $scope

    }

    elseif ($scope -like 'subscriptions/*/resourceGroups/*') {

        $scopeType = 'rgname'

        $temp = ($scope -split 'subscriptions/')[1]

        $temp = ($temp -split '/resourceGroups/')

        $subId = $temp[0]

        $rgName = $temp[1]

    }

    elseif ($scope -like 'subscriptions/*') {

        $scopeType = 'subId'

        $subId = ($scope -split 'subscriptions/')[1]

    }

    else {

        throw 'Improper scope provided. Please change format.'

    }

    return @{

        Scope = $scope

        ScopeType = $scopeType

        SubscriptionId = $subId

        ManagementGroupName = $mgName

        ResourceGroupName = $rgName

        ResourceName = $resName

        Resource = $resource

        ResourceNamespace = $resNamespace

        ResourceType = $resType

    }

}

# convert various parameter input formats to policy-formatted hashtable suitable for autorest serializers

function ConvertParameterInput

{

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param ($InputObject)

    # traverse collections to ensure nested values are all processed

    if ($InputObject -is [hashtable]) {

        $returnValue = @{}

        foreach ($key in $InputObject.Keys) {

            $returnValue[$key] = (ConvertParameterInput $InputObject[$key])

        }

        return $returnValue

    }

    elseif ($InputObject -is [array]) {

        $returnValue = @()

        foreach ($object in $InputObject) {

            $returnValue += (ConvertParameterInput $object)

        }

        return ,$returnValue

    }

    elseif ($InputObject -is [PSObject])

    {

        $returnValue = @{}

        foreach ($property in $InputObject.PSObject.Properties) {

            $returnValue[$property.Name] = (ConvertParameterInput $property.Value)

        }

        return $returnValue

    }

    else {

        return $InputObject

    }

}

# Wrapper for JSON -> PSObject conversion that works on both Core and Desktop editions

function ConvertFrom-JsonSafe

{

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param(

        [Parameter(ValueFromPipeline)]

        $InputObject,

        [switch]$AsHashtable = $false

    )

    if ($PSVersionTable.PSEdition -eq 'Core') {

        ConvertFrom-Json $InputObject -AsHashtable:$AsHashtable

    }

    elseif ($AsHashtable) {

        # ConvertFrom-Json on Windows Powershell doesn't support -AsHashtable parameter

        $converted = ConvertParameterInput ($InputObject | ConvertFrom-Json)

        if (($converted -is [array]) -and ($converted.Count -eq 1)) {

            return $converted[0]

        }

        else {

            return $converted

        }

    }

    else {

        ConvertFrom-Json $InputObject

    }

}

# tests whether the given string is a Uri

function Test-Uri {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param([string]$Value)

    $uri = ''

    [System.Uri]::TryCreate($Value, [System.UriKind]::Absolute, [ref]$uri)

}

# issues a GET to the given address and returns the contents

function Get-UriContent {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param([string]$UriAddress)

    $response = Invoke-WebRequest $UriAddress -DisableKeepAlive -Method Get

    if ($response.StatusCode -eq 200) {

        return $response.Content

    }

}

# if the given string is a file path or URI, returns the contents of the file or web page

# otherwise returns the original string

function GetFileUriOrStringParameterValue {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param([string]$parameterValue)

    # Test-Path can throw on bad input, but we just want to move to the next check if it does 

    try {

        if (Test-Path $parameterValue) {

            return Get-Content $parameterValue | Out-String

        }

    }

    catch {

        # if error, want to handle exactly same as path not being valid by continuing

    }

    if (Test-Uri $parameterValue) {

        return Get-UriContent $parameterValue

    }

    else {

        return $parameterValue

    }

}

# Recursive conversion function for common AST blocks from parsing

function Convert-AstLiteral {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param([Ast] $Node)

    # ensure Node isn't null before checking type in switch 

    if ($null -eq $Node) {

        return $null

    }

    switch ($Node) {

        # Numbers, $true/$false/$null

        { $_.GetType() -eq [ConstantExpressionAst] } { return $_.Value }

        # Strings like "text" or 'text'

        { $_.GetType() -eq [StringConstantExpressionAst] } { return $_.Value }

        { $_.GetType() -eq [ExpandableStringExpressionAst] } { return $_.Value }

        # This node type is essentially a wrapper node for an array

        { $_.GetType() -eq [ArrayExpressionAst] } {

            $arr = @()

            foreach ($e in $_.SubExpression.Statements) {

                $arr += Convert-AstLiteral $e

            }

            return $arr

        }

        # Arrays: @( ... )

        { $_.GetType() -eq [ArrayLiteralAst] } {

            $arr = @()

            foreach ($e in $_.Elements) {

                $arr += Convert-AstLiteral $e

            }

            return $arr

        }

        # Nested hashtables 

        { $_.GetType() -eq [HashtableAst] } {

            $h = @{}

            foreach ($kv in $_.KeyValuePairs) {

                $k = $kv.Item1.Value

                $h[$k] = Convert-AstLiteral $kv.Item2

            }

            return $h

        }

        # Case where a literal is wrapped in a pipeline

        { $_.GetType() -eq [PipelineAst] } {

            if ($_.PipelineElements.Count -eq 1) {

                return Convert-AstLiteral $_.PipelineElements[0].Expression

            }

            else {

                throw "Pipeline contains multiple elements, expected a single literal expression when parsing PSCustomObject."

            }

        }

        # Handles variables such as $null, $true, $false

        { $_.GetType() -eq [VariableExpressionAst] } {

            if ($_.VariablePath.IsVariable) {

                return $_.VariablePath.UserPath

            }

            else {

                throw "Unsupported variable path for safe conversion: $($_.VariablePath.ToString()). Unable to parse PSCustomObject."

            }

        }

        # Handles the case where a literal gets tokenized as a MemberExpressionAst - returns the string representation of the token

        { $_.GetType() -eq [MemberExpressionAst] } {

            return $_.Extent.Text

        }

        default {

            # Anything else is not allowed

            throw "Unsupported AST node for safe conversion: $($_.GetType().Name). Value: $($_.ToString()). Unable to parse PSCustomObject."

        }

    }

}

# Safely converts a string representation of a hashtable or PSCustomObject into a hashtable

function ConvertTo-HashtableSafely {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param(

        [Parameter(Mandatory)]

        [string] $InputObject

    )

    # Adding quotes to unquoted strings, datetimes, etc. to avoid parsing errors

    $fixedInput = $InputObject -replace '(?m)(=\s*)([a-zA-Z_][\w\-\.:/]*|\d{1,2}:\d{2}:\d{2}|\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}:\d{2}Z?)?|\d{1,2}/\d{1,2}/\d{4}(?:\s+\d{1,2}:\d{2}:\d{2})?|\d{4}/\d{2}/\d{2}(?:\s+\d{1,2}:\d{2}:\d{2})?)(\s*[\r\n;}]|$)', '$1"$2"$3'

    $tokens = $null; $errors = $null

    $ast = [Parser]::ParseInput($fixedInput, [ref]$tokens, [ref]$errors)

    if ($errors -and $errors.Count -gt 0) {

        throw "Invalid PSCustomObject or hashtable literal: $($errors[0].Message)"

    }

    # Find the first expression in the script

    $expr = $ast.EndBlock.Statements | ForEach-Object {

        $_.PipelineElements | ForEach-Object { $_.Expression }

    } | Select-Object -First 1

    if (-not ($expr -is [HashtableAst])) {

        throw "Top-level expression is not a hashtable. It is of type: $($expr.GetType())"

    }

    return Convert-AstLiteral $expr

}

# Returns metadata property as hashtable, extracting from file when necessary

function ResolvePolicyMetadataParameter {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param(

        $MetadataValue,

        [bool]$Debug = $false

    )

    if ($metadataValue -is [hashtable]) {

        return $metadataValue

    }

    if ([System.String]::IsNullOrEmpty($metadataValue)) {

        return $metadataValue

    }

    # This function will usually be passed a string, but can have an issue if passed a PSCustomObject that isn't converted to string

    if ($MetadataValue -isnot [string]) {

        $MetadataValue = $MetadataValue | ConvertTo-Json -Depth 30

    }

    $metadata = (GetFileUriOrStringParameterValue $metadataValue).Trim()

    if ($debug) {

        Write-Host -ForegroundColor Cyan Metadata: $metadata

    }

    if ($metadata -like '@{*') {

        # probably a PSCustomObject, try converting to hashtable

        return ConvertTo-HashtableSafely -InputObject $metadata

    }

    # otherwise it should be a JSON string

    if ($metadata -like '{*}') {

        return $metadata | ConvertFrom-JsonSafe -AsHashtable

    }

    throw "Unrecognized metadata format - value: [$($metadataValue)], type: [$($metadataValue.GetType())]"

}

# Returns a subset of the given parameters, copying scope, name, and common parameters into a new hashtable

function RemoveNonIdentifyingParameters {

    [Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.DoNotExportAttribute()]

    param(

        $InputParameterDictionary

    )

    $outputParameterDictionary = @{}

    # transfer name parameter

    $outputParameterDictionary['Name'] = $InputParameterDictionary['Name']

    # transfer scope parameters

    $scopeParams = @('ResourceGroupName', 'SubscriptionId', 'ResourceId', 'ManagementGroupId')

    foreach ($param in $scopeParams) {

        if ($InputParameterDictionary.ContainsKey($param)) {

            $outputParameterDictionary[$param] = $InputParameterDictionary[$param]

        }

    }

    # transfer common parameters

    $commonParams = @('Verbose', 'Debug', 'ErrorAction', 'WarningAction', 'InformationAction', 'ErrorVariable', 'WarningVariable', 'InformationVariable', 'OutVariable', 'OutBuffer', 'PipelineVariable')

    foreach ($param in $commonParams) {

        if ($InputParameterDictionary.ContainsKey($param)) {

            $outputParameterDictionary[$param] = $InputParameterDictionary[$param]

        }

    }

    return $outputParameterDictionary

}

# SIG # Begin signature block

# MIIncQYJKoZIhvcNAQcCoIInYjCCJ14CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCD6YLQDrQeSNQov

# 8W+oTlbMir7NkgV84tPubqkCh5wohKCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghn+MIIZ+gIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZI

# hvcNAQkEMSIEIIkNIn7BVXZx3n+/nw4A6H5q+8RjoudClUmMYWc04+v2MEIGCisG

# AQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAIUk5UA0aPrj5Z1I+lPns

# CVbdzF0YmV59qzBDfC8hMzOMBxOy2nODsJ/Pjn6WbNVQKy5a1XADXt5G2DjbZB/Z

# ATH/ZgJC8ryRtpdoNa+41k6HnFXdBA8thEaNv0QfHlmfFTsCm1TGqiXTeGgnwgT3

# RA69YzTq+Eaq5ZGQBPFVgNkssV/jszQQ0WSAOci8xpJnLraOHoPI9Mp+X4AotiGG

# Q6gcYlHRK/yFulVXunADv5uFLOl5v4XAnAaUx5WZRmXqd1eAuPGTKoq7JN0yccK3

# IG6UrbhEVRCrYPhB9WMvf0VFeEeqFwJIyB67qMKh6ecGsjQcL+RIkobNurRr1Dgx

# EqGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kwgheF

# AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIB

# QQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCA7CDW0O42jpV/AjYga

# GJVJYOis2QodLswVERbLQ2QksQIGahBLb3jJGBMyMDI2MDUyNzEwMjMzNy4zNTNa

# MASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2QjA1LTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIFEKAD

# AgECAhMzAAACEUUYOZtDz/xsAAEAAAIRMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgxM1oXDTI2MTExMzE4

# NDgxM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTAr

# BgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUG

# A1UECxMeblNoaWVsZCBUU1MgRVNOOjZCMDUtMDVFMC1EOTQ3MSUwIwYDVQQDExxN

# aWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOC

# Ag8AMIICCgKCAgEAz7m7MxAdL5Vayrk7jsMo3GnhN85ktHCZEvEcj4BIccHKd/NK

# C7uPvpX5dhO63W6VM5iCxklG8qQeVVrPaKvj8dYYJC7DNt4NN3XlVdC/voveJuPP

# hTJ/u7X+pYmV2qehTVPOOB1/hpmt51SzgxZczMdnFl+X2e1PgutSA5CAh9/Xz5NW

# 0CxnYVz8g0Vpxg+Bq32amktRXr8m3BSEgUs8jgWRPVzPHEczpbhloGGEfHaROmHh

# VKIqN+JhMweEjU2NXM2W6hm32j/QH/I/KWqNNfYchHaG0xJljVTYoUKPpcQDuhH9

# dQKEgvGxj2U5/3Fq1em4dO6Ih04m6R+ttxr6Y8oRJH9ZhZ3sciFBIvZh7E2YFXOj

# P4MGybSylQTPDEFAtHHgpkskeEUhsPDR9VvWWhekhQx3qXaAKh+AkLmz/hpE3e0y

# +RIKO2AREjULJAKgf+R9QnNvqMeMkz9PGrjsijqWGzB2k2JNyaUYKlbmQweOabsC

# ioiY2fJbimjVyFAGk5AeYddUFxvJGgRVCH7BeBPKAq7MMOmSCTOMZ0Sw6zyNx4Uh

# h5Y0uJ0ZOoTKnB3KfdN/ba/eKHFeEhi3WqAfzTxiy0rMvhsfsXZK7zoclqaRvVl8

# Q48J174+eyriypY9HhU+ohgiYi4uQGDDVdTDeKDtoC/hD2Cn+ARzwE1rFfECAwEA

# AaOCAUkwggFFMB0GA1UdDgQWBBRifUUDwOnqIcvfb53+yV0EZn7OcDAfBgNVHSME

# GDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1l

# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsG

# AQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01p

# Y3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB

# Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDAN

# BgkqhkiG9w0BAQsFAAOCAgEApEKdnMeIIUiU6PatZ/qbrwiDzYUMKRczC4Bp/XY1

# S9NmHI+2c3dcpwH2SOmDfdvIIqt7mRrgvBPYOvJ9CtZS5eeIrsObC0b0ggKTv2wr

# TgWG+qktqNFEhQeipdURNLN68uHAm5edwBytd1kwy5r6B93klxDsldOmVWtw/ngj

# 7knN09muCmwr17JnsMFcoIN/H59s+1RYN7Vid4+7nj8FcvYy9rbZOMndBzsTiosF

# 1M+aMIJX2k3EVFVsuDL7/R5ppI9Tg7eWQOWKMZHPdsA3ZqWzDuhJqTzoFSQShnZe

# nC+xq/z9BhHPFFbUtfjAoG6EDPjSQJYXmogja8OEa19xwnh3wVufeP+ck+/0gxNi

# 7g+kO6WaOm052F4siD8xi6Uv75L7798lHvPThcxHHsgXqMY592d1wUof3tL/eDaQ

# 0UhnYCU8yGkU2XJnctONnBKAvURAvf2qiIWDj4Lpcm0zA7VuofuJR1Tpuyc5p1ja

# 52bNZBBVqAOwyDhAmqWsJXAjYXnssC/fJkee314Fh+GIyMgvAPRScgqRZqV16dTB

# Yvoe+w1n/wWs/ySTUsxDw4T/AITcu5PAsLnCVpArDrFLRTFyut+eHUoG6UYZfj8/

# RsuQ42INse1pb/cPm7G2lcLJtkIKT80xvB1LiaNvPTBVEcmNSvFUM0xrXZXcYcxV

# XiYwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEB

# CwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYD

# VQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAe

# Fw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGm

# TOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/H

# ZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc

# wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62A

# W36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1w

# jjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCG

# MFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ

# 1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP

# 8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFz

# ymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHz

# NgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3

# xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsG

# AQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/

# LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG

# DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYB

# BQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8G

# A1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQw

# VgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9j

# cmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUF

# BwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3Br

# aS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQEL

# BQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfC

# cTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AF

# vonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l

# 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn

# 8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5m

# O0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyx

# TkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4

# S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9

# y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM

# +Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhw

# RNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCCAkEC

# AQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2QjA1LTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIa

# AxUAKyp8q2VdgAq1VGkzd7PZwV6zNc2ggYMwgYCkfjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO3AuEUwIhgPMjAyNjA1Mjcw

# MDI0MzdaGA8yMDI2MDUyODAwMjQzN1owdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA

# 7cC4RQIBADAKAgEAAgIILwIB/zAHAgEAAgIT2zAKAgUA7cIJxQIBADA2BgorBgEE

# AYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYag

# MA0GCSqGSIb3DQEBCwUAA4IBAQA/6SkEYWMpy9uOz/5ztNPQNpaib6ThRJ+mO4ch

# 7zQKSVcOPdFFZaUeJkvturMOXbhIu7GZLobx2/mpdUCE8T1Lu5ghtgxxHcvXU6yf

# 14I1ZF4lQ3LDKPyqJhhWyB+L9q+enZhzMW0d6ZiwWnj8mFxPiYwqP57VKunt5eRX

# vcFHasVv4i5o2+27XQ++phNIa7MJqgUZzVovEi+kfY9OEg8muTUSl7ODvAjfXK1M

# gxMHdFxJFCnYeAcxp2qiYtJ9JM6D9KdwhyvAYA4a4H/VsdIORbgCDqHvBas8fOwG

# ObuK71aic73gt9SC976hcmy0py8MVVZ1RPx35+xkbnSv/F8iMYIEDTCCBAkCAQEw

# gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIRRRg5m0PP/GwA

# AQAAAhEwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B

# CRABBDAvBgkqhkiG9w0BCQQxIgQg5F2GDCV2htrsUkKWORzzcmKDRo4BUiSQpTIO

# eMbj6vcwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAsrTOpmu+HTq1aXFwv

# lhjF8p2nUCNNCEX/OWLHNDMmtzCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAACEUUYOZtDz/xsAAEAAAIRMCIEICRbcIjgYTppqX1Rrsxa

# jDDlshbwSoFhpIz91cqyU5UsMA0GCSqGSIb3DQEBCwUABIICAMB9k0EMf+D8YSIR

# 5u3d8f9JIbI+2eyplzkFHX9e2RIFhh9vp7caRbmhEVaznY5qpDmkpxzg+VtqfRBn

# fllSnFa5B/mEvYnPTfwdLnuE69bSmYFcgPbfIm5I3DEqoO9p1JRkmoJH/DuGb+PO

# 2zNCdeEQVDotZfQguHXxW2kf8hGcjvz+YN5P7JAzxF9rLEFNG4Rszc+KcZNA3T7D

# HP9EVfk144Af44A3mwMA1lfCvkzX21FFD88sdHMxZ5Lp/Qp7C0FBe0rQKDNRtMBG

# PzCmByhpkNQCs4SN/t/iN6K7879NU6/CMupiIzsw0vc5BFm2JgFtY7ae2TZW2OJl

# 6WwAFFBSq87cE1TQVQ+WlBu7K1CxiEG/oV8Tkd8iBvpSyhBXChA4JZCs3Sc1YkYs

# pm48hNAqHPgYuG400TBHAp9zPObYdFRolqEijEMpZuQja/6TpFiviGrhEzQEzZ0e

# 78xTuMcvRPPQc8nos7T1T2swcRj8E9TjNf5ySjy01CbZjTdboLRXIltt2llEvuB5

# /qPoIb/vH88S6HzH+pyr5xwDo8uEKMeITd7SBccnEKbCDZicGfNMQqKv2WXhL6cQ

# cHyCAZqDCK0ASZj8A/CnSeSeCwEXBJa3YWXxa8iy4eX05BiH7TpzKQX/Z0bU56m8

# /QALsUAcTIqpFufSDdHuTyENcpY/

# SIG # End signature block