使用命令提示字元安裝 Microsoft Dynamics 365 for Outlook

安裝 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 安裝的參數

參數	Description
否	不使用參數，Setupclient.exe 執行時會顯示所有畫面。
installofflinecapability	決定是否將安裝離線功能。包含此參數時，會安裝離線功能及元件。如果不指定此參數，會安裝僅限連線用戶端。
/targetdir <“驅動器：\路徑”>	指定將安裝 Dynamics 365 for Outlook 檔案的資料夾。
/A	透過建立 Windows 安裝套件來建立 Dynamics 365 for Outlook 的管理安裝。此套件可讓使用者從網路共用執行安裝程式，或是讓非管理使用者執行群組原則導向的安裝程式。此參數必須與先前描述的 /targetdir 參數一起使用。使用此參數時，/targetdir 值不必位於本機電腦。可以使用對應磁碟機或網路共用，例如 \\share\mscrm_client_admin。重要：如果您未使用 `/targetdir` 參數指定目標資料夾，會在預設資料夾 <磁碟機:> Program Files\Microsoft Dynamics CRM。例如，下列命令： `Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"`
/Q	安靜模式安裝。此參數需要 XML 格式的設定檔。 `/i` 參數包括 XML 設定檔的名稱。沒有對話方塊或錯誤訊息會出現在顯示螢幕。若要擷取錯誤訊息資訊，請包括記錄檔參數 (/L 或 /LV)。
/L [驅動器：][[路徑] logfilename.log]	建立安裝活動的記錄檔。您必須指定記錄檔的檔案名稱，以及放置檔案的位置，但是路徑不可以是相對路徑，例如 %appdata%\CRMLogs。
/LV [驅動器：][[路徑] logfilename.log]	建立安裝活動的詳細資訊記錄檔。您必須指定記錄檔的檔案名稱，以及放置檔案的位置，但是路徑不可以是相對路徑，例如 %appdata%\CRMLogs。
停用離線功能	當您指定此參數時，Dynamics 365 for Outlook 將設定為隱藏應用程式中的「離線」按鈕。此按鈕可讓使用者切換到具有離線功能的 Dynamics 365 for Outlook。
ignoreofflinequeue	指定此參數時，安裝程式不會嘗試同步處理升級期間可能留存在離線佇列中的項目。
/X	卸載 Dynamics 365 for Outlook。這是已安裝應用程式時才可使用的維護模式選項。

用於安裝的範例 Dynamics 365 for Outlook XML 設定檔

以下設定檔範例將不具備離線存取功能的 Dynamics 365 for Outlook 安裝到 Program Files 資料夾中。

備註

您可以使用同一個檔案包含安裝與設定元素。安裝程式和設定精靈會忽略與作業無關的元素。

<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 設定的命令範例

以下命令使用名為 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 或 Client 安裝資料夾。

Dynamics 365 for Outlook XML 設定檔元素

元素	Description
<部署></部署>	設定檔必須是使用 <Deployment> 做為根元素的有效 XML 檔案。
<InstallOfflineCapability>真/假</InstallOfflineCapability>	指定 Dynamics 365 for Outlook 安裝的類型。指定 `true` 將會安裝具備離線存取功能的 Microsoft Dynamics 365 for Outlook。
<TargetDir>磁碟機：\path</TargetDirectory>	指定將安裝 Dynamics 365 for Outlook 檔案的資料夾。
<部署></部署>	適用於下列所有元素的父元素。
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl>	指定 Dynamics 365 for Customer Engagement 探索 Web 服務的 URL。對於 Dynamics 365 for Customer Engagement，請使用完整的組織 URL (例如 `https://orgname.crm.dynamics.com`)，或根據您的線上環境和位置，使用探索服務 URL，其格式為 `https://disco.crm.dynamics.com`。如需 URL 的清單，請參閱 MSDN：探索服務。
<FederatedAuthentication>true/false</FederatedAuthentication>	指定是否在設定精靈中使用聯合 (Azure Active Directory) 憑證進行驗證。如果指定 `false`，您可以使用像 user@contoso.onmicrosoft.com 這樣的認證。
<組織></Organizations>	這是下列 <Organization> 元素的上層元素。
<Organization FriendlyName=“我的友好組織名稱” IsPrimary=“true”/“false”>OrganizationName</Organization>	指定用戶端將連線的組織名稱。 FriendlyName。指定 Outlook 中的組織名稱以外的顯示名稱。 IsPrimary。指定將在 Dynamics 365 for Outlook 中設定為同步組織的組織。附註：OrganizationName 會區分大小寫。
<CEIP 通知>true/false</CEIP 通知>	指定 Dynamics 365 for Outlook 是否顯示「我想加入客戶體驗改善計畫」通知橫幅。預設設定為 `true`，並顯示通知橫幅。若指定 `false`，通知橫幅不會顯示在 Dynamics 365 for Outlook 中。其他資訊：Microsoft 客戶經驗改進計畫

執行設定精靈時需要使用者認證

設定精靈需要使用者認證。進行無訊息設定時，設定精靈會搭配 /Q 使用 Microsoft.Crm.Application.Outlook.ConfigWizard.exe，以在 Windows 保存庫中尋找使用者的認證。如果設定精靈找不到認證，或者認證不是所需格式，則設定無法完成，且錯誤會記錄到組態記錄檔。請注意，設定精靈不支援在 XML 設定檔中新增使用者 UPN 或密碼。如需 Windows 保存庫和 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 設定管理員。

在指令碼中，您可能也會想要加入偵測邏輯，以判斷是否已設定用戶端電腦。如果已設定，即可使指令碼結束而不需採取任何動作。

範例 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

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-09-30