Storebrowse
Storebrowse
是一款在客户端与服务器之间进行交互的轻型命令行实用程序。通过使用 storebrowse
实用程序,管理员可以自动执行以下日常操作:
- 添加应用商店。
- 列出已配置的应用商店中的已发布应用程序和桌面。
- 从已配置的应用商店订阅和取消订阅应用程序和桌面。
- 启用和禁用已发布的应用程序和桌面的快捷方式。
- 启动已发布的应用程序。
- 重新连接到断开连接的会话。
storebrowse
实用程序通常在 /util
文件夹中提供。您可以在安装位置下找到该文件。例如,/opt/Citrix/ICAClient/util
。
必备条件
storebrowse
实用程序需要 libxml2 库软件包。
启动已发布的桌面和应用程序
有两种方法可以启动资源:
- 可以使用命令行和
storebrowse
命令 - 可以使用 UI 启动资源。
本文讨论 storebrowse
命令。
Storebrowse
增强功能
针对服务连续性的 以前,仅在使用自助服务插件进行连接时,Workspace 连接租用文件才与远程服务器上的可用文件同步。因此,使用 storebrowse
启动应用程序和桌面会话时,不支持服务连续性功能。大多数第三方瘦客户端供应商都使用 storebrowse
连接到 Workspace 平台,并且没有为其启用服务连续性功能。
自 Citrix Workspace 应用程序的 2109 版本起,当您也使用 storebrowse
进行连接时,Workspace 连接租用文件将与远程服务器上的可用文件同步。此功能有助于第三方瘦客户端供应商即使在 Workspace 脱机时也能访问它。
注意:
- 此增强功能仅在云部署中启用了服务连续性时可用。有关详细信息,请参阅 Citrix Workspace 文档中的配置服务连续性部分。
命令用法
以下部分详细介绍了您可以从 storebrowse
实用程序中使用的 storebrowse
命令。
添加应用商店
-a, --addstore
说明:
添加包含网关和信标详细信息的应用商店以及 ServiceRecord 守护程序进程。此命令返回应用商店的完整 URL。如果添加应用商店失败,则将出现错误。
StoreFront 的命令示例:
命令:
./storebrowse -a *URL of StoreFront or a PNAStore*
示例:
./storebrowse -a https://my.firstexamplestore.net
注意:
可以使用
storebrowse
实用程序添加多个应用商店。以前,此命令会添加单个应用商店并返回应用商店的 URL。自 2311 版本起,除了现有功能外,此命令还会在有多个帐户可用时添加所有 URL。
帮助
-?, -h, --help
说明:
提供有关 storebrowse
实用程序用法的详细信息。
列出应用商店
-l --liststore
说明:
列出您已添加的应用商店。
StoreFront 上的命令示例:
./storebrowse -l
注意:
以前,此命令仅列出添加到帐户中的单个应用商店。自 2311 版本起,此命令还列出了多家应用商店。
列出身份验证方法
-lt
说明:自适用于 Linux 的 Citrix Workspace 应用程序版本 2402 起,引入了一个新命令 -lt
,用于列出为 StoreFront 启用的所有类型的身份验证方法。此命令支持使用凭据插入 SDK。
请按如下所示输入 storebrowse 命令:
./storebrowse -lt <full URL>`
<!--NeedCopy-->
输出如下所示:
枚举
-E --enumerate
说明:
列出可用资源。默认情况下将显示以下值:
- 资源名称
- 显示名称
- 资源文件夹
要查看详细信息,请将 -M --details
命令附加到 -E
命令。
注意:
运行 -E 命令时,如果您之前未提供凭据,则会显示身份验证窗口。
输入 -liststore 报告的整个应用商店 URL。
StoreFront 的命令示例:
-
./storebrowse.exe -E https://my.firstexamplestore.net/Citrix/Store/discovery
-
./storebrowse.exe -E -M https://my.firstexamplestore.net/Citrix/Store/discovery
已订阅
-S --subscribed
说明:
列出订阅的资源。默认情况下将显示以下值:
- 资源名称
- 显示名称
- 资源文件夹
要查看详细信息,请将 -M --details
命令附加到 -E
命令。
StoreFront 的命令示例:
-
./storebrowse.exe -S https://my.firstexamplestore.net/Citrix/Store/discovery
-
./storebrowse.exe -S -M https://my.firstexamplestore.net/Citrix/Store/discovery
详细信息
-M --details
说明:
此命令返回已发布的应用程序的几个属性。此命令通常与 -E 和 -S 命令一起使用。此命令采用的一个参数是与所需详细信息对应的数字之和:
- Publisher(0x1)
- VideoType(0x2)
- SoundType(0x4)
- AppInStartMenu(0x8)
- AppOnDesktop(0x10)
- AppIsDesktop(0x20)
- AppIsDisabled(0x40)
- WindowType(0x80)
- WindowScale(0x100)
- DisplayName(0x200)
- AppIsMandatory(0x10000)
- CreateShortcuts(0x100000)
- RemoveShortcuts(0x200000)
备注:
要为已订阅的应用程序创建菜单条目,请将 CreateShortcuts(0x100000) 参数与 -S、-s 和 -u 命令一起使用。
要删除所有菜单条目,请将 RemoveShortcuts(0x200000) 与 -S 命令一起使用。
StoreFront 的命令示例:
./storebrowse.exe -S -M 0x264 https://my.firstexamplestore.net/Citrix/Store/discovery
在上面的命令示例中,0x264 是 DisplayName(0x200)、AppIsDisabled(0x40)、AppIsDesktop(0x20) 和 SoundType(0x4) 的组合。输出将列出已订阅的资源以及详细信息。
可以使用 -M 命令列出具有所需详细信息的资源:
./storebrowse.exe -E -M 0x264 https://my.firstexamplestore.net/Citrix/Store/discovery
备注:
- 可以使用十进制或十六进制格式表示这些值。例如,512 表示 0x200。
- 如果某些详细信息无法通过 storebrowse 提供,则输出值为零。
订阅
-s --subscribe
说明:
订阅指定应用商店中的指定资源。
StoreFront 的命令示例:
./storebrowse -s <Resource_Name> https://my.firstexamplestore.net/Citrix/Store/discovery
取消订阅
-u --unsubscribe
说明:
从指定应用商店中取消订阅指定的资源。
StoreFront 的命令示例:
./storebrowse -u <Resource_Name> https://my.firstexamplestore.net/Citrix/Store/discovery
启动
-L --launch
说明:
启动与已发布资源的连接。实用程序随后将自动关闭,退出已成功连接的会话。
StoreFront 的命令示例:
./storebrowse -L <Resource_Name> https://my.firstexamplestore.net/Citrix/Store/discovery
图标
-i --icons
说明:
此命令以 PNG 格式提取桌面和应用程序图标。此命令与 -E 或 -S 命令一起使用。
要获取所需大小和深度的图标,请使用 best 参数或 size 参数方法。
best 参数
使用 best 参数方法,您可以获取服务器上提供的最佳大小的图标。可以稍后将图标转换为所需大小。best 参数方法是存储、应用带宽和简化脚本编写的最有效的方法。文件以 <resource name>.png 格式保存。
size 参数
要获取指定大小和深度的图标,请使用 size 参数方法。如果服务器无法获取给定大小或深度的图标,则会出现错误。
size 参数采用 WxB 格式,其中:
- W 为图标的宽度。所有图标都是正方形的,因此只需要一个值即可指定大小。
- B 为颜色深度。也就是说,每像素的位数。
注意:
值 W 是必需的。值 B 是可选的。
如果未指定这些值,则会显示所有可用图像深度的图标。这些文件以 <resource name>_WxWxB.png 格式保存。
对于 -E 或 -S 命令返回的每个资源,这两种方法都以 .png 格式保存图标。
图标存储在 .ICAClient/cache/icons 文件夹中。
StoreFront 的命令示例:
-
./storebrowse -E -i best https://my.firstexamplestore.net/Citrix/Store/discovery
-
./storebrowse -S -i 16x16 https://my.firstexamplestore.net/Citrix/Store/discovery
重新连接会话
-W [r|R] --reconnect [r|R]
说明:
重新连接指定应用商店的处于活动状态但已断开连接的会话。[r] 选项将重新连接所有断开连接的会话。[R] 选项将重新连接所有活动会话和断开连接的会话。
StoreFront 的命令示例:
-
./storebrowse -Wr https://my.firstexamplestore.net/Citrix/Store/discovery
-
./storebrowse -WR https://my.firstexamplestore.net/Citrix/Store/discovery
断开会话连接
-WD --disconnect
说明:
断开指定应用商店的所有会话的连接。
StoreFront 的命令示例:
./storebrowse -WD https://my.firstexamplestore.net/Citrix/Store/discovery
终止会话
-WT --terminate
说明:
终止指定应用商店的所有会话。
StoreFront 的命令示例:
./storebrowse -WT https://my.firstexamplestore.net/Citrix/Store/discovery
版本
-v --version
说明:
显示 storebrowse 实用程序的版本。
StoreFront 的命令示例:
./storebrowse -v
根目录
-r --icaroot
说明:
指定安装了适用于 Linux 的 Citrix Workspace 应用程序的根目录。如果未指定,则在运行时确定根目录。
StoreFront 的命令示例:
./storebrowse -r /opt/Citrix/ICAClient
用户名、密码、域
-U --username, -P --password, -D --domain
说明:
将用户名、密码和域详细信息传递给服务器。此方法仅适用于 PNA 应用商店。StoreFront 应用商店忽略此命令。详细信息不会被缓存。请通过每个命令输入详细信息。
StoreFront 的命令示例:
./storebrowse -E https://my.firstexamplestore.net/Citrix/Store/discovery -U user1 -P password -D domain-name
删除应用商店
-d --deletestore
说明:
取消在 ServiceRecord 后台程序中注册应用商店。
StoreFront 的命令示例:
./storebrowse -d https://my.firstexamplestore.net/Citrix/Store/discovery
配置自助服务
-c --configselfservice
说明:
获取并配置在 StoreCache.ctx 中存储的自助服务式 UI 设置。采用的参数格式为 <entry[=value]>。如果仅存在条目,则会输出设置的当前值。但是,如果存在某个值,则会使用该值配置设置。
StoreFront 的命令示例:
./storebrowse -c SharedUserMode=True
添加 CR 文件
-C --addcr
说明:
读取提供的 Citrix Receiver (CR) 文件,并提示您添加每个应用商店。输出与 -a 命令相同,但有多个应用商店,由换行符分隔。
StoreFront 的命令示例:
./storebrowse -C <path to CR file>
同步连接租用文件
-o --synclease
说明:
开始将 Workspace 连接租用文件与指定应用商店的远程服务器上的可用文件进行同步。此命令有助于更新默认应用商店并触发租用文件同步。如果禁用服务连续性,则会显示错误。
命令:
./storebrowse -o *URL of Store *
StoreFront 的命令示例:
./storebrowse –o https://my.firstexamplestore.net
关闭 storebrowse
守护程序
-K --killdaemon
说明:
终止 storebrowse
守护程序。因此,将清除所有凭据和令牌。
自 2311 版本起,-K
命令还有助于退出 StoreFront、云应用商店或 NetScaler Gateway。
StoreFront 的命令示例:
./storebrowse -K
列出错误代码
-e --listerrorcodes
说明:
列出注册的错误代码。
StoreFront 的命令示例:
./storebrowse -e
应用商店网关
-g --storegateway
说明:
为已在 ServiceRecord 后台程序中注册的应用商店设置默认网关。
StoreFront 的命令示例:
./storebrowse -g “<unique gateway name>” https://my.firstexamplestore.net/Citrix/Store/discovery
注意:
唯一网关名称必须在指定应用商店的网关列表中。
快速启动
-q, --quicklaunch
说明:
使用直接 URL 启动应用程序。此命令仅适用于 StoreFront 应用商店。
StoreFront 的命令示例:
.\storebrowse.exe -q <https://my.firstexamplestore.net/Citrix/Store/resources/v2/Q2hJkOlmNoPQrSTV9y/launch/ica> <https://my.firstexamplestore.net/Citrix/Store/discovery>
Daemonize
-n --nosingleshot
说明:
始终守护 storebrowse
进程。
StoreFront 的命令示例:
./storebrowse -n
文件参数
-F --fileparam
说明:
使用指定的文件路径和资源启动文件。
StoreFront 的命令示例:
./storebrowse -F “<path to file>” -L <Resource Name> <https://my.firstexamplestore.net/Citrix/Store/discovery>
工作流
本文演示了如何使用 storebrowse 命令启动应用程序的简单工作流:
-
./storebrowse -a https://my.firstexamplestore.net
添加应用商店并提供应用商店的完整 URL。记下完整的 URL,因为在后面的命令中会使用该 URL。
-
./storebrowse.exe -E https://my.firstexamplestore.net/Citrix/Store/discovery
列出所有已发布的应用程序和桌面。使用针对已注册的应用商店显示的弹出窗口输入您的凭据。
-
./storebrowse -L <Resource_Name> https://my.firstexamplestore.net/Citrix/Store/discovery
启动资源。从上一个命令的输出中获取资源名称。
-
./storebrowse -K
此命令将清除之前输入的凭据并关闭
storebrowse
守护程序。如果未明确提及此命令,storebrowse
进程将在一小时后退出。