使用命令提示符安装 Microsoft Dynamics 365 for Outlook

项目
03/21/2023

安装 Microsoft Dynamics 365 for Outlook 分两步进行。首先，必须运行安装程序以便在计算机上安装文件。接下来，运行 Dynamics 365 for Customer Engagement 配置向导来配置应用程序，完成安装。

重要提示

如果配置文件中的值和命令行参数中的值之间存在冲突，则命令行参数优先。

步骤 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 的安装命令示例

对于需要出差或不是始终连接到 Dynamics 365 Server 的用户，带脱机访问功能的 Dynamics 365 for Microsoft Office Outlook 可提供对其客户数据的访问。要在安静模式下安装带脱机访问功能的 Dynamics 365 for Microsoft Office Outlook：

Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"

要在安静模式下卸载带脱机访问功能的 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` 参数指定目标文件夹，安装程序会将管理安装安装到默认文件夹 <drive:> Program Files\Microsoft Dynamics CRM。例如，命令： `Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"`
/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 的用户的凭据来对 Dynamics 365 for Customer Engagement 进行身份验证。因此，若要执行 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 配置的 CRM 命令示例

以下命令将使用名为 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 [驱动器:] [[路径] 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>	配置文件必须是使用 <Deployment> 作为根元素的有效 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>	指定 Dynamics 365 for Customer EngagementDiscovery Web 服务的 URL。对于 Dynamics 365 for Customer Engagement，使用完整组织 URL（如 https://orgname.crm.dynamics.com），或者根据联机环境和位置，使用窗体 https://disco.crm.dynamics.com 中的发现服务 URL。有关 URL 的列表，请参阅 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 保管库和凭据管理器的详细信息，请参阅什么是凭据管理器。

用于配置的示例 Dynamics 365 for Outlook XML 配置文件

以下配置文件示例可将 Dynamics 365 for Outlook 配置为连接到名为 crmserver 的 Dynamics 365 Server 上一个名为 Contoso 的主要组织和另一个名为 AdventureWorksCycle 的组织。

备注

可以使用同时包含安装和配置元素的同一文件。安装程序和配置向导会忽略与操作无关的元素。

示例 Default_Client_Config.xml 文件

<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>

备注

之前的示例指定了用户可以访问的两个不同组织并将配置 Dynamics 365 for Outlook 配置为不显示“我要加入客户体验改善计划”通知标语。 Organization 元素中的值不能包含特殊字符或空格。对于 Customer Engagement (on-premises)，可以通过运行 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>https://CrmDiscoveryUrl</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Organization1</Organization>
</Organizations>
</Deployment>
```
在组织中其服务器已更改的每个客户端计算机上运行该脚本。可以通过多种方式运行该脚本，包括通过 Active Directory 用户和计算机 (ADUC) 中的用户属性对话框的配置文件选项卡，或通过组策略对象 (GPO)。

另请参阅

安装 Dynamics 365 for Outlook

通过