Модуль community.windows.win_firewall — Включение или отключение брандмауэра Windows

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows. Для использования этого модуля потребуются дополнительные требования, подробности см. в разделе Требования.

Для использования в плейбуке укажите: community.windows.win_firewall.

Описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Описание

Включение или отключение профилей брандмауэра Windows.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

Для этого модуля требуется Windows Management Framework 5 или более поздняя версия.

Параметры

Параметр	Комментарии
inbound_action string добавлен в community.windows 1.1.0	Установите значение для `allow` или `block` входящего сетевого трафика в профиль. `not_configured` допустимо при настройке GPO. Выбираемые значения: `"allow"` `"block"` `"not_configured"`
outbound_action string добавлен в community.windows 1.1.0	Установите значение для `allow` или `block` исходящего сетевого трафика в профиль. `not_configured` допустимо при настройке GPO. Выбираемые значения: `"allow"` `"block"` `"not_configured"`
profiles список / элементы=строка	Укажите один или несколько профилей для изменения. Выбираемые значения: `"Domain"` ← (по умолчанию) `"Private"` ← (по умолчанию) `"Public"` ← (по умолчанию) По умолчанию: `["Domain", "Private", "Public"]`
state строка	Установите состояние брандмауэра для заданного профиля. Выбираемые значения: `"disabled"` `"enabled"`

См. также

community.windows.win_firewall_rule: Автоматизация брандмауэра Windows.

Примеры

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

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

- name: Enable firewall for Domain profile and block outbound connections
  community.windows.win_firewall:
    profiles: Domain
    state: enabled
    outbound_action: block
  tags: block_connection

Возвращаемые значения

Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
enabled логическое	Текущий статус брандмауэра для выбранного профиля (после возможного изменения). Возвращаемое значение: всегда Пример: `true`
profiles строка	Выбранный профиль. Возвращаемое значение: всегда Пример: `"Domain"`
state список / элементы=строка	Желаемое состояние заданного(ых) профиля(ей) брандмауэра. Возвращаемое значение: всегда Пример: `["enabled"]`

Авторы

Michael Eaton (@michaeldeaton)

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

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