Модуль community.windows.win_firewall_rule — автоматизация брандмауэра Windows

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_firewall_rule.

Краткое описание
Параметры
Примечания
См. также
Примеры

Краткое описание

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

Параметры

Параметр	Описание
action строка	Действие, применяемое к объектам, для которых предназначено это правило. При создании нового правила по умолчанию используется `allow`. Варианты: `"allow"` `"block"`
description строка	Описание правила брандмауэра.
direction строка	Определяет, предназначено ли это правило для входящего или исходящего трафика. При создании нового правила по умолчанию используется `in`. Варианты: `"in"` `"out"`
enabled псевдонимы: enable логический	Определяет, включено или отключено это правило брандмауэра. При создании нового правила по умолчанию используется `true`. Варианты: `false` `true`
group строка	Имя группы для правила. Если параметр name не указан, модуль задаст параметры брандмауэра для всех правил этой группы.
icmp_type_code список / элементы=строка	Типы и коды ICMP для правила. Допустимо только, если параметр protocol имеет значение `icmpv4` или `icmpv6`. Каждый элемент соответствует формату `type:code`, где `type` — номер типа, а `code` — номер кода для этого типа или `` для всех кодов. Укажите только ``, чтобы применить правило ко всем типам и кодам ICMP. Список типов ICMP и соответствующих им кодов см. по адресу https://www.iana.org/assignments/icmp-parameters/icmp-parameters.xhtml. Типы и коды ICMP для IPV6 см. по адресу https://www.iana.org/assignments/icmpv6-parameters/icmpv6-parameters.xhtml.
localip строка	Локальный IP-адрес, к которому применяется это правило. Укажите `any`, чтобы применить правило ко всем локальным IP-адресам. При создании нового правила по умолчанию используется `any`.
localport строка	Локальный порт, к которому применяется это правило. Укажите `any`, чтобы применить правило ко всем локальным портам. При создании нового правила по умолчанию используется `any`. Необходимо указать параметр protocol.
name строка	Отображаемое имя правила. Этот параметр обязателен, если не указан group.
profiles псевдонимы: profile список / элементы=строка	Профиль, к которому применяется это правило. При создании нового правила по умолчанию используется `domain,private,public`.
program строка	Программа, к которой применяется это правило. Укажите `any`, чтобы применить правило ко всем программам. При создании нового правила по умолчанию используется `any`.
protocol строка	Протокол, к которому применяется это правило. Укажите `any`, чтобы применить правило ко всем службам. При создании нового правила по умолчанию используется `any`.
remoteip строка	Удалённый IP-адрес или диапазон, к которому применяется это правило. Укажите `any`, чтобы применить правило ко всем удалённым IP-адресам. При создании нового правила по умолчанию используется `any`.
remoteport строка	Удалённый порт, к которому применяется это правило. Укажите `any`, чтобы применить правило ко всем удалённым портам. При создании нового правила по умолчанию используется `any`. Необходимо указать параметр protocol.
service строка	Служба, к которой применяется это правило. Укажите `any`, чтобы применить правило ко всем службам. При создании нового правила по умолчанию используется `any`.
state строка	Следует добавить или удалить это правило. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

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

См. также

community.windows.win_firewall: Официальная документация по модулю community.windows.win_firewall.

Примеры

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

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

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

- name: Enable all the Firewall rules in application group
  win_firewall_rule:
    group: application
    enabled: true

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

- name: Firewall rule to allow ICMP v4 echo (ping)
  community.windows.win_firewall_rule:
    name: ICMP Allow incoming V4 echo request
    enabled: true
    state: present
    profiles: private
    action: allow
    direction: in
    protocol: icmpv4
    icmp_type_code:
      - '8:*'

- name: Firewall rule to alloc ICMP v4 on all type codes
  community.windows.win_firewall_rule:
    name: ICMP Allow incoming V4 echo request
    enabled: true
    state: present
    profiles: private
    action: allow
    direction: in
    protocol: icmpv4
    icmp_type_code: '*'

Авторы

Artem Zinenko (@ar7z1)
Timothy Vandenbrande (@TimothyVandenbrande)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_firewall_rule_module.html