inverse_inc.windows.win_gpo_link (1.0.2) — module

Install collection

Install with ansible-galaxy collection install inverse_inc.windows:==1.0.2

Add to requirements.yml

  collections:
    - name: inverse_inc.windows
      version: 1.0.2

Description

Can link a GPO to the target specified.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: link and enable, force the GPO test-gpo to the root domain
  win_gpo_link:
    name: test-gpo
    state: present
    enforced: yes
    enabled: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: remove the GPO link for test-gpo on the root domain
  win_gpo_link:
    name: test-gpo
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: link the GPO test-gpo to the Servers OU container
  win_gpo_link:
    name: test-gpo
    state: present
    target: OU=Server,DC=domain,DC=local

Inputs

    
name:
    description:
    - The name of the GPO to manage the link for.
    required: true

state:
    choices:
    - absent
    - present
    default: present
    description:
    - When C(yes), the link will be created.
    - When C(no), the link will be removed.

target:
    description:
    - The LDAP path of the target to link the GPO to.
    - When not specified, this will be the whole domain.

enabled:
    description:
    - Whether the link will be enabled or not.
    type: bool

enforced:
    description:
    - Whether the link will be enforced or not.
    type: bool