Az.Resources

7.6.0

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')]

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

    [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')]

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

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

    [System.String]

    # The policy assignment enforcement mode.

    # Possible values are Default and DoNotEnforce.

    ${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()]

    [Obsolete('This parameter is a temporary bridge to new types and formats and will be removed in a future release.')]

    [System.Management.Automation.SwitchParameter]

    # Causes cmdlet to return artifacts using legacy format placing policy-specific properties in a property bag object.

    ${BackwardCompatible} = $false,

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

                $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])) {

            $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.EnforcementMode -and $calledParameters.EnforcementMode) {

        $calledParameters.EnforcementMode = $existing.EnforcementMode

    }

    if ($BackwardCompatible) {

        $calledParameters.BackwardCompatible = $true

    }

    if ($writeln) {

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

    }

    New-AzPolicyAssignment @calledParameters

}

end {

} 

}

# SIG # Begin signature block

# MIIoPAYJKoZIhvcNAQcCoIIoLTCCKCkCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAVSQhQbRHSm1z0

# 1j99C+Z1k6+W5sgMIGOBL9ycEGdQbKCCDYUwggYDMIID66ADAgECAhMzAAADri01

# UchTj1UdAAAAAAOuMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwODU5WhcNMjQxMTE0MTkwODU5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQD0IPymNjfDEKg+YyE6SjDvJwKW1+pieqTjAY0CnOHZ1Nj5irGjNZPMlQ4HfxXG

# yAVCZcEWE4x2sZgam872R1s0+TAelOtbqFmoW4suJHAYoTHhkznNVKpscm5fZ899

# QnReZv5WtWwbD8HAFXbPPStW2JKCqPcZ54Y6wbuWV9bKtKPImqbkMcTejTgEAj82

# 6GQc6/Th66Koka8cUIvz59e/IP04DGrh9wkq2jIFvQ8EDegw1B4KyJTIs76+hmpV

# M5SwBZjRs3liOQrierkNVo11WuujB3kBf2CbPoP9MlOyyezqkMIbTRj4OHeKlamd

# WaSFhwHLJRIQpfc8sLwOSIBBAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhx/vdKmXhwc4WiWXbsf0I53h8T8w

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMTgzNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGrJYDUS7s8o0yNprGXRXuAnRcHKxSjFmW4wclcUTYsQZkhnbMwthWM6cAYb/h2W

# 5GNKtlmj/y/CThe3y/o0EH2h+jwfU/9eJ0fK1ZO/2WD0xi777qU+a7l8KjMPdwjY

# 0tk9bYEGEZfYPRHy1AGPQVuZlG4i5ymJDsMrcIcqV8pxzsw/yk/O4y/nlOjHz4oV

# APU0br5t9tgD8E08GSDi3I6H57Ftod9w26h0MlQiOr10Xqhr5iPLS7SlQwj8HW37

# ybqsmjQpKhmWul6xiXSNGGm36GarHy4Q1egYlxhlUnk3ZKSr3QtWIo1GGL03hT57

# xzjL25fKiZQX/q+II8nuG5M0Qmjvl6Egltr4hZ3e3FQRzRHfLoNPq3ELpxbWdH8t

# Nuj0j/x9Crnfwbki8n57mJKI5JVWRWTSLmbTcDDLkTZlJLg9V1BIJwXGY3i2kR9i

# 5HsADL8YlW0gMWVSlKB1eiSlK6LmFi0rVH16dde+j5T/EaQtFz6qngN7d1lvO7uk

# 6rtX+MLKG4LDRsQgBTi6sIYiKntMjoYFHMPvI/OMUip5ljtLitVbkFGfagSqmbxK

# 7rJMhC8wiTzHanBg1Rrbff1niBbnFbbV4UDmYumjs1FIpFCazk6AADXxoKCo5TsO

# zSHqr9gHgGYQC2hMyX9MGLIpowYCURx3L7kUiGbOiMwaMIIHejCCBWKgAwIBAgIK

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

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAOuLTVRyFOPVR0AAAAA

# A64wDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIAFO

# q054fa5VxpH/ZL/eZnB0MsvDbFfXkoM8bNbxm+78MEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAlledEd37+/Blln+RXGEPldFXrOh+xBJVnbgF

# rNImIUHNmERbq9ePraozRH2mSrEN/OIqgxTiOi+42q8tEz212Iwr+I+eALoaNoBk

# X65SURnpUTmv5kvtH2tfVu88Cyl1VCfcj5iTncJkHA2QN6H8veojayH8KdLs1zE1

# D/PXljWTg3+BUvluUlQfYQwLcOwz5yYkc8tux2eCyVRwKcMOK6gYI5DEECXulOfp

# AW0tLTPft/BHZMz3OLyqNunppUwqx2MX/RZhToZ5U5Uby4eYCF/RkmzsEM6eV6+T

# yv+C9LE0pH/ES66OQpJLT23lXxm7EbSVhZOYq3OIL0OJvzXi1aGCF5cwgheTBgor

# BgEEAYI3AwMBMYIXgzCCF38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCCSDHAYRBlhLM2hCPcD2xEYRtYvrVb/Wm2Y

# Iza9rRQ1SwIGZr4sW1gtGBMyMDI0MDgyOTAzMDgyNi40OTlaMASAAgH0oIHRpIHO

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046OTYwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2WgghHtMIIHIDCCBQigAwIBAgITMwAAAe+JP1ahWMyo2gAB

# AAAB7zANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDAeFw0yMzEyMDYxODQ1NDhaFw0yNTAzMDUxODQ1NDhaMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTYwMC0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Uw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCjC1jinwzgHwhOakZqy17o

# E4BIBKsm5kX4DUmCBWI0lFVpEiK5mZ2Kh59soL4ns52phFMQYGG5kypCipungwP9

# Nob4VGVE6aoMo5hZ9NytXR5ZRgb9Z8NR6EmLKICRhD4sojPMg/RnGRTcdf7/TYvy

# M10jLjmLyKEegMHfvIwPmM+AP7hzQLfExDdqCJ2u64Gd5XlnrFOku5U9jLOKk1y7

# 0c+Twt04/RLqruv1fGP8LmYmtHvrB4TcBsADXSmcFjh0VgQkX4zXFwqnIG8rgY+z

# DqJYQNZP8O1Yo4kSckHT43XC0oM40ye2+9l/rTYiDFM3nlZe2jhtOkGCO6GqiTp5

# 0xI9ITpJXi0vEek8AejT4PKMEO2bPxU63p63uZbjdN5L+lgIcCNMCNI0SIopS4ga

# VR4Sy/IoDv1vDWpe+I28/Ky8jWTeed0O3HxPJMZqX4QB3I6DnwZrHiKn6oE38tgB

# TCCAKvEoYOTg7r2lF0Iubt/3+VPvKtTCUbZPFOG8jZt9q6AFodlvQntiolYIYtqS

# rLyXAQIlXGhZ4gNcv4dv1YAilnbWA9CsnYh+OKEFr/4w4M69lI+yaoZ3L/t/UfXp

# T/+yc7hS/FolcmrGFJTBYlS4nE1cuKblwZ/UOG26SLhDONWXGZDKMJKN53oOLSSk

# 4ldR0HlsbT4heLlWlOElJQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFO1MWqKFwrCb

# trw9P8A63bAVSJzLMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8G

# A1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBs

# BggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy

# MDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH

# AwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAYGZa3aCDudbk9

# EVdkP8xcQGZuIAIPRx9K1CA7uRzBt80fC0aWkuYYhQMvHHJRHUobSM4Uw3zN7fHE

# N8hhaBDb9NRaGnFWdtHxmJ9eMz6Jpn6KiIyi9U5Og7QCTZMl17n2w4eddq5vtk4r

# RWOVvpiDBGJARKiXWB9u2ix0WH2EMFGHqjIhjWUXhPgR4C6NKFNXHvWvXecJ2WXr

# JnvvQGXAfNJGETJZGpR41nUN3ijfiCSjFDxamGPsy5iYu904Hv9uuSXYd5m0Jxf2

# WNJSXkPGlNhrO27pPxgT111myAR61S3S2hc572zN9yoJEObE98Vy5KEM3ZX53cLe

# fN81F1C9p/cAKkE6u9V6ryyl/qSgxu1UqeOZCtG/iaHSKMoxM7Mq4SMFsPT/8ieO

# dwClYpcw0CjZe5KBx2xLa4B1neFib8J8/gSosjMdF3nHiyHx1YedZDtxSSgegeJs

# i0fbUgdzsVMJYvqVw52WqQNu0GRC79ZuVreUVKdCJmUMBHBpTp6VFopL0Jf4Srgg

# +zRD9iwbc9uZrn+89odpInbznYrnPKHiO26qe1ekNwl/d7ro2ItP/lghz0DoD7kE

# GeikKJWHdto7eVJoJhkrUcanTuUH08g+NYwG6S+PjBSB/NyNF6bHa/xR+ceAYhcj

# x0iBiv90Mn0JiGfnA2/hLj5evhTcAjCCB3EwggVZoAMCAQICEzMAAAAVxedrngKb

# SZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmlj

# YXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIy

# NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXI

# yjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjo

# YH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1y

# aa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v

# 3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pG

# ve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viS

# kR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYr

# bqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlM

# jgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSL

# W6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AF

# emzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIu

# rQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIE

# FgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWn

# G1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEW

# M2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5

# Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi

# AEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV

# 9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3Js

# Lm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAx

# MC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv

# 6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZn

# OlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1

# bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4

# rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU

# 6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDF

# NLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/

# HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdU

# CbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKi

# excdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTm

# dHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZq

# ELQdVTNYs6FwZvKhggNQMIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp

# Y2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjk2MDAtMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMK

# AQEwBwYFKw4DAhoDFQBLcI81gxbea1Ex2mFbXx7ck+0g/6CBgzCBgKR+MHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6nnNHTAi

# GA8yMDI0MDgyODE2MjE0OVoYDzIwMjQwODI5MTYyMTQ5WjB3MD0GCisGAQQBhFkK

# BAExLzAtMAoCBQDqec0dAgEAMAoCAQACAkKdAgH/MAcCAQACAhPRMAoCBQDqex6d

# AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSCh

# CjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAH2nuh4lpnKz2rgJTuvkvcUl

# vskq6miTAS+Caco5itLnysjuXYKsaFL/DV55OT4+x3FrWylPVlZhHRuDP9XXWx9X

# i7zMCFM+eeeID0w/USH0euQfimC4c8Gcd0Fo9X0X+Jj3+h6ojz2R3iwltnuWxzsA

# 2HbuFJQ5BYTq2nrZECKeaTWWNaKuK0/Ib69Ki4SvUyM+xWRfMAdWVGOSYPn2nFAi

# uEQoqVqDpKHjZbwe12oTzfo+zqe886/v8tDOJA0mKb9ueWOZuyRO0Lx7Dq2M5uPI

# pZTSmViCTpmfZH1PklI16Ec8jEcMkodV+rntqEkCc/ssWAczkDKwsKFMzcYMYNgx

# ggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# Ae+JP1ahWMyo2gABAAAB7zANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkD

# MQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCAROBN3q+yj3rJDevvq/IR3

# Qfz74xyM5E03H/SddT3fMjCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIPBh

# KEW4Fo3wUz09NQx2a0DbcdsX8jovM5LizHmnyX+jMIGYMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHviT9WoVjMqNoAAQAAAe8wIgQgxh7b

# 3DNpLDXXnKfUBcHSKNcZeziVq1x/mn8R84N7OTAwDQYJKoZIhvcNAQELBQAEggIA

# Kve5+7p1dTkNu5yaMU/nBoL3DrWPbEzu83WtI95PRtsD7UG/MaUaq02YrNx7/Dyo

# /55G/J6m9jEl0bzpfknVbTuYn4lUPL+QdJ2UIc8rN/f7oV00KqXjD6W4UKHhCTB1

# hiRDr4EuM92BM4mxge0AcxXY7X676wWjpid2xqhT3DHFCgcYFIsU5yPCxXs5ME2R

# IjPnjCZjjN74sHBuNyVZXidKxTDE0UDeNCShVfBl66wjOeh3LNdQ7swG4PJT/kbB

# AitAFgHz0W+xPY1QvvO0OzwI1OUMu9z9zIG3vlGQInFNbOoC9NF0Hw3b2Qt4ZBp8

# u6qDhYj6LN7hzqCJwUSyzv4T/2ZQsDcJnS8cr7yHSr/dDaY9gKLGRYqmilU/ESU6

# itpj1kxutVhg3/hYwy/EGdwtwl5eBbLM3IcwWqEO11MLW8ip5m0e7n0PkmdwkKNZ

# 5iePvyEDf+GrglaHcsElsLbdEcEJlZxQd2ItGCOWQjplcu5RQDJefnNR8uUBxFJR

# dbGcKrP0aHSBQiaSlb596fK2u3MwzBV7zC5/mPJ6y4RKw++Tw0gJRgJ6FTPVNd5y

# nkTXtfuEYYHA0nV/7PdHBKxvwaY+xoeq5F1PXx+8mccr0RnigXQvFIPGh3WjOVzI

# 6IwqL98Nkb6iY4Ah4c/LrKCaUPyvuFZ7fFEEyYMBfCI=

# SIG # End signature block