community.windows.win_netbios 模块 – 管理 Windows 上的 TCP/IP NetBIOS 设置。

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您正在使用 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在剧本中使用它，请指定：community.windows.win_netbios。

概要

  • 启用或禁用 Windows 网络适配器上的 NetBIOS。

  • 可用于保护系统免受 NBT-NS 欺骗攻击并避免 NBNS 广播风暴。

  • 设置可以应用于系统范围或每个适配器。

参数

参数

注释

adapter_names

列表 / 元素=字符串

要管理 NetBIOS 设置的适配器名称列表。如果省略此选项，则配置将应用于系统上的所有适配器。

使用的适配器名称是网络控制面板或通过 Get-NetAdapter 中的连接标题，例如 Ethernet 2。

state

字符串 / 必需

是否应启用、禁用或使用默认值（使用 DHCP 服务器的设置，或者如果分配了静态 IP 地址则启用 NetBIOS）。

选项

  • "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

布尔值

布尔值，表示是否需要系统重启。

返回：始终

示例：true

作者

  • Thomas Moore (@tmmruk)