W3cubDocs

/Ansible

community.windows.win_rds_settings module – Manage main settings of a Remote Desktop Gateway server

Note

This module is part of the community.windows collection (version 2.4.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.windows. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.windows.win_rds_settings.

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

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.

Choices:

  • false
  • true

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.

Choices:

  • "https_http"
  • "https_https"
  • "none"

See Also

See also

community.windows.win_rds_cap

Manage Connection Authorization Policies (CAP) on a Remote Desktop Gateway server.

community.windows.win_rds_rap

Manage Resource Authorization Policies (RAP) on a Remote Desktop Gateway server.

community.windows.win_rds_settings

Manage main settings of a Remote Desktop Gateway server.

Examples

- name: Configure the Remote Desktop Gateway
  community.windows.win_rds_settings:
    certificate_hash: B0D0FA8408FC67B230338FCA584D03792DA73F4C
    max_connections: 50
  notify:
    - Restart TSGateway service

Authors

  • 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/ansible/latest/collections/community/windows/win_rds_settings_module.html