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

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

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

:~$ termidesk-client --help

BASH

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

:~$ termidesk-client --help-all

BASH

Для использования интерфейса командной строки Клиента в ОС 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

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

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

Параметр	Переменная окружения	Описание	Значение по умолчанию
`URL`	`TDSK_VDI_URL`	Адрес подключения к серверу или приложению. Доступен с версии 4.3. Допустимые схемы: `https://192.0.2.10` - подключение к серверу; `daass://192.0.2.10/foo/bar` - подключение к приложению	`Не задано`
`--debug`	`TDSK_DEBUG`	Включение отладочного режима. Для включения режима через переменную окружения достаточно присвоить ей ненулевое значение	`Не задано`
`--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`, соответственно, может работать только в среде ОС 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 (ОС 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