win_firewall_rule – Автоматизация брандмауэра Windows

Обзор
Параметры
См. также
Примеры
Статус

Обзор

Позволяет создавать/удалять/обновлять правила брандмауэра.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action строка	Варианты: allow block	Действие, которое следует выполнить для элементов, на которые распространяется это правило. По умолчанию `allow` при создании нового правила.
description строка		Описание правила брандмауэра.
direction строка	Варианты: in out	Применяется ли это правило к входящему или исходящему трафику. По умолчанию `in` при создании нового правила.
enabled логическое значение	Варианты: no yes	Включено или выключено это правило брандмауэра. По умолчанию `true` при создании нового правила. псевдонимы: enable
group строка добавлено в 2.9		Имя группы для правила.
localip строка		Локальный IP-адрес, к которому применяется это правило. Установлено в `any` для применения ко всем локальным IP-адресам. По умолчанию `any` при создании нового правила.
localport строка		Локальный порт, к которому применяется это правило. Установлено в `any` для применения ко всем локальным портам. По умолчанию `any` при создании нового правила. Требуется установить protocol
name строка / обязательно		Имя правила для отображения.
profiles список		Профиль, к которому применяется это правило. По умолчанию `domain,private,public` при создании нового правила. псевдонимы: profile
program строка		Программа, к которой применяется это правило. Установлено в `any` для применения ко всем программам. По умолчанию `any` при создании нового правила.
protocol строка		Протокол, к которому применяется это правило. Установлено в `any` для применения ко всем службам. По умолчанию `any` при создании нового правила.
remoteip строка		Удаленный IP-адрес/диапазон, к которому применяется это правило. Установлено в `any` для применения ко всем удаленным IP-адресам. По умолчанию `any` при создании нового правила.
remoteport строка		Удаленный порт, к которому применяется это правило. Установлено в `any` для применения ко всем удаленным портам. По умолчанию `any` при создании нового правила. Требуется установить protocol
service строка		Служба, к которой применяется это правило. Установлено в `any` для применения ко всем службам. По умолчанию `any` при создании нового правила.
state строка	Варианты: absent present ←	Добавить или удалить это правило.

См. также

win_firewall – Включить или отключить брандмауэр Windows: Официальная документация по модулю win_firewall.

Примеры

- name: Firewall rule to allow SMTP on TCP port 25
  win_firewall_rule:
    name: SMTP
    localport: 25
    action: allow
    direction: in
    protocol: tcp
    state: present
    enabled: yes

- name: Firewall rule to allow RDP on TCP port 3389
  win_firewall_rule:
    name: Remote Desktop
    localport: 3389
    action: allow
    direction: in
    protocol: tcp
    profiles: private
    state: present
    enabled: yes

- name: Firewall rule to be created for application group
  win_firewall_rule:
    name: SMTP
    group: application
    localport: 25
    action: allow
    direction: in
    protocol: tcp
    state: present
    enabled: yes

- name: Firewall rule to allow port range
  win_firewall_rule:
    name: Sample port range
    localport: 5000-5010
    action: allow
    direction: in
    protocol: tcp
    state: present
    enabled: yes

- name: Firewall rule to allow ICMP v4 (ping)
  win_firewall_rule:
    name: ICMP Allow incoming V4 echo request
    enabled: yes
    state: present
    profiles: private
    action: allow
    direction: in
    protocol: icmpv4

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Артем Зиненок (@ar7z1)
Timothy Vandenbrande (@TimothyVandenbrande)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_firewall_rule_module.html