1#!/usr/local/bin/python3.8
2# -*- coding: utf-8 -*-
3
4# Copyright: (c) 2019, RusoSova
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_computer_description
10short_description: Set windows description, owner and organization
11description:
12 - This module sets Windows description that is shown under My Computer properties. Module also sets
13   Windows license owner and organization. License information can be viewed by running winver commad.
14options:
15 description:
16   description:
17     - String value to apply to Windows descripton. Specify value of "" to clear the value.
18   required: false
19   type: str
20 organization:
21   description:
22     - String value of organization that the Windows is licensed to. Specify value of "" to clear the value.
23   required: false
24   type: str
25 owner:
26   description:
27     - String value of the persona that the Windows is licensed to. Specify value of "" to clear the value.
28   required: false
29   type: str
30author:
31 - RusoSova (@RusoSova)
32'''
33
34EXAMPLES = r'''
35- name: Set Windows description, owner and organization
36  community.windows.win_computer_description:
37   description: Best Box
38   owner: RusoSova
39   organization: MyOrg
40  register: result
41
42- name: Set Windows description only
43  community.windows.win_computer_description:
44   description: This is my Windows machine
45  register: result
46
47- name: Set organization and clear owner field
48  community.windows.win_computer_description:
49   owner: ''
50   organization: Black Mesa
51
52- name: Clear organization, description and owner
53  community.windows.win_computer_description:
54   organization: ""
55   owner: ""
56   description: ""
57  register: result
58'''
59
60RETURN = r'''
61#
62'''
63