Storebrowse

Storebrowse 是一款轻型命令行实用程序，用于在客户端与服务器之间进行交互。 它用于对 StoreFront 中的所有操作以及向 Citrix Gateway 进行身份验证。

有关早期版本的适用于 Citrix Receiver for Windows 的 Storebrowse 实用程序的文档，请参阅 Storebrowse for Citrix Receiver for Windows（适用于 Citrix Receiver for Windows 的 Storebrowse）文档。

通过使用 Storebrowse 实用程序，管理员可以自动执行以下日常操作：

• 添加应用商店。
• 枚举已配置的应用商店中已发布的 Citrix Virtual Apps and Desktops 和 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops 服务）。
• 通过手动选择任何已发布的 Citrix Virtual Apps and Desktops 和 Citrix DaaS 生成 ICA 文件。
• 使用 Storebrowse 命令行生成 ICA 文件。
• 启动已发布的应用程序。

Storebrowse 实用程序现在属于 Authmanager 组件。 安装 Citrix Workspace 应用程序后，Storebrowse 实用程序位于 AuthManager 安装文件夹中。

可以通过以下方式检查注册表路径来确认 Storebrowse 实用程序是否与 Authmanager 组件一起安装：

由管理员安装 Citrix Workspace 应用程序时：

由用户（非管理员）安装 Citrix Workspace 应用程序时：

要求

安装适用于 Windows 的 Citrix Workspace 应用程序版本 1808 或更高版本，才能在 StoreFront 和 Citrix Gateway 之间无缝地使用 Storebrowse 实用程序。 要安装 Citrix Workspace 应用程序版本 1809，至少需要 530 MB 可用磁盘空间和 2 GB RAM。

兼容性列表

Storebrowse 实用程序与以下操作系统兼容：

连接

Storebrowse 实用程序支持以下类型的连接：

• HTTP 应用商店
• HTTPS 应用商店
• Citrix Gateway 11.0 及更高版本

注意：

在 HTTP 应用商店上使用命令行时，Storebrowse 实用程序不接受凭据。

身份验证方法

StoreFront 服务器

StoreFront 支持使用不同的身份验证方法访问应用商店，但有些方法并不建议使用。 出于安全考虑，在创建应用商店时，某些身份验证方法默认情况下处于禁用状态。

• 用户名和密码： 用户在访问其应用商店时可以输入其凭据并进行身份验证。 在创建第一个应用商店时，显式身份验证默认情况下处于启用状态。 所有用户访问方法都支持显式身份验证。
• 域直通： 用户向其加入域的 Windows 计算机验证身份后，即可在访问自己的应用商店时自动登录。 要使用此选项，必须在用户设备上安装 Citrix Workspace 应用程序时启用直通身份验证。 有关配置域直通的详细信息，请参阅配置直通身份验证。
• HTTP Basic： Storebrowse 实用程序需要启用 HTTP Basic 身份验证才能与 StoreFront 服务器进行通信。 默认情况下，此选项在 StoreFront 服务器上处于禁用状态。 必须启用 HTTP Basic 身份验证方法。

Storebrowse 实用程序支持通过以下任一方法进行身份验证：

• 使用内置的 AuthManager 以及 Storebrowse 实用程序。 注意：使用 Storebrowse 实用程序时，必须在 StoreFront 上启用 HTTP Basic 身份验证方法。 当用户使用 Storebrowse 命令提供凭据时，此方法适用。
• 可以包含在适用于 Windows 的 Citrix Workspace 应用程序中的外部 Authmanager。

Citrix Gateway 支持

使用最新版本的 Storebrowse 实用程序时，现在可以添加 Citrix Gateway URL。 不需要在 Storebrowse 实用程序中进行任何额外的配置即可与 Citrix Gateway 进行通信。

通过 Citrix Gateway 实现单点登录

除了新添加的 Citrix Gateway 支持之外，现在还可以通过其使用单点登录。 您可以添加新应用商店以及枚举已发布的资源，而无需提供您的用户凭据。

有关通过 Citrix Gateway 支持单点登录的详细信息，请参阅支持通过 Citrix Gateway 实现单点登录。

注意：

仅在为 Citrix Gateway 配置了单点登录身份验证的已加入域的计算机上支持此功能。

启动已发布的桌面或应用程序

现在可以直接从应用商店启动资源，而不需要使用 ICA 文件。

命令用法

以下部分提供了有关可以从 Storebrowse 实用程序使用的命令的详细信息。

-a、–addstore

说明:

添加新应用商店。 返回应用商店的完整 URL。 如果失败，则会报告一条错误。

注意：

可以使用 Storebrowse 实用程序添加多个应用商店。

StoreFront 上的命令示例：

命令：

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*

Example:

.\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*

Example:

.\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（可以是 StoreFront 服务器或 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 文件。 launch 选项要求提供资源的名称以及应用商店 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

上面的输出中以粗体显示的名称用作 launch 选项的输入参数。

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

说明:

使用 Storebrowse 实用程序，在 -f 选项中定义的自定义路径中生成访问任何已发布的应用程序和桌面所需的 ICA 文件。

launch 选项要求提供文件夹名称和资源的名称作为输入以及应用商店 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

说明:

为 Storebrowse 实用程序内置的 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

通过 Citrix Gateway 实现单点登录支持

单点登录允许您对域进行身份验证，并使用该域提供的 Citrix Virtual Apps and Desktops 和 Citrix DaaS，而不需要重新对每个应用程序或桌面进行身份验证。 使用 Storebrowse 实用程序添加应用商店时，您的凭据将随为您枚举的虚拟应用程序和桌面一起传递到 Citrix Gateway 服务器，包括“开始”菜单设置。 配置单点登录后，可以添加应用商店、枚举虚拟应用程序和桌面以及启动所需的资源，而无需多次键入您的凭据。

Citrix Gateway 版本 11 及更高版本支持此功能。

必备条件：

有关如何为 Citrix Gateway 配置单点登录的必备条件，请参阅配置域直通身份验证。

可以使用组策略对象 (GPO) 管理模板启用通过 Citrix Gateway 实现的单点登录功能。

注意：

从 Citrix Receiver 升级到 Citrix Workspace 应用程序或首次全新安装 Citrix Workspace 应用程序时，必须向本地 GPO 中添加最新的模板文件。 有关向本地 GPO 中添加模板文件的详细信息，请参阅配置组策略对象管理模板。 如果进行升级，导出最新文件时将保留现有设置。

1. 通过运行 gpedit.msc 打开 Citrix Workspace 应用程序 GPO 管理模板
2. 在“计算机配置”节点下，转到管理模板 > Citrix 组件 > Citrix Workspace > 用户身份验证 > 适用于 Citrix Gateway 的单点登录。
3. 使用切换选项以启用或禁用“Single Sign-On”选项。
4. 单击应用和确定。
5. 重新启动 Citrix Workspace 应用程序会话以使所做的更改生效。

限制：

• 必须在 StoreFront 服务器上启用 HTTP Basic 身份验证方法，才能通过 Storebrowse 实用程序执行凭据注入操作。
• 如果您有 HTTP 应用商店，并尝试使用该实用程序连接到该应用商店以枚举或启动已发布的虚拟应用程序和桌面时，将不支持使用命令行选项执行凭据注入操作。 解决方法是，使用外部 AuthManager 模块，当您不使用命令行提供凭据时会触发该模块。
• Storebrowse 实用程序当前仅支持单个应用商店（在 StoreFront 服务器上配置了 Citrix Gateway）。
• 仅当为 Citrix Gateway 配置了单重身份验证时，才可使用 Storebrowse 实用程序中的凭据注入功能。
• Storebrowse 实用程序的命令行选项 Username (-U)、Password (-P) 和 Domain (-D) 区分大小写，并且只能使用大写字母。