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

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

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

Описание

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

Параметры 

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

• IP-адрес - IP-адрес подключаемого хоста.
• Имя пользователя -  имя пользователя подключаемого хоста.
• Домен пользователя - домен пользователя подключаемого хоста. Если подключение происходит с указанием домена, то перед этим необходимо войти в учетную запись вручную.
• Пароль - пароль пользователя подключаемого хоста.
• Ширина экрана  - ширина разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.
• Высота экрана - высота разрешения удаленного сеанса в пикселях. Значение должно находится в диапазоне от 200 до 8192.
• Полный экран - при включении чекбокса окно удаленного сеанса будет отображаться на весь экран.
• Буфер обмена - при включении чекбокса будет включено перенаправление буфера обмена.
• Параметры подключения - свойства подключения RDP. Необходимо указать словарь, где ключ - параметр подключения, а значение - значение параметра. Ссылка на параметры подключения
  Пример заполнения словаря:
  
• Отпечаток сертификата - отпечаток сертификата для подписи файла подключения к 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. Нажать на кнопку "Старт" в верхней панели. 

Результат: 

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

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

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

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