Administración y configuración de NETBIOS en Windows con PowerShell

Configuración de NETBIOS: puntos clave

• NETBIOS es un protocolo de red heredado de Windows con riesgos potenciales para la seguridad.
• El script PowerShell que analizamos hoy automatiza la configuración de NETBIOS en los adaptadores de red.
• El script comprueba si tiene derechos administrativos, asegurando una ejecución elevada.
• Utiliza métodos CIM modernos, pero recurre a WMI para los sistemas más antiguos.
• La automatización, como este script, ofrece coherencia y reduce los errores humanos en comparación con las configuraciones manuales.
• Prueba siempre los scripts en entornos no críticos antes de su despliegue completo.
• Una configuración adecuada de NETBIOS es esencial para la seguridad de la red, especialmente con sistemas heredados.
• Herramientas como NinjaOne pueden integrar y agilizar estos scripts para la gestión centralizada de TI.

En el cambiante panorama de la gestión de redes, es esencial comprender cómo configurar los parámetros que afectan a los protocolos de comunicación. Entre ellos, NETBIOS (Network Basic Input/Output System) destaca por su uso generalizado en redes Windows por razones de legado. Este post profundiza en un script PowerShell adaptado para realizaar la configuración de NETBIOS en Windows  a través de adaptadores de red.

Antecedentes

NETBIOS ha sido un elemento básico en las redes Windows durante años, desempeñando un papel en la resolución de nombres locales. Sin embargo, puede suponer un riesgo potencial para la seguridad si no se controla. Los profesionales de TI y los proveedores de servicios gestionados (MSP) a menudo se encuentran con la necesidad de gestionar y configurar de forma centralizada los ajustes de NETBIOS, ya sea para optimizar el rendimiento de la red, garantizar el cumplimiento o aumentar la seguridad. Aquí es donde entran en juego los scripts PowerShell, como el que se proporciona, que ofrecen una solución robusta y automatizable.

Configuración de NETBIOS: script

#Requires -Version 2.0

<#
.SYNOPSIS
    Disables or Enables NETBIOS on all network adapters
.DESCRIPTION
    Disables or Enables NETBIOS on all network adapters
.EXAMPLE
    No parameters needed.
    Sets the default of "Use NetBIOS setting from the DHCP server" on all network adapters
.EXAMPLE
    -Disable
    Disables NETBIOS on all network adapters
.EXAMPLE
    -Enable
    Enables NETBIOS on all network adapters
.OUTPUTS
    None
.NOTES
    General notes
    Release Notes:
    Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
.COMPONENT
    ProtocolSecurity
#>

[CmdletBinding()]
param (
    [Parameter()]
    [switch]
    $Enable,
    [Parameter()]
    [switch]
    $Disable
)

begin {
    function Test-IsElevated {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        $p = New-Object System.Security.Principal.WindowsPrincipal($id)
        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)
    }
}
process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }
    $NetBios = if ($PSBoundParameters.ContainsKey("Enable")) {
        # 1 - Enable NetBIOS over TCP/IP
        1
    }
    elseif ($PSBoundParameters.ContainsKey("Disable")) {
        # 2 - Disable NetBIOS over TCP/IP
        2
    }
    elseif ($PSBoundParameters.ContainsKey("Enable") -and $PSBoundParameters.ContainsKey("Disable")) {
        Write-Error "Can not enable and disable at the same time."
        exit 1
    }
    else {
        # 0 - Use NetBIOS setting from the DHCP server
        0
    }

    if ($(Get-Command "Get-CimInstance" -ErrorAction SilentlyContinue).Name -like "Get-CimInstance") {
        $Arguments = @{
            TcpipNetbiosOptions = [UInt32]($NetBios)
        }
        $Session = New-CimSession
        $Query = 'Select * From Win32_NetworkAdapterConfiguration'
        $Response = Invoke-CimMethod -Query $Query -Namespace Root/CIMV2 -MethodName SetTcpipNetbios -Arguments $Arguments -CimSession $Session
        if ($Response.ReturnValue -is [int] -and $Response.ReturnValue -gt 1) {
            # 0 and 1 are success return values
            # https://powershell.one/wmi/root/cimv2/win32_networkadapterconfiguration-SetTcpipNetbios#return-value
            Write-Error "SetTcpipNetbios returned error code ($($Response.ReturnValue))"
            Remove-CimSession -CimSession $Session
            exit 1
        }
        Write-Host "Netbios set to $NetBios"
        Remove-CimSession -CimSession $Session
    }
    else {
        $Adapters = $(Get-WmiObject -Class win32_networkadapterconfiguration)
        Foreach ($Adapter in $Adapters) {
            try {
                $Adapter.SetTcpipNetbios($NetBios)
            }
            catch {
                # Do nothing if error occurs
            }
            $Adapter | Select-Object Description, TcpipNetbiosOptions
        }
    }
}
end {}

 

Análisis detallado

El script presentado está desarrollado en PowerShell, una potente herramienta en manos de los administradores. Aquí tienes un desglose paso a paso:

• Comentarios iniciales y metadatos: proporcionan una descripción, ejemplos de uso y otros metadatos sobre la funcionalidad del script.
• Cmdlet Binding: permite que las funciones avanzadas actúen de forma similar a los cmdlets.
• Parámetros: define dos conmutadores, ‘Enable’ y ‘Disable’, para gestionar NETBIOS.
• Control de la elevación de los permisos: es crucial ejecutar estos scripts con derechos administrativos. La función “Test-IsElevated” lo garantiza comprobando si el usuario posee privilegios administrativos.
• Configuración de NETBIOS: en función del conmutador proporcionado (Enable/Disable), el script establece la opción NETBIOS correspondiente.
• Implementación: si existe el comando ‘Get-CimInstance’ (típico en las versiones modernas de PowerShell), utiliza CIM (modelo de información común) para configurar los adaptadores de red. Si no es así, vuelve al antiguo método WMI (instrumental de administración de Windows).
• Comentarios y limpieza: el script proporciona información sobre los ajustes aplicados y limpia las sesiones creadas.

Posibles casos de uso

Imagina que un MSP supervisa la infraestructura de TI de una empresa que amplía su presencia fusionándose con otra entidad. Tienen una mezcla de sistemas modernos y heredados. Este MSP necesita estandarizar la configuración de NETBIOS en cientos de máquinas para garantizar una interconexión perfecta y reducir las posibles vulnerabilidades de seguridad. Al implantar este script, pueden automatizar el proceso, ahorrando tiempo y minimizando los errores humanos.

Comparaciones

Aunque existen herramientas basadas en GUI y métodos manuales para la configuración de NETBIOS en máquinas individuales, la ventaja de este script reside en la automatización. Puede integrarse en scripts de despliegue o herramientas de gestión de sistemas de mayor envergadura. En comparación con las configuraciones manuales, este script reduce la posibilidad de descuidos y proporciona un método coherente y reproducible.

FAQ

• ¿Puedo ejecutarlo en cualquier máquina Windows? 
  Sí, siempre que dispongas de PowerShell, pero siempre prueba primero en una máquina no crítica.
• ¿Qué pasa si por error activo y desactivo NETBIOS simultáneamente? 
  El script tiene controles incorporados y arrojará un error si lo intentas.
• ¿Se me notifica de alguna forma si los ajustes se han aplicado correctamente? 
  Sí, el script proporciona información sobre la configuración de NETBIOS aplicada.

Implicaciones

Una mala configuración de NETBIOS puede dejar las máquinas expuestas a diversos ataques, especialmente en redes abiertas. Garantizar la configuración correcta es crucial para la seguridad informática. Aunque NETBIOS está menos extendido en las redes modernas, los sistemas heredados siguen dependiendo de él, por lo que la gestión de su configuración es importante.

Recomendaciones

• Ejecuta siempre los scripts en un entorno de prueba antes de desplegarlos en producción.
• Asegúrate de que entiendes cada componente del script para solucionar problemas si es necesario.
• Revisa y actualiza periódicamente los scripts a medida que evolucionan los estándares de red.

Reflexiones finales

Herramientas de automatización como NinjaOne agilizan aún más los procesos y pueden integrar scripts como éste, proporcionando control centralizado, informes y supervisión. A medida que nos adentramos en el intrincado mundo de las configuraciones de red, las herramientas y scripts que simplifican las tareas adquieren un valor incalculable para los profesionales de TI de todo el mundo.