Microsoft KB Archive/930140

= Error message when you run the Rule Deployment Wizard to deploy the mailbox rules to Microsoft Exchange Server mailboxes in Microsoft Dynamics CRM 3.0 &quot;Failed to save the rule to the user's mailbox&quot; =

Article ID: 930140

Article Last Modified on 8/15/2007

-

APPLIES TO


 * Microsoft Dynamics CRM 3.0

-



SYMPTOMS
In Microsoft Dynamics CRM 3.0, when you run the Rule Deployment Wizard to deploy the mailbox rules to Microsoft Exchange Server mailboxes, you receive the following error message:

Microsoft.Crm.Tools.ExchangeConnectorDeployment.RuleDeploymentException: Failed to save the rule to the user's mailbox.

System.ArgumentException: The parameter is incorrect.

at Microsoft.Crm.Tools.RulesWrapper.RulesClass.Update(Int32 reload)

at Microsoft.Crm.Tools.ExchangeConnectorDeployment.RuleDeploymentSession.DeployRule(DirectoryEntry userDirectoryEntry, String crmEmailAddress, Boolean disabledMode)

End of inner exception stack trace

at Microsoft.Crm.Tools.ExchangeConnectorDeployment.RuleDeploymentSession.DeployRule(DirectoryEntry userDirectoryEntry, String crmEmailAddress, Boolean disabledMode)

at Microsoft.Crm.Tools.ExchangeConnectorDeployment.RuleDeploymentRequest.ProcessNext



CAUSE
This problem occurs if one or more of the following conditions are true.
 * You use the Microsoft Dynamics CRM 3.0 Rule Deployment Wizard to deploy mailbox rules to Microsoft Exchange Server 2007 mailboxes.
 * The fully qualified domain name (FQDN) is listed in the DomainName column of the SystemUserBase table in the _MSCRM database.
 * The existing rules in the user's mailbox exceed a size of 32 kilobytes (KB).
 * There are hidden rules that exist in the user's mailbox. These rules may have been used in an earlier version of Microsoft Office Outlook.
 * The network may be preventing the Rule Deployment Wizard from automatically creating the mailbox rules.



RESOLUTION
To resolve this problem, use one or more of the following methods.

Method 1: Install the updated Microsoft Dynamics CRM 3.0 Rule Deployment Wizard
To deploy mailbox rules to Exchange Server 2007 mailboxes, you must use the updated Rule Deployment Wizard.  Download an update for the Microsoft Dynamics CRM-Exchange E-mail Router. To download this update, visit the following Microsoft Web site:

http://www.microsoft.com/downloads/details.aspx?FamilyID=f7656f0f-4195-4a7d-b654-2786787e1422&displaylang=en

 Uninstall the Microsoft Dynamics CRM-Exchange E-mail Router. To do this, follow these steps:  Click Start, click Run, type appwiz.cpl, and then click OK. In the Add or Remove Programs dialog box, click Microsoft CRM-Exchange E-mail Router, and then click Change/Remove. Click the Uninstall option, and then click Uninstall. Click Yes when you are prompted to uninstall the Microsoft Dynamics CRM-Exchange E-mail Router.</ol> </li> Install the update for the Microsoft Dynamics CRM-Exchange E-mail Router that you downloaded in step 1.</li></ol>

Method 2: Verify the DomainName column
<ol> On the server that is running Microsoft SQL Server and that stores the Microsoft Dynamics CRM databases, open SQL Query Analyzer. To do this, click Start, click All Programs, click Microsoft SQL Server, and then click Query Analyzer.</li> In the Database list, click the _MSCRM database.</li>  Copy the following script, paste the script into the query window, and then click Run. select DomainName from systemuserbase </li> For user records to which you will deploy the Microsoft Dynamics CRM mailbox rules, note any records that use the FQDN. For example, the DomainName column contains AdventureWorksCycle.com\jdoe instead of AdventureWorksCycle\jdoe.</li></ol>

To resolve this problem, contact Microsoft Customer Support Services. For a complete list of Microsoft Customer Support Services telephone numbers, and for information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

Method 3: Verify the size of the rules that are in the mailbox
In Microsoft Exchange Server 2003, the rules in a user's mailbox cannot exceed the size limit of 32 KB. If the user reaches this limit, the Rule Deployment Wizard may fail. For more information about this limit, click the following article number to view the article in the Microsoft Knowledge Base:

147298 Maximum number of rules per folder in the Inbox or in a public folder in Exchange Server 2003, Exchange 2000, and Exchange Server 5.5

For more information about how to work around this limit, click the following article number to view the article in the Microsoft Knowledge Base:

241325 &quot;There is not enough space on the Microsoft Exchange Server to store all of your rules&quot; error message when you create or import a rule in Outlook

Method 4: Delete hidden rules that may have been used by an earlier version of Outlook
<ol> Download the MFCMAPI tool. To do this, visit the following Microsoft Web site:

http://www.microsoft.com/downloads/details.aspx?familyid=55FDFFD7-1878-4637-9808-1E21ABB3AE37&displaylang=en

</li> Log on to the client computer to which you are deploying the rule.</li> Install the MFCMAPI tool.</li> Click OK to close the information window.</li> On the Session menu, click Logon and display message store.</li> In the Profile Name option, click Default Outlook Profile, and then click OK.</li> You should now see a list of the different mailbox folder groups for this user. Double-click the Mailbox -  folder. The Mailbox window opens, and the Root - Mailbox group is displayed on the left.</li> Expand Root - Mailbox.</li> Expand IPM_SUBTREE.</li> Right-click Inbox, and then click Display Rules Table. A window opens that lists all the rules for this user. This includes hidden rules.</li> Delete each rule that has a name of #NET FOLDERS#. To delete a rule, right-click the rule, and then click Delete.

Note Verify that you want to delete each rule before you click Delete. There are no confirmation questions.</li> <li>Run the Rule Deployment Wizard, and then deploy the rule to this user's mailbox.

The &quot;#NET FOLDERS#&quot; rules are hidden rules that remain from users who may have used Microsoft Office Outlook 98 or Microsoft Office Outlook 2000. The hidden rules were created in earlier versions of Outlook to let users share e-mail folders within the Exchange Server mailbox.</li></ol>

<div class="workaround_section">

WORKAROUND
If the problem still occurs, you can work around the problem by manually creating the rule on the user's mailbox. To do this, follow these steps:
 * 1) Start Outlook.
 * 2) Click Tools, click Rules and Alerts, and then click New Rule.
 * 3) Click Check messages when they arrive, and then click Next.
 * 4) Click Where my name is in the To or Cc box, and then click Next.
 * 5) Click Forward it to people or distribution list as an attachment, click people or distribution list in the Step 2 section, double-click the Microsoft Dynamics CRM forward mailbox account that you created when you installed the Microsoft Dynamics CRM E-Mail Exchange Router, and then click OK.
 * 6) Click Next, and then click Finish.

You can export the rule from one client computer, and then import that rule to another computer by using the Export Rules option and the Import Rules option. For more information, see Outlook Help.

<div class="moreinformation_section">

MORE INFORMATION
The Rule Deployment Wizard is a part of the Microsoft Dynamics CRM-Exchange E-mail Router.

You cannot install the Microsoft Dynamics CRM-Exchange E-mail Router on a computer that is running Exchange Server 2007. You still have to install the Microsoft Dynamics CRM-Exchange E-mail Router on a computer that is running Exchange Server 2003. However, you can deploy rules to an Exchange Server 2007 mailbox.

Keywords: kberrmsg kbtshoot kbmbsmigrate kbprb KB930140

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.