Microsoft.Xrm.Tooling.CrmConnector.PowerShell

3.3.0.1006

Microsoft.Xrm.Tooling.CrmConnector.PowerShell.psd1

                                #

# Module manifest for module 'Microsoft.Xrm.Tooling.CrmConnector.PowerShell'

#

# Generated by: Microsoft Dynamics 365 CRM Team

#

# Generated on: 4/12/2017 2:04:50 PM

#

@{

# Script module or binary module file associated with this manifest.

RootModule = 'Microsoft.Xrm.Tooling.CrmConnector.PowerShell.psm1'

# Version number of this module.

ModuleVersion = '3.3.0.1006'

# ID used to uniquely identify this module

GUID = '7982AE8F-1E4B-4333-9DF6-0305DBD4A3DA'

# Author of this module

Author = 'Microsoft Common Data Service Team'

# Company or vendor of this module

CompanyName = 'Microsoft'

# Copyright statement for this module

Copyright = '© 2022 Microsoft Corporation. All rights reserved'

# Description of the functionality provided by this module

Description = 'PowerShell wrapper for CDS CrmServiceClient'

# Minimum version of the Windows PowerShell engine required by this module

PowerShellVersion = '5.1'

# Name of the Windows PowerShell host required by this module

#PowerShellHostName = ''

# Minimum version of the Windows PowerShell host required by this module

#PowerShellHostVersion = ''

# Minimum version of the .NET Framework required by this module

#DotNetFrameworkVersion = '4.0'

# Minimum version of the common language runtime (CLR) required by this module

#CLRVersion = '4.0'

# Processor architecture (None, X86, Amd64) required by this module

#ProcessorArchitecture = ''

# Supported PSEditions: 'Desktop', 'Core'

CompatiblePSEditions = @('Desktop')

# Modules that must be imported into the global environment prior to importing this module

#RequiredModules = 

# Assemblies that must be loaded prior to importing this module

RequiredAssemblies = @(

'Microsoft.Xrm.Tooling.Ui.Styles.dll',

'Newtonsoft.Json.dll',

'Microsoft.Rest.ClientRuntime.dll'

)

# Script files (.ps1) that are run in the caller's environment prior to importing this module.

#ScriptsToProcess = @()

# Type files (.ps1xml) to be loaded when importing this module

#TypesToProcess = @()

# Format files (.ps1xml) to be loaded when importing this module

#FormatsToProcess = @()

# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess

NestedModules = if($PSEdition -eq 'Core')

{

    $null # No Core compatible modules

}

else # Desktop

{

    @(

        'Microsoft.Xrm.Tooling.CrmConnector.PowerShell.dll'

    )

}

# Functions to export from this module

FunctionsToExport = @()

# Cmdlets to export from this module

CmdletsToExport = @(

  'Get-CrmConnection',

  'Get-CrmOrganizations'

)

# Variables to export from this module

VariablesToExport = @(

    )

# Aliases to export from this module

AliasesToExport = @(

    )

# List of all modules packaged with this module.

 ModuleList = @(

    'Microsoft.Xrm.Tooling.CrmConnector.PowerShell'

    )

# List of all files packaged with this module

#FileList = @()

# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.

PrivateData = @{

    PSData = @{

        # Tags applied to this module. These help with module discovery in online galleries.

        # Tags = @()

        # A URL to the license for this module.

        LicenseUri = 'http://download.microsoft.com/download/E/1/8/E18C0FAD-FEC8-44CD-9A16-98EDC4DAC7A2/LicenseTerms.docx'

        # A URL to the main website for this project.

        ProjectUri = 'https://docs.microsoft.com/powershell/module/microsoft.xrm.tooling.crmconnector.powershell/?view=dynamics365ce-ps'

                # A URL to an icon representing this module.

        IconUri = 'https://connectoricons-prod.azureedge.net/powerappsforappmakers/icon_1.0.1056.1255.png'

        # ReleaseNotes of this module

        ReleaseNotes = '

Current Release:

3.3.0.1006

Updated User Password Authentication behavior to prefer OAuth for all Online Operations

Updated dependency for core sdk client

Resynced to 9.1.1.x CrmServiceClient

3.3.0.928:

Updated for Current Dataverse SDK

Updated behavior of ImportSolutionAsync to leverage updated Dataverse behavior post 9.2 release.

Updated Display name for Northamerica 2 Region to reflect that it is more commonly know as GCC. 

Updated Newtonsoft.Json to v11.0.2 to match Dataverse server.

Adding EnableAffinityCookie to allow for override of Affinity behavior when interacting with Dataverse. 

    In general, users should not manipulate this property. more details can be found here: https://docs.microsoft.com/en-us/powerapps/developer/data-platform/api-limits#remove-the-affinity-cookie

Adding support for enhanced features for solution import. 

Added support to auto retry 503 server unavailable network errors

Added support to allow for callers to add custom headers to the request to Dataverse - this is intended for Microsoft releated consumers only.

Fixed an issue where BypassPluginExecution property on request was not being understood properly by the server. 

Updated minimum required Microsoft.Xrm.Sdk.dll assembly version to Microsoft.CrmSdk.CoreAssemblies.9.0.2.25. 

Warning!, failure to update to this or higher level assembly will result in the following error: 

        Method not found: void Microsoft.Xrm.Sdk.ParameterCollection.AddOrUpdateIfNotNull(System.String, System.Object).

3.3.0.900:

Added new public property to Read out InMemory Logs in string list format or Tuple(datetime,logevent) format. 

Added new public property for OrganizationDetail Information called "OrganizationDetail" for the currently connected environment.

Added new enum for ImportSolution additional property options called "ImportSolutionProperties" - this contains valid options for additional properties for the ImportSolution handler

Adding Switzerland Geo to Regions List.

Fixed an issue with .Clone not correctly supporting adding telemetry handlers to cloned connections

Fixed an issue with telemetry for the client that was using incorrect format for useragent content

3.3.0.899:

Added initial support for in memory log capture support. 

3.3.0.897:

Fixed an issue with sovereign cloud discovery reference data that would prevent a login control from picking the correct global discovery server when connecting.

3.3.0.892:

Fixed Authority property data loss post clone process

Fixed an error with connection string based IFD Auth flows that slipped though testing.

3.3.0.891:

Fixed an error where discovery would be used when using AD and IFD to connect to onpremise even if connection strings where used. 

3.3.0.890:

Fixed an error where timeout property was not properly assigned when using Non-oAuth types 

Fixed an error with setting CallerId when ClientSecret Auth type is used.  

    Thanks for all the bug reports on this and repros that really helped us run it down. 

3.3.0.887:

Uptaking new CoreSDK release

3.3.0.886:

Uptaking current CDS SDK. 

3.3.0.885:

Internal fixes to unify the way in which online and onprem instances were determined from the URI provided.

Added new Static Property on Utilities called IsValidOnlineHost, this takes a URL and determines if it a valid OnLine URI for the CDS Service

Corrected an issue where the AdminAPI URL provided by Get-CrmOrganizations was incorrect.

Fixed a bug Null Object Error that would occur occasionaly during connect when many concurrent connects were run.

    This would typically happen if a developer used a Task.Wait behavior to create a stack of connections at once. 

Fixed a bug that would prevent logs from being generated even when verbose tracing was enabled. 

3.3.0.874:

Added Support for new properties in discovery response. 

Added: 

    Tenant Id - ID of the tenant that the instance resides in

    Enviroment Id - ID of the PowerPlatform Envrioment that the instance resides in

    UrlName - Host name for the target instance. 

Fixed a bug where the second ( or third ) connection string attempt in the same process would cause the client to try to reuse the current connection.

Fixed a bug where the SDK Version Property was not properly returning from the CrmServiceClient

3.3.0.869:

    Fixed a bug with how errors are handled when they are raised from ADAL 3.19+.  MFA Force Login will now work properly again. 

    Updated default response sizes to support more verbose error messages from CDS

3.3.0.862

    ADAL 3.19+ is now required for this library.  ADAL 2.x clients will need to be updated to use ADAL 3.x+

    Added Support for Current User ID login when using Online flows with oAuth (Login control/connection string support )

    Added Support for ClientID Secret Auth when using oAuth flows. (connection string support )

3.3.0.857 

Added support for France and New US Geos

    Added new behavior to return the full login error when initial connect fails in LastException. 

    Fixed https activation issue introduced by .net 4.8. - This should no longer require http activation to be enabled on windows. 

    Fixed issue where a long running cloned connection loses its access token.

3.3.0.841 - (Nuget-9.0.2.16):

    Added native support for handing throttling messages from server. 

    Fixed issue where a cloned connections token could time out in a way that was not detected. 

            When failing, this would result in a mid operation Authentication failure reporting something like "Anonymous Access Failed"

    Added Support for China Geo

    Minor changes to logging of Import Solution Activities 

    #### VERSION RESET HERE TO NOW FOLLOW BUILD VERSIONS OF THIS MODULE... 

NOTE: Notes Below are synced to Nuget Release Found here: https://www.nuget.org/packages/Microsoft.CrmSdk.XrmTooling.CrmConnector.PowerShell/

9.0.2.12

    Fixed bug in CrmServiceClient which would cause some OnPrem connections to fail with an error "Item already added to List"

    Minor Perf Improvements

9.0.2.11:

    Updated to include Fixed version of CrmServiceClient and login control for new US Geo ( US Gov High )

9.0.2.9: 

    Picked up updated CrmServiceClient (Microsoft.Xrm.Tooling.Connector)

9.0.2.8: 

    Picked up updated CrmServiceClient (Microsoft.Xrm.Tooling.Connector)

9.0.2.7: 

    Picked up updated CrmServiceClient (Microsoft.Xrm.Tooling.Connector)

9.0.2.5: 

    Fixed a bug with using ExecuteCrmWebRequest where SkipDiscovery was also used that would cause the command to fail with a malformed URI error.

    Fix to support SSO login, issue manifested as unable to execute a SSO login on second attempt.

    Fix to make local metadata cache instance aware, 

        Issue manifested in a single client process where more then one connection was made to different CDS instances and the metadata helpers were used.  The Metadata would not be instance specific.

    Streamlined .Clone support by removing unneeded WhoAmI validation call.

    Added new .Clone override to allow a developer to pass an assembly reference to the .Clone method to use when establishing strong types for that connection.

    Added additional error log details when a fault is detected

9.0.2.4:

    Added support for retrying SDK request if the server throws a retriable errors.

    ImportSolutionToCrmAsync – 

        Returns an AsyncOperation ID that must be polled for solution Import completion or failure. 

        Note, Async jobs are subject to Async queuing and overhead, thus use this with caution.

    DeleteAndPromoteSolutionAsync – 

        Returns an AsyncOperation ID that must be polled for completion

        Note: DeleteAndPromote Async support is not generally available to all regions and versions of the platform.  If this is not available the async job with fail immediately.

        Note: Async jobs are subject to Async queuing and overhead, thus use this with caution.

9.0.2.3: 

    Added new dependencies: 

        Json.net version 6.0.0.0

        Microsoft.Rest.ClientRuntime 3.0.0.0

    Added Support for Caller ID using AAD Object ID of caller -

        Added new property on CrmServiceClient: CallerAADObjectId

        Supported for 8.1 and later.

    Added New Method ExecuteCrmWebRequest

        This method supports using the XRM WebAPI directly from the CRMServiceClient.

        Supports only oAuth and Certificate Auth connection types

        Supported for 8.0 and later. 

        Supports Common request types and supports batch execute.

    Added Global Discovery Support for Instance lookup 

        Global discovery is now used for all lookup, both regional and global (Online Region = Dont Know) when OAuth is used, except where special region rules are required.

        Note: Germany and North America 2 are not scanned when Online Region = Dont Know is selected.

    Added SkipDiscovery to all connection string variants.

    Added Certificate support for constructor variants. 

    Fixed issue with allowing discovery selection using onPrem and OAuth.

    Fixed an issue with older On-Prem ADFS instances that do not require a resource URI.

    **Special notes: 

        Added additional telemetry support to connection requests

            This will add the process name of the calling process (if available) to help with troubleshooting and support requests.

        Added request IDs to all requests to help with troubleshooting and support requests.

            These will appear only when verbose logging is enabled. 

9.0.0.5: 9.0 Initial Release

9.0.0.3-preview: 

    Initial release.

    To register module, run the RegisterXrmTooling.ps1'

    } # End of PSData hashtable

} # End of PrivateData hashtable

# HelpInfo URI of this module

#HelpInfoURI = ''

# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.

#DefaultCommandPrefix = ''

}

# SIG # Begin signature block

# MIInsQYJKoZIhvcNAQcCoIInojCCJ54CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC30SD9+knwrM/D

# Q0JRa4gR4oOBZ5V2Xw1oG8JW2dZLEaCCDXYwggX0MIID3KADAgECAhMzAAADTrU8

# esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU

# p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1

# 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm

# WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa

# +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq

# jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk

# mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31

# TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2

# kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d

# hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM

# pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh

# JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX

# UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir

# IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8

# 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A

# Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H

# tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGZEwghmNAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB

# BQCggaAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEILZ175zneT9K4buZL69rUDvm

# BNLaAxHdgzLR9qbxeQR8MDQGCisGAQQBgjcCAQwxJjAkoBKAEABUAGUAcwB0AFMA

# aQBnAG6hDoAMaHR0cDovL3Rlc3QgMA0GCSqGSIb3DQEBAQUABIIBAM94ZByw+Thr

# xRbjrplBZLX92mM08u+GZJI6e70JsERLtv+IeghywIyQ9AjhZW/kC1e5djTqjccl

# GClYHat+cXwWQZF+bpkJV8WjZPytoIRG0009Sxw9pFPA1n2aBTVLP2KCfPzU1BzH

# kUjUR3WzrHGlPp+Mph/XDfONIjzBuxS8fld1ZLcySLjlXlZg4lDNG3BXFJ4PczRK

# mP9x1vbPTMCVtzIqz3MvYXqSs1P/Rec0hjyaYAPs4Za7NevH1qu3Nv7kF+VqWx8s

# IhP4d7pxViDYEy8mKRvUpj+oilQZ/Fr9KLG4VHjWkZ3jLFog8hbT97CpjO7MrnQf

# +txAv6GJVjShghcpMIIXJQYKKwYBBAGCNwMDATGCFxUwghcRBgkqhkiG9w0BBwKg

# ghcCMIIW/gIBAzEPMA0GCWCGSAFlAwQCAQUAMIIBWQYLKoZIhvcNAQkQAQSgggFI

# BIIBRDCCAUACAQEGCisGAQQBhFkKAwEwMTANBglghkgBZQMEAgEFAAQg5Ap2tkrm

# 315JAllUlkcTnc+TqEeGIRoBRpYxE2HH3MACBmVCxFaaSRgTMjAyMzExMDcyMzEy

# MzAuMzY3WjAEgAIB9KCB2KSB1TCB0jELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9u

# cyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4NkRGLTRCQkMtOTMz

# NTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEXgwggcn

# MIIFD6ADAgECAhMzAAAB3V1XHZXUraobAAEAAAHdMA0GCSqGSIb3DQEBCwUAMHwx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTIzMTAxMjE5MDcwOVoXDTI1

# MDExMDE5MDcwOVowgdIxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRl

# ZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046ODZERi00QkJDLTkzMzUxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCoTgOUROoud5x1ER+JZ3yi6fvSb4qbk7XLWoqwsTFE

# qz0suQlitg7a4kD/k+dh12zdoOwJLUNaUGW0wxhcyundN72GDawj7iSvj0bD9hT1

# Q4wV8uZqy0RcyBxy2ogGqGxObxSbqMWdGVnSjArPGnI4R1Jn2mPu/fwke7jfgePs

# YyasL3aVP5qdJgKt3mq8h/gCpr+pZK0DfM4K3GwoB8LKr76k+pRBamKYu7ip+zAG

# G0ni3tKTHWrVeRFujVZ1zGDk0Srhj38nwSnUobmpS6PPJBu6mtpmwOZe+/l9OiQH

# rDJKMmK+P/QoAxYx1KXB0jg7o5RQSjItevM0XS3q3aVtGwV/RA7sdswTDGhCvDcs

# WsAhLgKu/vu5LRQG5d4VCrbs2AtRVGblJdgaulNe0uAirKkd4rS0/ajXG9qQCeI6

# yA3ZZeU4KKnn+YKb/mHLwTPN+G1xTcMrXd7oww9uD/Q3fMX1Sb7po7AUEJCuU/6s

# tx60CfLndZx0r7RVYuUmv7mxrmBKUvIBehg1jefym73hZHbKE1SD6PKZFoYz7NEO

# 5wOfrgcUAeM5YxIys+VluwQOMKZhZtuH4QZkY1eDW6fp+/HIAI7w0n05QOg2AXL9

# pMdSR9nSIWkZ0njl3j0+oTBdCJeffCzLtK8N+VYlFnAEJFDVE8UZ6hhcc+cPmbrD

# AwIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFG6i9baMj1HaRcsh0gylo9COJcPxMB8G

# A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG

# Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy

# MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w

# XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy

# dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG

# A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD

# AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAuVNmyDS4FyB1mzHKlbn/Y5FE/yvM8iwb7

# uYfCa6mEds/3mjtsqNTqHPUocr8W3vRmQ7u5JFM8UsidSGZLGWcOhQ6usmTU9zxI

# wBJ0RKUQS/Evpm14PjuFS0tC0pm/FyGYi7GqmdHwxHL9x3gPv8v6ipwkFpF4IaWh

# DMBjEM0ZIRsHBnV69cxqUOx08b37ue8RcWV9TJCp1hRDSerq3fuLXlIF49J4CDsf

# /5d1zCtx7fE9vs7xiTQBfuf+agZO569O/cyAmxV78bYnTTeXqF3VvvawCJEvlBg9

# fQGXQa7benWfjnQKrgYg5GEOZFX1DCkt9ch0DhoJhcbgjs06Vh2pa6qXSJZbMvCj

# bI+VPbDjYlgHfTzZchBx20GQ5ovfwTZTmMk7dGHoS2w6L5mVDWs5O/TnfwPde5qg

# nU6qxMcARlD2zD/v73WFKmibKbqQZ1LYzn/++gwIVcvHv3us0ffD5KZZpYjtm6y9

# 0N6w+vmQlXaxjPUZuoVAwQZL2IfmI5hnXEORwelk/UXnPPqgx5m4S4V+GXWmq3ef

# zl3i24Mdn+y+EEEI9yoKo6gzliJ1YTRNYGLU1ix3uPPNnf5Oy7otCtYPBGayg+5m

# jq7CSyjypXoHHifRQqmNbA1ClIUWtBB1FvmZCi5aISq0uxcI3ayDVpDwYG0M5wo3

# RNpuO0I02zCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI

# hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy

# MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg

# M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF

# dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6

# GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp

# Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu

# yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E

# XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0

# lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q

# GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ

# +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA

# PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw

# EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG

# NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV

# MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK

# BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC

# AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX

# zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v

# cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI

# KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG

# 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x

# M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC

# VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449

# xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM

# nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS

# PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d

# Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn

# GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs

# QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL

# jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL

# 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggLU

# MIICPQIBATCCAQChgdikgdUwgdIxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMg

# TGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046ODZERi00QkJDLTkzMzUx

# JTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAHBgUr

# DgMCGgMVADYjRxll2zWgz8Z8og2xDnIkoxYQoIGDMIGApH4wfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDo9SvCMCIYDzIwMjMx

# MTA4MDUzMzU0WhgPMjAyMzExMDkwNTMzNTRaMHQwOgYKKwYBBAGEWQoEATEsMCow

# CgIFAOj1K8ICAQAwBwIBAAICBQswBwIBAAICEVcwCgIFAOj2fUICAQAwNgYKKwYB

# BAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGG

# oDANBgkqhkiG9w0BAQUFAAOBgQAFhKvj4CFTMaqp6epOUPmyf8yqd77BNNDAjX29

# JbZGxD+tz6inBC3Y3liJJx8B5J3MTAx5qDVld59keo6sw8T81DgjSO1WxEoo6qvY

# K7wvvk/wcjDqpl4S0mPXeLkauOUWVuxidwiI3HXed9xWAhee6GFXlzH6lfxuBmWO

# SEwINjGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# AhMzAAAB3V1XHZXUraobAAEAAAHdMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG

# 9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIH0C0jYSC0UA/Neb

# eoZOFQrQ34MgqNZzpi+SHp/AotpTMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCB

# vQQgYf8OLZplrE94mZx7R9FZN+1AjdNpUcWPkYjjesAxY2YwgZgwgYCkfjB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAd1dVx2V1K2qGwABAAAB3TAi

# BCBbu72RapEdbB1w/NzLs03MeY7drOwmQ3R3oAtL+HCQNTANBgkqhkiG9w0BAQsF

# AASCAgCDByQXPN+CVcQqHXWBfoBTcWff5JBz6uBzh87k/MFkB7748rr6YGhGn12/

# 74ClJ9ID4d5GGN5nhTM/ON7z4LRjPp2V92FdR3jBJwl10mmKyj2gxBO84nuesAtX

# RQy5/jb54nNpVYIkWgDEfGNlyNVJ1cWdYVdoV4Gm41Vt0XrcYfudlfbLY3A1//kY

# gX7FE03oMgZEkyNv1fkbTunYcDmbMBl7BIiCoubr5NvcW0K5hlQLCwnReQexEhsY

# YTFWccg0LLNXx4hVhBw+0jb+of2eqOI0sM0PQz74zsYvJe4k3vwRp0lM/GeNs7rN

# h42Y3cHBPPusWFqOuMkUjmtYuYuM0pScsB9/VUNN74xpJyh+KVltUxBMn0eRnY09

# gLZdt1SKHO3+/vdN207aYMYhdSrQFbzxYjy44DMKdjHWsCvhUC9bVV5RiflyEL1W

# IcMHj5MXy2VfGUVJhCxdzdRY4EbOLTbgr2FcBB5+NB57m1OFcs41z5z1T7coTT1Y

# eZ2G1RvCcjhvC1sXJQ+eKBfnJu3peI0xQFafOD4HiLvZ2NLYgg73GHSrPET1Gfok

# gAJ6d3g/LJ3lwhGohXOjz09R28eXGIOZmpyr66D/4qCnc2ZBhi77TTToqpZv+2Hf

# 3MVJ2XCS/0LYzLjVhK9jVYzVRlY5juUL8yxYngguW/Oy2EKM8w==

# SIG # End signature block