Storebrowse

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

• 有关适用于 Windows 版 Citrix Receiver 的 Storebrowse 实用程序的旧版本文档，请参阅适用于 Windows 版 Citrix Receiver 的 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 版或更高版本，以便 Storebrowse 实用程序能够在 StoreFront 和 Citrix Gateway 之间无缝工作。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 和 Datacenter 版本

• Windows Server 2012 Standard 和 Datacenter 版本

• Windows Server 2008 R2 64 位版本

  Windows Server 2008 R2 64 位版本

• 连接

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

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

注意：

Storebrowse 实用程序不支持通过命令行在 HTTP 应用商店上接受凭据。

身份验证方法

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 单点登录

除了新增的 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

说明：

列出用户添加的 Store。

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 作为输入以及 Store URL，Store 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 文件。launch 选项需要资源名称以及 Store URL，Store URL 可以是 StoreFront 服务器 URL 或 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

Description:

您可以添加应用商店，枚举已发布的资源（应用程序和桌面），并使用单个命令启动资源。此选项接受以下参数：用户名、密码、域、要启动的资源的友好名称以及应用商店 URL。但是，如果用户未提供凭据，则会弹出 AuthManager 提示以输入凭据，然后才会启动资源。

您可以通过执行以下命令获取已发布应用程序和桌面的资源名称：

.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

此命令会生成以下输出：

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjY3VsYXRvci/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

Description:

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

启动选项需要一个文件夹名称以及资源名称作为输入，并附带应用商店 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

Description:

为 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

Description:

删除现有的 StoreFront 或 Citrix Gateway 应用商店。

StoreFront 上的命令示例：

.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery

Citrix Gateway 上的命令示例：

.\storebrowse.exe –d https://my.secondexmaplestore.com

Single sign-on support with Citrix Gateway

单点登录 (Single Sign-on) 允许您对域进行身份验证，并使用该域提供的 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. 使用切换选项启用或禁用单点登录选项。
4. 单击“应用”和“确定”。
5. 重新启动 Citrix Workspace 应用程序会话以使更改生效。

限制：

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