win_rds_rap – Manage Resource Authorization Policies (RAP) on a Remote Desktop Gateway server
win_rds_rap – Manage Resource Authorization Policies (RAP) on a Remote Desktop Gateway server
Synopsis
- Creates, removes and configures a Remote Desktop resource authorization policy (RD RAP).
- A RD RAP allows you to specify the network resources (computers) that users can connect to remotely through a Remote Desktop Gateway server.
Requirements
The below requirements are needed on the host that executes this module.
- Windows Server 2008R2 (6.1) or higher.
- The Windows Feature “RDS-Gateway” must be enabled.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
allowed_ports list |
List of port numbers through which connections are allowed for this policy. To allow connections through any port, specify 'any'. | |
computer_group string |
The computer group name that is associated with this resource authorization policy (RAP). This is required when computer_group_type is | |
computer_group_type string |
|
The computer group type:
|
description string |
Optional description of the resource authorization policy. | |
name - / required |
Name of the resource authorization policy. | |
state string |
|
The state of resource authorization policy. If If If If |
user_groups list |
List of user groups that are associated with this resource authorization policy (RAP). A user must belong to one of these groups to access the RD Gateway server. Required when a new RAP is created. |
See Also
See also
- win_rds_cap – Manage Connection Authorization Policies (CAP) on a Remote Desktop Gateway server
- The official documentation on the win_rds_cap module.
- win_rds_rap – Manage Resource Authorization Policies (RAP) on a Remote Desktop Gateway server
- The official documentation on the win_rds_rap module.
- win_rds_settings – Manage main settings of a Remote Desktop Gateway server
- The official documentation on the win_rds_settings module.
Examples
- name: Create a new RDS RAP
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
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Kevin Subileau (@ksubileau)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/win_rds_rap_module.html