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-->

输出如下所示:

Storebrowse 命令

枚举

-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 命令启动应用程序的简单工作流:

  1. ./storebrowse -a https://my.firstexamplestore.net

    添加应用商店并提供应用商店的完整 URL。记下完整的 URL,因为在后面的命令中会使用该 URL。

  2. ./storebrowse.exe -E https://my.firstexamplestore.net/Citrix/Store/discovery

    列出所有已发布的应用程序和桌面。使用针对已注册的应用商店显示的弹出窗口输入您的凭据。

  3. ./storebrowse -L <Resource_Name> https://my.firstexamplestore.net/Citrix/Store/discovery

    启动资源。从上一个命令的输出中获取资源名称。

  4. ./storebrowse -K

    此命令将清除之前输入的凭据并关闭 storebrowse 守护程序。如果未明确提及此命令,storebrowse 进程将在一小时后退出。

Storebrowse