community.windows.win_netbios – Manage NetBIOS over TCP/IP settings on Windows.¶
Note
This plugin is part of the community.windows collection (version 1.3.0).
To install it use: ansible-galaxy collection install community.windows
.
To use it in a playbook, specify: community.windows.win_netbios
.
Synopsis¶
Enables or disables NetBIOS on Windows network adapters.
Can be used to protect a system against NBT-NS poisoning and avoid NBNS broadcast storms.
Settings can be applied system wide or per adapter.
Parameters¶
Notes¶
Note
Changing NetBIOS settings does not usually require a reboot and will take effect immediately.
UDP port 137/138/139 will no longer be listening once NetBIOS is disabled.
Examples¶
- 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
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
reboot_required
boolean
|
always |
Boolean value stating whether a system reboot is required.
Sample:
True
|
Authors¶
Thomas Moore (@tmmruk)