Модуль community.windows.win_rds_cap — управление политиками авторизации подключений (CAP) на сервере шлюза удалённых рабочих столов

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows. Для работы с этим модулем требуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.windows.win_rds_cap.

Краткое описание
Требования
Параметры
См. также
Примеры

Краткое описание

Создаёт, удаляет и настраивает политику авторизации подключений к удалённому рабочему столу (RD CAP).
RD CAP позволяет указать пользователей, которым разрешено подключаться к серверу шлюза удалённых рабочих столов.

Требования

На узле, на котором выполняется этот модуль, необходимы следующие компоненты.

Windows Server 2008R2 (6.1) или более поздней версии.
Должна быть включена функция Windows «RDS-Gateway».

Параметры

Параметр	Комментарии
allow_only_sdrts_servers boolean	Указывает, разрешены ли подключения только к серверам узлов сеансов удалённых рабочих столов, которые применяют политику перенаправления шлюза удалённых рабочих столов. Допустимые значения: `false` `true`
auth_method string	Указывает, как сервер шлюза RD выполняет проверку подлинности пользователей. При создании новой CAP значение по умолчанию — `password`. Допустимые значения: `"both"` `"none"` `"password"` `"smartcard"`
computer_groups list / elements=string	Список групп компьютеров, которым разрешено подключаться к серверу шлюза удалённых рабочих столов.
idle_timeout integer	Задаёт интервал времени в минутах, по истечении которого неактивный сеанс отключается. Значение 0 отключает ограничение времени бездействия.
name string / обязательный	Имя политики авторизации подключений.
order integer	Порядок проверки политики. Сначала проверяется CAP, для которой order задано значение «1». По умолчанию новая CAP занимает первую позицию. Если указанное значение превышает общее количество существующих политик, политика займёт последнюю позицию, а порядок проверки будет ограничен этим количеством.
redirect_clipboard boolean	Разрешить перенаправление буфера обмена. Допустимые значения: `false` `true`
redirect_drives boolean	Разрешить перенаправление дисков. Допустимые значения: `false` `true`
redirect_pnp boolean	Разрешить перенаправление устройств Plug and Play. Допустимые значения: `false` `true`
redirect_printers boolean	Разрешить перенаправление принтеров. Допустимые значения: `false` `true`
redirect_serial boolean	Разрешить перенаправление последовательных портов. Допустимые значения: `false` `true`
session_timeout integer	Максимальное время бездействия сеанса в минутах. Значение 0 отключает ограничение времени сеанса.
session_timeout_action string	Действие, выполняемое сервером по истечении времени ожидания сеанса. `disconnect`: отключить сеанс. `reauth`: незаметно повторно выполнить проверку подлинности и авторизацию сеанса. Допустимые значения: `"disconnect"` ← (по умолчанию) `"reauth"`
state string	Состояние политики авторизации подключений. Если указано `absent`, политика будет удалена. Если указано `present`, политика будет настроена и создана. Если указано `enabled`, политика будет настроена, создана и включена. Если указано `disabled`, политика будет настроена и создана, но отключена. Допустимые значения: `"absent"` `"enabled"` `"disabled"` `"present"` ← (по умолчанию)
user_groups list / elements=string	Список групп пользователей, которым разрешено подключаться к серверу шлюза удалённых рабочих столов. Обязательный параметр при создании новой CAP.

См. также

community.windows.win_rds_cap: Управление политиками авторизации подключений (CAP) на сервере шлюза удалённых рабочих столов.
community.windows.win_rds_rap: Управление политиками авторизации ресурсов (RAP) на сервере шлюза удалённых рабочих столов.
community.windows.win_rds_settings: Управление основными настройками сервера шлюза удалённых рабочих столов.

Примеры

- name: Create a new RDS CAP with a 30 minutes timeout and clipboard redirection enabled
  community.windows.win_rds_cap:
    name: My CAP
    user_groups:
      - BUILTIN\users
    session_timeout: 30
    session_timeout_action: disconnect
    allow_only_sdrts_servers: true
    redirect_clipboard: true
    redirect_drives: false
    redirect_printers: false
    redirect_serial: false
    redirect_pnp: false
    state: enabled

Авторы

Kevin Subileau (@ksubileau)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_rds_cap_module.html