PowerShell : gestion et configuration de NetBIOS dans Windows

NetBIOS : les principaux points à retenir

• NetBIOS est un protocole réseau Windows assez ancien qui présente des risques potentiels pour la sécurité.
• Le script PowerShell fourni en automatise la configuration sur les cartes réseau.
• Il vérifie les droits d’administration pour garantir une exécution avec des privilèges administrateur uniquement.
• Il utilise des méthodes CIM (Common Information Model) modernes, mais se rabat sur les méthodes WMI (Windows Management Instrumentation) pour les systèmes plus anciens.
• L’automatisation, comme ce script, assure la cohérence et réduit les erreurs humaines contrairement aux configurations manuelles.
• Testez toujours les scripts dans des environnements non critiques avant de les déployer complètement.
• Une configuration correcte de NetBIOS est essentielle à la sécurité du réseau, en particulier avec les anciens systèmes.
• Des outils comme NinjaOne peuvent intégrer et rationaliser ces scripts pour une gestion informatique centralisée.

Dans le paysage en constante évolution de la gestion des réseaux, il est essentiel de comprendre comment configurer les paramètres qui affectent les protocoles de communication. Parmi ceux-ci, NetBIOS (Network Basic Input/Output System) se distingue par son utilisation répandue dans les réseaux Windows car cela fait longtemps qu’il existe. Cet article examine en profondeur un script PowerShell conçu pour configurer NetBIOS dans Windows  sur toutes les cartes réseau.

Contexte

NetBIOS est un élément essentiel des réseaux Windows depuis des années, car il joue un rôle dans la résolution des noms locaux. Il peut toutefois présenter un risque potentiel pour la sécurité s’il n’est pas contrôlé. Les professionnels de l’informatique et les fournisseurs de services gérés (MSP) ont souvent besoin de le gérer et d’en configurer les paramètres de manière centralisée, que ce soit pour optimiser les performances du réseau, garantir la conformité ou renforcer la sécurité. C’est là que les scripts PowerShell, comme celui fourni, entrent en jeu, offrant une solution performante et automatisable.

Le 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 {}

 

Description détaillée

Le script présenté est développé sous PowerShell, un outil puissant entre les mains des administrateurs. En voici la description étape par étape :

• Commentaires initiaux et métadonnées : Ils fournissent une description, des exemples d’utilisation et d’autres métadonnées sur les fonctionnalités du script.
• Cmdlet Binding : Permet aux fonctions avancées d’agir de la même manière que les cmdlets.
• Paramètres : Définit deux commutateurs, « Enable » (activer) et « Disable » (désactiver), pour gérer NetBIOS.
• Vérification de l’élévation : Il est essentiel d’exécuter ces scripts avec des droits d’administrateur. La fonction « Test-IsElevated » assure cette fonction en vérifiant si l’utilisateur actuel possède des privilèges administratifs.
• Configuration de NetBIOS : En fonction du commutateur fourni (Enable/Disable), le script définit l’option NetBIOS correspondante.
• Implémentation : Si la commande « Get-CimInstance » existe (typique dans les versions modernes de PowerShell), elle utilise le CIM pour configurer les cartes réseau. Si ce n’est pas le cas, elle revient à l’ancienne méthode WMI.
• Feedback et nettoyage : Le script fournit un feedback sur les paramètres appliqués et nettoie les sessions créées.

Cas d’utilisation potentiels

Imaginez une entreprise MSP qui supervise l’infrastructure informatique d’une firme qui étend sa présence en fusionnant avec une autre entité. Cette dernière dispose aussi bien de systèmes modernes que de systèmes plus anciens. L’entreprise MSP doit normaliser les paramètres NetBIOS sur des centaines de machines afin d’assurer une mise en réseau fluide et de réduire les vulnérabilités potentielles en matière de sécurité. En déployant ce script, elle peut automatiser le processus, ce qui permet de gagner du temps et de minimiser les erreurs humaines.

Comparaisons

Bien qu’il existe des outils basés sur une interface graphique et des méthodes manuelles pour configurer les paramètres NetBIOS sur des machines individuelles, l’avantage de ce script réside dans l’automatisation. Il peut être intégré à des scripts de déploiement plus importants ou à des outils de gestion des systèmes. Par rapport aux configurations manuelles, ce script réduit les risques d’oubli et fournit une méthode cohérente et reproductible.

FAQ

• Puis-je l’utiliser sur n’importe quelle machine Windows ? 
  Oui, du moment que vous disposez de PowerShell, mais commencez toujours par tester sur une machine non critique.
• Que se passe-t-il si j’active et désactive NetBIOS simultanément par erreur ? 
  Le script comporte des contrôles intégrés et génère une erreur si vous essayez.
• Y a-t-il un feedback si les paramètres ont été appliqués avec succès ? 
  Oui, le script fournit un feedback sur la configuration NetBIOS appliquée.

Implications

Une mauvaise configuration de NetBIOS peut exposer les machines à diverses attaques, en particulier sur les réseaux ouverts. Il est essentiel pour la sécurité informatique de veiller à ce que les paramètres soient corrects. Bien que ce protocole soit moins répandu dans les réseaux modernes, les systèmes existants en dépendent toujours, ce qui rend la gestion de ses paramètres importante.

Recommandations

• Exécutez toujours les scripts dans un environnement de test avant de les déployer dans l’environnement de production.
• Assurez-vous de bien comprendre chaque élément du script afin de pouvoir en résoudre les erreurs si nécessaire.
• Révisez et mettez régulièrement à jour les scripts en fonction de l’évolution des normes de mise en réseau.

Conclusion

Les outils d’automatisation, tels que NinjaOne, permettent de rationaliser davantage les processus et d’intégrer des scripts de ce type, en centralisant le contrôle, le reporting et la surveillance. Dans le monde complexe des configurations de réseau, les outils et les scripts qui simplifient les tâches deviennent inestimables pour tous les professionnels de l’informatique.