Install Microsoft Dynamics CRM 2013 for Outlook for desktop virtualization

  • Article

 

Applies To: Dynamics CRM 2013

This topic describes how to install CRM for Outlook with roaming user profiles by using Windows Server Remote Desktop Services.

In This Topic

Roaming user profiles

Windows Server Remote Desktop Services

Support for Citrix XenApp 6.5 session virtualization for Microsoft Dynamics CRM for Outlook on a single XenApp instance

Roaming user profiles

A roaming user profile is a copy of the local user profile that is copied to, and stored on, a server share. The advantage of roaming user profiles is that users do not have to create a profile on each computer that they use on a network. Their profile is downloaded to each computer that they log on to on a network. Changes made to a roaming user profile are synchronized with the server copy of the profile when the user logs off.

While the roaming user profile moves with the user, software applications such as CRM for Outlook do not. Identical applications have to be installed on each computer that the user logs on to.

Windows Server Remote Desktop Services

Remote Desktop Services is a centralized desktop and application platform solution that uses presentation and desktop virtualization technologies.

CRM 2013 for Outlook is supported for running on Windows Server 2008, Windows Server 2008 R2, or Windows Server 2012 Remote Desktop Services. When users run an application on Remote Desktop Services, the application execution occurs on the server. Only keyboard, mouse, and display information are transmitted over the network. Users see only their own individual sessions, which are managed transparently by the server operating system and remain independent of any other client session.

More information: Remote Desktop Services

Deploy CRM for Outlook to use as a Remote Desktop Services application

The following is the basic procedure required to deploy CRM for Outlook to use as a Remote Desktop Services application.

  1. Provide at least one Microsoft Windows Server that is running the Remote Desktop Services server role. More information: Remote Desktop Services

  2. Install CRM for Outlook using the /disableofflinecapability parameter on the Remote Desktop Services server. Go offline mode is not supported when CRM for Outlook is installed for Remote Desktop Services use. More information:  Install Microsoft Dynamics CRM for Outlook using a command prompt

    Important

    The CRM for Outlook offline database is not supported for roaming profile use.

  3. Run the Microsoft Dynamics CRM Configuration Wizard on the Remote Desktop Services server. For instructions, see Task 2: Configure Microsoft Dynamics CRM for Outlook.

  4. Disable the Microsoft Dynamics CRM Configuration Wizard on all desktops that will be used to connect to Remote Desktop Services and run CRM for Outlook. For details, see the section below.

Disable the CRM for Outlook Configuration Wizard

Note

The information in this topic applies to CRM for Outlook deployments that use Remote Desktop Services. To remove only the Get CRM for Outlook button for CRM for Outlook deployments that don’t use Remote Desktop Services, see the “Set whether users see CRM for Outlook message” setting in System Settings dialog box – Outlook tab.

The CRM for Outlook Configuration Wizard starts every time a roaming user connects to a Windows Server that is running Remote Desktop Services. In addition, users will see the option to configure CRM for Outlook when they run Microsoft Office Outlook.

Tip

Instead of manually creating the registry key as described here, you can use Group Policy or a logon script to create the registry key for the Remote Desktop Services users who do not use CRM for Outlook.

Warning

Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require you to reinstall the operating system and Microsoft Dynamics CRM. We can’t guarantee that these problems can be resolved. Modify the registry at your own risk.

To disable the CRM for Outlook Configuration Wizard and the option to configure CRM for Outlook in Microsoft Outlook 2010 and Microsoft Outlook 2013, follow these steps on the client computer.

Disable the Configuration Wizard when you use Office 2010 and Office 2013

  1. On the computer where Microsoft Office is installed, start Registry Editor (regedit.exe).

  2. Locate the following registry subkey: HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins

  3. Right-click Addins, point to New, and then click Key.

  4. Type crmaddin.Addin, and then press ENTER.

  5. Right-click crmaddin.Addin, point to New, and then click DWORD Value or DWORD (32-bit) Value.

  6. Type LoadBehavior and then press ENTER.

  7. Right-click LoadBehavior, and then click Modify.

  8. Type 8 in the Value Data box, click Decimal, and then click OK.

  9. Exit Registry Editor.

To disable the CRM for Outlook Configuration Wizard and the option to configure CRM for Outlook in Microsoft Office 2007, follow these steps on the client computer:

Disable the Configuration Wizard when you use Office 2007

  1. On the computer where Microsoft Office is installed, start Registry Editor (regedit.exe).

  2. Locate the following registry subkey: HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Outlook\Resiliency\DisabledItems

  3. Right-click DisabledItems, point to New, and then click Binary Value.

  4. Type CRMAddin and then press ENTER.

  5. Right-click CRMAddin and then click Modify.

  6. Enter the following in the Value Data box and then click OK:

    Use this value for:

    • 32-bit versions of Microsoft Office and CRM for Outlook running on 32-bit versions of Windows.

    • 64-bit versions of Microsoft Office and CRM for Outlook running on 64-bit versions of Windows.

    hex:01,00,00,00,80,00,00,00,2e,00,00,00,63,00,3a,00,5c,00,70,00,72,\ 
00,6f,00,67,00,72,00,61,00,6d,00,20,00,66,00,69,00,6c,00,65,00,73,00,5c,00,\ 
6d,00,69,00,63,00,72,00,6f,00,73,00,6f,00,66,00,74,00,20,00,64,00,79,00,6e,\
00,61,00,6d,00,69,00,63,00,73,00,20,00,63,00,72,00,6d,00,5c,00,63,00,6c,00,\
69,00,65,00,6e,00,74,00,5c,00,62,00,69,00,6e,00,5c,00,63,00,72,00,6d,00,61,\
00,64,00,64,00,69,00,6e,00,2e,00,64,00,6c,00,6c,00,00,00,6d,00,69,00,63,00,\
72,00,6f,00,73,00,6f,00,66,00,74,00,20,00,64,00,79,00,6e,00,61,00,6d,00,69,\
00,63,00,73,00,20,00,63,00,72,00,6d,00,00,00

    Use this value for 32-bit versions of Microsoft Office and CRM for Outlook on 64-bit versions of Windows.

    hex:01,00,00,00,8c,00,00,00,2e,00,00,00,63,00,3a,00,5c,00,70,00,72,\00,6f,00,67,00,72,00,61,00,6d,00,20,00,66,00,69,00,6c,00,65,00,73,00,20,00,\28,00,78,00,38,00,36,00,29,00,5c,00,6d,00,69,00,63,00,72,00,6f,00,73,00,6f,\00,66,00,74,00,20,00,64,00,79,00,6e,00,61,00,6d,00,69,00,63,00,73,00,20,00,\63,00,72,00,6d,00,5c,00,63,00,6c,00,69,00,65,00,6e,00,74,00,5c,00,62,00,69,\00,6e,00,5c,00,63,00,72,00,6d,00,61,00,64,00,64,00,69,00,6e,00,2e,00,64,00,\6c,00,6c,00,00,00,6d,00,69,00,63,00,72,00,6f,00,73,00,6f,00,66,00,74,00,20,\00,64,00,79,00,6e,00,61,00,6d,00,69,00,63,00,73,00,20,00,63,00,72,00,6d,00,\00,00

    Important

    This binary value is based on the default installation locations of the Crmaddin.dll file. By default, the Crmaddin.dll file is installed in one of the following file system locations:

    C:\Program Files\Microsoft Dynamics CRM\Client\bin\crmaddin.dll

    C:\Program Files (x86)\Microsoft Dynamics CRM bin\crmaddin.dll

    If the Crmaddin.dll file is installed in a different location, the binary value in this step will be different.

  7. Exit Registry Editor.

Support for Citrix XenApp 6.5 session virtualization for Microsoft Dynamics CRM for Outlook on a single XenApp instance

Microsoft will support a configuration that is Citrix XenApp 6.5 with session virtualization for Microsoft Dynamics CRM for Outlook on a single XenApp instance. That support is only for Microsoft Dynamics CRM 2013 Service Pack 1 for Microsoft Office Outlook.

Please note that Citrix deployment may include a complex configuration topology based on other configurations, and these are not supported. For example, these configurations are not supported:

  • Citrix products like XenApp (except for version 6.5), XenDesktop, and XenServer and versions of these products

  • Application streaming modes

  • Modes of application deployment

  • Options for load balancing

  • Application virtualization layered on top of other virtualization technologies (such as Network and storage virtualization technologies)

See Also

Advanced deployment options for Microsoft Dynamics CRM for Outlook
Install language packs for Microsoft Dynamics CRM 2013
Install CRM for Outlook for Microsoft Dynamics CRM 2013