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 Virtual Apps and Desktops 生成 ICA 文件。
  • 使用 Storebrowse 命令行生成 ICA 文件。
  • 启动已发布的应用程序。

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

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

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

   
在 32 位计算机上 [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install]
在 64 位计算机上 [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

由用户(非管理员)安装 Citrix Workspace 应用程序时:

   
在 32 位计算机上 [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install]
在 64 位计算机上 [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

要求

安装适用于 Windows 的 Citrix Workspace 应用程序版本 1808 或更高版本,才能在 StoreFront 和 Citrix Gateway 之间无缝地使用 Storebrowse 实用程序。要安装 Citrix Workspace 应用程序版本 1809,至少需要 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 Edition 和 Datacenter Edition
Windows Server 2012 Standard Edition 和 Datacenter Edition
Windows Server 2008 R2(64 位版本)
Windows Server 2008 R2(64 位版本)

连接

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

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

注意:

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

身份验证方法

StoreFront 服务器

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

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

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

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

Citrix Gateway 支持

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

通过 Citrix Gateway 实现 Single Sign-On

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

有关通过 Citrix Gateway 支持 Single Sign-On 的详细信息,请参阅支持通过 Citrix Gateway 实现 Single Sign-On

注意:

仅在为 Citrix Gateway 配置了 Single Sign-On 身份验证的已加入域的计算机上支持此功能。

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

现在可以直接从应用商店启动资源,而不需要使用 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(可以是 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 支持 Single Sign-On

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

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

必备条件:

有关如何为 Citrix Gateway 配置 Single Sign-On 的必备条件,请参阅配置域直通身份验证

可以使用组策略对象 (GPO) 管理模板启用通过 Citrix Gateway 实现的 Single Sign-On 功能。

注意:

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

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

限制:

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