使用命令提示字元安裝 Microsoft Dynamics CRM for Outlook
發行︰ 2016年7月
適用於: Dynamics CRM 2015
安裝 Microsoft Dynamics CRM for Outlook 的程序分為兩個步驟。 第一,您必須執行安裝程式,在電腦上安裝檔案。 其次,執行 Microsoft Dynamics CRM設定精靈以設定應用程式,並完成安裝。
重要
如果設定檔的值與命令列參數的值之間相衝突,命令列參數具有優先權。
本主題內容
步驟 1:安裝檔案
步驟 2:使用 XML 設定檔來設定 CRM for Outlook
CRM for Outlook 設定的命令範例
CRM for Outlook XML 設定檔元素
執行設定精靈時需要使用者認證
CRM for Outlook XML 設定檔的設定範例
步驟 1:安裝檔案
以下命令顯示以命令提示字元執行 Microsoft Dynamics CRM for Outlook 安裝程式的可用選項:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[磁碟機:][[路徑] logfilename.log]"] [/targetdir "[磁碟機:][路徑]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
CRM for Outlook 安裝的命令範例
對於外出或並非總是連線至 Microsoft Dynamics CRM Server 的使用者,Microsoft Dynamics CRM for Microsoft Office Outlook with Offline Access 可供存取客戶資料。 若要以安靜模式安裝 Microsoft Dynamics CRM for Microsoft Office Outlook with Offline Access:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
若要以安靜模式解除安裝 Microsoft Dynamics CRM for Microsoft Office Outlook with Offline Access:
SetupClient /x /q
CRM for Outlook 安裝的參數
參數 |
描述 |
---|---|
無 |
不使用參數,Setupclient.exe 執行時會顯示所有畫面。 |
installofflinecapability |
決定是否將安裝離線功能。 包含此參數時,會安裝離線功能及元件。 如果不指定此參數,會安裝僅限連線用戶端。 |
/targetdir <"drive:\path"> |
指定將安裝 Dynamics CRM for Outlook 檔案的資料夾。 |
/A |
建立 Windows Installer 封裝,以建立 Dynamics CRM for Outlook 的系統管理安裝。 此封裝可以讓使用者從網路共用執行安裝程式,或者讓非管理使用者執行由群組原則驅使的安裝程式。 此參數必須與先前描述的 /targetdir 參數一起使用。 使用此參數時,/targetdir 值不必位於本機電腦。 可以使用對應的磁碟機或網路共用,例如 \\share\mscrm_client_admin。 重要 如果您使用 /targetdir 參數時不指定目標資料夾,安裝程式會在預設資料夾 <drive:> 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 CRM for Outlook 設定為隱藏應用程式中的 [離線] 按鈕。 此按鈕可讓使用者切換至離線功能的 Dynamics CRM for Outlook。 |
ignoreofflinequeue |
指定此參數時,安裝程式將不嘗試同步處理升級期間可能留存在離線佇列中的項目。 |
/X |
解除安裝 Dynamics CRM for Outlook。 這是已安裝應用程式時才可使用的維護模式選項。 |
CRM for Outlook XML 設定檔的安裝範例
以下設定檔範例會將沒有離線存取功能的 Dynamics CRM for Outlook 安裝於 Program Files 資料夾。
注意
您可以使用同一個檔案包含安裝與設定元素。安裝程式及設定精靈會忽略與作業無關的元素。
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
步驟 2:使用 XML 設定檔來設定 CRM for Outlook
安裝 Dynamics CRM for Outlook 之後,必須進行設定。 您也可以在命令提示字元執行 Dynamics CRM for Outlook設定精靈,便可以達成上述目的。設定精靈檔案名稱為 Microsoft.Crm.Application.Outlook.ConfigWizard.exe,位於 Dynamics CRM for Outlook 安裝所在的 Client\ConfigWizard 資料夾中。 根據預設,資料夾為 C:\Program Files\Microsoft Dynamics CRM。
注意
執行Dynamics CRM for Outlook的使用者的認證將用於向 Microsoft Dynamics CRM 驗證。 因此,若要執行 Dynamics CRM for Outlook 的無訊息設定,您必須在使用者內容中執行設定精靈,例如執行使用者叫用的批次檔案或以登入指令碼的單次項目執行。 如需詳細資訊,請參閱執行設定精靈時需要使用者認證。 若要使用 Microsoft 群組原則來部署 Dynamics CRM for Outlook,請參閱使用群組原則來部署 Microsoft Dynamics CRM for Outlook。
如果未指定設定檔的路徑,設定精靈將在非漫遊設定檔資料夾 ((%localappdata%\Microsoft\MSCRM\) 中搜尋預設的設定檔 (default_client_config.xml)。 如果檔案並未位於非漫遊設定檔資料夾,設定精靈將搜尋 Dynamics CRM for Outlook 安裝所在的資料夾。 根據預設,Dynamics CRM for Outlook會安裝到 C:\Program Files\Microsoft Dynamics CRM 資料夾。
如果設定檔位於其他應用程式所使用的漫遊位置 (AppData\Roaming\Microsoft\MSCRM\),則將不予認可。
CRM for Outlook 設定的命令範例
下列命令會以安靜模式使用名為 config_client.xml 的檔案來設定 Microsoft Dynamics CRM 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 Vault 中的使用者認證才能在安靜模式中執行設定精靈。其他資訊:執行設定精靈時需要使用者認證
/i [drive:] [[path] configfilename.xml]] 命令列參數提供 Microsoft Dynamics CRM for Outlook 安裝程式 必要的資訊。 它是每個安裝畫面都需要的相同資訊。XML 元素必須為英文 (美國);不能使用特殊或擴充字元。 具有當地語系化 XML 元素的 XML 設定檔將無法正確運作。 每個 XML 元素的說明及 XML 檔案的範例如下:
當 /xa 參數搭配 /q 參數使用時,就會移除針對 Dynamics CRM for Outlook 所設定的所有組織。
/R 參數可用來隱藏 設定精靈 使用者介面,只顯示進度對話方塊。 這個參數需要名為 Default_Client_Config.xml 的有效 XML安裝程式檔案,而且該檔案必須位於本機使用者的 AppData 或 Client 安裝資料夾。
CRM for Outlook XML 設定檔元素
項目 |
描述 |
---|---|
<Deployments> </Deployments> |
設定檔必須是有效的 XML 檔案,並使用 <Deployment> 做為根元素。 |
<InstallOfflineCapability>true/false</InstallOfflineCapability> |
指定 Dynamics CRM for Outlook 安裝的類型。 指定 true,將會安裝 Microsoft Dynamics CRM for Outlook with Offline Access 功能。 |
<TargetDir>drive:\path</TargetDirectory> |
指定將安裝 Dynamics CRM for Outlook 檔案的資料夾。 |
<Deployment> </Deployment> |
適用於下列所有元素的父元素。 |
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> |
指定 Microsoft Dynamics CRMDiscovery Web Service 的 URL。 對於 Microsoft Dynamics CRM Server的內部部署,支援的繫結可以是 HTTP 或 HTTPS。 如果 Discovery Web Service 使用的是預設連接埠 80 (HTTP) 或 443 (HTTPS) 以外的連接埠,您必須指定連接埠號碼。 如果這是 Microsoft Dynamics CRM Server 的完整伺服器部署,Discovery Web Service URL 會與 Web 應用程式的 URL 相同,例如 http://crmserver。 對於 Microsoft Dynamics CRM Online,請使用完整的組織 URL,例如 https://orgname.crm.dynamics.com,或根據您的連接環境和位置,使用探索服務 URL,其格式為 https://disco.crm.dynamics.com。 如需 URLs 的清單,請參閱 MSDN:探索服務。 |
<Organizations> </Organizations> |
這是下列 <Organization> 元素的父元素。 |
<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization> |
指定用戶端將連線的組織名稱。 FriendlyName: 指定 Outlook 中的組織名稱以外的顯示名稱。 IsPrimary: 指定將在 Dynamics CRM for Outlook 中設定為同步處理組織的組織。 注意 OrganizationName 會區分大小寫。 |
<CEIPNotification>true/false</CEIPNotification> |
指定 Dynamics CRM for Outlook 是否顯示「我要加入客戶經驗改進計畫」通知橫幅。 預設設定為 true,並顯示通知橫幅。 若指定 false,通知橫幅不會顯示在 Dynamics CRM for Outlook。其他資訊:Microsoft 客戶經驗改進計畫 |
執行設定精靈時需要使用者認證
設定精靈 需要使用者認證。 在無訊息設定時使用 Microsoft.Crm.Application.Outlook.ConfigWizard.exe 檔案的 /Q,設定精靈 會在 Windows 保存庫中尋找使用者的認證。 如果設定精靈找不到認證,或者認證不是所需格式,設定不會完成,且錯誤會記錄到組態記錄檔。 請注意,設定精靈不支援在 XML 設定檔中新增使用者 UPN 或密碼。 如需如何從命令指令碼加入使用者認證到 Windows 保存庫的詳細資訊,請參閱在 CRM 2011 宣告啟用環境中為 CRM for Outlook 用戶端進行無訊息設定部落格文章。 如需 Windows 保存庫和 Windows 認證管理員的詳細資訊,請參閱什麼是認證管理員?
CRM for Outlook XML 設定檔的設定範例
以下設定檔範例設定 Dynamics CRM for Outlook 連線至名稱為 crmserver 之 Microsoft Dynamics CRM Server 上,名稱為 Contoso 的主要組織及另一個稱為 AdventureWorksCycle 的組織。
注意
您可以使用同一個檔案包含安裝與設定元素。安裝程式及設定精靈將忽略與作業無關的元素。
範例 Default_Client_Config.xml 檔案
<Deployments>
<Deployment>
<DiscoveryUrl>http://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Constoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
注意
之前的範例指定使用者可存取的兩個不同組織,並設定 Dynamics CRM for Outlook 不顯示「我要加入客戶經驗改進計畫」通知橫幅。Organization 元素中的值不可包含特殊字元或空格。 在 Microsoft Dynamics CRM (內部部署),您可以執行 Get-CrmOrganization Windows PowerShell cmdlet 或在 部署管理員 的 [組織] 區域中,從 [名稱] 欄找到組織唯一名稱。
使用指令碼設定 CRM for Outlook
撰寫指令碼,為 Dynamics CRM 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://contoso.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)。
另請參閱
安裝 CRM for Outlook
使用命令提示字元安裝 Microsoft Dynamics CRM Server
CRM for Outlook 應用程式
© 2016 Microsoft Corporation. 著作權所有,並保留一切權利。 著作權