2026 年 7 月 16 日

在 Omnissa Access 中設定 Citrix 多站台彙總和關鍵字篩選

Omnissa Access 支援 Citrix 的多站台彙總和關鍵字篩選功能，以協助管理員管理虛擬應用程式和桌面平台。若要在 Omnissa Access 中設定這些功能，您必須在 Omnissa Access Console 中建立 Citrix 虛擬應用程式集合之前，先完成額外的先決條件。

Citrix 多站台彙總功能可彙總多個網站中的應用程式和桌面平台資源，並去掉重複部分，讓使用者看不到重複的應用程式和桌面平台。如果已在 StoreFront 中設定多站台彙總，您可以在完成所需的先決條件工作後，於 Omnissa Access 中為虛擬應用程式集合選取對應的啟用多站台彙總設定。

Citrix 關鍵字篩選功能允許管理員使用關鍵字，來控制資源的顯示和啟動。如果已在 StoreFront 中設定關鍵字篩選，您可以在完成所需的先決條件工作後，於 Omnissa Access 中為虛擬應用程式集合選取對應的關鍵字篩選設定。

**重要：**僅 Omnissa Access Connector 22.09 及更新版本支援 Citrix 多站台彙總和關鍵字篩選。

多站台彙總功能需求

Omnissa Access 對多站台彙總具有以下先決條件：

每個虛擬應用程式集合僅能設定一個多站台環境。
虛擬應用程式集合可以是多站台集合，也可以是非多站台集合。如果您選取啟用多站台彙總選項，請勿新增任何 Citrix XML 伺服器。只需輸入 StoreFront URL。
同步時僅會使用預設彙總群組。
確保沒有多站台 StoreFront 伺服器共用同一個傳遞控制器。
Omnissa Access 假設各傳遞控制器發佈的資源及其權利皆相同。如果不相同，應用程式啟動可能會失敗。
對於未彙總的傳遞控制器，請建立單獨的虛擬應用程式集合。
在建立其他傳遞控制器時，請遵循以下指引：
- 如果您手動建立傳遞控制器，請勿在指令碼中為資源提供 UUID。讓系統自動產生 UUID。
  
  例如，請使用以下命令： New-BrokerApplication -AdminAddress "ctx1.example.com" -CommandLineExecutable "C:\Program Files\Windows NT\Accessories\wordpad.exe" -DesktopGroup 1 -Name "WordPad2" -UserFilterEnabled 1
  
  請勿使用以下命令： New-BrokerApplication -AdminAddress "ctx1.example.com" -CommandLineExecutable "C:\Program Files\Windows NT\Accessories\wordpad.exe" -DesktopGroup 1 -Name "WordPad2" -UserFilterEnabled 1 -UUID 6b151d87-b878-4e7c-bdee-86729e54213f
  
  當您省略 UUID 時，系統會自動產生 UUID 和 UID，且與原始資源不同。 Omnissa Access 支援此情境。但是，如果您輸入原始資源的 UUID，則 UUID 會相符，但自動產生的 UID 會與原始資源的 UID 不同。Omnissa Access 不支援此情境。
- 如果您透過複製另一個傳遞控制器來建立傳遞控制器，則無需變更任何內容。UUID 和 UID 會與原始資源相同，而 Omnissa Access 支援此情境。
請參閱以下支援與不支援情境的範例。

多個傳遞控制器中資源的支援情境

控制器 1 (相同資源)：

控制器 2 (相同資源)：

控制器 3 (相同資源)：

在此範例中，控制器 2 是由控制器 1 複製而來，而控制器 3 則是手動建立的。

多個傳遞控制器中資源的不支援情境

控制器 1 (相同資源)：

控制器 2 (相同資源)：

在此範例中，UUID 相符但 UID 不相符，因此不受支援。

多站台彙總和關鍵字篩選的先決條件

無論是多站台彙總或關鍵字篩選，執行虛擬應用程式服務的 Omnissa Access Connector 伺服器都必須與 StoreFront 伺服器建立遠端 PowerShell 連線。某些 Citrix 環境會限制可在 StoreFront 伺服器上遠端執行的 PowerShell 命令。對於這些環境，您可以建立一個 PowerShell 工作階段組態檔，以便僅允許執行虛擬應用程式服務的使用者才能建立遠端工作階段，並且僅允許執行與多站台彙總和關鍵字篩選相關的 StoreFront 命令。

完成適用於您的案例的先決條件。您必須先完成先決條件，然後才能建立虛擬應用程式集合。

如果您的 Citrix 環境對可在 StoreFront 上遠端執行的 PowerShell 命令沒有任何限制，請完成以下先決條件：

安裝 Omnissa Access Connector 22.09 或更新版本。
在 Omnissa Access Connector 安裝程式的 [Citrix 組態] 頁面上，取消選取啟用 Citrix StoreFront 受限 PowerShell 工作階段選項。

如果您的 Citrix 環境對可在 StoreFront 上遠端執行的 PowerShell 命令具有一些限制，請完成以下先決條件：

安裝 Omnissa Access Connector 22.09 或更新版本。
在 StoreFront 伺服器中，為有限的 PowerShell 工作階段建立工作階段組態檔。請參閱設定受限遠端 PowerShell 工作階段的工作階段組態檔。
編輯該檔案，並新增多站台彙總和關鍵字篩選所需的命令。請參閱將命令新增至工作階段組態檔。
在 Omnissa Access Connector 安裝程式的 Citrix 組態頁面上，選取啟用 Citrix StoreFront 受限 PowerShell 工作階段選項，並輸入您所建立的工作階段組態檔名稱。請參閱在 Omnissa Access Connector 安裝程式中選取受限 PowerShell 工作階段選項。
如果您不希望虛擬應用程式服務載入關鍵字篩選所需的 StoreFront 模組，請在 Omnissa Access Connector 安裝程式的 Citrix 組態頁面上，選取停用 Citrix 自動載入 StoreFront 模組選項。選取此選項後，虛擬應用程式服務便不會載入這些模組，並且所需命令將透過有限 PowerShell 工作階段組態設定來執行。

為有限遠端 PowerShell 工作階段設定工作階段組態檔

如果您的 Citrix 環境對可在 StoreFront 上遠端執行的 PowerShell 命令具有一些限制，請建立一個工作階段組態檔，以便為虛擬應用程式服務設定有限的 PowerShell 工作階段。該組態僅允許執行虛擬應用程式服務的使用者建立遠端工作階段，並且僅允許執行與多站台彙總和關鍵字篩選相關的 StoreFront 命令。

登入 StoreFront 伺服器。
以可執行虛擬應用程式服務的網域使用者身分，開啟 PowerShell 視窗。

**重要：**請確保您使用與執行虛擬應用程式服務相同的網域使用者帳戶。該網域使用者還必須是能夠載入 Citrix PSSnapin 的 Citrix 伺服器唯讀管理員。
執行下列命令：
1. New-PSSessionConfigurationFile -VisibleCmdlets Get-STFStoreService,Get-STFStoreFarm,Get-STFUserFarmMapping,Get-STFEquivalentFarmset,'Write-Host' -LanguageMode RestrictedLanguage -SessionType RestrictedRemoteServer -Path .\filename.pssc
  
  將 filename 替換為組態檔的名稱，例如 WorkspaceONE。該名稱只能使用英數字元。
2. Register-PSSessionConfiguration -Path filename.pssc -Name configurationName
  
  將 configurationName 替換為組態檔的名稱，例如 WorkspaceONE。請使用您指定給 filename 的相同名稱，但不要包含副檔名。該名稱只能使用英數字元。
3. Set-PSSessionConfiguration -Name configurationName -ShowSecurityDescriptorUI
4. 在顯示的 [權限] 對話方塊中，選取將允許建立 PowerShell 工作階段的網域使用者，然後選取允許資料行中的執行 (叫用) 核取方塊，以授與使用者執行權限。
  
  **重要：**請確保您選取與執行虛擬應用程式服務相同的網域使用者帳戶。該網域使用者還必須是能夠載入 Citrix PSSnapin 的 Citrix 伺服器唯讀管理員。
  
  例如：
系統會在 C:\Windows\System32\WindowsPowerShell\v1.0\SessionConfig 目錄中建立一個工作階段組態檔。

在工作階段組態檔中新增命令

編輯您建立的工作階段組態檔，以新增多站台彙總和關鍵字篩選所需的命令。

在 StoreFront 伺服器中，移至以下目錄：

C:\Windows\System32\WindowsPowerShell\v1.0\SessionConfig
開啟 filename.pssc 檔案以進行編輯。
將以下命令附加到 VisibleCmdlets 清單中：

'Get-ItemProperty', 'Select-Object', 'Format-List'

將下列命令附加到檔案結尾：

AliasDefinitions = @{ Name = 'Select' ; Value = 'Microsoft.PowerShell.Utility\Select-Object'}
 
FunctionDefinitions =@{
 'Name' = 'Get-DSResourceFilterKeyword'
 'Options' = 'ReadOnly'
 'ScriptBlock' = {
                   param(
                     [Parameter(Mandatory=$true)]
                     [long]$SiteId,
                     [Parameter(Mandatory=$true)]
                     [string]$VirtualPath
                   )
                   $path = "C:\inetpub\wwwroot\$VirtualPath\web.config"
                   $xpath = "/configuration/citrix.deliveryservices/wing/resources/settingsGroup/enumeration/filterByKeywords"
                   $xml = Select-Xml -path $path -xpath $xpath
                   $includeKeywords = $null
                   if ( $xml.Node.include ) {
                     GetKeywords -KeywordsString $xml.Node.include
                   }
                   $excludeKeywords = $null
                   if ( $xml.Node.exclude ) {
                     $excludeKeywords = GetKeywords -KeywordsString $xml.Node.exclude
                   }
                   $returnObject = new-object PSObject
                   $returnObject | Add-Member -MemberType NoteProperty -Name "Include" -Value $includeKeywords -PassThru `
                                 | Add-Member -MemberType NoteProperty -Name "Exclude" -Value $excludeKeywords
                   return $returnObject
                 };
 },@{
 'Name' = 'GetKeywords'
 'Options' = 'ReadOnly'
 'ScriptBlock' = {
                   param(
                     [Parameter(Mandatory=$true)]
                     [string]$KeywordsString
                   )
                   $set = @()
                   $res = $KeywordsString -split ";"
                   foreach ($kw in $res)
                   {
                     $kw = if ($kw) {$kw.trim()} else {$null}
                     if ($kw)
                     {
                       $set += $kw
                     }
                   }
                   return $set
                 }
 },@{
 'Name' = 'Get-STFStoreFarm'
  'Options' = 'ReadOnly'
  'ScriptBlock' = {
                    $Global:FormatEnumerationLimit = -1
                    Citrix.StoreFront.Stores\Get-STFStoreFarm @Args
                  }
},@{
'Name' = 'Get-STFEquivalentFarmset'
  'Options' = 'ReadOnly'
  'ScriptBlock' = {
                    $Global:FormatEnumerationLimit = -1
                    Citrix.StoreFront.Stores.MultiSite\Get-STFEquivalentFarmset @Args
                  }
  }
 
}

執行以下命令，以重新啟動 Windows 服務：

Get-Service -Name WinRM | Restart-Service

在 Omnissa Access Connector 安裝程式中選取受限 PowerShell 工作階段選項

在設定完成工作階段組態檔後，請在 Omnissa Access Connector 安裝程式中選取受限 PowerShell 工作階段選項，並指定工作階段組態檔名稱。

執行 Omnissa Access Connector 安裝程式。
在 [Citrix 組態] 頁面上，選取啟用 Citrix StoreFront 有限 PowerShell 工作階段選項。
輸入您建立的工作階段組態檔的名稱。

輸入的檔名不應包含副檔名，且不包含名稱中的額外字元。例如，如果檔案系統中的名稱為 WorkspaceONEsjk1p2.pssc，請輸入 WorkspaceONE。

啟用多站台彙總和關鍵字篩選

完成先決條件後，您可以為 Citrix 整合建立虛擬應用程式集合，並啟用多站台彙總和關鍵字篩選功能。

若要啟用多站台彙總，請在 Citrix 虛擬應用程式集合中，選取啟用多站台彙總選項。
若要啟用關鍵字篩選，請在 Citrix 虛擬應用程式集合中，選取關鍵字篩選選項。

如需建立虛擬應用程式集合的詳細資訊，請參閱在 Omnissa Access 中設定 Citrix 伺服器陣列。

此頁面對您有幫助嗎?