Интерфейс командной строки Клиента и параметры конфигурирования

Интерфейс командной строки Клиента и параметры конфигурирования

Параметры запуска и функционирования Клиента могут быть переопределены аргументами командной строки или переменными окружения.

Для получения краткой информации по доступным аргументам командной строки следует вызвать приложение termidesk-client с аргументом --help:

termidesk-client --help

Для получения полной информации по доступным аргументам командной строки следует вызвать приложение termidesk-client  с аргументом --help-all:

termidesk-client --help-all

Для использования интерфейса командной строки Клиента в ОС Microsoft Windows нужно:

  • открыть командную строку от имени администратора;
  • вызывать Клиент из каталога C:\Program Files\UVEON\Termidesk Client\bin;
  • перенаправить вывод команды в файл. В указанном файле будет показан результат выполнения команды.

Пример получения полной информации по доступным аргументам командной строки с выводом в файл C:\client_help_all.txt:

"C:\Program Files\UVEON\Termidesk Client\bin\termidesk-client.exe" --help-all > C:\client_help_all.txt

Список доступных аргументов и переменных окружения приведен в таблице. В ОС Microsoft Windows указанные аргументы также воспринимаются, однако результат не выводится в командную строку.

После установки Клиента в ОС добавилась служба Termidesk TBUS, необходимая для взаимодействия компонентов Termidesk. Запуск службы осуществляется автоматически, через приложение C:\Program Files\UVEON\Termidesk Client\bin\termidesk-tbus.exe. 

Приложение termidesk-tbus.exe поддерживает ключ -e, позволяющий запустить termidesk-tbus.exe как исполняемый файл, а не как службу.

При задании переменных окружения стоит учесть, что они также влияют на настройки ПО Termidesk Viewer (см. подраздел Интерфейс командной строки ПО Termidesk Viewer и параметры конфигурирования).

Список аргументов командной строки и переменных окружения для Клиента

ПараметрПеременная окруженияОписаниеЗначение по умолчанию
URL TDSK_VDI_URL

Адрес подключения к серверу или приложению. Параметр доступен с версии 4.3.

Допустимые схемы:

https://192.0.2.10 - подключение к серверу;

daass://192.0.2.10/foo/bar  - подключение к приложению.

Начиная с Termidesk версии 5.1 поддерживается подключение к серверу с указанием URI сайта, например: https://192.0.2.10/site

Не задано

--debug TDSK_DEBUG Включение отладочного режима. Для включения режима через переменную окружения достаточно присвоить ей ненулевое значение Не задано
--lang TDSK_LANG

Выбор языка для приложения. Параметр доступен с версии 5.0. По умолчанию язык будет определен из региональных настроек, установленных в ОС.

Возможные значения: «ru», «en»

auto
--timeout
 		TDSK_TIMEOUT Время ожидания сетевых подключений 60
--user-auth
 		TDSK_USER_AUTH Имя домена аутентификации для подключения. Параметр доступен с версии 4.3 Не задано
--user-name
 		TDSK_USER_NAME Имя пользователя для подключения. Параметр доступен с версии 4.3 Не задано
--user-password
 		TDSK_USER_PASSWORD Пароль пользователя для подключения. Параметр доступен с версии 4.3 Не задано
--version Не задана Вывод текущей версии Клиента Не задано
Не задан TDSK_RDS_GATEWAYHOSTNAME

Имя шлюза (FQDN) для приложения mstsc.exe. Для корректной работы может потребоваться отредактировать файл hosts в ОС. Используется при подключении к шлюзу MS RDS через компонент «Шлюз»

 Не задано
Не задан TDSK_RDP_SIGN_SHA256

Отпечаток сертификата для подписи RDP-файла. Параметр доступен с версии 5.0.

Может быть задан как через указанную переменную окружения, так и через конфигурационный файл Termidesk Client.ini в параметре RDPSignSHA256.

Задание параметра через конфигурационный файл, а не через переменную окружения, имеет бОльший приоритет.

Используется для подключения к РМ через компонент «Шлюз» с использованием утилиты mstsc.exe. Параметр актуален только при подключении через утилиту mstsc.exe, соответственно, может работать только в среде ОС Microsoft Windows.

Для использования подписи RDP-файла должны быть выполнены условия:

  • сертификат (открытый ключ), использующийся для подписи, должен быть передан на узел с Клиентом совместно с закрытым ключом к нему;
  • на узел с Клиентом должен быть установлен как сертификат, использующийся для подписи, так и закрытый ключ к нему. На узел  должен быть установлен корневой сертификат, который использовался для выдачи сертификата, использующегося для подписи;
  • в поле «Common Name» сертификата, использующегося для подписи, должен быть задан FQDN узла с Клиентом.

Подпись RDP-файла и подключение на заданный в сертификате FQDN происходит только если отпечаток сертификата задан, иначе подключение инициируется на IP-адрес 127.0.0.1.

Пример значения отпечатка сертификата при задании через переменную окружения:

TDSK_RDP_SIGN_SHA256 = 76FC4AFA6967D8EDDB3786C0364F767BF9C10397

Не задано

Параметры конфигурирования Клиента могут быть заданы через файл C:\Users\<user>\AppData\Roaming\UVEON\Termidesk Client.ini (ОС Microsoft Windows) или /home/<user>/.config/UVEON/Termidesk Client.ini (ОС Astra Linux).

Пример конфигурационного файла:

[Global]
# Язык приложения (ru - русский, en - английский)
Language=ru
# Стиль приложения (light - светлый, dark - темный)
Style=light
# Запуск только одного экземпляра клиента
OneInstance=true
# Игнорирование ошибок SSL (4.0.0)
ignoreSslErrors=true
# Безопасное хранение паролей, возможные значения false/true
secureStorage=false
# Использовать Termidesk Viewer для RDP (4.3.0)
UseTermideskRDP=true
# Отпечаток сертификата для подписания rdp файла mstsc.exe при подключении через WS (5.0.0)
RDPSignSHA256=76FC4AFA6967D8EDDB3786C0364F767BF9C10397
# Адрес, который будет слушать vdi-proxy (5.0.0)
VdiProxyIniHost=0.0.0.0
   
[MainWindow]
# Cкрытие клиента в трей (4.1.0)
CloseToTray=false
# Геометрия главного окна (формат Qt)
Geometry=01d9d0cb00030000000001fb000000d6000006fa00000387000001fb000000f3000006fa0000038700000000000000000780000001fb000000f3000006fa00000387
# Порядок отображения серверов
ServersOrder=27d22dce-2255-4abe-b4e0-c0fee7100351, 2682d0e9-bb75-4e0e-8f61-5216b5c95205
# Режим отображения рабочих мест 0 - список, 1 - плитки
WorkplacesViewMode=0
   
[Servers]
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Auth=\x412\x43d\x443\x442\x440\x435\x43d\x43d\x44f\x44f \x411\x414
# Комментарий
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Comment=
# Логин
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Login=user1
# Тип пароля для аутентификации
2682d0e9-bb75-4e0e-8f61-5216b5c95205\PassType=Keyboard
# При значении параметра secureStorageEnabled=false, хранит пароль, преобразованный с помощью алгоритма blowfish.
# При значении параметра secureStorageEnabled=true, в зависимости от ОС, хранит префикс, указывающий на способ хранения.
# Для UNIX - secretservice:
# Для Windows - wincredential:
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Password=blowfish:hidden
# Хост сервера
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Url=vdi-demo.termidesk.ru
# Последняя полученная версия сервера (4.3.1)
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Version=5.0
# Идентификатор выбранного транспорта для рабочего места
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Workplaces\Fcc121357-04a3-5f68-acf8-0f8517b6e4fc\FavoriteTransportId=6ac1f9f5-9ae0-5ae0-a304-cf967b582900
# Список избранных рабочих мест
2682d0e9-bb75-4e0e-8f61-5216b5c95205\FavoriteWorkplaces=F3d316f76-b429-5406-b110-9b07e864b3fa, Fcc121357-04a3-5f68-acf8-0f8517b6e4fc
# Название аутентификатора
27d22dce-2255-4abe-b4e0-c0fee7100351\Auth=termidesk-freeipa
# Запрет сохранения пароля и удаление ранее сохраненного (4.3.1)
27d22dce-2255-4abe-b4e0-c0fee7100351\KeepPassword=false
# Запрет сохранения логина и удаление ранее сохраненного (4.3.1)
27d22dce-2255-4abe-b4e0-c0fee7100351\KeepLogin=false
# Подключение к сессии при аутентификации, 2 – активировано, 0 – деактивировано (5.1.0)
27d22dce-2255-4abe-b4e0-c0fee7100351\sessionReconnect=2
# Управление повторным подключением к сессии, 3 - активировано, 0 – деактивировано (5.1.0)
27d22dce-2255-4abe-b4e0-c0fee7100351\sessionRoaming=3