Storebrowse
注意:
本文仅适用于 Citrix Workspace 的本地部署。有关云部署,请参阅 适用于 Workspace 的 Storebrowse 文档。
Storebrowse 是一款在客户端与服务器之间进行交互的命令行实用程序。它用于对 StoreFront 中的所有操作以及向 Citrix Gateway 进行身份验证。
通过使用 Storebrowse 实用程序,管理员可以自动执行以下操作:
- 添加应用商店。
- 列出已配置的应用商店中的已发布应用程序和桌面。
- 通过手动选择任何已发布的虚拟应用程序和桌面生成 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 Server 2022 |
Windows Server 2016 |
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:此方法由第三方客户端集成和 Web 门户网站使用,其中使用外部用户界面来捕获域限定的用户名和密码。StoreFront 使用 IIS 中的基本身份验证功能将凭据传输到 StoreFront 服务器。然后,StoreFront 使用域服务或 Broker XML Service 身份验证来验证凭据以及获取组信息。有关如何启用 HTTP Basic 身份验证的信息,请参阅管理身份验证方法文档中的 HTTP Basic。
- 适用于 Storebrowse 的高级 NetScaler 策略:适用于 Windows 的 Citrix Workspace 应用程序现在支持使用 Storebrowse 的 NetScaler Gateway 上的高级策略。支持的身份验证协议为 LDAP 身份验证。
注意:
Windows 上的 Storebrowse 不支持 nFactor 身份验证协议。
Storebrowse 实用程序支持通过以下任一方法进行身份验证:
- 使用随 Storebrowse 实用程序内置的
AuthManager
。注意:使用 Storebrowse 实用程序时,请在 StoreFront 上启用 HTTP Basic 身份验证方法。当用户使用 Storebrowse 命令提供凭据时,此方法适用。 - 使用适用于 Windows 的 Citrix Workspace 应用程序中包含的
Authmanager
。当您使用域直通身份验证时,可以使用此方法。有关详细信息,请参阅域直通身份验证文档。
启动已发布的桌面或应用程序
现在可以直接从应用商店启动资源,而不需要使用 ICA 文件。
注意:
您无法使用 Storebrowse 命令打开 SaaS 应用程序或已发布的内容。
命令用法
以下部分提供了有关可以从 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`
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
跟踪 Storebrowse 命令状态
您可以在文件中跟踪 Storebrowse 命令的执行状态。要跟踪成功状态,请在 -f launch
命令中提供一个唯一的文件名。此命令使用您提供的名称生成一个文件。失败状态存在于 ica.error
文件中,该文件是自动创建的。
注意:
请务必使用
-f launch
命令为文件名添加.ica
扩展名。否则,不会生成该文件。
用于跟踪成功和失败的文件已存在于 %LOCALAPPDATA%\citrix\selfservice\cache
,您可以根据需要监视这些文件。
默认情况下,此增强功能处于启用状态。
下面是使用带 -f
选项的启动命令的示例:
-launch -f <uniqueFileName.ica> "launchcommandline"
For example:
SelfService.exe storebrowse -launch -f uniqueFileName.ica -s store0-5c3ec017 -CitrixID store0-5c3ec017@@a9a8e3ac-099d-4577-b84e-e33d0695df39.Notepad -ica "https://cwawiniwstest.cloudburrito.com/Citrix/Store/resources/v2/YTlhOGUzYWMtMDk5ZC00NTc3LWI4NGUtZTMzZDA2OTVkZjM5Lk5vdGVwYWQ-/launch/ica" -cmdline
<!--NeedCopy-->
通过 Citrix Gateway 实现单点登录支持
单点登录功能允许您对某个域进行身份验证,并使用该域提供的 Citrix Virtual Apps and Desktops 和 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)。您可以登录,而无需对每个应用程序或桌面重新进行身份验证。添加应用商店时,您的凭据将随 Citrix Virtual Apps and Desktops 和 Citrix DaaS 和“开始”菜单设置传递到 Citrix Gateway 服务器。
Citrix Gateway 版本 11 及更高版本支持此功能。
必备条件:
有关如何为 Citrix Gateway 配置单点登录的必备条件,请参阅配置域直通身份验证。
可以使用组策略对象 (GPO) 管理模板启用通过 Citrix Gateway 实现的单点登录功能。
- 通过运行 gpedit.msc 打开 Citrix Workspace 应用程序 GPO 管理模板
- 在计算机配置节点下,转至管理模板 > Citrix 组件 > Citrix Workspace > 用户身份验证 > 通过 Citrix Gateway 实现 Single Sign-On。
- 使用切换选项以启用或禁用“Single Sign-On”选项。
- 单击应用和确定。
- 重新启动 Citrix Workspace 应用程序会话以使所做的更改生效。
限制:
- 在 StoreFront 服务器上启用 HTTP Basic 身份验证方法,以便通过 Storebrowse 实用程序执行凭据注入操作。
- 如果您有 HTTP 应用商店,并尝试使用该实用程序连接到该应用商店以检查或启动已发布的虚拟应用程序和桌面,则不支持使用命令行选项执行凭据注入操作。解决方法:如果您未使用命令行提供凭据,请使用外部
AuthManager
模块。 - Storebrowse 实用程序当前仅支持单个应用商店(在 StoreFront 服务器上配置了 Citrix Gateway)。
- 仅当为 Citrix Gateway 配置了单重身份验证时,才可使用 Storebrowse 实用程序中的凭据注入功能。
-
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
注意:
- 您可以提供多个用分号分隔的第三方应用程序。
- 版本 2107 及更高版本支持此功能。