使用命令提示符安装 Microsoft Dynamics 365 for Outlook
发布日期： 2017年2月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
安装 Microsoft Dynamics 365 for Outlook 分两步进行。 首先，必须运行安装程序以便在计算机上安装文件。 接下来，运行 Microsoft Dynamics 365配置向导 配置应用程序和完成安装。
重要
如果配置文件中的值和命令行参数中的值之间存在冲突，则命令行参数优先。
本主题内容
步骤 1：安装文件
步骤 2：使用 XML 配置文件来配置 Dynamics 365 for Outlook
配置 Dynamics 365 for Outlook 的命令示例
Dynamics 365 for Outlook XML 配置文件元素
在运行配置向导时，需要用户凭据
用于配置的 Dynamics 365 for Outlook 的 XML 配置文件示例
步骤 1：安装文件
备注
有关下载说明，请参阅安装 Dynamics 365 for Outlook。
以下命令显示可用于在命令提示符处运行 Microsoft Dynamics CRM for Outlook 安装程序的选项：
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
安装 Dynamics 365 for Outlook 的命令示例
对于需要出差或不是始终连接到 Microsoft Dynamics 365 服务器的用户，带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook 可提供对其客户数据的访问。 若要以安静模式安装带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook，请运行以下命令：
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
以安静模式卸载 带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook：
SetupClient /x /q
Dynamics 365 for Outlook 安装的参数
参数 |
说明 |
|---|---|
无 |
如果不使用参数，则 Setupclient.exe 在运行时将显示所有屏幕。 |
installofflinecapability |
确定是否安装脱机功能。 如果包括此参数，将安装脱机功能和组件。 如果不指定此参数，将安装仅限联机使用的客户端。 |
/targetdir <"drive:\path"> |
指定将在其中安装 Dynamics 365 for Outlook 文件的文件夹。 |
/A |
通过创建 Windows Installer 程序包来创建 Dynamics 365 for Outlook 的管理安装。 该程序包允许用户从网络共享位置运行 安装，或者允许非管理员用户运行由组策略驱动的 安装。 此参数必须与前面描述的 /targetdir 参数一起使用。 使用此参数时，“/targetdir”值不必位于本地计算机上。 可以使用映射驱动器或网络共享位置（例如 \\share\mscrm_client_admin）。 重要 如果不使用 /targetdir 参数指定目标文件夹，安装 会将管理安装安装到默认文件夹 <驱动:> Program Files\Microsoft Dynamics CRM。 例如，命令： |
/Q |
安静模式安装。 此参数需要一个 XML 格式的配置文件。/i 参数包含 XML 配置文件的名称。 不会在显示屏幕上显示任何对话框或错误消息。 若要捕获错误消息，请包含日志文件参数（/L 或 /LV）。 |
/L [drive:][[path] logfilename.log] |
创建一个安装活动日志文件。 必须指定日志文件的文件名及放置位置，但路径不能是相对路径（如 %appdata%\CRMLogs）。 |
/LV [drive:][[path] logfilename.log] |
创建一个详细的安装活动日志文件。 必须指定日志文件的文件名及放置位置，但路径不能是相对路径（如 %appdata%\CRMLogs）。 |
disableofflinecapability |
如果指定此参数，Dynamics 365 for Outlook 将配置为在应用程序中隐藏“脱机”按钮。 此按钮使用户可以切换到具有脱机功能的 Dynamics 365 for Outlook。 |
ignoreofflinequeue |
如果指定此参数，安装将不会尝试同步升级过程中可能仍留在脱机队列中的项目。 |
/X |
卸载 Dynamics 365 for Outlook。 这是一个只有在已安装应用程序时才可用的维护模式选项。 |
用于安装的 Dynamics 365 for Outlook 的 XML 配置文件示例
以下配置文件示例会在 Program Files 文件夹中安装不带脱机访问功能的 Dynamics 365 for Outlook。
备注
可以使用同时包含安装和配置元素的同一文件。安装 和 配置向导 会忽略与操作无关的元素。
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
步骤 2：使用 XML 配置文件来配置 Dynamics 365 for Outlook
安装 Dynamics 365 for Outlook 后，必须对其进行配置。 可以通过在命令提示符处运行 Dynamics 365 for Outlook配置向导 来完成。配置向导 文件名为“Microsoft.Crm.Application.Outlook.ConfigWizard.exe”，位于已安装 Dynamics 365 for Outlook 的 Client\ConfigWizard 文件夹中。 默认情况下，文件夹为 C:\Program Files\Microsoft Dynamics CRM。
备注
将使用运行 Dynamics 365 for Outlook 的用户的凭据来验证到 Microsoft Dynamics 365。 因此，若要执行 Dynamics 365 for Outlook 的静默配置，您必须在用户上下文中运行配置向导（如通过运行用户调用的批处理文件或者通过在登录脚本中进行一次性输入运行）。 有关详细信息，请参阅在运行配置向导时，需要用户凭据。 若要使用 Microsoft 组策略部署 Dynamics 365 for Outlook，请参阅使用组策略部署 Microsoft Dynamics 365 for Outlook。
如果未指定配置文件的路径，配置向导 将在非漫游配置文件夹 (%localappdata%\Microsoft\MSCRM\ 中查找默认配置文件 (default_client_config.xml)。 如果该文件不在非漫游配置文件文件夹中，配置向导 将在已安装 Dynamics 365 for Outlook 的文件夹中查找。 在默认情况下，将 Dynamics 365 for Outlook 安装在 C:\Program Files\Microsoft Dynamics CRM 文件夹中。
如果配置文件位于其他应用程序使用的漫游位置 (AppData\Roaming\Microsoft\MSCRM\)，将不会使用该文件。
配置 Dynamics 365 for Outlook 的命令示例
以下命令将使用名为 config_client.xml 的文件以安静模式配置带脱机访问功能的 Microsoft Dynamics 365 for Outlook，并输出一个名为 clientinstall.log 的日志文件：
Microsoft.Crm.Application.Outlook.ConfigWizard.exe /Q /i c:\config_client.xml /xa /l c:\clientinstall.log
/“Q”安静模式配置参数需要一个 XML 格式的配置文件。 不会在显示屏幕上显示任何对话框或错误消息。 若要捕获错误消息信息，请包含日志文件参数 (/L) 或详细日志记录 (/LV)。
重要
若要以安静模式运行 配置向导，需要在 Windows 保管库存储的有效用户凭据。详细信息：在运行配置向导时，需要用户凭据
/i [drive:] [[path] configfilename.xml]] 命令行参数为 Microsoft Dynamics CRM for Outlook 安装程序 提供必需信息。 这些信息正是各个安装屏幕所需的信息。XML 元素必须采用英语（美国）编写；不能使用特殊字符或扩展字符。 包含本地化 XML 元素的 XML 配置文件将无法正常工作。 下面对各个 XML 元素进行解释，并给出一个示例 XML 文件：
/xa 参数与 /q 参数一起使用时，将删除为 Dynamics 365 for Outlook 配置的所有组织。
/R 参数用于隐藏 配置向导 用户界面和仅显示“进度”对话框。 此参数需要一个名称为 Default_Client_Config.xml 的有效 XML安装 文件，且必须位于本地用户 AppData 或客户端安装文件夹中。
Dynamics 365 for Outlook XML 配置文件元素
元素 |
说明 |
|---|---|
<Deployments> </Deployments> |
配置文件必须是使用<“部署”>作为根元素的有效 XML 文件。 |
<InstallOfflineCapability>true/false</InstallOfflineCapability> |
指定 Dynamics 365 for Outlook 的安装类型。 指定 true 将安装 带脱机访问功能的 Microsoft Dynamics 365 for Outlook 功能。 |
<TargetDir>drive:\path</TargetDirectory> |
指定将在其中安装 Dynamics 365 for Outlook 文件的文件夹。 |
<Deployment> </Deployment> |
接下来的所有元素的上级元素。 |
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> |
指定 Microsoft Dynamics 365Discovery Web Service 的 URL。 对于 Microsoft Dynamics 365 服务器 本地部署，支持的绑定可以是 HTTPS 或 HTTP。 如果Discovery Web Service使用的是默认端口 80 (HTTP) 或 443 (HTTPS) 之外的端口，则必须指定端口号。 如果这是 Microsoft Dynamics 365 服务器 的一个完全服务器部署，则Discovery Web Service URL 与 Web 应用程序的 URL 相同（如 http:// crmserver）。 对于 Microsoft Dynamics 365 (online)，请使用整个组织 URL（如 https://orgname.crm.dynamics.com），或者根据联机环境和位置，使用窗体 https://disco.crm.dynamics.com 中的发现服务 URL。 有关 URLs 的列表，请参阅 MSDN：发现服务。 |
<FederatedAuthentication>true/false</FederatedAuthentication> |
指定联合 (Azure Active Directory) 凭证是否用于在 配置向导 中进行身份验证。 如果指定 false，可以使用凭证，例如 user@contoso.onmicrosoft.com。 |
<Organizations> </Organizations> |
它是随后的 <“Organization”> 元素的上级元素。 |
<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization> |
指定客户端将连接到的组织的名称。 FriendlyName。 指定与 Outlook 中的组织名称不同的其他显示名称。 IsPrimary。 指定将配置为 Dynamics 365 for Outlook 中的同步组织的组织。 备注 OrganizationName 区分大小写。 |
<CEIPNotification>true/false</CEIPNotification> |
指定 Dynamics 365 for Outlook 是否显示“我想要加入客户体验改进计划”提示标语。 默认设置为 true，并显示提示标语。 如果指定 false，提示标语不出现在 Dynamics 365 for Outlook。详细信息：Microsoft 客户体验改善计划 |
在运行配置向导时，需要用户凭据
配置向导 要求用户凭据。 在静默配置过程中，通过使用带 /Q 参数的 Microsoft.Crm.Application.Outlook.ConfigWizard.exe 文件，配置向导 将在 Windows 保管库中查找用户的凭据。 如果 配置向导 找不到凭据，或者凭据未采用所需格式，则配置将无法完成，并向配置日志中记录错误。 请注意，配置向导 不支持在 XML 配置文件中添加用户 UPN 或密码。 有关如何通过命令脚本向 Windows 保管库添加用户凭据的信息，请参阅博客文章在支持 CRM 2011 声明的环境中静默配置 CRM for Outlook 客户端。 有关 Windows 保管库和凭据管理器的详细信息，请参阅什么是凭据管理器。
用于配置的 Dynamics 365 for Outlook 的 XML 配置文件示例
以下配置文件示例可将 Dynamics 365 for Outlook 配置为连接到名为 crmserver 的 Microsoft Dynamics 365 服务器上一个名为 Contoso 的主要组织和另一个名为 AdventurewWorksCycle 的组织。
备注
可以使用同时包含安装和配置元素的同一文件。安装 和 配置向导 会忽略与操作无关的元素。
示例 Default_Client_Config.xml 文件
<Deployments>
<Deployment>
<DiscoveryUrl>http://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
备注
之前的示例指定了用户可以访问的两个不同组织并将配置 Dynamics 365 for Outlook 配置为不显示“我要加入客户体验改善计划”通知标语。Organization 元素中的值不能包含特殊字符或空格。 对于 Dynamics 365（本地），可以通过运行 Get-CrmOrganization Windows PowerShell cmdlet 查找组织唯一名称，或转至“设置”>“自定义”>“开发人员资源”，然后在“实例参考信息”下复制“唯一名称”。
使用脚本配置 Dynamics 365 for Outlook
编写一个脚本以自动更新 Dynamics 365 for Outlook 用户的配置设置。 可以使用以下代码行，基于名为 servername 的计算机上存储的新配置文件执行基本配置操作。
在以下脚本中，将覆盖默认客户端配置文件，移除以前配置的组织，将用户凭据添加到 Windows 保管库，并安装新组织。
copy /y \\<servername>\share\Default_Client_Config.xml "c:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml" "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /xa cmdkey /generic:Microsoft_CRM_https://disco.crm.dynamics.com/ /user:user@contoso.com /password{password_goes_here} "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /i "C:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"提示
考虑将您的脚本作为登录脚本运行，或者强制脚本在特定时间运行，例如使用 Microsoft System Center 2012 Configuration Manager。
在脚本中，您可能还想包括检测逻辑以确定客户端计算机是否已配置。 如果已配置，则可以让脚本退出而不执行任何操作。
示例 Default_Client_Config.xml 文件
<Deployment> <DiscoveryUrl>http://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>在组织中其服务器已更改的每个客户端计算机上运行该脚本。 可以通过多种方式运行该脚本，包括通过 Active Directory 用户和计算机 (ADUC) 的用户属性对话框的“配置文件”选项卡，或通过组策略对象 (GPO)。
另请参阅
安装 Dynamics 365 for Outlook
设置 Dynamics 365 for Outlook
使用命令提示符安装 Microsoft Dynamics CRM 服务器
Dynamics 365 for Outlook
© 2017 Microsoft。 保留所有权利。 版权