A module for testing network bandwidth over the internet as well as private networks.
Author: Matthew Bobke
Whenever I've needed to run a network bandwidth test, I've defaulted to services such as Speedtest by Ookla and fast.com. While effective, I spend a lot of time in the shell and I don't want to have to open an internet browser just to see if my network speeds are slow. iPerf3 is a simple command-line utility for testing network bandwidth and has been combined with PowerShell to form
PSSpeedTest. Behind the scenes, the executable is retrieved using the ChocolateyGet
Install-Module -Name PSSpeedTest -Repository PSGallery
NOTE: Installing this module will not automatically install
Install-SpeedTestServer will prompt for the installation of these two items if they are not installed and the global
$ConfirmationPreference is not
Usage (Public Functions)
Get-Help FunctionName -Full for detailed help.
Returns a list of your configured default speed test servers/ports for
Used to set the default speed test servers/ports for
Invoke-SpeedTest when using the
-Local switch arguments.
Runs a speed test against a server that is running iPerf3. The
-Local switches will use stored defaults, or a server can be specified with
-Port can be left out to use the default iPerf3 port 5201.
Sets up iPerf3 as a server process on the local computer. This performs the following:
- Installs the
ChocolateyGetPackageProvider if not already present.
- Installs the
iPerf3package if not already present.
- Sets the inbound/outbound firewall rules for the given port (5201 if the
-Portparameter is not used.)
- Creates a Scheduled Task to run
iperf3.exewith the necessary parameters for server usage on computer startup.
Removes all items configured by
Install-SpeedTestServer with the exception of the
.\build.ps1 -Task Test
Contributions are welcome and encouraged. Please submit issues and pull requests!