Skip to main content

Test-NetworkSpeed

SYNOPSIS

Test network file transfer speeds, upload and download.

SYNTAX

Test-NetworkSpeed [[-LocalPath] <String>] [[-RemotePath] <String>] [[-FileSize] <Int64>]
[<CommonParameters>]

DESCRIPTION

Will test the file transfer speed of a generated file and provide you with the speed in Mbps (Megabit) and MBps (Megabyte) for uploads and downloads to a SMB file share.

EXAMPLES

EXAMPLE 1

Test-NetworkSpeed

Runs Test-NetworkSpeed using the configured values in the Keldor config.ps1 file.

EXAMPLE 2

Test-NetworkSpeed -FileSize 500KB

Runs Test-NetworkSpeed but with the FileSize parameter. This example will generate 500 Kilobyte files to transfer.

EXAMPLE 3

Test-NetworkSpeed -FileSize 100MB

Runs Test-NetworkSpeed but with the FileSize parameter. This example will generate 100 Megabyte files to transfer.

EXAMPLE 4

Test-NetworkSpeed -FileSize 1GB

Runs Test-NetworkSpeed but with the FileSize parameter. This example will generate 1 Gigabyte files to transfer.

EXAMPLE 5

Test-NetworkSpeed -LocalPath C:\Transfer

Runs Test-NetworkSpeed but with the local path parameter.

EXAMPLE 6

Test-NetworkSpeed -LocalPath D:\Temp -RemotePath \\server1.keldor.dev\Transfer

Runs Test-NetworkSpeed but with the local and remote path parameters.

PARAMETERS

-LocalPath

Specifies the path to the local folder where a file will be generated and where a file will be copied to.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemotePath

Specifies the path to the remote folder where a file will be generated and where a file will be copied to.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FileSize

Specifies the file size of the file to be generated and transferred. Enter in the format xxKB, xxMB, or xxGB.

Type: Int64
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Management.Automation.PSCustomObject

NOTES

ALIASES

None.

PLATFORM APPLICABILITY

Windows only. The platform-aware loader does not export this command on Linux or macOS.

POWERSHELL COMPATIBILITY

See PowerShell compatibility for the supported runtime policy. PowerShell 7.6 LTS is preferred.

https://docs.keldor.dev/powershell/keldor/Test-NetworkSpeed