Download PDF
Download page Интерфейс командной строки Клиента и параметры конфигурирования.
Интерфейс командной строки Клиента и параметры конфигурирования
Интерфейс командной строки Клиента и параметры конфигурирования
Параметры запуска и функционирования Клиента могут быть переопределены аргументами командной строки или переменными окружения.
Для получения краткой информации по доступным аргументам командной строки следует вызвать приложение 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. Допустимые схемы:
Начиная с Termidesk версии 5.1 поддерживается подключение к серверу с указанием URI сайта, например: | |
--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) для приложения | Не задано |
Не задан |
TDSK_RDP_SIGN_SHA256
| Отпечаток сертификата для подписи Может быть задан как через указанную переменную окружения, так и через конфигурационный файл Задание параметра через конфигурационный файл, а не через переменную окружения, имеет бОльший приоритет. Используется для подключения к РМ через компонент «Шлюз» с использованием утилиты Для использования подписи
Подпись Пример значения отпечатка сертификата при задании через переменную окружения:
| Не задано |
Параметры конфигурирования Клиента могут быть заданы через файл 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