Создать подключение Версия 1 (net)

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

Описание

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

Параметры 

Входные параметры

IP-адрес                                               IP-адрес подключаемого хоста.

Имя пользователя                              имя пользователя подключаемого хоста.

Домен пользователя                          домен пользователя подключаемого хоста. Если подключение происходит с указанием домена, то перед этим необходимо войти в учетную запись вручную.

Пароль                                                пароль пользователя подключаемого хоста.

Ширина экрана                                  ширина разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.

Высота экрана                                    высота разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.

Полный экран                                    при включении чекбокса окно удаленного сеанса будет отображаться на весь экран.

Буфер обмена                                    при включении чекбокса будет включено перенаправление буфера обмена.

Параметры подключения                 свойства подключения RDP. Необходимо указать словарь, где ключ - параметр подключения, а значение - значение параметра.
                                                            Ссылка на параметры подключения

Пример заполнения словаря:

1. Отпечаток сертификата - отпечаток сертификата для подписи файла подключения к RDP. 

   Пример отпечатки сертификата: 
   - 4213ca08c656a7f404fb27800b3bbe86198e3be1

   
   Для подписи файла подключения к 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 =>  Службы удаленных рабочих столов 

Выходные параметры

Контекст RDP                          экземпляр RDP сеанса, к которому будут обращаться дальнейшие действия (Отключить процесс, Получить список процессов, Разорвать подключение). 

Настройки

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

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

    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

Пример использования 

Задача

Подключиться к удаленному рабочему столу, отобразить сообщение, далее завершить сеанс на удаленном рабочем столе. 

Решение

Воспользоваться действиями "Создать подключение", "Сообщение", "Разорвать подключение". 

Реализация

1. Собрать схему робота, состоящую из действий: 
   
   
2. Настроить параметры действия "Создать подключение". 
   
   
3. Настроить параметры действия "Сообщение". 
   
   
4. Настроить параметр действия "Разорвать подключение". 
   
   
5. Нажать на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно. 

Выполнено подключение к удаленному рабочему столу. 

Отображено заданное сообщение 

После нажатия на кнопку ОК  будет отображено окно о завершении сеанса по работе с удаленным рабочим столом.