2026 年 3 月 14 日

部署錯誤

您在部署 Unified Access Gateway 至環境中時，可能會遇到困難。您可以使用多種程序來診斷及修正部署時發生的問題。

執行從網際網路下載的指令碼時出現安全警告

請確認 PowerShell 指令碼為您預期要執行的指令碼，然後在 PowerShell 主控台中執行下列命令：

unblock-file .\uagdeploy.ps1

`ovftool command not found`

請確認您已在 Windows 機器上安裝 OVF Tool 軟體，並且該軟體安裝在指令碼預期的位置。

內容 netmask1 中的網路無效

這則訊息可能會指出 netmask0、netmask1 或 netmask2。請確認已在 netInternet、netManagementNetwork 及 netBackendNetwork 這三個網路各自的 INI 檔案中設定值。

關於作業系統識別碼不受支援的警告訊息

警告訊息顯示指定的作業系統識別碼 SUSE Linux Enterprise Server 12.0 64-bit (id:85) 在選定主機上不受支援。它對應至以下作業系統識別碼：Other Linux (64-bit)。

請忽略此警告訊息。系統會自動對應至受支援的作業系統。

`Locator does not refer to an object error`

此錯誤指出，vSphere OVF Tool 使用的 target= 值與您的 vCenter Server 環境不相符。最上層物件的指定方式如下：

target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/

該物件現在會列出可於下一層級使用的名稱選項。

target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host/Cluster1/
or
target=vi://administrator@vsphere.local:PASSWORD@192.168.0.21/Datacenter1/host/esxhost1

在目標中使用的資料夾名稱、主機名稱及叢集名稱有區分大小寫。

`Error message: Unable to retrieve client certificate from session: sessionId`

檢查是否已在瀏覽器中正確安裝使用者憑證。
檢查是否已在瀏覽器和 Unified Access Gateway 上啟用預設的 TLS 通訊協定版本 1.2。

無法使用在 Chrome 瀏覽器中啟動的 VMware vSphere Web Client 部署 Unified Access Gateway OVA

您必須在 vSphere Web Client 上用來部署 ova 檔案的瀏覽器上安裝用戶端整合外掛程式。在 Chrome 瀏覽器上安裝外掛程式後，系統會顯示一則錯誤訊息，指出瀏覽器並未安裝，且將不允許您在來源位置中輸入 ova 檔案 URL。這是 Chrome 瀏覽器的問題，與 Unified Access Gateway OVA 無關。建議您使用其他瀏覽器來部署 Unified Access Gateway OVA。

無法使用 VMware vSphere HTML4/5 Web Client 部署 Unified Access Gateway OVA

您可能會遇到 Invalid value specified for property 等錯誤。此問題與 Unified Access Gateway OVA 無關。建議您改用 vSphere FLEX Client 來部署 OVA。

無法使用 VMware vSphere 6.7 HTML5 Web Client 部署 Unified Access Gateway OVA

您可能會發現，在 VMware vSphere 6.7 HTML5 Web Client 的部署內容頁面上有部分欄位遺失。此問題與 Unified Access Gateway OVA 無關。建議您改用 vSphere FLEX Client 來部署 OVA。

無法透過 Chrome 從 Workspace ONE Access 啟動 XenApp

從 Workspace ONE Access 部署 Unified Access Gateway 作為 Web 反向 Proxy 之後，您可能無法從 Chrome 瀏覽器啟動 XenApp。

請遵循下列步驟來解決此問題。

使用下列 REST API 從 Workspace ONE Access 服務停用功能旗標 orgUseNonNPAPIForCitrixLaunch。

PUT https://fqdn/SAAS/jersey/manager/api/tenants/settings?tenantId=tenantname
{ "items":[ {"name":"orgUseNonNPAPIForCitrixLaunch","value": "false"} ] }
with the following two headers:
Content-Type application/json
Authorization HZN value_of_HZN_cookie_for_admin_user

等待 24 小時使變更生效，或重新啟動 Workspace ONE Access 服務。
- 若要在 Linux 上重新啟動服務，請登入虛擬應用裝置並執行下列命令：service horizon-workspace restart。
- 若要在 Windows 上重新啟動服務，請執行下列指令碼：install_dir\usr\local\horizon\scripts\horizonService.bat restart。

此頁面對您有幫助嗎?