Storebrowse

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

通过使用 Storebrowse 实用程序,管理员可以自动执行以下操作:

  • 添加应用商店。
  • 从配置的应用商店中枚举已发布的应用程序和桌面。
  • 通过手动选择任何已发布的 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 或更高版本。
  • 最少 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:启用 HTTP Basic 身份验证,以便 Storebrowse 实用程序能够与 StoreFront 服务器进行通信。默认情况下,此选项在 StoreFront 服务器上处于禁用状态。必须启用 HTTP Basic 身份验证方法。

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

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

通过 Citrix Gateway 实现单点登录

除了新添加的 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。启动 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

说明:

在已发布的应用程序和桌面的自定义路径中生成 ICA 文件。

启动选项需要文件夹名称和资源名称作为带 Store URL 的输入。应用商店 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 实现单点登录支持

Single Sign-On 允许您对域进行身份验证,并使用该域提供的 Citrix Virtual Apps and Desktops,而不需要重新对每个应用程序或桌面进行身份验证。添加应用商店时,您的凭据将随枚举的 Citrix Virtual Apps and Desktops 和“开始”菜单设置传递到 Citrix Gateway 服务器。

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

必备条件:

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

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

  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) 区分大小写,并且必须采用大写形式。
Storebrowse