Создать подключение / Create connection

Группа действий: Удаленный доступ

Описание

Действие создает подключение к удаленному рабочему столу.

Параметры

Входящие параметры:

IP-адрес -
Имя пользователя -
Домен пользователя -
Пароль -
Ширина экрана -
Высота экрана -
Полный экран -
Буфер обмена -
Параметры подключения -
Отпечаток сертификата -

Исходящие параметры:

Контекст RDP - экземпляр RDP сеанса, к которому будут обращаться дальнейшие действия.

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
IP-адрес	IP-адрес подключаемого хоста.	Robin.String		Да
Имя пользователя	Имя пользователя подключаемого хоста.	Robin.String		Да
Домен пользователя	Домен пользователя подключаемого хоста. Если подключение происходит с указанием домена, то перед этим необходимо войти в учетную запись вручную.	Robin.String		Нет
Пароль	Пароль пользователя подключаемого хоста.	Robin.Password		Да
Ширина экрана	Ширина разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.	Robin.Numeric		Нет
Высота экрана	Высота разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.	Robin.Numeric		Нет
Полный экран	При значении «true» окно удаленного сеанса будет отображаться на весь экран.	Robin.Boolean	true	Нет
Буфер обмена	При значении «true» будет включено перенаправление буфера обмена.	Robin.Boolean	true	Нет
Параметры подключения	Свойства подключения RDP. Необходимо указать словарь, где ключ - параметр подключения, а значение - значение параметра. Ссылка на параметры подключения	Robin.Dictionary		Нет
Отпечаток сертификата	Отпечаток сертификата для подписи файла подключения к RDP.	Robin.String		Нет
Результаты
Контекст RDP	Экземпляр RDP сеанса, к которому будут обращаться дальнейшие действия.	Robin.RemoteDesktop

Особые условия использования

Подключение создается по IP адресу, Имени пользователя и Пароля учетной записи пользователя удаленного компьютера.
Если подключение не удается создать - робот возвращает ошибку.
Если робот завершил работу и в схеме не было действия "Разорвать подключение", то сеанс с удаленным рабочем столом остается открытым.
Есть возможность настройки экрана отображаемого сеанса - Ширина, Высота экрана и Полноэкранный режим.
Ширина и высота указанные пользователем должны находится в диапазоне от 200 до 8192. Иначе экран откроется по размеру последнего подключения.
Если заполнен один из параметров Ширина/Высота, а другой параметр Высота/Ширина нет, то робот выдаст ошибку.
Есть возможность перенаправления буфера обмена - передачи текста/файлов из буфера между компьютером и удаленным хостом.
Все остальные параметры для подключения пользователь может ввести в параметр с типом словарь, указав в ключе название параметра, а в значении содержание самого параметра. Список доступных параметров и их значения представлен на сайте: https://learn.microsoft.com/ru-ru/windows-server/remote/remote-desktop-services/clients/rdp-files
Пример заполнения словаря:
Если словарь с параметрами подключения будет некорректно заполнен или хотя бы один параметр будет неверно описан, то все параметры не будут учитываться. Робот ошибку не вернет.
Если в словаре указан параметр, который уже есть в параметрах действия, то действие будет учитывать параметры из словаря. Пример: "Полноэкранный режим" - false, В словаре указан "Полноэкранный режим" - true. Результат: Сеанс откроется в полноэкранном режиме.
Если подключение происходит с указанием домена, то перед этим пользователю надо вручную подключиться к этой доменной учетной записи.
Для подписи файла подключения к RDP надо добавить сертификат в систему и прописать его в реестре. При подключении к удаленному рабочему столу без сертификата будет отображено окно:

Алгоритм действий:

Добавить или взять существующий сертификат sha256 в личных и доверенных сертификатах (Certmgr.msc - https://learn.microsoft.com/ru-ru/dotnet/framework/tools/certmgr-exe-certificate-manager-tool)
Этот сертификат добавить в реестр по пути: regedit (В поле поиска на панели задач введите regedit, а затем выберите Редактор реестра в результатах)=> Компьютер\HKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\Windows NT\Terminal Services добавить TrustedCertThumbprints
Если это не сработает, то надо в групповых политиках добавить этот сертификат в доверенные (https://blog.superautomation.co.uk/2020/10/rdp-file-signing.html)
- Gpedit.msc
- Конфигурация компьютера => Административные шаблоны => Компоненты Windows => Службы удаленных рабочих столов

Полезные ссылки:
https://admx.help/?Category=Windows_10_2016&Policy=Microsoft.Policies.TerminalServer::TS_CLIENT_TRUSTED_CERTIFICATE_THUMBPRINTS_2&Language=ru-ru
https://learn.microsoft.com/ru-ru/dotnet/framework/tools/certmgr-exe-certificate-manager-tool
https://crypt-online.ru/crypts/sha256/
https://blog.superautomation.co.uk/2020/10/rdp-file-signing.html