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 Basic 身份验证的信息，请参阅管理身份验证方法文档中的 HTTP Basic。
- Storebrowse 的高级 NetScaler 策略：适用于 Windows 的 Citrix Workspace app 支持 NetScaler Gateway 上的 Storebrowse 高级策略。支持的身份验证协议是 LDAP 身份验证。
注意：
Storebrowse 在 Windows 上不支持 nFactor 身份验证协议。
Storebrowse 实用程序支持以下任一身份验证方法：
- 使用与 Storebrowse 实用程序内置的
AuthManager。注意：在使用 Storebrowse 实用程序时，请在 StoreFront 上启用 HTTP Basic 身份验证方法。当用户使用 Storebrowse 命令提供凭据时，此方法适用。 - 使用适用于 Windows 的 Citrix Workspace app 中包含的
Authmanager。当您使用域直通身份验证时，可以使用此方法。有关详细信息，请参阅域直通身份验证文档。
启动已发布的桌面或应用程序
您现在可以直接从应用商店启动资源，而无需使用 ICA 文件。
注意：
您不能使用 Storebrowse 命令打开 SaaS 应用程序或已发布内容。
命令用法
以下部分提供了有关您可以从 Storebrowse 实用程序使用的命令的详细信息。
添加应用商店
-a、--addstore
说明：
添加新的应用商店。返回应用商店的完整 URL。如果返回失败，则会报告错误。
注意：
Storebrowse 实用程序支持多应用商店配置。
StoreFront 上的命令示例：
命令：
storebrowse.exe –U *username* -P *password* -D *domain* -a *StoreFront 的 URL*
示例：
.\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 *Citrix Gateway 的 URL*
示例：
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>
帮助
-
/? -
说明：
提供有关 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 服务器或 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 命令状态
您可以在文件中跟踪 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 及更高版本中受支持。