Интерфейс командной строки ПО Termidesk Viewer и параметры конфигурирования

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

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

vdi-viewer --help

BASH

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

vdi-viewer --help-all

BASH

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

открыть командную строку от имени администратора;
вызывать приложение vdi-viewer из каталога C:\Program Files\UVEON\Termidesk Viewer;
перенаправить вывод команды в файл. В указанном файле будет показан результат выполнения команды.

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

"C:\Program Files\UVEON\Termidesk Viewer\vdi-viewer.exe" --help-all > C:\viewer_help_all.txt

BASH

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

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

Список аргументов командной строки и переменных окружения ПО Termidesk Viewer

Параметр	Переменная окружения	Описание	Значение по умолчанию
`--debug`	`TDSK_DEBUG`	Включение отладочного режима. Для включения режима через переменную окружения достаточно присвоить ей ненулевое значение	`Не задано`
`--lang`	`TDSK_LANG`	Выбор языка для приложения. Параметр доступен с версии ПО Termidesk Viewer 1.9.0. По умолчанию язык будет определен из региональных настроек, установленных в ОС. Возможные значения: `ru`, `en`	`auto`
`--timeout`	`TDSK_TIMEOUT`	Время ожидания подключения к компоненту «Шлюз» (в секундах). Параметр доступен с версии ПО Termidesk Viewer 1.5.0. С версии 1.10.0 параметр влияет также на время ожидания подключения к РМ по протоколу RDP. Для этого подключения может указан диапазон от 0 до 600 секунд. Крайне малые значения через переменную окружения задавать не рекомендуется, т.к. она влияет на настройки Клиента	`60`
`--version`	`Не задана`	Вывод текущей версии ПО Termidesk Viewer	`Не задано`
`--video-codec`	`TDSK_VIDEO_CODEC`	Кодек видеокамеры. Параметр доступен с версии ПО Termidesk Viewer 1.6. Возможные значения: `libtheora` - нативный метод кодирования Theora; `theora` - кодирование через конвейер Gstreamer	`libtheora`
`Не задан`	`TDSK_RDP_PRT_UNIVERSAL`	Определяет драйвер, который будет использован при перенаправлении принтера по протоколу RDP. Параметр доступен с версии ПО Termidesk Viewer 1.10.0. Наличие переменной `TDSK_RDP_PRT_UNIVERSAL` активирует перенаправление принтера с использованием универсального драйвера (Microsoft Software Printer Driver). Для перенаправления принтера с использованием нативного драйвера переменную нужно удалить.	`Не задано`
`Не задан`	`TDSK_FILECOPY_BANDWIDTH`	Задает ограничение скорости передачи (Кбайт/с) файла по протоколу TERA. Отсутствие переменной эквивалентно значению `0`. Возможные значения: `0` - скорость неограниченна; `1 - 10000` - значение скорости	`Не задано`
`Не задан`	`TDSK_DISPLAY_BANDWIDTH`	Задает ограничение скорости (Кбайт/с) видеоканала при подключении по протоколу TERA. Отсутствие переменной эквивалентно значению `0`. Возможные значения: `0` - скорость неограниченна; `1 - 10000` - значение скорости	`Не задано`
Параметры для TERA-подключения
`--loginctrl`	`TDSK_LOGINCTRL`	Режим работы ПО Termidesk Viewer при завершении сессии. Параметр доступен с версии ПО Termidesk Viewer 6.1. Возможные значения: `enable` - ПО Termidesk Viewer завершит работу при завершении или переключении сессии; `disable` - ПО Termidesk Viewer не будет завершать работу при завершении или переключении сессии; значение не задано - поведение зависит от режима аутентификации пользователя в РМ: если пользователь аутентифицировался с использованием технологии единого входа (SSO), то ПО Termidesk Viewer завершит работу при завершении или переключении сессии; если пользователь аутентифицировался с предъявлением пароля, то при завершении сессии отобразится экран блокировки с полем для ввода пароля для дальнейшей работы пользователя	`Не задано`
`--keepalive`	`Не задана`	Время ожидания (в секундах) подтверждения приема от TERA. Если в течение заданного времени ответ не получен, то произойдет автоматическое рассоединение. Параметр доступен с версии ПО Termidesk Viewer 6.1. Параметр действует только для протокола TERA. Для протоколов RDP и SPICE используется значение по умолчанию (15 секунд). Возможные значения: `0` - ожидание подтверждения приема отключено; `1 - 7200`	`15`
`--credentials_username`	`Не задана`	Идентификатор пользователя и контекст для аутентификации в TERA через поставщик учетных данных (Credentials Provider, в версии 6.1 только для ОС Microsoft Windows). Параметр доступен с версии ПО Termidesk Viewer 6.1. При вызове ПО Termidesk Viewer с этим параметром будет запрошен ввод пароля (аутентификатора Credentials Provider). Особенности: параметр (параметры), введенный через интерактивный режим имеет приоритет выше, чем параметр (параметры), полученный из других источников; если параметр задан в интерфейсе командной строки, то он переопределяет любые другие значения (например, из файла с расширением `.vv`); если параметр не задан в интерфейсе командной строки, то используются значения из файла с расширением `.vv`); если параметр не задан нигде, то будет передан признак отсутствия готовности аутентифицироваться через поставщик учетных данных. Формат: <имя_пользователя>@<домен>	`Не задано`
`--timezone_sync`	`TDSK_SYNC_TIMEZONE`	Режим работы ПО Termidesk Viewer для синхронизации временной зоны между пользовательской рабочей станцией и РМ. Параметр доступен с версии ПО Termidesk Viewer 6.1. Возможные значения: `enable` - ПО Termidesk Viewer будет синхронизировать временную зону; `disable` - ПО Termidesk Viewer не будет синхронизировать временную зону; значение не задано - поведение зависит от настроек политик, пришедших от сервера и от настроек TERA	`Не задано`
`--time_sync`	`TDSK_SYNC_TIME`	Режим работы ПО Termidesk Viewer для синхронизации времени между пользовательской рабочей станцией и РМ. Параметр доступен с версии ПО Termidesk Viewer 6.1. Возможные значения: `enable` - ПО Termidesk Viewer будет синхронизировать время; `disable` - ПО Termidesk Viewer не будет синхронизировать время; значение не задано - поведение зависит от настроек политик, пришедших от сервера и от настроек TERA	`Не задано`
`--audio_latency`	`TDSK_AUDIO_LATENCY`	Время (в миллисекундах) длительности джиттер-буфера, отслеживающего неравномерность поступления сетевых пакетов, задерживающего и накапливающего их для плавности воспроизведения аудио-материала без прерываний и рывков. Параметр доступен с версии ПО Termidesk Viewer 6.1. Возможные значения: `0` - задержка не используется; `1` - `10 000`. Рекомендуемое значение: `100` - 250. Особенности: значение до 400 применяется для нестабильного подключения или далеко расположенных участников подключения; при появлении помех в воспроизведении аудио-материала (щелчков, треска) джиттер-буфер можно увеличить на 100 мс. Следует помнить, что большое увеличение параметра не рекомендуется, т.к. может появиться дискомфорт при прослушивании голоса в аудиоконференциях	100

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

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

# Диалог перенаправления принтеров
[Printers redirection]
# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x4\x99\0\0\x3\n\0\0\x6\xaa\0\0\x4)\0\0\x4\x9e\0\0\x3%\0\0\x6\xa5\0\0\x4$\0\0\0\0\0\0\0\0\n\0\0\0\x4\x9e\0\0\x3%\0\0\x6\xa5\0\0\x4$)
 
# Диалог перенаправления каталога
[SharingDir]
 
# Выбранный каталог для перенаправления
Dir=/home/as/Documents
 
# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x4\x97\0\0\x3\x43\0\0\x5\xb7\0\0\x3\xf1\0\0\x4\x9c\0\0\x3^\0\0\x5\xb2\0\0\x3\xec\0\0\0\0\0\0\0\0\n\0\0\0\x4\x9c\0\0\x3^\0\0\x5\xb2\0\0\x3\xec)
ReadOnly=0
 
# Диалог перенаправление USB устройств
[USB Redirection]
# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x2\xbe\0\0\x1l\0\0\x5\xa0\0\0\x2\xaf\0\0\x2\xc3\0\0\x1\x87\0\0\x5\x9b\0\0\x2\xaa\0\0\0\0\0\0\0\0\n\0\0\0\x2\xc3\0\0\x1\x87\0\0\x5\x9b\0\0\x2\xaa)

BASH