/ home / community / community.windows / 2.2.0 / module / win_rds_settings

community.windows.win_rds_settings (2.2.0) — module

Manage main settings of a Remote Desktop Gateway server

Authors: Kevin Subileau (@ksubileau)

Install collection

Install with ansible-galaxy collection install community.windows:==2.2.0

Add to requirements.yml

  collections:
    - name: community.windows
      version: 2.2.0

Description

Configure general settings of a Remote Desktop Gateway server.

Requirements

Windows Server 2008R2 (6.1) or higher.
The Windows Feature "RDS-Gateway" must be enabled.

Usage examples

Scanned by Steampunk Spotter

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

Inputs

    
ssl_bridging:
    choices:
    - https_http
    - https_https
    - none
    description:
    - Specifies whether to use SSL Bridging.
    - 'C(none): no SSL bridging.'
    - 'C(https_http): HTTPS-HTTP bridging.'
    - 'C(https_https): HTTPS-HTTPS bridging.'
    type: str

max_connections:
    description:
    - The maximum number of connections allowed.
    - If set to C(0), no new connections are allowed.
    - If set to C(-1), the number of connections is unlimited.
    type: int

certificate_hash:
    description:
    - Certificate hash (thumbprint) for the Remote Desktop Gateway server. The certificate
      hash is the unique identifier for the certificate.
    type: str

enable_only_messaging_capable_clients:
    description:
    - If enabled, only clients that support logon messages and administrator messages
      can connect.
    type: bool