Az.Resources

7.8.0

Policy.Autorest/custom/Update-AzPolicyExemption.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 exemption with the given scope and name.

.Description

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

.Notes

## RELATED LINKS

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

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

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

.Link

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

#>

function Update-AzPolicyExemption {

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

[Alias('Set-AzPolicyExemption')]

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

param(

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

    [ValidateNotNullOrEmpty()]

    [Alias('PolicyExemptionName')]

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

    [System.String]

    # The name of the policy exemption.

    ${Name},

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

    [ValidateNotNullOrEmpty()]

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

    [System.String]

    # The scope of the policy exemption.

    # 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(ParameterSetName='Id', Mandatory, ValueFromPipelineByPropertyName)]

    [ValidateNotNullOrEmpty()]

    [Alias('ResourceId')]

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

    [System.String]

    # The ID of the policy assignment to delete.

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

    [ValidateSet('Waiver', 'Mitigated')]

    [Microsoft.Azure.PowerShell.Cmdlets.Policy.PSArgumentCompleterAttribute('Waiver', 'Mitigated')]

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

    [System.String]

    # The policy exemption category

    ${ExemptionCategory},

    [Parameter(ValueFromPipelineByPropertyName)]

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

    [System.String[]]

    # The policy definition reference ID list when the associated policy assignment is for a policy set (initiative).

    ${PolicyDefinitionReferenceId},

    [Parameter(ValueFromPipelineByPropertyName)]

    [Nullable[System.DateTime]]

    # The expiration date and time (in UTC ISO 8601 format yyyy-MM-ddTHH:mm:ssZ) of the policy exemption.

    ${ExpiresOn},

    [Parameter(ValueFromPipelineByPropertyName)]

    [System.Management.Automation.SwitchParameter]

    # Indicates whether to clear the expiration date and time of the policy exemption.

    ${ClearExpiration},

    [Parameter(ValueFromPipelineByPropertyName)]

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

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

    [System.String]

    # The policy assignment metadata.

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

    ${Metadata},

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

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

    ${InputObject},

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

    [ValidateSet('Default', 'DoNotValidate')]

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

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

    [System.String]

    # The option whether validate the exemption is at or under the assignment scope.

    ${AssignmentScopeValidation},

    [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-AzPolicyExemption(" $PSBoundParameters ") - (ParameterSet: $($PSCmdlet.ParameterSetName))"

    }

}

process {

    if ($writeln) {

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

    }

    # Id can be a parameter or from the input object

    if ($Id) {

        $thisId = $Id

    } else {

        $thisId = $InputObject.Id

    }

    # construct id for exemption to update

    $resolved = ResolvePolicyExemption $Name $Scope $thisId

    $getParameters = Get-ExtraParameters @PSBoundParameters

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

    if ($writeln) {

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

    }

    try {

        $existing = Get-AzPolicyExemption @getParameters

    }

    catch {

        # treat any error on get as nonexistent

        if ($writeLn) {

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

        }

    }

    if (!$existing) {

        throw "[PolicyExemptionNotFound] : The policy exemption '$($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')

    $calledParameters.PolicyAssignment = [PSCustomObject]@{ Id = $existing.PolicyAssignmentId }

    if (!$ExemptionCategory) {

        $calledParameters.ExemptionCategory = $existing.ExemptionCategory

    }

    if (!$ExpiresOn) {

        $calledParameters.ExpiresOn = $existing.ExpiresOn

    }

    if ($ClearExpiration) {

        $calledParameters.ExpiresOn = $null

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

    }

    if (!$calledParameters.DisplayName) {

        $calledParameters.DisplayName = $existing.DisplayName

    }

    if (!$calledParameters.Description) {

        $calledParameters.Description = $existing.Description

    }

    if (!$calledParameters.PolicyDefinitionReferenceId -and !($calledParameters.PolicyDefinitionReferenceId -is [array])) {

        $calledParameters.PolicyDefinitionReferenceId = $existing.PolicyDefinitionReferenceId

    }

    if (!$calledParameters.Metadata) {

        $calledParameters.Metadata = $existing.Metadata

    }

    if (!$calledParameters.AssignmentScopeValidation -and $existing.AssignmentScopeValidation) {

        $calledParameters.AssignmentScopeValidation = $existing.AssignmentScopeValidation

    }

    if ($BackwardCompatible) {

        $calledParameters.BackwardCompatible = $true

    }

    if ($writeln) {

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

    }

    New-AzPolicyExemption @calledParameters

}

end {

} 

}

# SIG # Begin signature block

# MIIoVAYJKoZIhvcNAQcCoIIoRTCCKEECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCrZUIKSF8Xk1yQ

# 0p5hcRiLrtcRQTF38wKejSiwUySG5KCCDYUwggYDMIID66ADAgECAhMzAAAEA73V

# lV0POxitAAAAAAQDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTEzWhcNMjUwOTExMjAxMTEzWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCfdGddwIOnbRYUyg03O3iz19XXZPmuhEmW/5uyEN+8mgxl+HJGeLGBR8YButGV

# LVK38RxcVcPYyFGQXcKcxgih4w4y4zJi3GvawLYHlsNExQwz+v0jgY/aejBS2EJY

# oUhLVE+UzRihV8ooxoftsmKLb2xb7BoFS6UAo3Zz4afnOdqI7FGoi7g4vx/0MIdi

# kwTn5N56TdIv3mwfkZCFmrsKpN0zR8HD8WYsvH3xKkG7u/xdqmhPPqMmnI2jOFw/

# /n2aL8W7i1Pasja8PnRXH/QaVH0M1nanL+LI9TsMb/enWfXOW65Gne5cqMN9Uofv

# ENtdwwEmJ3bZrcI9u4LZAkujAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU6m4qAkpz4641iK2irF8eWsSBcBkw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMjkyNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AFFo/6E4LX51IqFuoKvUsi80QytGI5ASQ9zsPpBa0z78hutiJd6w154JkcIx/f7r

# EBK4NhD4DIFNfRiVdI7EacEs7OAS6QHF7Nt+eFRNOTtgHb9PExRy4EI/jnMwzQJV

# NokTxu2WgHr/fBsWs6G9AcIgvHjWNN3qRSrhsgEdqHc0bRDUf8UILAdEZOMBvKLC

# rmf+kJPEvPldgK7hFO/L9kmcVe67BnKejDKO73Sa56AJOhM7CkeATrJFxO9GLXos

# oKvrwBvynxAg18W+pagTAkJefzneuWSmniTurPCUE2JnvW7DalvONDOtG01sIVAB

# +ahO2wcUPa2Zm9AiDVBWTMz9XUoKMcvngi2oqbsDLhbK+pYrRUgRpNt0y1sxZsXO

# raGRF8lM2cWvtEkV5UL+TQM1ppv5unDHkW8JS+QnfPbB8dZVRyRmMQ4aY/tx5x5+

# sX6semJ//FbiclSMxSI+zINu1jYerdUwuCi+P6p7SmQmClhDM+6Q+btE2FtpsU0W

# +r6RdYFf/P+nK6j2otl9Nvr3tWLu+WXmz8MGM+18ynJ+lYbSmFWcAj7SYziAfT0s

# IwlQRFkyC71tsIZUhBHtxPliGUu362lIO0Lpe0DOrg8lspnEWOkHnCT5JEnWCbzu

# iVt8RX1IV07uIveNZuOBWLVCzWJjEGa+HhaEtavjy6i7MIIHejCCBWKgAwIBAgIK

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

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAQDvdWVXQ87GK0AAAAA

# BAMwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIKf4

# MsQyhd8NnmUM+JrrcSH/2BaiROJo5z2a0WC2zNWeMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAeF+xAPpBmV7KbYgg76iiGOiqzJFVY0+Q0mCH

# 86I5MJ0xIigs5DMoj2JkJvHYEy7LfHFWp0KLxmXpWZ9k+MV8DHzG3DmBk0S1D4Hm

# YlzuWXS+HFQQNYS+db/YlNCorkm8Y9w/Q+myq7d+ila6lQTKHhL6dvnSm2XKF2/u

# sEA161nbTa72WmHPF90xMBDVgekpoabYBEBFjFPUdGL2oFrZAtgokDRVbP55p4Jj

# g5EbX2/Vv6VlfzCuee7MQKLhlqNVWeWgFxDDK/0y0iMblFbkUwH1MberCfwZ8f/L

# xYDM4gOgADi0bU2gpFiZmkeIUOLnTySvIr65nb8+3jcMtAtQgKGCF68wgherBgor

# BgEEAYI3AwMBMYIXmzCCF5cGCSqGSIb3DQEHAqCCF4gwgheEAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFZBgsqhkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCC6+QebTmie/wsLqeodaX9oAMPfgnqXNCbr

# FfOkeVo8dwIGZ2KyTuAxGBIyMDI1MDEwOTA2Mzc0OS4wM1owBIACAfSggdmkgdYw

# gdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsT

# JE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMe

# blNoaWVsZCBUU1MgRVNOOjZCMDUtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3Nv

# ZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIR/jCCBygwggUQoAMCAQICEzMAAAH2gy8m

# alRdIsEAAQAAAfYwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAg

# UENBIDIwMTAwHhcNMjQwNzI1MTgzMTA0WhcNMjUxMDIyMTgzMTA0WjCB0zELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9z

# b2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046NkIwNS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDR

# Ql4sxH831Y8FmG4pUUX55Ylnrxa6N2PhfolHTlzE7kJ6k1ejXutVrPBYuSbkCNpW

# HX1lWMMKEfOKbGyhpfE27wgOCArCle+kAAi2/hTHnR71La5XB8q/nun0kob5DtU4

# 1KG6OXU0IyRyBKs92Z3/zNyyaHNw2hsuiasIAg5FnwjCFjLiyJVCV/U0qGXIDOaR

# YkPQ37rQiKiAUHODfIhKy+ug7HTHXFKLY+JEhCVNcTvgyCBkMgMqof+Fv0VPaQr+

# dX9peO6j0syutGafjihhgAN7+s73kX5Ibe666F/4fgiuJevSH2m0DpLAck9LZWZs

# 1YKNBarkbhiStyps8xrHu81dTC7tPrkTx8U93Ui4T1GwbhMwBXteRcGimY81+8vS

# GPGDjiSlCffzhXjqj7N1CrLkr10OVab8nq9m2nnIDU/IPfD4dsa5tLSeIRDUvrAY

# 6s9/MibQV06f7EWjjwRGX4XHD/c69czkJjUSqfMTOc+PMlzs4nCElVHdVAMeMFwQ

# VM69L0TR2I27V6hzD5kKTPg+7+hC/6CpT5t/Evx7s8WS19EOUzoXI7OM/jO4jbmA

# Py073MmDqDp9Glplzjf2YBuSXfMJXNMsOByG/pLFBqMm2++hBpnFB/S1GI9xuvYd

# Z8yiqp326JDSFNQSEbjgUFJN5Q9l4R6dEJZp0JbgbwIDAQABo4IBSTCCAUUwHQYD

# VR0OBBYEFEjBmwm45wl9Jw9Zxdm4EDgHz0ryMB8GA1UdIwQYMBaAFJ+nFV0AXmJd

# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l

# AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA

# A4ICAQDXeQGKsfVwe7VZhHXKyPXbmiYa1DQ9pCQTPAZvvTG2pKgj6y9CKGyB1NjF

# o9+nYhUV2CNoxoGLzXAHz+e7zroV8Uop2F2nfCcxn3U+k/g6h7s1x/qogKSBK7CB

# 0h1C+oTSHxVDlBbmwNXhDQmePh/sodjHg2IzwLiNPDxJC2y7FaJMfYeKR/dBgHvV

# rt0H3OAc6RbSGBQR5Y72aHbBaphL9DjwBKM6pjD+FrnihU59/bZZqgf78fF301MR

# T/i+W+xEgxZPSOyc0jvWNUCtPhD0G3pVKFbPKqtoTpIpShmsTAGlWwjQsyDZfeE4

# tuULW/Ezf7AzI6H3toU6zuwWe56a0jYx+PyqDXoFlMnFeWk+6tasb44GPgGhMOQL

# 0DFdgHfIS27AyzulFYvLEjHD/BX1McpQab7H5UTQ84vCStIyCO6VJeSl8QsdZaIJ

# WyUlsUggH/gCW/6NAlIoAm6j0IStubap4OT/OMliVhpUYzIq5hn65JFUoHaqQQ9w

# TMbV073MhrUynfYn7PNbc/uy4l+PDrazeEM4uT7qUxA5HTjH7ajXsbctx4uSTEmb

# jUSt2JOMCZ0KV6f3KXoeAykZLiiSMUIlf4Kk4VfuAEDc9XFBa5uKwBBsvkeBMUG1

# A0TNwJ2HUZjD/qfPM0237QZCeehsF1184CKqTO8i2peO8bIrVDCCB3EwggVZoAMC

# AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy

# NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9

# DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2

# Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N

# 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc

# ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ

# j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk

# lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy

# L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M

# 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX

# pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU

# HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode

# 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA

# ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE

# FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB

# MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE

# AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB

# /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug

# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N

# aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG

# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv

# b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt

# 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP

# MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++

# Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9

# QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2

# wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR

# AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z

# bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx

# t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3

# Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN

# uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z

# cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNZMIICQQIBATCCAQGhgdmkgdYw

# gdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsT

# JE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMe

# blNoaWVsZCBUU1MgRVNOOjZCMDUtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3Nv

# ZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQAVT15Kl3GzRrTo

# kUi4YUciP8j7fqCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MA0GCSqGSIb3DQEBCwUAAgUA6ymIEjAiGA8yMDI1MDEwODIzMjYxMFoYDzIwMjUw

# MTA5MjMyNjEwWjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDrKYgSAgEAMAoCAQAC

# Ag4DAgH/MAcCAQACAhJTMAoCBQDrKtmSAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwG

# CisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEL

# BQADggEBAB1HDADCMMBabXT9Mgm8gbvAFQfTwzAE/Prc9+FZd6xn9AhYZbgFNvm/

# LNo4hIc5Gwz6hrCxkUN6OpjgOAktSKiD3JQq0v3N/LuMuEyDOQb6sJDEWYuJO1Dd

# +cA57XuuZQ+XHl1OURuyksM8Y0KNx3eYu6soa7Sa/j7eiUOjPewWBzSSjJJ8TbLd

# CzWp5QCvTlCY1OuSaHmuuvCEdhjQFQFx5mhLXeaa7qhHnw365yenhg6pSgdWXE55

# nk3MUkhiEX+JyVs8mAu6BBv3qtknZNlTOVjK++qasivs4/E8j4y6T17zDmaQXkw/

# bcMHXreofQVLAmp6Ew5Crwd3t4Ig3X4xggQNMIIECQIBATCBkzB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAfaDLyZqVF0iwQABAAAB9jANBglghkgB

# ZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3

# DQEJBDEiBCDol78lKM5/0n3CUKhbGinGp9EZ2CsbpgOkSLG3M0XA7TCB+gYLKoZI

# hvcNAQkQAi8xgeowgecwgeQwgb0EICthTPGUXqblRItLh/w1cv/xqg0RV2wJlGYX

# 4uVCMbaiMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMA

# AAH2gy8malRdIsEAAQAAAfYwIgQgIoGKOQNEMTy5GkgfDTfhCagzbPwQRMQ0lOi0

# mv3baEwwDQYJKoZIhvcNAQELBQAEggIAXwQ341dd59SeMXeJDjkC8+3pb4CVZJM4

# ZhBt0OQMORtgIDe4RmgoqX5NQw0XsQBeTJ4W9dvAgJbs3mbRou4BrsA0vcTE/9o7

# Q4P+atbhEzkBZH9cP0QytJwYCC/ORSO9SFqedFtzceQd2KWDd5JuDg4D3SuhthC0

# QUE9QzRjkEl4QtmNM4K/y23Xj83p8edo0hYiqRy8y+dvZ6X+XOrRGX2z7A5hbnM2

# lI97AnUhXlvSn/Tj1fm2GNw5vRs6eab5qGEXxSCz2hqZR/dN+84wg8SutX66boSH

# 8jHQYFolhFJeeX+fn1I0RjON7+RQBHVoYcJDD9ScJYKS5YgqWLjVtuE2S8fXikJX

# XQExizxBfyJ7P3anA40rs7pJWiMxLHROgVPjAYcpXH8P2ec84zJw/evfDpfGDFGa

# qj7PGNGvpUJJJR0fvzYC3LecWLbcbwoqIqG2HwhyEqNFbyVQU8LfFSbThJdxzsHH

# jokUdIzDV5PdUJTRh0UT85El2qr6f9Lfn6hJyWsRnBPb6eQLLflY+QaZK3PU9ChM

# MB0krvOa3R6dtmVTfUl4OXQP/Qw8GeOvXTKdc18zGb1/jh7QidxxDnQTHsVyrbLp

# xAmsuwOCcGzvs3m2dJjEqF5+PLETYpUgoZfqNSR6MI1S65PxUeCB8HAq0XJ7g+oH

# rU1CpbcuCnc=

# SIG # End signature block