Install Dynamics 365 for Outlook

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

To set up Microsoft Dynamics 365 for Outlook on a user’s computer, you need to install the software, and then configure it. This topic describes how to set up and configure Dynamics 365 for Outlook, and also how to enable multi-factor authentication (MFA) through OAuth. Using MFA can help make client authentication more secure, especially for mobile users.

For information about installing Dynamics 365 for Outlook at a command prompt (silent installation), see Install Microsoft Dynamics 365 for Outlook using a command prompt.

For information about installing Dynamics 365 for Outlook using System Center Configuration Manager (SCCM), see the download Use SCCM to install Dynamics 365 for Outlook.

Important

  • You can’t install Dynamics 365 for Outlook on a computer running Microsoft Exchange Server.

  • Tracking activities is not supported when Dynamics 365 App for Outlook and Dynamics 365 for Outlook are used together by the same user.

  • Microsoft has released Dynamics 365 for Microsoft Outlook version 8.2.2.137 update. This update includes support for Transport Layer Security (TLS) 1.2, which is required for connecting Dynamics 365 for Outlook with Dynamics 365 (online), version 9.0. See Version 8.2.2.137 Update for Dynamics 365 for Microsoft Outlook.

In This Topic

Install Dynamics 365 for Outlook

Configure Dynamics 365 for Outlook

Enable multi-factor authentication through OAuth

Install Dynamics 365 for Outlook

You can add offline capability for the user either during this installation or at a later time.

Tip

If you encounter an issue installing, connecting, or enabling Dynamics 365 for Outlook with your Dynamics 365 (online) organization, use the Microsoft Support and Recovery Assistant to diagnose and fix the issue. You’ll need to sign in to the diagnostics tool with your Dynamics 365 (online) credentials.

  1. Meet the Dynamics 365 for Outlook requirements specified in Microsoft Dynamics 365 for Outlook hardware requirements and Dynamics 365 for Outlook support.

  2. Log on to the computer as a local administrator.

  3. Make sure that the latest Microsoft Office updates are installed, including all security updates. To verify, visit Microsoft Update.

  4. Locate and run the appropriate installation file by choosing one of the following methods:

    • To install from the web, go to Microsoft Dynamics CRM 2016 for Microsoft Office Outlook (Outlook Client), and then download and run the executable file that matches the installed Microsoft Office architecture.

    • To install from a DVD, double-click SetupClient.exe in the installation folder for the architecture (32-bit or 64-bit) of Microsoft Office that you’ve installed:

      • ... \Client\amd64 for 64-bit

      • ... \Client\i386 for 32-bit

    • To install from the Microsoft Dynamics 365 web application:

      1. Click the Settings button Settings button, and then click Apps for Dynamics 365.

      2. On the Apps for Dynamics 365 page, click Download from Microsoft Download Center.

      3. If you see any dialog boxes titled Security Warning, click Run in each.

      The Microsoft Dynamics 365 for Microsoft Office Outlook Setup wizard starts.

  5. On the License Agreement page, review the information. If you accept the license agreement, select I accept the license agreement, and then click Next.

  6. If the Get Recommended Updates page appears, indicate whether you want to obtain updates through the Microsoft Update program, and then click Next.

    Note

    Microsoft releases improvements to Dynamics 365 for Outlook as software updates. If you click Get Recommended Updates, those updates will be installed automatically. The exact level of automation, for example, whether any user interaction is required during the installation, is determined by the group policy of your organization.

  7. Click Install Now or Options.

    • To install Dynamics 365 for Outlook with offline capability, click Options, select Offline Capability on the Customize Installation page, and then click Install Now. Although offline capability lets you run Microsoft Dynamics 365 without a network or Internet connection, it does require the installation of additional technologies and places more demand on your computer’s processor and memory. For more information about the minimum recommended requirements, see Microsoft Dynamics 365 for Outlook hardware requirements.

    • To install Dynamics 365 for Outlook without offline capability, click Install Now.

    Important

    If you don’t install offline capability at this point, the user will initially have no offline capability. If you click Install Now, the Outlook user can add offline capability later by clicking Go Offline in Outlook.

    The program features are installed and a progress indicator is displayed. You may be asked to restart your computer to complete the installation.

  8. On the completion page of the Microsoft Dynamics 365 for Microsoft Office Outlook Setup wizard, click Close.

Configure Dynamics 365 for Outlook

After Dynamics 365 for Outlook is installed, it must be configured. When you restart Outlook after you’ve installed Dynamics 365 for Outlook, the configuration wizard starts automatically.

Note

If you don’t want to configure Dynamics 365 for Outlook immediately after you install it, click Cancel. A Configure Microsoft Dynamics 365 for Outlook button then appears on the Outlook toolbar and will remain there until you configure Dynamics 365 for Outlook.

If the wizard doesn’t start automatically, you can start it as follows: On the Start screen, click Configuration Wizard or on earlier versions of Windows click Start > All Programs > Microsoft Dynamics 365, and then click Configuration Wizard. Alternatively, click Configure Microsoft Dynamics 365 for Outlook on the Dynamics 365 tab in Outlook.

If you encounter an issue configuring Dynamics 365 for Outlook with your Dynamics 365 (online) organization, use the Microsoft Dynamics CRM for Outlook Configuration Diagnostic to fix the issue. You’ll need to sign in to the diagnostics tool with your Dynamics 365 (online) credentials.

  1. To add an organization, choose one of the following:

    • To connect to a Microsoft Dynamics 365 (online) organization, choose Dynamics 365 (online) from the drop-down list.

    • To connect to an on-premises deployment of Microsoft Dynamics 365, type the discovery-service URL for Microsoft Dynamics 365 in the format https://orgname.contoso.com for Internet-facing deployment (IFD) or http://crmserver:5555 for internal deployments.

  2. Click Connect.

    If you are prompted for credentials, select from the following options.

    • For a Microsoft Dynamics 365 (online) organization, enter your Microsoft Online Services user name and password, and then click OK. This information should have been sent to you in email when your account was added.

    • For an on-premises deployment of Microsoft Dynamics 365, you may not be prompted because Microsoft Dynamics 365 will use your Active Directory domain credentials.

  3. Click Close.

  4. If you’re a member of more than one organization, restart the Configuration Wizard to designate a different organization as your current organization.

Enable multi-factor authentication through OAuth

In the Microsoft Dynamics 365 for Outlook Configuration Wizard, System Administrators can enable multi-factor authentication through the OAuth 2.0 Framework. OAuth 2.0 is an open framework for authorization that lets users provide access tokens, instead of credentials, to access data hosted by a given service provider (such as Dynamics 365). Using MFA can help make client authentication more secure, especially for mobile users. Dynamics 365 (online and on-premises) versions of Microsoft Dynamics 365 can take advantage of MFA; Microsoft Dynamics 365 on-premises requires at least Windows Server 2012 R2. Dynamics 365 (online) automatically uses OAuth.

If you have upgraded your authentication server to use OAuth prior to installing Dynamics Dynamics 365 for Outlook, Dynamics Dynamics 365 for Outlook will automatically check for and use OAuth for MFA. Users will see the OAuth sign-in form the first time they use Dynamics Dynamics 365 for Outlook.

If you upgrade your authentication server to use OAuth after rolling out Dynamics Dynamics 365 for Outlook, you have two options to set Dynamics Dynamics 365 for Outlook to use OAuth.

  1. Reconfigure Dynamics 365 for Outlook on all computers. Run the Microsoft Dynamics 365 for Outlook Configuration Wizard and remove and re-add your organization.

    -- OR --

  2. Use Group Policy to update the following registration key:

    HKEY_CURRENT_USER\Software\Microsoft\MSCRMClient\{orgid}.

    Set AuthenticationProvider to 0

    After the registry change, Dynamics Dynamics 365 for Outlook will automatically check for and use OAuth for MFA.

In addition

You might need to enable the following AD FS endpoint: /adfs/service/trust/13/windowstransport

For information on enabling an endpoint, see Sign in to Office 365, Azure, or Intune fails after you change the federation service endpoint.

See Also

Dynamics 365 for Outlook support
Blog: Microsoft Dynamics CRM for Outlook Configuration Diagnostic
Deploy Microsoft Dynamics 365 for Outlook by using Group Policy

© 2017 Microsoft. All rights reserved. Copyright