Storebrowse
注意：
本文仅适用于本地部署的 Citrix Workspace。有关云部署，请参阅 Storebrowse for Workspace 文档。
-
Storebrowse 是一个在客户端和服务器之间交互的命令行实用程序。它用于对 StoreFront 和 Citrix Gateway 中的所有操作进行身份验证。
-
管理员可以使用 Storebrowse 实用程序自动执行以下操作：
- 添加应用商店。
- 列出配置的应用商店中已发布的应用程序和桌面。
- 通过手动选择任何已发布的虚拟应用程序和桌面来生成 ICA® 文件。
- 使用 Storebrowse 命令行生成 ICA 文件。
- 启动已发布的应用程序。
Storebrowse 实用程序是 Authmanager 组件的一部分。Citrix Workspace app 安装完成后，Storebrowse 实用程序位于 AuthManager 安装文件夹中。
要确认 Storebrowse 实用程序已随 Authmanager 组件一起安装，请检查以下注册表路径：
当管理员安装 Citrix Workspace app 时：
| | | | — |—|
-
在 32 位计算机上 [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install] -
在 64 位计算机上 [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]
当用户（非管理员）安装 Citrix Workspace app 时：
| 在 32 位计算机上 | [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install] |
| 在 64 位计算机上 | [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
要求
Storebrowse 实用程序与以下操作系统兼容：
| 操作系统 |
|---|
| Windows 10 32 位和 64 位版本 |
-
Windows Server 2022 -
Windows Server 2016 -
Windows Server 2008 R2，64 位版本 Windows Server 2008 R2，64 位版本 -
连接
Storebrowse 实用程序支持以下连接类型：
- HTTP 应用商店
- HTTPS 应用商店
- Citrix Gateway 11.0 及更高版本
注意：
在 HTTP 应用商店上，Storebrowse 实用程序不接受使用命令行的凭据。
身份验证方法
StoreFront 服务器
StoreFront 支持不同的身份验证方法来访问应用商店，但并非所有方法都受推荐。出于安全目的，在创建应用商店时，某些身份验证方法默认处于禁用状态。
- 用户名和密码：输入要进行身份验证的凭据以访问应用商店。默认情况下，在您创建第一个应用商店时，显式身份验证处于启用状态。
- 域直通：在对已加入域的 Windows 计算机进行身份验证后，您将自动登录到应用商店。要使用此选项，请在安装 Citrix Workspace app 时启用直通身份验证。有关域直通的更多信息，请参阅 配置直通身份验证 文档。
- HTTP Basic：此方法由第三方客户端集成和 Web 门户使用，其中外部用户界面用于捕获域限定的用户名和密码。StoreFront 使用 IIS 中的基本身份验证功能将凭据传输到 StoreFront 服务器。然后，StoreFront 使用 域服务 或 Broker XML 服务身份验证 来验证凭据并获取组信息。有关如何启用 HTTP 基本身份验证的信息，请参阅 管理身份验证方法 文档中的 HTTP Basic。
Storebrowse 实用程序支持以下任一身份验证方法：
- 使用与 Storebrowse 实用程序内置的
AuthManager。注意：在使用 Storebrowse 实用程序时，请在 StoreFront 上启用 HTTP 基本身份验证方法。当用户使用 Storebrowse 命令提供凭据时，此方法适用。 - 使用 Citrix Workspace app for Windows 附带的
Authmanager。当您使用域直通身份验证时，可以使用此方法。有关更多信息，请参阅 域直通身份验证 文档。
启动已发布的桌面或应用程序
您现在可以直接从应用商店启动资源，而无需使用 ICA 文件。
注意：
您无法使用 Storebrowse 命令打开 SaaS 应用程序或 已发布内容。
命令用法
以下部分提供了有关您可以从 Storebrowse 实用程序使用的命令的详细信息。
添加应用商店
-a、--addstore
说明：
添加新的应用商店。返回应用商店的完整 URL。如果返回失败，则会报告错误。
注意：
Storebrowse 实用程序支持多应用商店配置。
StoreFront 上的命令示例：
命令：
storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*
示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)
Citrix Gateway 上的命令示例：
命令：
storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*
示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>
如果配置了网关的 StoreFront 具有单个应用商店，则上述方法将起作用。
如果配置了网关的 StoreFront 具有多个应用商店，则需要使用以下命令：
命令：storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*?StoreName
-
示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a https://mysecondexample.com?Store -
帮助
/?
说明：
提供有关 Storebrowse 实用程序用法的详细信息。
列出应用商店
(-l)、--liststore
描述：
列出用户添加的商店。
StoreFront 上的命令示例：
.\storebrowse.exe –l
Citrix Gateway 上的命令示例：
.\storebrowse.exe –l
枚举
(-M 0x2000 -E)
描述：
枚举资源。
StoreFront 上的命令示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gateway 上的命令示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.secondexample.net>
快速启动
-q、--quicklaunch
描述：
使用 Storebrowse 实用程序为已发布的应用程序和桌面生成 ICA 文件。quicklaunch 选项需要一个启动 URL 作为输入，以及商店 URL。启动 URL 可以是 StoreFront 服务器 URL 或 Citrix Gateway URL。ICA 文件生成在 %LocalAppData%\Citrix\Storebrowse\cache 目录中。
您可以通过运行以下命令获取任何已发布的应用程序和桌面的启动 URL：
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
典型的启动 URL 如下所示：
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
StoreFront 上的命令示例：
.\storebrowse.exe –U {Username} –P {Password}–D {Domain} –q {Launch_URL_of_published_ apps and desktops }<https://my.firstexamplestore.net/Citrix/Store/resources/v2/Q2hJkOlmNoPQrSTV9y/launch/ica> <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gateway 上的命令示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>
启动
-
-L、--launch -
描述：
-
使用 Storebrowse 实用程序为已发布的应用程序和桌面生成所需的 ICA 文件。启动选项需要资源名称以及商店 URL。该名称可以是 StoreFront 服务器 URL 或 Citrix Gateway URL。ICA 文件生成在
%LocalAppData%\Citrix\Storebrowse\cache目录中。 -
运行以下命令以获取已发布的应用程序和桌面的显示名称：
-
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery -
此命令会产生以下输出：
-
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
StoreFront 上的命令示例：
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gateway 上的命令示例：
<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>
会话启动
-S、--sessionlaunch
描述：
使用此命令，您可以添加商店、验证并启动已发布的资源。此选项接受以下参数：
- 用户名
- 密码
- 域
- 要启动的资源名称
- 商店 URL
但是，如果用户未提供凭据，AuthManager 将提示输入凭据，然后启动资源。
您可以通过运行以下命令获取已发布的应用程序和桌面的资源名称：
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
此命令会产生以下输出：
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
上一个输出中以粗体显示的名称用作 -S 选项的输入参数。
StoreFront 上的命令示例：
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >
Citrix Gateway 上的命令示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>
文件文件夹
-f、--filefolder
描述：
在自定义路径中为已发布的应用程序和桌面生成 ICA 文件。
启动选项需要文件夹名称和资源名称作为输入，并提供 Store URL。Store URL 可以是 StoreFront 服务器或 Citrix Gateway URL。
StoreFront 上的命令示例：
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}
Citrix Gateway 上的命令示例：
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}
跟踪身份验证
-t、--traceauthentication
说明：
为 AuthManager 组件生成日志。仅当 Storebrowse 实用程序使用内置 AuthManager 时才生成日志。日志在 localappdata%\Citrix\Storebrowse\logs 目录中生成。
注意：
此选项不得是用户命令行中列出的最后一个参数。
StoreFront 上的命令示例：
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}
Citrix Gateway 上的命令示例：
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}
删除应用商店
-d、--deletestore
说明：
删除现有 StoreFront 或 Citrix Gateway 应用商店。
StoreFront 上的命令示例：
.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery
Citrix Gateway 上的命令示例：
.\storebrowse.exe –d https://my.secondexmaplestore.com
跟踪 Storebrowse 命令状态
从 2305.1 版本开始，您可以在文件中跟踪 Storebrowse 命令的执行状态。要跟踪成功状态，请使用 -f launch 命令提供唯一的文件名。此命令将生成一个您提供的名称的文件。失败状态存在于自动创建的 ica.error 文件中。
注意：
确保使用
-f launch命令向文件名添加.ica扩展名。否则，不会生成文件。
用于跟踪成功和失败的文件位于 %LOCALAPPDATA%\citrix\selfservice\cache，您可以根据需要监视这些文件。
此增强功能默认启用。
以下是使用带 -f 选项的启动命令的示例：
-launch -f <uniqueFileName.ica> "launchcommandline"
For example:
SelfService.exe storebrowse -launch -f uniqueFileName.ica -s store0-5c3ec017 -CitrixID store0-5c3ec017@@a9a8e3ac-099d-4577-b84e-e33d0695df39.Notepad -ica "https://cwawiniwstest.cloudburrito.com/Citrix/Store/resources/v2/YTlhOGUzYWMtMDk5ZC00NTc3LWI4NGUtZTMzZDA2OTVkZjM5Lk5vdGVwYWQ-/launch/ica" -cmdline
<!--NeedCopy-->
Citrix Gateway 单点登录支持
单点登录允许您对域进行身份验证，并使用该域提供的 Citrix Virtual Apps and Desktops™ 和 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops 服务）。您可以登录，而无需重新对每个应用程序或桌面进行身份验证。添加应用商店时，您的凭据将通过 Citrix Gateway 服务器，以及 Citrix Virtual Apps and Desktops 和 Citrix DaaS，以及“开始”菜单设置。
此功能在 Citrix Gateway 版本 11 及更高版本中受支持。
必备条件：
有关如何为 Citrix Gateway 配置单点登录的必备条件，请参阅配置域直通身份验证。
可以使用组策略对象 (GPO) 管理模板启用 Citrix Gateway 的单点登录功能。
- 通过运行 gpedit.msc 打开 Citrix Workspace 应用程序 GPO 管理模板
- 在计算机配置节点下，转至管理模板 > Citrix 组件 > Citrix Workspace > 用户身份验证 > Citrix Gateway 单点登录。
- 使用切换选项启用或禁用单点登录选项。
- 单击应用和确定。
- 重新启动 Citrix Workspace 应用程序会话以使更改生效。
限制：
- 在 StoreFront 服务器上启用 HTTP 基本身份验证方法，以便使用 Storebrowse 实用程序执行凭据注入操作。
- 如果您有 HTTP 应用商店并尝试使用该实用程序连接到该应用商店以检查或启动已发布的虚拟应用程序和桌面，则不支持使用命令行选项进行凭据注入。作为一种解决方法，如果您不使用命令行提供凭据，请使用外部
AuthManager模块。 - Storebrowse 实用程序目前仅支持在 StoreFront 服务器上配置的单个 Citrix Gateway 应用商店。
- Storebrowse 实用程序中的凭据注入仅在 Citrix Gateway 配置了单因素身份验证时才有效。
-
Storebrowse 实用程序的命令行选项
Username (-U)、Password (-P)和Domain (-D)区分大小写，并且必须仅使用大写。
要为使用 ICOSDK 的第三方应用程序启用 SSON，请创建以下注册表：
- 注册表项：
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson - 注册表值：第三方应用程序的完整路径
- 注册表类型：reg_multi_sz
示例：
- 注册表项：
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson - 注册表值：C:\temp1\abc.exe;C:\temp2\xyz.exe
- 注册表类型：reg_multi_sz
注意：
- 您可以提供多个第三方应用程序，用分号分隔。
- 此功能从版本 2107 开始受支持。
增强的 Storebrowse 会话处理
从此版本开始，Storebrowse 的会话处理通过以下增强功能得到改进，优化了用户体验和高可用性环境中的关键资源管理，从而提高了效率：
-
Storebrowse 在启动虚拟应用程序时智能地忽略现有会话 - 此选项可防止重新连接到当前正在被系统主动终止的会话，从而提高稳定性。这确保了对关键业务应用程序的无缝、无错误访问，尤其是在客户端更新期间，通过减少复杂的配置需求来简化管理。要启用智能会话处理，管理员必须将 -I true 参数添加到现有 Storebrowse 命令中。此参数与所有现有启动类型无缝集成，同时保持当前的语法结构。
命令示例：
快速启动：
以前的语法：
.\storebrowse.exe -U {Username} -P {Password} –D {Domain} -q {Launch_URL_of_published_ apps and desktops} <https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery> <!--NeedCopy-->具有智能会话处理的增强语法：
.\storebrowse.exe -U {Username} -P {Password} –D {Domain} -I true -q {Launch_URL_of_published_ apps and desktops} https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery> <!--NeedCopy--> -
Storebrowse API 支持返回会话列表 - 此选项提供了对活动用户会话的宝贵可见性，从而能够进行更具上下文感知和更高效的会话启动。这种改进的可见性减少了应用程序访问期间影响用户的错误和延迟，确保为所有用户提供更流畅、更可靠的体验。