ansible.builtin.win_netbios (v2.9.27) — module

Install Ansible via pip

Install with pip install ansible==2.9.27

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

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Disable NetBIOS system wide
  win_netbios:
    state: disabled

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Disable NetBIOS on Ethernet2
  win_netbios:
    state: disabled
    adapter_names:
      - Ethernet2

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Set NetBIOS to system default on all adapters
  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).
    required: false
    type: list

Outputs

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