ansible.builtin.win_firewall (v2.5.15) — module

Install Ansible via pip

Install with pip install ansible==2.5.15

Description

Enable or Disable Windows Firewall profiles.

Requirements

• This module requires Windows Management Framework 5 or later.

Usage examples

Scanned by Steampunk Spotter

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

- name: Enable firewall for Domain, Public and Private profiles
  win_firewall:
    state: enabled
    profiles:
    - Domain
    - Private
    - Public
  tags: enable_firewall

Scanned by Steampunk Spotter

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

- name: Disable Domain firewall
  win_firewall:
    state: disabled
    profiles:
    - Domain
  tags: disable_firewall

Inputs

    
state:
    choices:
    - enabled
    - disabled
    description:
    - Set state of firewall for given profile.

profiles:
    choices:
    - Domain
    - Private
    - Public
    default:
    - Domain
    - Private
    - Public
    description:
    - Specify one or more profiles to change.

Outputs

enabled:
  description: current firewall status for chosen profile (after any potential change)
  returned: always
  sample: true
  type: bool
profiles:
  description: chosen profile
  returned: always
  sample: Domain
  type: string
state:
  description: desired state of the given firewall profile(s)
  returned: always
  sample: enabled
  type: list