使用命令提示字元安裝 Microsoft Dynamics 365 for Outlook
安裝 Microsoft Dynamics 365 for Outlook 的程序分為兩個步驟。 第一，您必須執行安裝程式，在電腦上安裝檔案。 接下來，執行 Dynamics 365 for Customer Engagement 設定精靈以設定應用程式並完成安裝。
重要
如果設定檔的值與命令列參數的值之間相衝突，命令列參數具有優先權。
步驟 1：安裝檔案
Note
如需下載指示，請參閱安裝 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 with Offline Access 提供對其客戶資料的存取。 若要以安靜模式來安裝 Dynamics 365 for Microsoft Office Outlook with Offline Access：
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
若要以安靜模式來解除安裝 Dynamics 365 for Microsoft Office Outlook with Offline Access：
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 設定檔的安裝範例
以下設定檔範例會將沒有離線存取功能的 Dynamics 365 for Outlook 安裝於 Program Files 資料夾。
Note
您可以使用同一個檔案包含安裝與設定元素。 安裝程式和設定精靈會忽略與作業無關的元素。
<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。
Note
執行 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 with Offline Access，並輸出名為 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 設定檔項目
| 元素 | 描述 |
|---|---|
| <Deployments></Deployments> | 設定檔必須是使用 <Deployment> 做為根元素的有效 XML 檔案。 |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | 指定 Dynamics 365 for Outlook 安裝的類型。 指定 true 會安裝 Microsoft Dynamics 365 for Outlook with Offline Access 功能。 |
| <TargetDir>drive:\path</TargetDirectory> | 指定將安裝 Dynamics 365 for Outlook 檔案的資料夾。 |
| <Deployment></Deployment> | 適用於下列所有元素的父元素。 |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | 指定 Dynamics 365 for Customer Engagement 探索 Web 服務的 URL。 對於 Customer Engagement Dynamics 365，請使用完整的組織 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></Organizations> | 這是下列 <Organization> 元素的父元素。 |
| <Organization FriendlyName="我的易記組織名稱" 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 保存庫和 Windows 認證管理員的詳細資訊，請參閱什麼是認證管理員？
Dynamics 365 for Outlook XML 設定檔的設定範例
下列設定檔範例設定 Dynamics 365 for Outlook 連線至名為 crmserver 之 Dynamics 365 Server 中稱為 Contoso 的主要組織以及另一個稱為 AdventureWorksCycle 的組織。
Note
您可以使用同一個檔案包含安裝與設定元素。 安裝程式和設定精靈會忽略與作業無關的元素。
範例 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>
Note
之前的範例指定使用者可存取的兩個不同組織，並設定 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)。