win_rds_settings – Manage main settings of a Remote Desktop Gateway server
New in version 2.8.
Synopsis
- Configure general settings of 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 |
|---|---|---|
| certificate_hash string | Certificate hash (thumbprint) for the Remote Desktop Gateway server. The certificate hash is the unique identifier for the certificate. | |
| enable_only_messaging_capable_clients boolean |
| If enabled, only clients that support logon messages and administrator messages can connect. |
| max_connections integer | The maximum number of connections allowed. If set to 0, no new connections are allowed.If set to -1, the number of connections is unlimited. | |
| ssl_bridging string |
| Specifies whether to use SSL Bridging. none: no SSL bridging.https_http: HTTPS-HTTP bridging.https_https: HTTPS-HTTPS bridging. |
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: Configure the Remote Desktop Gateway
win_rds_settings:
certificate_hash: B0D0FA8408FC67B230338FCA584D03792DA73F4C
max_connections: 50
notify:
- Restart TSGateway service
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)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_rds_settings_module.html