Comment générer un rapport complet sur le réseau local sans fil (WLAN) à l’aide de PowerShell

Les rapports sur le réseau local sans fil (WLAN) sont indispensables dans le secteur de l’informatique. La capacité à comprendre rapidement et efficacement l’état, les performances et les failles de sécurité potentielles des réseaux sans fil est vitale pour toute entreprise, qu’elle soit grande ou petite. Un script PowerShell bien structuré permet aux professionnels de l’informatique et aux fournisseurs de services gérés (MSP) de générer un rapport complet sur le réseau local sans fil.

Contexte

À une époque où le temps de fonctionnement et la sécurité du réseau sont primordiaux, la possibilité de générer un rapport sur le réseau local sans fil devient une nécessité. Ces rapports aident les professionnels de l’informatique à surveiller la performance de leurs réseaux, à comprendre le comportement des utilisateurs et à repérer les anomalies potentielles qui pourraient indiquer des failles de sécurité. Pour les entreprises MSP qui gèrent les réseaux de plusieurs clients, ces rapports constituent un bon moyen de montrer le travail effectué et les informations clés. Le script fourni est un outil qui peut être utilisé par les professionnels de l’informatique pour automatiser et simplifier ce processus de création de rapports.

Le script

#Requires -Version 5.1

<#
.SYNOPSIS
    Saves a Wireless LAN report to a Multi-Line Custom Field.
.DESCRIPTION
    Saves a Wireless LAN report to a Multi-Line Custom Field.
.EXAMPLE
     -CustomField "wlanreport"
    Saves a Wireless LAN report to a Multi-Line Custom Field.
.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2016
    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).
#>

[CmdletBinding()]
param (
    [Parameter()]
    [String]
    $CustomField = "wlanreport"
)

process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }
    if ($env:CustomField) {
        # Use Script Variable and overwrite parameter
        $CustomField = $env:CustomField
    }
    $WLanReportXmlPath = "C:ProgramDataMicrosoftWindowsWlanReportwlan-report-latest.xml"
    # Generate the wlan report
    netsh.exe wlan show wlanreport | Out-Null
    # Check that the xml report exists
    if (-not $(Test-Path -Path $WLanReportXmlPath)) {
        Write-Host "[Error] $WLanReportXmlPath was not created by: netsh.exe wlan show wlanreport"
        exit 1
    }
    # Convert the report from XML to a hash table
    $WLanReport = [xml[]]$(Get-Content -Raw -Path $WLanReportXmlPath) | ConvertFrom-Xml
    # Get the date that the report was generated
    $ReportDate = [DateTime]::ParseExact($WLanReport.WlanReport.ReportInformation.ReportDate -replace 'Z', "yyyy'-'MM'-'dd'T'HH':'mm':'ss", $null)
    # Collect data into one variable
    $Report = if ($WLanReport) {
        # Output the date of the report
        Write-Output "Report Date : $ReportDate"
        # Output the user information
        $WLanReport.WlanReport.UserInformation | Format-Table
        # Output the saved Access Points
        $WLanReport.WlanReport.Profiles.'Wi-Fi'.Keys | ForEach-Object {
            $AccessPointName = $_
            $AccessPointData = [xml[]]$WLanReport.WlanReport.Profiles.'Wi-Fi'."$AccessPointName"
            if ($null -ne $AccessPointData) {
                $AccessPoint = $AccessPointData | ConvertFrom-Xml
                [PSCustomObject]@{
                    AccessPointName  = $AccessPointName
                    Authentication   = $AccessPoint."$AccessPointName".MSM.security.authEncryption.authentication
                    Encryption       = $AccessPoint."$AccessPointName".MSM.security.authEncryption.encryption
                    MacRandomization = $AccessPoint."$AccessPointName".MacRandomization.enableRandomization
                }
            }
        } | Format-Table
        
        # Output the system information
        $WLanReport.WlanReport.SystemInformation.Keys | ForEach-Object {
            $Data = $($WLanReport.WlanReport.SystemInformation."$($_)")
            if ($Data -is "String") {
                Write-Output "$_ : $Data"
            }
        }
        # Output network adapters
        Get-NetAdapter | Format-Table Name, InterfaceDescription, Status, MacAddress, LinkSpeed, MediaType
    }
    else {
        $null
    }

    if ($Report) {
        # Output report to Activity Feed
        $Report | Out-String | Write-Host
        # Save report to multi-line custom field
        Ninja-Property-Set -Name $CustomField -Value $($Report | Out-String)
    }
    else {
        Write-Host "Could not generate wlan report."
        exit 1
    }
    
}
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)
    }
    function ConvertFrom-Xml {
        param([parameter(Mandatory, ValueFromPipeline)] [System.Xml.XmlNode] $node)
        process {
            if ($node.DocumentElement) { $node = $node.DocumentElement }
            $oht = [ordered] @{}
            $name = $node.Name
            if ($node.FirstChild -is [system.xml.xmltext]) {
                $oht.$name = $node.FirstChild.InnerText
            }
            else {
                $oht.$name = New-Object System.Collections.ArrayList 
                foreach ($child in $node.ChildNodes) {
                    $null = $oht.$name.Add((ConvertFrom-Xml $child))
                }
            }
            $oht
        }
    }
}
end {
    $ScriptVariables = @(
        [PSCustomObject]@{
            name           = "CustomField"
            calculatedName = "customfield"
            required       = $true
            defaultValue   = [PSCustomObject]@{
                type  = "TEXT"
                value = "wlanreport"
            }
            valueType      = "TEXT" # Must be uppercase!
            valueList      = $null
            description    = "A multi-line Custom Field that the report will be saved to."
        }
    )
}

 

Description détaillée

Le script commence par vérifier la version nécessaire, qui est la 5.1, afin d’assurer la compatibilité. Ensuite, un synopsis, une description et des exemples sont fournis, offrant une explication succincte de l’objectif du script..

Des paramètres sont ensuite définis pour le script, la valeur par défaut étant « wlanreport ». Dans le bloc « processus », le script vérifie la présence de privilèges élevés. Sans droits d’administrateur, le script ne s’exécutera pas. Il vérifie ensuite la présence d’une variable d’environnement nommée « CustomField » Si elle est trouvée, elle remplacera le paramètre du script.

La partie principale du script génère le rapport WLAN par le biais de la commande netsh.exe wlan show wlanreport et vérifie ensuite si le rapport a été créé avec succès. Après validation, il convertit ce rapport XML en une table de hachage plus lisible, extrait les données utiles telles que les informations sur les utilisateurs, les point d’accès et les informations sur le système, puis les présente sous forme de tableau.

Le bloc final du script définit quelques fonctions personnalisées comme Test-IsElevated, qui vérifie si le script est exécuté avec des droits élevés, et ConvertFrom-Xml, une fonction permettant de convertir des données XML.

Cas d’utilisation potentiels

Imaginez Sarah, informaticienne dans une entreprise de taille moyenne. Leur bureau a récemment connu des fluctuations de réseau et Sarah a pour mission de diagnostiquer les problèmes liés au réseau local sans fil (WLAN). À l’aide de ce script, elle peut rapidement générer un rapport détaillé sur le réseau local sans fil, en découvrant les données relatives aux connexions des utilisateurs, aux points d’accès actifs et aux détails du système, ce qui l’aide à identifier la cause première du problème.

Comparaisons

Traditionnellement, la génération d’un rapport WLAN impliquait des interventions manuelles, à l’aide d’outils intégrés au système d’exploitation, de logiciels tiers ou même d’outils matériels. Bien que ces méthodes soient toujours valables, le script PowerShell offre automatisation, rapidité et cohérence, ce qui est particulièrement avantageux pour les entreprises MSP qui gèrent de nombreux réseaux et ont besoin d’une approche standardisée.

FAQ

• Ce script peut-il être modifié pour fonctionner sur des versions plus anciennes de PowerShell ? 
  Ce script nécessite spécifiquement la version 5.1 en raison de certaines fonctionnalités qu’il utilise. Tenter de l’utiliser avec des versions plus anciennes peut entraîner des problèmes de compatibilité.
• Que faire si je veux que le rapport soit enregistré ailleurs ? 
  Le script peut être modifié. Vous devrez modifier la variable $WLanReportXmlPath en fonction de l’emplacement souhaité.

Implications

Bien que le script permette de générer des rapports complets sur les réseaux locaux sans fil, les utilisateurs doivent comprendre ses résultats pour prendre des décisions pertinentes en matière de sécurité. Le fait de négliger des détails spécifiques ou de mal interpréter les données peut conduire à des vulnérabilités de sécurité qui passent inaperçues.

Recommandations

• Exécutez toujours le script avec les autorisations nécessaires.
• Assurez-vous que votre version de PowerShell est compatible.
• Examinez et interprétez régulièrement les rapports produits pour une prise de décision efficace.

Conclusions

NinjaOne offre aux professionnels de l’informatique une plateforme centralisée pour gérer l’infrastructure informatique. Le couplage de ce script avec les capacités de NinjaOne peut améliorer la surveillance, la gestion et le reporting des réseaux sans fil, en fournissant une approche complète de la gestion des réseaux informatiques. En tirant parti d’outils tels que le script PowerShell fourni, les professionnels de l’informatique peuvent travailler plus intelligemment, en veillant à ce que leurs réseaux soient toujours à leur meilleure performance.