Az.Resources

10.2.2

Policy.Autorest/custom/Update-AzPolicyAssignment.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.

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

<#

.Synopsis

This operation updates a policy assignment with the given scope and name.

Policy assignments apply to all resources contained within their scope.

For example, when you assign a policy at resource group scope, that policy applies to all resources in the group.

.Description

This operation updates a policy assignment with the given scope and name.

Policy assignments apply to all resources contained within their scope.

For example, when you assign a policy at resource group scope, that policy applies to all resources in the group.

.Notes

## RELATED LINKS

[Get-AzPolicyAssignment](./Get-AzPolicyAssignment.md)

[New-AzPolicyAssignment](./New-AzPolicyAssignment.md)

[Remove-AzPolicyAssignment](./Remove-AzPolicyAssignment.md)

.Link

https://learn.microsoft.com/powershell/module/az.resources/update-azpolicyassignment

#>

function Update-AzPolicyAssignment {

[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Policy.Models.IPolicyAssignment])]

[Alias('Set-AzPolicyAssignment')]

[CmdletBinding(DefaultParameterSetName='Name', SupportsShouldProcess=$true, ConfirmImpact='Low')]

param(

    [Parameter(ParameterSetName='Name', Mandatory, ValueFromPipelineByPropertyName)]

    [Parameter(ParameterSetName='NameParameterObject', Mandatory, ValueFromPipelineByPropertyName)]

    [Parameter(ParameterSetName='NameParameterString', Mandatory, ValueFromPipelineByPropertyName)]

    [ValidateNotNullOrEmpty()]

    [Alias('PolicyAssignmentName')]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Category('Path')]

    [System.String]

    # The name of the policy assignment.

    ${Name},

    [Parameter(ParameterSetName='Name', ValueFromPipelineByPropertyName)]

    [Parameter(ParameterSetName='NameParameterObject', ValueFromPipelineByPropertyName)]

    [Parameter(ParameterSetName='NameParameterString', ValueFromPipelineByPropertyName)]

    [ValidateNotNullOrEmpty()]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Category('Path')]

    [System.String]

    # The scope of the policy assignment.

    # Valid scopes are: management group (format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), subscription (format: '/subscriptions/{subscriptionId}'), resource group (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'), or resource (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

    ${Scope},

    [Parameter(ValueFromPipelineByPropertyName)]

    [AllowEmptyCollection()]

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

    [System.String[]]

    # The policy's excluded scopes.

    ${NotScope},

    [Parameter(ParameterSetName='Id', Mandatory, ValueFromPipeline)]

    [Parameter(ParameterSetName='IdParameterObject', Mandatory, ValueFromPipeline)]

    [Parameter(ParameterSetName='IdParameterString', Mandatory, ValueFromPipeline)]

    [ValidateNotNullOrEmpty()]

    [Alias('PolicyAssignmentId')]

    [Alias('ResourceId')]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Category('Path')]

    [System.String]

    # The ID of the policy assignment to update.

    # Use the format '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

    ${Id},

    [Parameter(ValueFromPipelineByPropertyName)]

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

    [System.String]

    # The display name of the policy assignment.

    ${DisplayName},

    [Parameter(ValueFromPipelineByPropertyName)]

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

    [System.String]

    # This message will be part of response in case of policy violation.

    ${Description},

    [Parameter(ValueFromPipelineByPropertyName)]

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

    [System.String]

    # The policy assignment metadata.

    # Metadata is an open ended object and is typically a collection of key value pairs.

    ${Metadata},

    [Parameter(ParameterSetName='NameParameterObject', Mandatory)]

    [Parameter(ParameterSetName='IdParameterObject', Mandatory)]

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

    [PSCustomObject]

    # The parameter values for the assigned policy rule.

    # The keys are the parameter names.

    ${PolicyParameterObject},

    [Parameter(ParameterSetName='NameParameterString', Mandatory, ValueFromPipelineByPropertyName)]

    [Parameter(ParameterSetName='IdParameterString', Mandatory, ValueFromPipelineByPropertyName)]

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

    [System.String]

    # The parameter values for the assigned policy rule.

    # The keys are the parameter names.

    ${PolicyParameter},

    [Parameter(ValueFromPipelineByPropertyName)]

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

    [ArgumentCompleter({ LocationCompleter })]

    [System.String]

    # The location of the policy assignment.

    # Only required when utilizing managed identity.

    ${Location},

    [Parameter(ValueFromPipelineByPropertyName)]

    [ValidateNotNullOrEmpty()]

    [ValidateSet('Default', 'DoNotEnforce', 'Enroll')]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.PSArgumentCompleterAttribute('Default', 'DoNotEnforce', 'Enroll')]

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

    [System.String]

    # The policy assignment enforcement mode.

    # Possible values are Default, DoNotEnforce, and Enroll.

    ${EnforcementMode},

    [Parameter()]

    [ValidateSet('None', 'SystemAssigned', 'UserAssigned')]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.PSArgumentCompleterAttribute('None', 'SystemAssigned', 'UserAssigned')]

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

    [System.String]

    # The identity type.

    # This is the only required field when adding a system or user assigned identity to a resource.

    ${IdentityType},

    [Parameter()]

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

    [System.String]

    # The user identity associated with the policy.

    # The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

    ${IdentityId},

    [Parameter(ValueFromPipelineByPropertyName)]

    [AllowEmptyCollection()]

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

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Runtime.Info(PossibleTypes=([Microsoft.Azure.PowerShell.Cmdlets.Policy.Models.INonComplianceMessage[]]))]

    [PSCustomObject[]]

    # The messages that describe why a resource is non-compliant with the policy.

    # To construct, see NOTES section for NONCOMPLIANCEMESSAGE properties and create a hash table.

    ${NonComplianceMessage},

    [Parameter(ParameterSetName = 'InputObject', Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Models.IPolicyAssignment]

    ${InputObject},

    [Parameter()]

    [AllowEmptyCollection()]

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

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Models.IOverride[]]

    # The policy property value override.

    ${Override},

    [Parameter()]

    [AllowEmptyCollection()]

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

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.Models.IResourceSelector[]]

    # The resource selector list to filter policies by resource properties.

    ${ResourceSelector},

    [Parameter()]

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

    [ValidateNotNull()]

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

    [System.Management.Automation.PSObject]

    # The DefaultProfile parameter is not functional.

    # Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

    ${DefaultProfile},

    [Parameter(DontShow)]

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

    [System.Management.Automation.SwitchParameter]

    # Wait for .NET debugger to attach

    ${Break},

    [Parameter(DontShow)]

    [ValidateNotNull()]

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

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

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

    ${HttpPipelineAppend},

    [Parameter(DontShow)]

    [ValidateNotNull()]

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

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

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

    ${HttpPipelinePrepend},

    [Parameter(DontShow)]

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

    [System.Uri]

    # The URI for the proxy server to use

    ${Proxy},

    [Parameter(DontShow)]

    [ValidateNotNull()]

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

    [System.Management.Automation.PSCredential]

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

    ${ProxyCredential},

    [Parameter(DontShow)]

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

    [System.Management.Automation.SwitchParameter]

    # Use the default credentials for the proxy

    ${ProxyUseDefaultCredentials}

)

begin {

    # turn on console debug messages

    $writeln = ($PSCmdlet.MyInvocation.BoundParameters.Debug -as [bool]) -or ($PSCmdlet.MyInvocation.BoundParameters.Verbose -as [bool])

    if ($writeln) {

        Write-Host -ForegroundColor Cyan "begin:Update-AzPolicyAssignment(" $PSBoundParameters ") - (ParameterSet: $($PSCmdlet.ParameterSetName))"

    }

}

process {

    if ($writeln) {

        Write-Host -ForegroundColor Cyan "process:Update-AzPolicyAssignment(" $PSBoundParameters ") - (ParameterSet: $($PSCmdlet.ParameterSetName))"

    }

    # Id can be a parameter or from the input object

    if ($Id) {

        $thisId = $Id

    }

    else {

        $thisId = $InputObject.Id

    }

    # client side parameter validation

    if (!$Location -and $IdentityType -and ($IdentityType -ne 'None')) {

        throw 'Location needs to be specified if a managed identity is to be assigned to the policy assignment.'

    }

    if ($IdentityType -eq 'SystemAssigned' -and $IdentityId) {

        throw "Cannot specify an identity ID if identity type is 'SystemAssigned'."

    }

    if ($IdentityType -eq 'UserAssigned' -and !$IdentityId) {

        throw "A user assigned identity id needs to be specified if the identity type is 'UserAssigned'."

    }

    # construct id for assignment to update

    $resolved = ResolvePolicyAssignment $Name $Scope $thisId

    $getParameters = Get-ExtraParameters @PSBoundParameters

    $getParameters['Id'] = $resolved.ResourceId

    if ($writeln) {

        Write-Host -ForegroundColor Blue -> Get-AzPolicyAssignment'(' $getParameters ')'

    }

    try {

        $existing = Get-AzPolicyAssignment @getParameters

    }

    catch {

        # treat any error on get as nonexistent

        if ($writeLn) {

            Write-Host -ForegroundColor DarkGray 'Swallowed exception: ' $_

        }

    }

    if (!$existing) {

        throw "[PolicyAssignmentNotFound] : The policy assignment '$($resolved.ResourceId)' is not found."

    }

    $calledParameters = @{}

    # populate called parameters from input object if present (these will be overridden by command-line values below)

    if ($InputObject) {

        foreach ($parameterName in $InputObject.Keys) {

            $value = $InputObject.($parameterName)

            if ($value -or ($value -is [array]) -or ($value -is [switch])) {

                $calledParameters.($parameterName) = $value

            }

        }

    }

    # skip $null and empty values to avoid validation failures on pipeline input

    foreach ($parameterName in $PSBoundParameters.Keys) {

        $value = $PSBoundParameters.($parameterName)

        if ($value -or ($value -is [array]) -or ($value -is [switch])) {

            $calledParameters.($parameterName) = $value

        }

    }

    # supply required parameters and remove custom parameters

    $calledParameters.Name = $resolved.Name

    $calledParameters.Scope = $resolved.Scope

    $null = $calledParameters.Remove('Id')

    $null = $calledParameters.Remove('InputObject')

    # policy definition can't be updated, so make it from existing Id

    $calledParameters.PolicyDefinition = [PSCustomObject]@{ Id = $existing.PolicyDefinitionId }

    # make a 3-way merge of updateable parameters

    if (!$NonComplianceMessage) {

        if ($_.NonComplianceMessage) {

            $calledParameters.NonComplianceMessage = $_.NonComplianceMessage

        }

        elseif ($existing.NonComplianceMessage) {

            $calledParameters.NonComplianceMessage = $existing.NonComplianceMessage

        }

    }

    if (!$PolicyParameterObject -and !$PolicyParameter) {

        if ($_.Parameter) {

            $calledParameters.PolicyParameter = ConvertTo-Json $_.Parameter -Depth 100 

        }

        elseif ($existing.Parameter) {

            $calledParameters.PolicyParameter = ConvertTo-Json $existing.Parameter -Depth 100 

        }

    }

    if (!$NotScope -and !($NotScope -is [array])) {

        $calledParameters.NotScope = $existing.NotScope

    }

    if (!$Location) {

        if ($_.Location) {

            $calledParameters.Location = $_.Location

        }

        elseif ($existing.Location) {

            $calledParameters.Location = $existing.Location

        }

    }

    if (!$calledParameters.DisplayName) {

        $calledParameters.DisplayName = $existing.DisplayName

    }

    if (!$calledParameters.Description) {

        $calledParameters.Description = $existing.Description

    }

    if (!$calledParameters.Metadata) {

        $calledParameters.Metadata = $existing.Metadata

    }

    if ($calledParameters.Metadata -is [PSCustomObject]) {

        $calledParameters.Metadata = $calledParameters.Metadata | ConvertTo-Json -Depth 30

    }

    if (!$calledParameters.EnforcementMode -and $calledParameters.EnforcementMode) {

        $calledParameters.EnforcementMode = $existing.EnforcementMode

    }

    if ($writeln) {

        Write-Host -ForegroundColor Blue -> New-AzPolicyAssignment'(' $calledParameters ')'

    }

    New-AzPolicyAssignment @calledParameters

}

end {

} 

}

# SIG # Begin signature block

# MIInSAYJKoZIhvcNAQcCoIInOTCCJzUCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBhHXNsaD/Lqayj

# QL37NMn5iXed9cu17002XbYrjYWnPKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1

# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8

# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg

# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4

# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R

# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk

# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw

# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg

# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0

# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh

# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9

# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H

# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3

# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n

# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs

# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo

# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb

# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6

# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z

# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v

# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs

# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA

# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl

# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow

# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo

# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh

# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h

# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd

# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp

# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t

# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5

# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs

# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK

# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5

# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW

# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ

# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC

# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB

# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI

# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4

# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh

# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q

# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU

# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb

# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z

# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u

# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW

# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV

# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnkMIIZ4AIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYK

# KwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIGG03ygS

# StqRNdX8H+Jo3lRhHAV73aenLgs8a6q4kIWXMEIGCisGAQQBgjcCAQwxNDAyoBSA

# EgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20w

# DQYJKoZIhvcNAQEBBQAEggEAF2zZelN+nMQCdWhyc53htNwlQNTZO3Ky1JSy75IH

# blqYulU4aZpMaICGDiOTHPOImAav/dAknbmeKfvyhRPDXf6MTW7Y+3/nBnnMMShA

# uqJkeW7rz+mctjajjaCKZ44V0cESvrJyfo6BSDWSqlAt9VxL/MEpGq8BbTYalgk2

# pIhLfNuekBm8hb9P0lnSf/QaNOnPmI3Tou8SmZ/zJOJHvYd64HNlMIjrkf0aDftZ

# r37MHgAzSVNnPwcqaSZuaZFrm1pnE7Tsf81sFuty24sD6LJSLaNl+9xgAFaozUtp

# 1MByqt/MZWXrJBVHgTVIoCiNQ93xzGEOWoT+mCs7ekhSB6GCF5YwgheSBgorBgEE

# AYI3AwMBMYIXgjCCF34GCSqGSIb3DQEHAqCCF28wghdrAgEDMQ8wDQYJYIZIAWUD

# BAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoD

# ATAxMA0GCWCGSAFlAwQCAQUABCBUKSzwnRoFWL7EoKQ6PhdacOl9oghTPb99jJDi

# EgcTKQIGaqqP1swJGBIyMDI2MTAyODAwNDM1MC43OFowBIACAfSggdGkgc4wgcsx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p

# Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNT

# IEVTTjpGMDAyLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgU2VydmljZaCCEe0wggcgMIIFCKADAgECAhMzAAACICTh5uAXubSOAAEAAAIg

# MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4X

# DTI2MDIxOTE5Mzk1MloXDTI3MDUxNzE5Mzk1MlowgcsxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh

# IE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjpGMDAyLTA1RTAt

# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIw

# DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANFhjvKvuKNboJHXvy4q94gy5+61

# Y6JzGAnAo5x7/YY5Bx66zplZ9fXiLeM2Dck4/swYkyQ4C5zBYHCIDxRGn5liQaOl

# WhWQZmxXbtaOovCl/YDCoGwn9POrATskUVrG6nct3GPwaN0nKYMVGt1U3+lgegEW

# uMPUiQgO7xvUJafy2CiaIpFJj5JO8mr32ZWR2mEwEhQY56BCfLypF3bhUwTTGLw6

# iaSz1mr0SMN4ocam8BtdQRDqbdxE6gQ+FMT+aLB5Af1Oom3cg6yo+/cvy6uiMHvj

# tcELbLQIMgeUotwuXdkbwPslcqdZMV6feaww8mly+tDfNQFUmsf+YjdHEeYKH2mk

# M/S4bX48nCTof/H6x+gb2FbrjGheSnHoMR81k19xd0ptcXbxcRd0s2fOjdIs1XKZ

# 5AmE2o5IqGdTzhCcqauMSTnjUmK6uUMKQJY72VQFQxv3HSfJ9dRs1E9UuA/49MxF

# 1c6jAl1gLMJB83ZmovSzhgjbwXUNufsGDDYTg/UT26ey8zMke3OFLZOHdOkJ8Fs4

# ZqUiUX3H8Mln+yyb/LLNP1i0gV6qZ83EE9MTdo66HofGZMgLN9gABO9Y2EFujX1D

# CyM94D0m+GpMsLYpQ2CteugbLh4NmjSfuMViNmRSKHVPL7wTqoS9XY1rpnmBTIPl

# r60cYOarr0KZSId/AgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQU28ic4IiHEYDyZjuX

# WDTtQe/I2DMwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0f

# BFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwv

# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsG

# AQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx

# MCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAK0oYG2jUFK+bhYUj4nQ

# 1LJWFTUscvsXd9uNnZ3sXkqf8UJMFlenOsNWXrcUtE1wgWmcnLj+eWDjevtPmwk9

# 2jgyzwANIdAQmcdK7fH1SmMLNEQE+L36ceG8OBHH/VaYEPqBBRkks6Fw3ZPFbgon

# KGKcy2IEW2Q1Fna+ZnUwB01dObl3QvCTfDOP79/tUIJNYJclKio1rdVT/qwAIcj3

# sS9ufODxt3eHGt/PoJwJW5/vt6C9EeKe2Em7BJF48/tpWZx69vWdZQgAgJ0F5sdA

# 6vM0h5YEhDC9wVpLdIVz7j2uqvBA4wUNHgVgHNLtvRB4FXEW4svaJW7goAcw1SEs

# tIPiIosMUE1M61PNOWEa8yAbvsDVyN5CsMwdrqhF4wN5QOodSvG/yDshF0iH6HSA

# MuTM3TEi7OWLQG/sm3JsYltXonFoMXgLNIIgxGkrn2cjqIqjguCdtAFklbv7pqRi

# wob+lc+V/E2/YiekPXS1IKQK/D2SvpbX41E34S5lzNGADBaVwr1clne67+/+jEe0

# 7v+SZUiznUX2pXpjZA1d3q1Tjpg+sr3ybZAPKz6W8s2KYrR7XFntnUZrAqiEoa+U

# sAtYOVlCqAd8nfUIHQuUgMjuIvJhOl3aLIqOqyRtCLIy0gIf5GYf+gKDsk4rRkDd

# cgxtr1pJaAEXdBnqkbcQZ5CqMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA

# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg

# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2

# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS

# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r

# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k

# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu

# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09

# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR

# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC

# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD

# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR

# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB

# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq

# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ

# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt

# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB

# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP

# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu

# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2

# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d

# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk

# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp

# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp

# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY

# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB

# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB

# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V

# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq

# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V

# M1izoXBm8qGCA1AwggI4AgEBMIH5oYHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBP

# cGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046RjAwMi0wNUUwLUQ5

# NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAH

# BgUrDgMCGgMVAJMYD2+mwnqCWoIuYjSuCAbHhgQSoIGDMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDui7zdMCIYDzIw

# MjYxMDI4MDAxNDIxWhgPMjAyNjEwMjkwMDE0MjFaMHcwPQYKKwYBBAGEWQoEATEv

# MC0wCgIFAO6LvN0CAQAwCgIBAAICQHQCAf8wBwIBAAICE1wwCgIFAO6NDl0CAQAw

# NgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgC

# AQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAnE+3TprOa3/p+CYLQuU0Y81ehgnA

# xbvT2PKVh9w2Ov/p4gYMWoZlDqVmekiInk+aKqMj1SOFpEzQG7NNUfgz2MXXMWu2

# polX29q71+9QFW6hL9OAInwt0ZTojjI6a/vSCHR0qho2Rm4mlSgCYXG228jJxebl

# fvr5Eau/ExwM5I0wuMa0LsY39EBcWjyJGosZJKVtE230r81gpDtP14bGJ6lRgP23

# SswXGJQfK6Q++0Dc6/5rBfSYc/u+bgzDmgGU06zWGr8uwPq3dCiL11xW1Jf+pdPs

# SUWeN9FFFDsVmTs0ToF+mJ3kwTYGWdkV5Pzf0BEcceEK5Re8rks1+Uw0GzGCBA0w

# ggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACICTh

# 5uAXubSOAAEAAAIgMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYL

# KoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIHXrWd6UyrcfhViuEzLm+b+0IKaQ

# iQ9CimvBrKV6cTkrMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQg43u/I6U8

# DVWqUSnRAhUaU13xLlhYGcqP3su5NYdI7a8wgZgwgYCkfjB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMAITMwAAAiAk4ebgF7m0jgABAAACIDAiBCCKZwommrmk

# CupteA/5B31q4ASSMM3iyOcNE2NweafYzDANBgkqhkiG9w0BAQsFAASCAgB31BYB

# IOyRYDoHWwzTZz5K1Hn5KhiPyrGsQ2F4pPM5VJbHPaLTqXAmcJS3F5MFmKAE5yuf

# YI6Tq0vbpDWUjIrwDy6PKl3DNpF2yoZkYnFJefdiQL/Uzt3U+X80wvjEiUJK4Myw

# uvsVG/iBjsw3OliqUuwdG7TTFq/C66K0FVNY+ghfLFzZamcPs2eNfh/gWC5FHV9Z

# dgxiI6AaK5nZ9qpRIG4x4oEoFJYkDptdSCPuUddEMrxjO+E7MSdQakw/wfnXaIh8

# xkemfaXuxJwZuqxt3KipziT83iPsOC4pd2WoAfmn4WsS17421UA7RoB8aZG7P9uo

# zj1WjaSOIh01KAvbty49IbWc/LnMHxwnTViPnBkJagDA4V4B22Ep8llhlKUE+gVj

# pcSro+H/G1AoGya5kCsvOeHft6lLT6MItFN0UWLoj3YbS4fV8nLsYhKNzfk0wB4b

# oRY/bw2wAnX7aaKy7/LAhppwIkDlKIDqMDx1D54kpShYDDDZqkRVQle6hKNxfTGU

# DSt+Bh5f4f8S5CbOJYI/fXVoTqAU2R+3WleiDQ/hyYN1va/kIjeoxubJs/gk9GUk

# rVRxY2k5MvFN4ufFL7BGXRfcGPuvAn30S79bFKCziMUV392IiNJimgaozsyGg7p5

# VMixDSlysSScLiToD1JTXi5gutw4H3Spa5a9WQ==

# SIG # End signature block