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

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

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

termidesk-client --help
BASH

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

termidesk-client --help-all
BASH

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

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

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

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

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

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

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

Адрес подключения к компоненту «Универсальный диспетчер» или приложению. Параметр доступен с версии 4.3.

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

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

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

Не задано

--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 через компонент Termidesk «Шлюз»

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

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

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

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

Используется для подключения к ВРМ через компонент Termidesk «Шлюз» с использованием утилиты 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
secureStorageEnabled=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\Password=blowfish:hidden
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Url=vdi-demo.termidesk.ru
2682d0e9-bb75-4e0e-8f61-5216b5c95205\Workplaces\F3d316f76-b429-5406-b110-9b07e864b3fa\FavoriteTransportId=6ac1f9f5-9ae0-5ae0-a304-cf967b582900
# Идентификатор выбранного транспорта для рабочего места
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
# Комментарий
27d22dce-2255-4abe-b4e0-c0fee7100351\Comment=
# Логин
27d22dce-2255-4abe-b4e0-c0fee7100351\Login=user2
# При значении параметра secureStorageEnabled=false, хранит пароль, преобразованный с помощью алгоритма blowfish.
# При значении параметра secureStorageEnabled=true, в зависимости от ОС, хранит префикс, указывающий на способ хранения.
# Для UNIX - secretservice:
# Для Windows - wincredential:
27d22dce-2255-4abe-b4e0-c0fee7100351\Password=
# Хост сервера
27d22dce-2255-4abe-b4e0-c0fee7100351\Url=192.0.2.1
# Запрет сохранения пароля и удаление ранее сохраненного (4.3.1)
27d22dce-2255-4abe-b4e0-c0fee7100351\KeepPassword=false
# Последняя полученная версия сервера (4.3.1)
27d22dce-2255-4abe-b4e0-c0fee7100351\Version=4.3.1
# Запрет сохранения логина и удаление ранее сохраненного (4.3.1)
27d22dce-2255-4abe-b4e0-c0fee7100351\KeepLogin=false
BASH