Подготовка к подключению
На компьютере Windows должна быть включена служба RDP. Нужны учётная запись с правом удалённого входа и сетевой маршрут от Mac к серверу, при необходимости через локальную сеть или VPN. Установка клиента не включает службу RDP в Windows.
На странице загрузки выберите пакет для процессора вашего Mac: Apple silicon требует macOS 13 или новее, Intel — macOS 12 или новее. Там же указано, какие загрузки доступны. Скачайте соответствующий DMG и перенесите rdp-cli в папку «Программы». Следующая команда настраивает доступ к CLI. Если терминал не находит программу, откройте новый терминал или укажите полный путь к исполняемому файлу в приложении. DMG также содержит отдельный исполняемый файл.
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
Создание сеанса
Замените адрес из примера и USER на сервер и учётную запись, которыми вам разрешено пользоваться. Вставьте блок в Терминал macOS (zsh), введите пароль по запросу и нажмите Return. Пароль не отображается; блок передаёт его rdp-cli и автоматически завершает ввод.
Для доменной учётной записи добавьте --domain DOMAIN. Вместо пароля можно указать сохранённые данные через --credential-ref CREDENTIAL; не сочетайте несколько источников пароля. Текущая политика сертификатов RDP по умолчанию — ignore. Проверьте rdp-cli connect --help и настройте проверку для своей среды.
Прочитайте состояние и ошибки в JSON-ответе, сохраните data.session. Даже подключённый сеанс может показывать экран входа или приветствия.
read -r -s "rdp_password?Пароль: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
Проверка настоящего экрана
Подставьте полученное значение вместо SESSION и откройте first-screen.png. Ответ содержит также data.observation: используйте его для ввода на основе этого снимка. После переподключения, смены управления или конфигурации экранов требуется новое наблюдение.
rdp-cli screenshot --session SESSION --out first-screen.png
Просмотр по желанию
Для удалённого подключения не нужно локальное окно. Когда захотите увидеть ход работы, откройте просмотр того же сеанса. Окно запускается без права ввода; кнопками можно приостановить работу и взять управление. Закрытие окна просмотра сохраняет соединение. Закрытие окна, владеющего управлением, оставляет ввод приостановленным.
rdp-cli watch --session SESSION --viewer window
Если подключение не удалось
Проверьте адрес, сеть, службу RDP и права учётной записи. Перед повторной отправкой пароля прочитайте структурированную ошибку. Настройки совместимости применяйте только к нужным старым серверам. Состояние существующего сеанса можно проверить командой rdp-cli status --session SESSION.
Связанные статьи
- Удалённые задачи через команды агента
- Просмотр, пауза и перехват управления тем же сеансом
- Быстрый старт