Cómo generar un informe WLAN (LAN inalámbrica) completo con PowerShell

Los informes de LAN inalámbricas son indispensables en el sector de las TI. La capacidad de comprender de forma rápida y eficaz el estado, el rendimiento y las posibles vulnerabilidades de seguridad de las redes inalámbricas es vital para las empresas, ya sean grandes o pequeñas. A través de un script PowerShell bien estructurado, se puede lograr esto sin problemas, proporcionando a los profesionales de TI y proveedores de servicios gestionados (MSP) la capacidad de generar un informe WLAN (LAN inalámbrica) completo.

Antecedentes

En una era en la que el tiempo de actividad de la red y la seguridad son primordiales, la capacidad de generar un informe WLAN (LAN inalámbrica) completo se convierte en una necesidad. Estos informes ayudan a los profesionales de TI a supervisar el estado de sus redes, comprender el comportamiento de los usuarios y detectar posibles anomalías que podrían indicar fallos de seguridad. Para los MSP que gestionan las redes de varios clientes, estos informes ofrecen una forma tangible de mostrar el trabajo realizado y los conocimientos adquiridos. El script proporcionado para generar un informe WLAN es una herramienta que puede ser aprovechada por los profesionales de TI para automatizar y simplificar este proceso de generación de informes, aprovechando el poder de los scripts de PowerShell.

El script para generar un informe WLAN completo

#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."
        }
    )
}

 

Análisis detallado

El script para generar un informe WLAN comienza comprobando la versión necesaria de Powershell, que es la 5.1, para garantizar la compatibilidad. A continuación, se presenta una sinopsis, una descripción y ejemplos que explican sucintamente el propósito del script.

Seguidamente, se definen los parámetros para el script, siendo el predeterminado «wlanreport». En el bloque ‘proceso’, el script para generar un informe WLAN comprueba si hay privilegios elevados. Sin derechos de administrador, el script no se ejecutará. A continuación, comprueba si existe una variable de entorno llamada «CustomField». Si se encuentra, sobrescribirá el parámetro del script.

La parte principal del script genera el informe WLAN a través del comando «netsh.exe wlan show wlanreport» y luego comprueba si el informe se ha creado correctamente. Tras la validación, convierte este informe XML en una tabla hash más legible, extrae datos útiles como la información de usuario, los puntos de acceso y la información del sistema y, a continuación, les da un formato de tabla.

El bloque final del script define algunas funciones personalizadas como Test-IsElevated, que comprueba si el script se ejecuta con derechos elevados, y ConvertFrom-Xml, una función para convertir datos XML.

Posibles casos de uso

Imagina a Sara, una profesional de TI en una mediana empresa. Su oficina ha experimentado recientemente algunas fluctuaciones en la red, y la tarea de Sara es diagnosticar cualquier problema con la WLAN. Con este script, puede generar un informe WLAN detallado rápidamente, descubriendo datos relacionados con las conexiones de los usuarios, los puntos de acceso activos y los detalles del sistema, lo que le ayuda a localizar la causa raíz del problema.

Comparaciones

Tradicionalmente, generar un informe WLAN implicaba intervenciones manuales, utilizando herramientas integradas en el sistema operativo, software de terceros o incluso herramientas de hardware. Aunque estos métodos siguen siendo válidos, el script PowerShell proporcionado ofrece automatización, velocidad y coherencia, lo que resulta especialmente beneficioso para los MSP que gestionan numerosas redes y requieren un enfoque estandarizado.

Preguntas frecuentes

• ¿Se puede modificar este script para generar un informe WLAN para que funcione en versiones anteriores de PowerShell? 
  Este script requiere específicamente la versión 5.1 debido a algunas funcionalidades que utiliza. Intentar utilizarlo con versiones anteriores puede provocar problemas de compatibilidad.
• ¿Y si quiero guardar el informe en otro sitio? 
  El script puede modificarse. Tendrás que cambiar la variable $WLanReportXmlPath a la ubicación deseada.

Implicaciones

Aunque el script ayuda a generar informes exhaustivos sobre la WLAN, los usuarios deben comprender sus resultados para tomar decisiones de seguridad acertadas. Pasar por alto detalles específicos o malinterpretar los datos puede llevar a que las vulnerabilidades de seguridad pasen desapercibidas.

Recomendaciones

• Ejecuta siempre el script para generar un informe WLAN completo con los permisos necesarios.
• Asegúrate de que tu versión de PowerShell es compatible.
• Revisa e interpreta periódicamente los informes generados para tomar decisiones eficaces.

Reflexiones finales

Para los profesionales de TI, NinjaOne ofrece una plataforma centralizada para gestionar la infraestructura de TI. La combinación de este script para generar un informe WLAN con las capacidades de NinjaOne puede mejorar la supervisión, la gestión y la generación de informes sobre redes inalámbricas, proporcionando un enfoque holístico de la gestión de redes de TI. Al aprovechar herramientas como el script PowerShell proporcionado, los profesionales de TI pueden trabajar de forma más inteligente, garantizando que sus redes estén siempre al máximo rendimiento.