Citrix Workspace App 自動化安裝最佳實踐

本文所描述的所有針對Windows系統中使用的Citrix Workspace App，對於Linux、MAC OS、Android、IOS等系統不適用。

Citrix Workspace App取代了 Citrix Receiver。 Receiver最新（也是最後一個）版本爲4.12，最後一個LTSR版本爲4.9.6。 Citrix Workspace App最新LTSR版本爲1912。
Citrix Workspace App與 Citrix Receiver比較在文件、目錄以及註冊表都很是類似，但也有以下的區別    

名稱從Receiver變動爲Workspace App。但實際不少已知的安裝路徑和註冊表項並無變化，如：C:\Program Files (x86)\Citrix\ICA ClientC:\Program Files (x86)\Citrix\ICAClient\ReceiverHKLM\SOFTWARE\WOW6432Node\Citrix\ICA ClientHKLM\SOFTWARE\WOW6432Node\Citrix\ReceiverHKLM\SOFTWARE\WOW6432Node\Citrix\ReceiverInside圖標從原來的黑色變爲新的藍色圖標添加了應用於SaaS應用的嵌入式瀏覽器一些新功能的增長，例如CitrixCasting（用於Workspace HUB）和CitrixFiles（原Citrix ShareFile）的支持

1、 安裝和配置Citrix Workspace App

---

一、Citrix Workspace App安裝程序

CitrixWorkspaceApp.exe爲安裝文件，該文件包含不少MSI文件，其中每個組件就存在一個MSI安裝程序，以下：

1. AppProtection.msi （Workspaceapp 1909後新增）
2. AppProtectionAdvanced.msi
3. AuthManager.msi
4. CtxBrowserInstaller.msi （Workspaceapp 1808後新增，但1912 LTSR中不包含）
5. DesktopViewer.msi
6. GenericUSB.msi
7. ICAWebWrapper.msi
8. RIInstaller.msi
9. SelfServicePlugin.msi
10. SSONWrapper.msi
11. Vd3dClient.msi
12. WebHelper.msi
13. WinDockerInstaller.msi （Workspaceapp 1809後新增）

注意：經過如下命令能夠從安裝文件中提取MSI文件，或者使用7 ZIP工具進行全部文件的提取。 CitrixWorkspaceApp.exe  /extract%directory%

---

二、Citrix Workspace App命令行參數

有關全部命令行參數的詳細介紹，請參閱官方文檔https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/install.html#list-of-command-line-parameters，強烈建議在部署Citrix Workspace App以前先閱讀全文。也能夠經過Citrix Receiver CommandlineHelper Tool來協助構建準確的命令行語法。
具體使用哪些參數須要由實際環境和需求來決定，須要注意如下幾點：

• 某些參數須要與服務器端組件配合配置。如啓用雙向內容重定向。
• 某些參數須要本地管理員權限。如/incluedSSON啓用單點登陸。
• 某些時候可能須要系統從新啓動。如直到從新啓動用戶設備後，CitrixWorkspace App才能識別在安裝時處於掛起狀態的USB設備。

 下面是一些常見的參數用法    

/silent 靜默安裝，在安裝過程當中禁用安裝對話框和提示。 /includeSSON 要求您以管理員身份安裝。指示 Citrix Workspace App隨SingleSign-On 組件安裝。這將啓用單點登陸，用戶在登陸Windows後無需再次輸入身份驗證信息。 /FORCE_LAA=1 啓用本地應用程序訪問。 /EnableCEIP=false 禁用參與Citrix客戶體驗改善計劃（CEIP）。CEIP收集匿名統計信息和程序使用狀況信息，並將其發送給Citrix。 /AutoUpdateCheck=disabled 禁用Citrix Workspace App自動更新

 

---

三、Citrix Workspace App日誌文件

Citrix Workspace App安裝時會生成多個日誌文件：一個通用的日誌（"TrolleyExpress"）和每一個MSI安裝文件對應一個日誌文件，以下：

• TrolleyExpress-%Date%-%Time%.log
• CtxInstall-DesktopViewer-%Date%-%Time%.log
• CtxInstall-SelfServicePlugin-%Date%-%Time%.log

生成的日誌文件取決於安裝時選擇的組件，安裝的組件越多生成的日誌文件越多。Citrix Workspace App安裝生成的日誌文件在TEMP文件夾中子文件夾CTXReceiverInstallLogs-％Date％-％Time％中建立。通常狀況下，TEMP文件夾的位置以下：

• C:\Users\%UserName%\AppData\Local\Temp
  每一個用戶本身的臨時目錄。
• C:\Users\%UserName%\AppData\Local\Temp\%SessionNumber%
  此目錄與上一個目錄幾乎相同。不一樣之處在於每一個用戶每一個會話都有本身的臨時目錄。若是管理員容許，則用戶能夠在一個系統上進行多個會話。
• C:\Windows\Temp
  這是本地SYSTEM賬戶的TEMP。如Microsoft SCCM之類的軟件部署工具使用SYSTEM賬戶在本地計算機上進行安裝。
• C:\Temp
  通常在胖客戶端上使用該目錄。

固然，實際環境中的TEMP目錄可能與上面列出的目錄不一樣。能夠經過查看環境變量％TEMP％來確認。 

---

四、配置默認設備訪問行爲

當容許用戶在虛擬桌面中訪問本地客戶端設備上的文件時，可能會看到如下安全警告：
會涉及如下本地資源：

• 客戶端驅動器
• 麥克風和網絡攝像頭
• USB和其餘設備

Citrix Workspace App默認行爲是提示用戶。做爲管理員，能夠經過修改註冊表或使用ADMX組策略模板來定義訪問級別。有四個訪問級別：

• 0 =沒法訪問
• 1 =只讀訪問
• 2 =徹底訪問
• 3 =提示用戶訪問

默認狀況下，用戶能夠在「鏈接中心」的「首選項」下配置鏈接首選項。
 
若是要禁止用戶更改首選項，請將下面註冊表項中的Default值設置爲false： HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Client Selective Trust\oidPredefinedSecurityPolicySettings\InstantiatedSecurityPolicyEditable
 

五、禁止啓動「添加帳戶」窗口

在「添加賬戶」窗口中，按照Citrix的規定，用戶能夠經過輸入電子郵件地址或服務器URL來設置Citrix Workspace App賬戶。CitrixWorkspace App肯定與之關聯的NetScaler Gateway、StoreFront服務器，而後提示用戶登陸。默認狀況下，在安裝結束時窗口中將顯示「添加帳戶」按鈕。
爲了防止出現此按鈕，能夠執行如下兩項操做之一：

1. 將安裝文件CitrixWorkspaceApp.exe重命名爲CitrixWorkspaceAppWeb.exe（名稱必須寫正確）。
2. 在運行安裝以前，使用組策略設置EnableFTU*或在註冊表項HKLM\SOFTWARE\Wow6432Node\Policies\Citrix中建立註冊表項EnableX1FTU（DWORD值爲0）。

結果是不會顯示「添加賬戶」按鈕。
固然，若是是以靜默安裝方式，由於始終不會顯示安裝過程的圖形界面，因此上述的操做也就沒有必要了。 默認狀況下，用戶登陸時也會觸發顯示「添加賬戶」窗口。
爲防止出現此窗口，有以下三種方式     

在註冊表項 HKCU\Software\Citrix\Receiver新建註冊表項 HideAddAccountOnRestart（DWORD值爲1）。在窗口中勾選「登陸時不自動顯示此窗口」將建立相同的註冊表項。 在註冊表項 HKLM\SOFTWARE\WOW6432Node\Citrix\Dazzle新建註冊表項 AllowAddStore（REG_SZ值爲N）。 將安裝文件CitrixWorkspaceApp.exe重命名爲CitrixWorkspaceAppWeb.exe（名稱必須寫正確）。

---

六、防止意外啓動時的MSI修復

嘗試啓動已發佈的應用時，可能會觸發對組件「Citrix OnlinePlug-in」的MSI安裝程序修復。
要解決此問題，只需從註冊表 WEB_CLIENT（Citrix Online Plug-in MSI的一部分）中刪除全部數據 。 千萬不要刪除註冊表值自己！只需將值清空，以下所示。
WEB_CLIENT（REG_SZ）位置以下： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products\%ProductGUID%\Features不一樣版本的Citrix Workspace App的產品GUID不一樣，須要注意。 

---

七、禁止顯示初始化界面

用戶首次打開Citrix Workspace App時，將顯示啓動窗口「Citrix Receiver is Citrix Workspace App」 下面註冊表可防止出現該窗口

• 註冊表項：HKEY_CURRENT_USER\Software\Citrix\Splashscreen
• REG_SZ SplashscreenShown
• 值爲1

 

---

八、刪除Citrix Workspace App快捷方式

在安裝過程當中，Citrix Workspace App會在公共用戶（即全部用戶）的「開始菜單」中的「程序」建立一個快捷方式： C:\ProgramData\StartMenu\Programs\Citrix Workspace.lnk經過以下的PowerShell腳本將該快捷方式刪除： $File = Join-Path $env:AllUsersProfile "StartMenu\Programs\Startup\Citrix Workspace.lnk" if ( Test-Path $File ) {                         try{                                     Remove-Item"$File" | Out-Null                         }catch {                                     Exit1                         } } Citrix Workspace App自啓動經過以下命令： "C:\Program Files (x86)\Citrix\ICAClient\concentr.exe" /startup   註冊表 HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run-> ConnectionCenter 

---

九、優化

有幾個註冊表值能夠提升Citrix Workspace App的性能。若是遇到（開始菜單）圖標的枚舉緩慢的狀況，在 HKLM\SOFTWARE\Wow6432Node\Citrix\Dazzle\嘗試如下注冊表配置：

• InitialRefreshMinMs (REG_SZ) = 1  –最小化與Store聯繫以前的啓動延遲
• InitialRefreshMaxMs (REG_SZ) = 1  –最小化與Store聯繫以前的啓動延遲
• MaxSimultaneousFetches (REG_DWORD) =6  –縮短開始菜單中的圖標加載時間
• MaxSimultaneousSubscribes (REG_DWORD) =6  –縮短開始菜單中的圖標加載時間