Storebrowse

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

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

• 添加应用商店。
• 列出已配置应用商店中已发布的应用程序和桌面。
• 通过手动选择任何已发布的虚拟应用程序和桌面来生成 ICA® 文件。
• 使用 Storebrowse 命令行生成 ICA 文件。
• 启动已发布的应用程序。

Storebrowse 实用程序是 Authmanager 组件的一部分。Citrix Workspace app 安装完成后，Storebrowse 实用程序位于 AuthManager 安装文件夹中。

要确认 Storebrowse 实用程序已随 Authmanager 组件一起安装，请检查以下注册表路径：

当管理员安装 Citrix Workspace app 时：

• 在 64 位计算机上

  [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

• 当用户（非管理员）安装 Citrix Workspace app 时：

要求

• 适用于 Windows 的 Citrix Workspace app 1808 版或更高版本。
• 至少 530 MB 的可用磁盘空间。
• 2 GB RAM。

兼容性矩阵

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

• 操作系统

• Windows 10 32 位和 64 位版本

  Windows 8.1 32 位和 64 位版本

  Windows 7 SP1 32 位和 64 位版本

  Windows Thin PC

  Windows Server 2016

  Windows Server 2012 R2 Standard 和 Data Center 版本

• Windows Server 2012 Standard 和 Data Center 版本

• 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：启用 HTTP Basic 身份验证，以便 Storebrowse 实用程序可以与 StoreFront 服务器通信。此选项在 StoreFront 服务器上默认处于禁用状态。启用 HTTP Basic 身份验证方法。

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

• 使用 Storebrowse 实用程序内置的 Authmanager。注意：在使用 Storebrowse 实用程序时，请在 StoreFront 上启用 HTTP Basic 身份验证方法。这适用于用户使用 Storebrowse 命令提供凭据的情况。
• 可随适用于 Windows 的 Citrix Workspace app 一起包含的外部 Authmanager。

通过 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*

示例：

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

/?

说明：

提供有关 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 文件。启动选项需要资源名称和 Store URL。Store 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

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 的单点登录功能。

1. 通过运行 gpedit.msc 打开 Citrix Workspace 应用程序 GPO 管理模板。
2. 在计算机配置节点下，转到管理模板 > Citrix 组件 > Citrix Workspace > 用户身份验证 > Citrix Gateway 单点登录。
3. 使用切换选项启用或禁用单点登录选项。
4. 单击应用和确定。
5. 重新启动 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

注意：

• 您可以提供多个第三方应用程序，用分号分隔。