1#!/usr/local/bin/python3.8
2# -*- coding: utf-8 -*-
3
4# Copyright: (c) 2018, Kevin Subileau (@ksubileau)
5# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
6
7DOCUMENTATION = r'''
8---
9module: win_rds_settings
10short_description: Manage main settings of a Remote Desktop Gateway server
11description:
12  - Configure general settings of a Remote Desktop Gateway server.
13author:
14  - Kevin Subileau (@ksubileau)
15options:
16  certificate_hash:
17    description:
18      - Certificate hash (thumbprint) for the Remote Desktop Gateway server. The certificate hash is the unique identifier for the certificate.
19    type: str
20  max_connections:
21    description:
22      - The maximum number of connections allowed.
23      - If set to C(0), no new connections are allowed.
24      - If set to C(-1), the number of connections is unlimited.
25    type: int
26  ssl_bridging:
27    description:
28      - Specifies whether to use SSL Bridging.
29      - 'C(none): no SSL bridging.'
30      - 'C(https_http): HTTPS-HTTP bridging.'
31      - 'C(https_https): HTTPS-HTTPS bridging.'
32    type: str
33    choices: [ https_http, https_https, none ]
34  enable_only_messaging_capable_clients:
35    description:
36      - If enabled, only clients that support logon messages and administrator messages can connect.
37    type: bool
38requirements:
39  - Windows Server 2008R2 (6.1) or higher.
40  - The Windows Feature "RDS-Gateway" must be enabled.
41seealso:
42- module: community.windows.win_rds_cap
43- module: community.windows.win_rds_rap
44- module: community.windows.win_rds_settings
45'''
46
47EXAMPLES = r'''
48- name: Configure the Remote Desktop Gateway
49  community.windows.win_rds_settings:
50    certificate_hash: B0D0FA8408FC67B230338FCA584D03792DA73F4C
51    max_connections: 50
52  notify:
53    - Restart TSGateway service
54'''
55
56RETURN = r'''
57'''
58