This documentation is archived and is not being maintained.

Common Provider Configuration Settings

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

The following settings are common to both outbound and inbound providers. Be aware that all time intervals in the configuration file are specified in milliseconds.

Tag NameDescription
ProviderConfigurationDefines a group of settings for a single e-mail provider. Each provider has its own set of settings.

A deploymentId tag attribute is supported. The deployment ID is used in the E-mail Configuration Wizard (ECW). For all ECW generated provider nodes, the ID value is a GUID. If a non-GUID value is used, the E-mail Router treats this as a manual entry by the user and maintains it in successive updates of the configuration file.

ProviderAssemblyIdentifies the name of the assembly that contains the providers.
ProviderClassIdentifies the fully qualified name of the provider class within the assembly.
CrmServerUrlDefines the Microsoft Dynamics CRM server URL to which the provider will synchronize e-mail.
CrmAuthModeDefines the mode used to authenticate against the Microsoft Dynamics CRM server. Supported mode values are as follows: WindowsAuthentication, Passport, and ClearText.
CrmUserDefines the user account that is used to connect to Microsoft Dynamics CRM.
CrmPasswordDefines an encrypted user account password that is used when the service connects to Microsoft Dynamics CRM. For more information, see note 1 later in this topic.
EmailServerDefines the name of the e-mail server.
EmailAuthModeDefines the mode used to authenticate with the e-mail server. Supported values are as follows: WindowsAuthentication (default), NTLM, ClearText, and Anonymous.
LogLevelDefines the log level for the provider where: 1 = Normal, 2 = Advanced, 3 = Details.
TargetIndicates the e-mail target to interact with. For the outgoing e-mail provider, specify the e-mail server name. For an inbound provider, specify the mailbox name.
DirectionIndicates if the provider is an inbound or outbound provider. Supported values are as follows: Inbound, Outbound.
CacheCapacityDefines the cache capacity (hash table) size. A typical value is 1024.
ConnectionTimeoutDefines the length of time before a connection time-out occurs for the action against the e-mail server.
PollingPeriodDefines the time interval after which the provider should be rescheduled.
MaxMessageCountDefines the maximum number of messages to download in one polling period.
EmailPortDefines the e-mail port to use when interacting with the e-mail server.


The file that contains the encryption key is named EncryptionKey.xml and is located in the same folder as the configuration XML file. The value of the CrmPassword tag must be encrypted (or decrypted) by using the Microsoft.Crm.Encryptor class. The class constructor accepts the name of the encryption key file as a parameter.

See Also


© 2010 Microsoft Corporation. All rights reserved.