a-c-m
/
community.general
mirror of https://github.com/ansible-collections/community.general.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
community.general/lib/ansible/modules/windows/win_product_facts.py

62 lines
1.6 KiB
Python
Raw Normal View History

win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
#!/usr/bin/python
# -*- coding: utf-8 -*-
Windows: Add missing parameter types and doc fixes (#50232) * Windows: Add missing parameter types and doc fixes This PR includes: - Adding missing parameter types - Various documentation fixes * Update lib/ansible/modules/windows/win_copy.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_credential.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_computer.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_user.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_environment.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_psexec.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_uri.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_wait_for.py Co-Authored-By: dagwieers <dag@wieers.com> * Ensure docstrings are raw strings
2019-01-03 16:50:44 +00:00
# Copyright: (c) 2017, Dag Wieers (@dagwieers) <dag@wieers.com>
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
ANSIBLE_METADATA = {'metadata_version': '1.1',
'status': ['preview'],
'supported_by': 'community'}
Windows: Add missing parameter types and doc fixes (#50232) * Windows: Add missing parameter types and doc fixes This PR includes: - Adding missing parameter types - Various documentation fixes * Update lib/ansible/modules/windows/win_copy.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_credential.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_computer.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_user.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_environment.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_psexec.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_uri.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_wait_for.py Co-Authored-By: dagwieers <dag@wieers.com> * Ensure docstrings are raw strings
2019-01-03 16:50:44 +00:00
DOCUMENTATION = r'''
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
---
module: win_product_facts
Windows facts for licensing information (#50079) * Windows facts for ansible_winlicense_edition, ansible_winlicense_channel, ansible_winlicense_status added * bugfix, replaced = with : * changed facts to ansible_os_license_* in win_product_facts.ps1 Shortened the short_description in win_product_facts.py removed errant - options: {} from win_product_facts.py * Code optimisations and changed return code to $null from NA when unknown license information returned from CIM SoftwareLicensingProduct class. * code optimisation
2019-02-05 20:59:06 +00:00
short_description: Provides Windows product and license information
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
description:
win_product_facts: Fix RETURN information (#52058)
2019-02-13 09:09:30 +00:00
- Provides Windows product and license information.
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
version_added: '2.5'
author:
- Dag Wieers (@dagwieers)
'''
EXAMPLES = r'''
- name: Get product id and product key
win_product_facts:
'''
Windows: Add missing parameter types and doc fixes (#50232) * Windows: Add missing parameter types and doc fixes This PR includes: - Adding missing parameter types - Various documentation fixes * Update lib/ansible/modules/windows/win_copy.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_credential.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_computer.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_domain_user.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_environment.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_psexec.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_uri.py Co-Authored-By: dagwieers <dag@wieers.com> * Update lib/ansible/modules/windows/win_wait_for.py Co-Authored-By: dagwieers <dag@wieers.com> * Ensure docstrings are raw strings
2019-01-03 16:50:44 +00:00
RETURN = r'''
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
ansible_facts:
win_product_facts: Fix RETURN information (#52058)
2019-02-13 09:09:30 +00:00
description: Dictionary containing all the detailed information about the Windows product and license.
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
returned: always
win_product_facts: Fix RETURN information (#52058)
2019-02-13 09:09:30 +00:00
type: complex
contains:
ansible_os_license_channel:
description: The Windows license channel.
returned: always
type: str
sample: Volume:MAK
version_added: '2.8'
ansible_os_license_edition:
description: The Windows license edition.
returned: always
type: str
sample: Windows(R) ServerStandard edition
version_added: '2.8'
ansible_os_license_status:
description: The Windows license status.
returned: always
type: str
sample: Licensed
version_added: '2.8'
ansible_os_product_id:
description: The Windows product ID.
returned: always
type: str
sample: 00326-10000-00000-AA698
ansible_os_product_key:
description: The Windows product key.
returned: always
type: str
sample: T49TD-6VFBW-VV7HY-B2PXY-MY47H
win_product_facts: New module to get Windows product information (#35206) * win_setup: Add Product ID and Product Key in facts So this is actually a very nice way to get product key information from systems collected centrally. Especially with systems that have been upgraded from Windows 7 or Windows 8 to Windows 10 may not have a valid Windows 10 product license key printed anywhere, it was a digital license. If you ever have to reinstall the system, you may recover the system from the recovery partition, or the original media, but cannot upgrade to Windows 10 for free. By collecting the product key, one can always reinstall your free Windows upgrade. My only question is, do we want this to be part of the default facts, as it may be considered important information. Or should we make a special **win_product_key_facts** ? * Add ACPI product key support * Add integration test * Remove Get-ProductKey function, move inline
2018-01-23 00:44:55 +00:00
'''