community.windows.win_rds_rap 模块 – 管理远程桌面网关服务器上的资源授权策略 (RAP)

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：community.windows.win_rds_rap。

概要

  • 创建、删除和配置远程桌面资源授权策略 (RD RAP)。

  • RD RAP 允许您指定用户可以通过远程桌面网关服务器远程连接的网络资源（计算机）。

要求

在执行此模块的主机上需要以下要求。

  • Windows Server 2008R2 (6.1) 或更高版本。

  • 必须启用 Windows 功能“RDS-网关”。

参数

参数

注释

allowed_ports

列表 / 元素=字符串

允许此策略连接的端口号列表。

要允许通过任何端口连接，请指定“any”。

computer_group

字符串

与此资源授权策略 (RAP) 关联的计算机组名称。

当 computer_group_type 为 rdg_group 或 ad_network_resource_group 时，这是必需的。

computer_group_type

字符串

计算机组类型

rdg_group：RD 网关托管组

ad_network_resource_group：Active Directory 域服务网络资源组

allow_any：允许用户连接到任何网络资源。

选择

  • "rdg_group"

  • "ad_network_resource_group"

  • "allow_any"

description

字符串

资源授权策略的可选描述。

name

字符串 / 必需

资源授权策略的名称。

state

字符串

资源授权策略的状态。

如果 absent 将确保删除该策略。

如果 present 将确保配置并存在该策略。

如果 enabled 将确保配置、存在并启用该策略。

如果 disabled 将确保配置、存在但禁用该策略。

选择

  • "absent"

  • "disabled"

  • "enabled"

  • "present" ← (默认)

user_groups

列表 / 元素=字符串

与此资源授权策略 (RAP) 关联的用户组列表。用户必须属于这些组之一才能访问 RD 网关服务器。

创建新 RAP 时是必需的。

另请参阅

另请参阅

community.windows.win_rds_cap

管理远程桌面网关服务器上的连接授权策略 (CAP)。

community.windows.win_rds_rap

管理远程桌面网关服务器上的资源授权策略 (RAP)。

community.windows.win_rds_settings

管理远程桌面网关服务器的主要设置。

示例

- name: Create a new RDS RAP
  community.windows.win_rds_rap:
    name: My RAP
    description: Allow all users to connect to any resource through ports 3389 and 3390
    user_groups:
      - BUILTIN\users
    computer_group_type: allow_any
    allowed_ports:
      - 3389
      - 3390
    state: enabled

作者

  • Kevin Subileau (@ksubileau)