Модуль community.windows.win_netbios — управление настройками NetBIOS через TCP/IP в Windows.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

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

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

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

Включает или отключает NetBIOS на сетевых адаптерах Windows.
Может использоваться для защиты системы от отравления NBT-NS и предотвращения широковещательных штормов NBNS.
Настройки можно применять для всей системы или отдельно для каждого адаптера.

Параметры

Параметр	Комментарии
adapter_names list / elements=string	Список имён адаптеров, для которых нужно управлять настройками NetBIOS. Если этот параметр не указан, конфигурация применяется ко всем адаптерам системы. В качестве имени адаптера используется подпись подключения в панели управления сетями или через `Get-NetAdapter`, например `Ethernet 2`.
state string / обязательный	Определяет, должен ли NetBIOS быть включён, отключён или настроен по умолчанию (использовать настройку DHCP-сервера либо включить NetBIOS, если назначен статический IP-адрес). Варианты: `"enabled"` `"disabled"` `"default"`

Параметр

Комментарии

adapter_names

list / elements=string

Список имён адаптеров, для которых нужно управлять настройками NetBIOS. Если этот параметр не указан, конфигурация применяется ко всем адаптерам системы.

В качестве имени адаптера используется подпись подключения в панели управления сетями или через Get-NetAdapter, например Ethernet 2.

state

string / обязательный

Определяет, должен ли NetBIOS быть включён, отключён или настроен по умолчанию (использовать настройку DHCP-сервера либо включить NetBIOS, если назначен статический IP-адрес).

Варианты:

"enabled"
"disabled"
"default"

Примечания

Примечание

Изменение настроек NetBIOS обычно не требует перезагрузки и вступает в силу немедленно.
После отключения NetBIOS прослушивание UDP-портов 137/138/139 прекращается.

Примеры

- name: Disable NetBIOS system wide
  community.windows.win_netbios:
    state: disabled

- name: Disable NetBIOS on Ethernet2
  community.windows.win_netbios:
    state: disabled
    adapter_names:
      - Ethernet2

- name: Enable NetBIOS on Public and Backup adapters
  community.windows.win_netbios:
    state: enabled
    adapter_names:
      - Public
      - Backup

- name: Set NetBIOS to system default on all adapters
  community.windows.win_netbios:
    state: default

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

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

Ключ	Описание
reboot_required boolean	Логическое значение, указывающее, требуется ли перезагрузка системы. Возвращается: всегда Пример: `true`

Авторы

Thomas Moore (@tmmruk)

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

© 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_netbios_module.html