Cómo ejecutar pruebas de velocidad de Internet automatizadas con PowerShell

Mantener un rendimiento óptimo de la red es crucial en el mundo de las TI. Un aspecto esencial es asegurarse de que la velocidad de Internet se ajusta a las normas exigidas. Los profesionales de TI y los proveedores de servicios gestionados (MSP) necesitan métodos fiables para medir y verificar estas velocidades.

Un script PowerShell que automatice este proceso puede ahorrar tiempo y garantizar una información precisa y actualizada. Este post explorará un script detallado diseñado para ejecutar pruebas de velocidad de Internet utilizando la CLI de Ookla y almacenar los resultados en un campo personalizado.

Contexto

El script proporcionado aprovecha la CLI de Ookla para ejecutar pruebas de velocidad de Internet en dispositivos Windows, por lo que es muy útil para los profesionales de TI y MSP. Este script aborda un reto común: probar y verificar la velocidad de Internet a través de múltiples dispositivos sin causar congestión en la red. Al aleatorizar la hora de inicio de las pruebas dentro de un intervalo de 60 minutos, garantiza que las pruebas estén repartidas, reduciendo la probabilidad de que se realicen simultáneamente.

El script para realizar pruebas de velocidad de Internet

#Requires -Version 3.0

<#
.SYNOPSIS
    Runs an internet speed test using Ookla Cli on the target windows device and saves the results to a Multi-Line Custom Field.
.DESCRIPTION
    Runs an internet speed test using Ookla Cli on the target windows device and saves the results to a Multi-Line Custom Field.
    Script will pick a random time slot from 0 to 60 minutes to run the speed test.
    This lessens the likely hood that multiple devices are testing at the same time.

    The default custom field: speedtest
.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows 7, Windows Server 2012
    Minimum PowerShell Version: 3.0
    Release Notes: Renamed script and added Script Variable support
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
    Utility
#>
[CmdletBinding()]
param (
    [Parameter()]
    [string]$CustomField = "speedtest",
    [Parameter()]
    [switch]$SkipSleep = [System.Convert]::ToBoolean($env:skipRandomSleepTime)
)
begin {
    if ($env:customFieldName -and $env:customFieldName -notlike "null") { $CustomField = $env:customFieldName }
    # add TLS 1.2 and SSL3 to allow Invoke-WebRequest to work under older PowerShell versions
    if ($PSVersionTable.PSVersion.Major -eq 2) {
        Write-Host "Requires at least PowerShell 3.0 to run."
        exit 1
    }
    else {
        try {
            $TLS12Protocol = [System.Net.SecurityProtocolType] 'Ssl3 , Tls12, Tls11'
            [System.Net.ServicePointManager]::SecurityProtocol = $TLS12Protocol
        }
        catch {
            Write-Host "Failed to set SecurityProtocol to Tls 1.2, Tls1.1, and Ssl3"
        }
    }
    $CurrentPath = Get-Item -Path ".\"
}
process {
    # Random delay from 0 to 60 minutes in 2 minute time slots
    $MaximumDelay = 60
    $TimeChunks = 2
    $Parts = ($MaximumDelay / $TimeChunks) + 1
    $RandomNumber = Get-Random -Minimum 0 -Maximum $Parts
    $Minutes = $RandomNumber * $TimeChunks
    if (-not $SkipSleep) {
        Start-Sleep -Seconds $($Minutes * 60)
    }

    # Get latest version of speedtest cli
    try {
        $Cli = Invoke-WebRequest -Uri "https://www.speedtest.net/apps/cli" -UseBasicParsing
    }
    catch {
        Write-Host "Failed to query https://www.speedtest.net/apps/cli for speed test cli zip."
        exit 1
    }
    
    # Get the download link
    $Url = $Cli.Links | Where-Object { $_.href -like "*win64*" } | Select-Object -ExpandProperty href
    # Build the URL and destination path
    $InvokeSplat = @{
        Uri     = $Url
        OutFile = Join-Path -Path $CurrentPath -ChildPath $($Url | Split-Path -Leaf)
    }
    # Download the speedtest cli zip
    try {
        Invoke-WebRequest @InvokeSplat -UseBasicParsing
    }
    catch {
        Write-Host "Failed to download speed test cli zip from $Url"
        exit 1
    }
    
    # Build the path to speedtest.exe
    $ExePath = Join-Path -Path $CurrentPath -ChildPath "speedtest.exe"
    $MdPath = Join-Path -Path $CurrentPath -ChildPath "speedtest.md"

    if ($(Get-Command -Name "Expand-Archive" -ErrorAction SilentlyContinue).Count) {
        Expand-Archive -Path $InvokeSplat["OutFile"] -DestinationPath $CurrentPath
    }
    else {
        # Unzip the speedtest cli zip
        Add-Type -AssemblyName System.IO.Compression.FileSystem
        if ((Test-Path -Path $ExePath)) {
            Remove-Item -Path $ExePath, $MdPath -Force -Confirm:$false -ErrorAction Stop
        }
        [System.IO.Compression.ZipFile]::ExtractToDirectory($InvokeSplat["OutFile"], $CurrentPath)
    }

    $JsonOutput = if ($(Test-Path -Path $ExePath -ErrorAction SilentlyContinue)) {
        # Run speed test and output in a json format
        try {
            Invoke-Command -ScriptBlock {
                & .\speedtest.exe --accept-license --accept-gdpr --format=json
                if (0 -ne $LASTEXITCODE) {
                    Write-Error -Message "Failed to run speedtest.exe."
                }
            }
        }
        catch {
            Remove-Item -Path $ExePath, $MdPath, $InvokeSplat["OutFile"] -Force -Confirm:$false
            Write-Error -Message "Failed to run speedtest.exe."
            exit 1
        }
    }

    if ($JsonOutput) {
        # Convert from Json to PSCustomObject
        $Output = $JsonOutput | ConvertFrom-Json
        # Output the results
        $Results = [PSCustomObject]@{
            Date       = $Output.timestamp | Get-Date
            ISP        = $Output.isp
            Down       = "$([System.Math]::Round($Output.download.bandwidth * 8 / 1MB,0)) Mbps"
            Up         = "$([System.Math]::Round($Output.upload.bandwidth * 8 / 1MB,0)) Mbps"
            ResultUrl  = $Output.result.url
            PacketLoss = $Output.packetLoss
            Jitter     = $Output.ping.jitter
            Latency    = $Output.ping.latency
            Low        = $Output.ping.low
            High       = $Output.ping.high
        } | Out-String
        $Results | Write-Host
        Ninja-Property-Set -Name $CustomField -Value $Results
    }
    Remove-Item -Path $ExePath, $MdPath, $InvokeSplat["OutFile"] -Force -Confirm:$false
    exit 0
}
end {
    
    
    
}

 

Análisis detallado

El script realiza varias tareas clave:

1. Inicialización de parámetros: establece los parámetros por defecto y comprueba las variables de entorno.
2. Configuración TLS: garantiza que se establecen los protocolos de seguridad adecuados para las versiones anteriores de PowerShell.
3. Retraso aleatorio: introduce un retraso aleatorio antes de ejecutar la prueba de velocidad para evitar la congestión de la red.
4. Descarga de Speedtest CLI: descarga la última versión de la CLI de Ookla.
5. Ejecución de la prueba de velocidad: ejecuta la prueba de velocidad y captura los resultados en formato JSON.
6. Análisis sintáctico y almacenamiento de resultados: convierte los resultados JSON a un formato legible y los almacena en un campo personalizado.

Desglose paso a paso

1. Inicialización de parámetros. El script para realizar pruebas de velocidad de Internet comienza definiendo parámetros. $CustomField especifica dónde se almacenarán los resultados, y $SkipSleep es un interruptor para omitir el retraso aleatorio.
2. Configuración TLS. Esta sección asegura que los protocolos TLS apropiados están habilitados, lo cual es necesario para peticiones web seguras.
3. Retraso aleatorio. Para evitar la congestión de la red, el script para realizar pruebas de velocidad de Internet espera un tiempo aleatorio entre 0 y 60 minutos antes de ejecutar la prueba de velocidad.
4. Speedtest CLI Download. Esta parte descarga y extrae la última versión del CLI de Ookla.
5. Ejecución de la prueba de velocidad. El script para realizar pruebas de velocidad de Internet ejecuta la prueba de velocidad y muestra los resultados en formato JSON.
6. Análisis y almacenamiento de resultados. Los resultados se analizan y almacenan en un campo personalizado.

Posibles casos de uso

Imagina un MSP que gestiona redes de múltiples clientes. Al desplegar este script para realizar pruebas de velocidad de Internet en los equipos cliente, el MSP puede recopilar datos sobre la velocidad de Internet sin intervención manual. Por ejemplo, si un cliente informa de una lentitud intermitente en la velocidad de Internet, el MSP puede revisar los resultados históricos de las pruebas de velocidad para identificar patrones y abordar el problema con mayor eficacia.

Comparaciones

Otros métodos para comprobar la velocidad de Internet pueden ser el uso de herramientas web o aplicaciones independientes. Aunque pueden ser eficaces, carecen de automatización y almacenamiento centralizado de datos. Este script de PowerShell para realizar pruebas de velocidad de Internet ofrece una solución racionalizada y automatizada que se integra a la perfección con los sistemas existentes, proporcionando una ventaja significativa en términos de eficiencia y gestión de datos.

FAQ

P1: ¿Por qué utilizar un retraso aleatorio?

R1: El retraso aleatorio ayuda a evitar que varios dispositivos ejecuten la prueba de velocidad simultáneamente, lo que podría sesgar los resultados y crear congestión en la red.

P2: ¿Este script para realizar pruebas de velocidad de Internet se puede ejecutar en cualquier versión de PowerShell?

R2: El script requiere al menos PowerShell 3.0 debido a ciertas dependencias de cmdlets y configuraciones TLS.

P3: ¿Qué pasa si falla la descarga del CLI de Ookla?

R3: El script para realizar pruebas de velocidad de Internet incluye un sistema de gestión de errores que permite salir de forma automática y proporcionar un mensaje de error si falla la descarga.

Implicaciones

Unas pruebas de velocidad de Internet precisas pueden ayudar a identificar posibles problemas en la red, incluidas anomalías relacionadas con la seguridad, como caídas inesperadas de la velocidad que podrían indicar interferencias en la red o un uso no autorizado. La supervisión periódica mediante este script para realizar pruebas de velocidad de Internet puede proporcionar información sobre el rendimiento de la red y ayudar a mantener unas normas de seguridad sólidas.

Recomendaciones

1. Programación regular: programa la ejecución del script para realizar pruebas de velocidad de Internet a intervalos regulares para una supervisión continua.
2. Revisión de los resultados: revisa periódicamente los datos recopilados para identificar tendencias y abordar cualquier problema.
3. Almacenamiento seguro: asegúrate de que los resultados se almacenan de forma segura para evitar accesos no autorizados.

Reflexiones finales

El uso de este script de PowerShell para ejecutar pruebas de velocidad de Internet ofrece una potente herramienta para los profesionales de TI y los MSP. Al automatizar el proceso y almacenar los resultados en un campo personalizado, simplifica la supervisión del rendimiento de la red. NinjaOne puede mejorar aún más esta capacidad integrando el script en su conjunto de herramientas, proporcionando una plataforma centralizada para gestionar y analizar los datos de rendimiento de la red.