/ home / community / community.windows / 2.2.0 / module / win_netbios

community.windows.win_netbios (2.2.0) — module

Manage NetBIOS over TCP/IP settings on Windows.

Authors: Thomas Moore (@tmmruk)

Install collection

Install with ansible-galaxy collection install community.windows:==2.2.0

Add to requirements.yml

  collections:
    - name: community.windows
      version: 2.2.0

Description

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.

Usage examples

Scanned by Steampunk Spotter

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

Scanned by Steampunk Spotter

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

Scanned by Steampunk Spotter

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

Scanned by Steampunk Spotter

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

Inputs

    
state:
    choices:
    - enabled
    - disabled
    - default
    description:
    - Whether NetBIOS should be enabled, disabled, or default (use setting from DHCP server
      or if static IP address is assigned enable NetBIOS).
    required: true
    type: str

adapter_names:
    description:
    - List of adapter names for which to manage NetBIOS settings. If this option is omitted
      then configuration is applied to all adapters on the system.
    - The adapter name used is the connection caption in the Network Control Panel or
      via C(Get-NetAdapter), eg C(Ethernet 2).
    elements: str
    required: false
    type: list

Outputs

reboot_required:
  description: Boolean value stating whether a system reboot is required.
  returned: always
  sample: true
  type: bool