Storebrowse

Storebrowse 是一款在客户端与服务器之间进行交互的轻型命令行实用程序。通过使用 storebrowse 实用程序,管理员可以自动执行以下日常操作:

  • 添加应用商店。
  • 列出已配置的应用商店中的已发布应用程序和桌面。
  • 从已配置的应用商店订阅和取消订阅应用程序和桌面。
  • 启用和禁用已发布的应用程序和桌面的快捷方式。
  • 启动已发布的应用程序。
  • 重新连接到断开连接的会话。

storebrowse 实用程序通常在 /util 文件夹中提供。您可以在安装位置下找到该文件。例如 /opt/Citrix/ICAClient/util

必备条件

storebrowse 实用程序需要 libxml2 库软件包。

启动已发布的桌面和应用程序

有两种方法可以启动资源:

  • 可以使用命令行和 storebrowse 命令
  • 可以使用 UI 启动资源。

本文探讨 storebrowse 命令。

命令用法

以下部分详细介绍了您可以从 storebrowse 实用程序中使用的 storebrowse 命令。

-a、–addstore

说明:

添加包含网关和信标详细信息的新应用商店以及 ServiceRecord 守护程序进程。此命令返回应用商店的完整 URL。如果添加应用商店失败,则将出现错误。

StoreFront 上的命令示例:

命令:

./storebrowse -a *URL of StoreFront or a PNAStore*

示例:

./storebrowse –a https://my.firstexamplestore.net

注意:

可以使用 storebrowse 实用程序添加多个应用商店。

-h、-?、–help

说明:

提供有关 storebrowse 实用程序用法的详细信息

-l –liststore

说明:

列出您已添加的应用商店。

StoreFront 上的命令示例:

./storebrowse –l

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

说明:

终止指定应用商店的所有会话。

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

-C –addCR

说明:

读取提供的 Citrix Receiver (CR) 文件,并提示您添加每个应用商店。输出与 -a 命令相同,但有多个应用商店,由换行符分隔。

StoreFront 上的命令示例:

./storebrowse –C <path to CR file>

-K –killdaemon

说明:

终止 storebrowse 后台程序。因此,将清除所有凭据和令牌。

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>

-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